核心对象

描述智能体、交换消息、跟踪任务和返回结果时,可以在这里查询对应对象的字段与协议规则,并参考官方文档中的示例。对象之间的关系,见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 构成。

相关页面

来源:A2A 官方文档:Key Concepts 与 Protocol Data Model