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 是谁、在哪里、能做什么、怎么鉴权"。

核心字段

字段含义示例
nameAgent 身份标识"code-reviewer"
urlA2A 服务端点"https://agents.example.com/reviewer"
skills能力列表(含 id、name、description、examples)代码审查、安全扫描
authentication鉴权方案OAuth2 / API Key / JWT

完整规范还包括 capabilities(streaming、pushNotifications 等)、defaultInputModesdefaultOutputModes 等扩展字段。

与 ARD 的关系

  • ARD 的 ai-catalog.json 告诉你"这个域名有哪些资源"(WHERE)
  • Agent Card 告诉你"这个具体 Agent 能做什么"(WHAT)

ARD Catalog 中的条目指向 Agent Card,Agent Card 描述具体能力。两者配合完成从发现到理解的完整流程。

类比

Agent Card 之于 A2A,类似 OpenAPI 规范之于 REST API——都是机器可读的接口描述文档,让调用方无需查阅文档即可理解对方的能力和调用方式。