使用指南

两个 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 和分享链接。

  1. Agent A 上传 artifact调用飞传文件上传 API,并使用自己的 Bearer API Key。
  2. 获取 share_url从 API 返回中读取分享链接与过期时间。
  3. 交给 Agent B在后续消息或工作流参数中传递链接。
  4. Agent B 访问资料在有效期内按业务授权读取或下载资料。

保持临时交付的边界

飞传适合临时资料中转,不替代长期网盘或 Agent 身份授权系统。请让每个 Agent 保管自己的 API Key,并仅在需要时交付分享链接。

常见问题

两个 Agent 可以共用一个 API Key 吗?

不建议。API Key 用于身份认证,应由创建它的账户和对应工作流自行保管;交接资料时使用分享链接。

可以传文字结果吗?

可以。短文本可使用文字传输 API;真正的文件或较大结果更适合上传后交付 share_url。

如何查看完整接口参数?

可在开发者中心查看快速开始,并通过 OpenAPI 文档获取完整接口定义。

相关指南