返回首页

什么是 AI Agent Callback URL

Callback URL 让 AI Agent 能在长任务完成后被动收到结果，并继续执行。

最近更新: 2026-06-24

AI Agent 的 callback URL，本质上是为某个任务或会话生成的公网地址。外部系统在任务完成后把结果发回来，Agent 再基于这次回调继续后续流程，而不是一直轮询。

典型流程

  1. Agent 创建 callback URL。
  2. Agent 把这个地址交给第三方异步任务。
  3. 第三方稍后完成任务并回调结果。
  4. Agent 被唤醒，读取 payload，然后继续执行。

示例 payload

{
  "jobId": "vid_123",
  "status": "completed",
  "outputUrl": "https://cdn.example.com/output.mp4"
}

常见错误

  • 不相关任务复用同一个 callback URL
  • 明明支持 callback 却仍然持续轮询
  • 恢复 Agent 前不校验回调内容

FAQ

为什么不直接轮询？

轮询更吵、更慢，而且对长任务通常成本更高。

回调里至少应该有什么？

至少要有任务标识、最终状态，以及下一步处理所需的数据。

如果你需要 wait-and-resume 流程，可以直接用 WebhookPilot callback session。