Workspace是文件的容器和权限边界，所有文件操作必须依附于某个Workspace，每个Workspace自带专属文件系统挂载点，实现物理隔离与配额管理。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Agent Space中所有文件操作都必须依附于某个Workspace，没有独立于Workspace存在的文件；每个Workspace自带专属文件系统挂载点，文件上传、读取、版本管理全部在该Workspace上下文中完成。
Workspace是文件的容器和权限边界
登录Agent Space后，你看到的任何文件列表、上传入口、PDF预览或代码仓库链接，背后都绑定着当前激活的Workspace ID。系统不会让你把一份合同PDF直接“上传到平台”，而是强制你先选中一个Workspace，再点击「Upload Files」——这一步不是流程设计冗余，而是安全机制：不同Workspace的文件目录完全隔离，【跨Workspace无法通过路径拼接或API绕过访问彼此文件】。
例如法务部用的“合同归档Workspace”和HR部用的“员工档案Workspace”，即使两个空间都存了名为《2026年劳动合同模板.docx》的文件，它们实际存储路径分别是：/workspace/WS-legal-7a2f/files/... 和 /workspace/WS-hr-9c4d/files/...，底层物理隔离。
文件如何进入Workspace
方法一：Web界面拖拽上传
进入目标Workspace → 点击左侧菜单「Files」→ 页面中央出现虚线框 → 直接将本地PDF、Excel、TXT等文件拖入即可。上传后文件自动存入该Workspace默认根目录，不支持自定义子路径（如需结构化管理，须后续用YAML配置文件树）。
方法二：通过Agent调用tool自动写入
在Agent配置中启用file-write工具，并在permissions字段声明可写目录：permissions: {write: ["/data/outputs/"]}
Agent运行时生成的分析报告、OCR识别结果会自动落盘到该Workspace指定路径下，【该路径对其他Workspace不可见，且不能写入上级目录如“/”或“/workspace”】。
方法三：API批量导入（仅限管理员）
调用POST /v1/workspaces/{ws_id}/files/import接口，携带ZIP包及映射规则JSON。注意：ZIP内不能含绝对路径（如/etc/passwd），否则整包拒绝入库。
文件生命周期由Workspace状态决定
第一步：确认Workspace处于Active状态
在Workspaces列表页查看目标空间右侧状态标签，灰色“Inactive”表示该Workspace已暂停，此时所有关联文件不可读、不可被Agent访问，但物理存储保留30天。
第二步：检查Workspace配额余量
点击Workspace详情页 → 查看「Storage Usage」栏，若显示“98% used”，则新上传文件会失败并返回HTTP 403错误，此时必须删除旧文件或升级套餐，【配额超限不会自动清理历史版本，也不会覆盖同名文件】。
第三步：触发文件版本快照（可选）
在Files页面勾选某PDF → 点击「Create Snapshot」→ 输入描述如“终版-法务审核后”。该快照将永久锁定当前内容哈希值，后续同名文件覆盖不影响快照内容，可用于审计回溯。
