使用指南
两个 AI Agent 之间怎么交接文件?
Agent A 上传产物后取得 share_url,再将这个链接和必要说明交给 Agent B。
查看开发者 API用 URL 交接临时产物
报告、导出数据、压缩包和其他 artifact 往往不适合直接塞入 Agent 消息。飞传将文件保存在临时 Transfer 中,Agent 之间只传递 share_url。
API Key 仅用于调用飞传 API,不是交付凭证;实际交付给另一个 Agent 的应该是分享链接或取件码。
一个简单的 Agent 交接流程
Agent A 使用自己的 API Key 上传文件,飞传返回对应的 Transfer 和分享链接。
- Agent A 上传 artifact调用飞传文件上传 API,并使用自己的 Bearer API Key。
- 获取 share_url从 API 返回中读取分享链接与过期时间。
- 交给 Agent B在后续消息或工作流参数中传递链接。
- Agent B 访问资料在有效期内按业务授权读取或下载资料。
保持临时交付的边界
飞传适合临时资料中转,不替代长期网盘或 Agent 身份授权系统。请让每个 Agent 保管自己的 API Key,并仅在需要时交付分享链接。
常见问题
两个 Agent 可以共用一个 API Key 吗?
不建议。API Key 用于身份认证,应由创建它的账户和对应工作流自行保管;交接资料时使用分享链接。
可以传文字结果吗?
可以。短文本可使用文字传输 API;真正的文件或较大结果更适合上传后交付 share_url。
如何查看完整接口参数?
可在开发者中心查看快速开始,并通过 OpenAPI 文档获取完整接口定义。
