为接入任务准备文件
当前 Bridge 的 SendMessage 接收文本,不接受旧 Invoke 的 files 数组或 Base64 文件内容。文件应通过所选能力的文件管理流程准备,不要继续调用旧媒体上传示例。
选择文件准备路径
| 任务 | 文件放在哪里 |
|---|---|
| 根据制度、手册等资料回答问题 | 上传到知识库,由智能体检索 |
| 由你自己的应用读取、分析或生成文件 | 应用准备文件,并通过用户工具包返回处理结果 |
| 调用已经提供文件能力的远程服务 | 按 MCP 服务约定上传并使用文件 |
| 在平台沙箱中执行文件任务 | 按沙箱的配置和文件使用流程准备 |
在消息中引用已准备的内容
先确认目标工具或知识库能读取文件,再在消息中说明任务和已准备的文件标识。把 URL 写入文本不会自动授予访问权限,也不保证智能体具备下载和解析能力。应用侧工具应从已认证业务会话选择文件,不能直接信任模型给出的任意路径或 URL。
遵守所选能力的限制
文件类型、大小、存储时间和解析限制由实际使用的知识库、沙箱或外部服务决定。不要把旧 Invoke 上传接口的限制套用到其他能力;先用一份小型、非敏感文件验证读取和处理结果。
保护文件内容
仅授权完成任务所需的文件范围。限时 URL、文件标识和工具结果中都可能包含敏感信息;避免写入公开日志,按业务策略安排到期和清理。
处理文件读取失败
先检查文件是否存在、访问是否过期、目标能力是否有权限,再检查格式和处理错误。业务工具读取失败时返回 ERROR,不要编造文件内容,也不要把消息提交成功当成文件处理成功。