Agent Card
A2A 协议中 Agent 的能力声明文档,托管在 `/.well-known/agent-card.json`。包含四个核心字段:name(我是谁)、url(在哪找我)、skills(能做什么)、authentication(怎么鉴权)。其他 Agent 读取 Agent Card 即可判断对方能否协助完成特定子任务。
定义
Agent Card 是 A2A(Agent-to-Agent)协议中 Agent 的能力声明文档——一个托管在 /.well-known/agent-card.json 的 JSON 文件,让其他 Agent 能够理解"这个 Agent 是谁、在哪里、能做什么、怎么鉴权"。
核心字段
| 字段 | 含义 | 示例 |
|---|---|---|
name | Agent 身份标识 | "code-reviewer" |
url | A2A 服务端点 | "https://agents.example.com/reviewer" |
skills | 能力列表(含 id、name、description、examples) | 代码审查、安全扫描 |
authentication | 鉴权方案 | OAuth2 / API Key / JWT |
完整规范还包括 capabilities(streaming、pushNotifications 等)、defaultInputModes、defaultOutputModes 等扩展字段。
与 ARD 的关系
- ARD 的 ai-catalog.json 告诉你"这个域名有哪些资源"(WHERE)
- Agent Card 告诉你"这个具体 Agent 能做什么"(WHAT)
ARD Catalog 中的条目指向 Agent Card,Agent Card 描述具体能力。两者配合完成从发现到理解的完整流程。
类比
Agent Card 之于 A2A,类似 OpenAPI 规范之于 REST API——都是机器可读的接口描述文档,让调用方无需查阅文档即可理解对方的能力和调用方式。