跳转到主要内容
Agent Server 的默认地址为 http://localhost:8124。业务资源使用版本化前缀 /v1;请求与响应为 JSON,错误为 application/problem+json,运行事件使用 SSE。

约定

  • 时间为带时区的 ISO 8601 UTC;
  • ID 为不透明字符串,不要解析其格式;
  • 未知请求字段被拒绝;
  • 创建 Assistant/Thread/Schedule 返回 201;创建/恢复 Run 返回 202
  • 资源删除成功返回 204
  • 运行的业务失败体现在 run.statusrun.error,不由 HTTP 状态替代;
  • 自动重试创建 run 时必须使用稳定的 Idempotency-Key

完整端点清单

Run 生命周期

稳定状态值为 pendingrunningpausedsucceededfailedcancellingcancelledtimed_outdead_letter

认证与 RBAC

Bearer token、开发 API key 与角色。

错误与 SSE

稳定错误码、续传与去重。