用途:创建符合 A2A(Agent-to-Agent)协议标准的 Agent Card,对外声明智能体身份、技能、认证要求与能力,供其他 A2A 兼容智能体发现和编排调用。适用于构建可被发现的智能体、暴露多智能体编排能力、将现有智能体迁移到 A2A 协议、在实现前定义公开契约,以及接入消费 Agent Card 的注册表或目录。
主要能力:定义身份块(name、description、url、provider、version);枚举技能,每项含 id、name、description、tags、examples、inputModes、outputModes;配置认证方案(none、oauth2、oidc、apiKey);声明能力标志(streaming、pushNotifications、stateTransitionHistory);设置 defaultInputModes 与 defaultOutputModes。
使用方式:先定义身份与描述,再枚举技能并给出输入输出 MIME 类型,然后按部署环境选择最小可行认证(本地开发用 none,内部服务用 apiKey,公网用 oauth2 或 oidc),声明实际支持的能力标志,最后校验并发布。发布时需将卡片托管在 https://<agent-url>/.well-known/agent.json,设置 Content-Type: application/json,跨域发现时启用 CORS,并注册到相关目录。可用 curl -s https://agent.example.com/.well-known/agent.json | python3 -m json.tool 测试发现。
限制与注意:不得夸大能力,未实现的功能标志应设为 false;技能边界需清晰不重叠;描述要具体;缺少 CORS 会导致浏览器客户端无法获取;省略默认模式会使客户端不知发送何种内容类型;技能或能力变更时需更新版本;未实现前不应发布。资料未提供具体收费、价格或平台信息。