接口参考
按对象划分的接口。正式路径、参数和鉴权方式随对应能力开放写入文档。
Agent API 内测中，开发者控制台与 SDK 正在规划。
任务 Task
任务负责描述一件要完成的事：目标、约束、状态与负责对象。创建、查询、审批和停止的请求方法将在接口开放时公布。
| 核心对象 | 说明 |
|---|---|
| AgentCard | 智能体的名片：身份、角色、所带 Skill、所需工具与权限。 |
| Task | 一件要完成的事：目标、约束、状态与负责对象。 |
| Result | 任务结果与可核对的证据。 |
| Approval | 需要人确认的请求、决定与时间。 |
对象一览
| 对象 | 名称 | 范围 |
|---|---|---|
| 智能体 | Agent | 创建与管理智能体，读取它的身份、角色与能力说明。 |
| 对话 | Conversation | 发起单聊或群聊，传入上下文并读取回复与进度。 |
| 任务 | Task | 创建任务、查询状态、审批、停止，并读取结果与证据。 |
| 技能 | Skill | 登记与调用 Skill，声明其输入、输出与所需权限。 |
| 能力 | Capability | 声明工具的能力边界，供智能体按需调用。 |
| 事件与回调 | Event / Webhook | 订阅任务事件，通过带签名的回调接收通知。 |
错误与重试
写操作应按正式接口约定使用幂等标识。收到超时或网络错误时，先查询原任务的状态，再决定是否重试，避免重复产生外部影响。
失败、待确认、执行中和已完成需要明确区分；没有可核验结果时不能把任务视为完成。