核心对象
描述智能体、交换消息、跟踪任务和返回结果时,可以在这里查询对应对象的字段与协议规则,并参考官方文档中的示例。对象之间的关系,见A2A 核心概念与组件 。
| 对象 | 是什么 | 适合在这些时候阅读 |
|---|---|---|
| Agent Card | 智能体发布的、用来描述自身的 JSON 文档 | 您要发布智能体,或需要发现并选择智能体 |
| Task | 带生命周期的有状态工作单元 | 您要处理长时间运行的工作、多轮输入或取消 |
| Message | 客户端与智能体之间的一轮通信 | 您要发送请求,或返回澄清与状态消息 |
| Part | 内容容器:文本、文件或结构化数据 | 您要交换文件或 JSON,而不只是文本 |
| Artifact | 任务产生的具体产出物 | 您要返回结果,或分块流式返回结果 |
声明智能体能力与认证方式时,可查询 Agent Card 中的这两个对象:
| 对象 | 是什么 | 适合在这些时候阅读 |
|---|---|---|
| AgentSkill | 卡片 skills 列表中的一项 | 您要描述自己的智能体能做什么,或阅读其他智能体的卡片 |
| SecurityScheme | 卡片如何声明认证方式,从 API Key 到 OAuth 2.0 | 您要保护智能体端点,或需要了解如何向某个端点认证 |
对象之间如何配合
客户端先读取 Agent Card,了解如何访问智能体、它能做什么。然后发送一条 Message,内容由一个或多个 Part 组成。智能体用一条直接的 Message 或一个 Task 来响应。Task 会经历一系列状态,它产生的结果是 Artifact,同样由 Part 构成。