必须先挂载文件到workspace数据源并为agent单独分配读写权限，否则agent无法解析或操作文件；上传pdf需含“合同”二字，读权限须在data sources中手动勾选，写权限可通过designer或yaml限定路径。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在Agent Space中为Agent配置文件读写权限，必须先将文件挂载进Workspace的数据源，再单独为每个Agent分配对应权限，否则Agent即使看到文件也无法解析内容或执行操作。

上传文件到Workspace数据源

进入目标Workspace首页 → 点击顶部导航栏「Data Sources」→「+ Add Source」→ 选择「File Storage」。

上传方式选「Upload Files」，一次最多传50个PDF，单个文件不能超过15MB。【文件名必须含中文“合同”二字，否则PDF解析器会跳过该文件】。

上传完成后，系统自动为该文件生成唯一标识符并建立索引，但此时所有Agent仍无访问权。

为指定Agent分配文件读取权限

在「Data Sources」页面右侧打开刚添加的文件条目 → 找到「Permissions」面板 → 展开「Assign to Agents」下拉菜单。

勾选目标Agent名称（如“合同查询员”）→ 在其右侧切换开关设为「Read」→ 点击「Save Permissions」。

这一步不可省略：不勾选就等于把钥匙给了Agent却锁死了门。未授权Agent调用pdf-search工具时会返回空结果，且日志中不报错，仅显示“no accessible documents found”。

Self-Improvement Agent

记录学习、错误和纠正，以实现持续改进。使用场景：（1）命令意外失败；（2）用户纠正（‘不，那不对…）

下载

限制Agent仅能写入指定子目录（高级控制）

方法一：通过Agent Designer界面配置

进入该Agent编辑页 → 切换到「Tools」标签页 → 找到file-write工具 → 点击右侧「Configure」→ 在「Allowed Write Paths」字段填入相对路径，例如：./outputs/contracts/。

方法二：通过YAML手动声明（更精确）

在Agent配置的YAML中加入以下字段：

tools:
  - name: file-write
   config:
    allowed_paths: ["./outputs/contracts/", "./logs/"]
    blocked_paths: ["/", "/etc/", "/root/"]

保存后，Agent调用write_file("./config.yaml", "...")会触发拒绝响应：“Path ./config.yaml is outside allowed write scope”。