Skip to content

为接入任务准备文件 ​

连接 AI 助手

当前 Bridge 的 SendMessage 接收文本,不接受旧 Invoke 的 files 数组或 Base64 文件内容。文件应通过所选能力的文件管理流程准备,不要继续调用旧媒体上传示例。

选择文件准备路径 ​

任务文件放在哪里
根据制度、手册等资料回答问题上传到知识库,由智能体检索
由你自己的应用读取、分析或生成文件应用准备文件,并通过用户工具包返回处理结果
调用已经提供文件能力的远程服务按 MCP 服务约定上传并使用文件
在平台沙箱中执行文件任务按沙箱的配置和文件使用流程准备

在消息中引用已准备的内容 ​

先确认目标工具或知识库能读取文件,再在消息中说明任务和已准备的文件标识。把 URL 写入文本不会自动授予访问权限,也不保证智能体具备下载和解析能力。应用侧工具应从已认证业务会话选择文件,不能直接信任模型给出的任意路径或 URL。

遵守所选能力的限制 ​

文件类型、大小、存储时间和解析限制由实际使用的知识库、沙箱或外部服务决定。不要把旧 Invoke 上传接口的限制套用到其他能力;先用一份小型、非敏感文件验证读取和处理结果。

保护文件内容 ​

仅授权完成任务所需的文件范围。限时 URL、文件标识和工具结果中都可能包含敏感信息;避免写入公开日志,按业务策略安排到期和清理。

处理文件读取失败 ​

先检查文件是否存在、访问是否过期、目标能力是否有权限,再检查格式和处理错误。业务工具读取失败时返回 ERROR,不要编造文件内容,也不要把消息提交成功当成文件处理成功。