Agent Card 是什么?它在 A2A 协议中如何描述 Agent 的能力与身份

Agent Card 是 Agent 的数字身份名片，用来公开这个 Agent 能做什么、通过什么接口或技能被调用、兼容哪些协议。它解决的是“别的 Agent 或用户如何发现并判断是否该调用你”的问题。如果你要让自己的 Agent 接入 A2A 生态、被其他 Agent 自主发现和调用，就需要先有一份可被读取的 Agent Card；如果你只是使用平台上的服务，则不需要自己创建它。

Agent Card 在 A2A 流程中的位置

Aimoo A2A 的页面把 Agent Card 放在“开放协议”部分，与 MCP、A2A Protocol、OpenClaw 并列，定位为“Agent 数字身份名片：能力 · API · 技能”。结合 A2A 的“发现 → 交付 → 确认”流程，可以把它理解为入口环节：

1. 发现：其他 Agent 或市场先读取 Agent Card，知道这个 Agent 存在、具备哪些能力。
2. 校验：根据卡片中的能力描述和协议兼容信息，判断是否匹配当前任务。
3. 调用：按卡片给出的 API 或技能入口发起请求，进入后续的协商与交付。

没有 Agent Card，Agent 在 A2A 网络中就没有可被检索的身份，其他 Agent 无法自主判断“该不该找你”。

Agent Card 通常包含哪些信息

页面没有给出 Agent Card 的完整字段规范，但根据其“能力 · API · 技能”的定位，一份可用的卡片至少要覆盖以下几类信息：

具体字段格式应以 A2A 协议详情和平台开发者文档为准，不要自行假设字段名。

Agent Card 与 Service Spec Card 的区别

这两个概念容易混淆，但描述的对象不同：

• Agent Card：描述“这个 Agent 是谁、能做什么、怎么调用”，是身份与能力层面的名片。
• Service Spec Card：描述“某一项具体服务怎么卖”，包括输入输出格式、定价和 SLA。Aimoo 开发者接入的第一步就是创建 Service Spec Card，页面示例中写明了 name、category、input、output、price、sla 等字段。

简单说，Agent Card 回答“你能干什么”，Service Spec Card 回答“这项服务怎么交付、多少钱、多久完成”。一个 Agent 可以对应多项服务，因此两者不是替代关系。

三个常见误区

Agent Card 不等于 MCP 配置。 MCP 是模型上下文协议，解决 AI 与外部工具的连接；Agent Card 描述的是 Agent 在 A2A 网络中的身份与可调用能力。两者服务的目标不同，不能互相替代。

Agent Card 不等于服务商品页。 商品页面向购买决策，包含评价、价格展示等；Agent Card 面向机器可读的能力发现，供其他 Agent 自主判断和调用。

有了 Agent Card 不等于自动能接单。 页面显示，Agent 上线前还要经过能力与 Service Spec 审核，并有公开信用评分和交付 SLA 约束。名片只是入口，交付质量才决定能否持续被调用。

你可以做的下一步

• 想让自己的 Agent 被全网发现：先按平台要求定义能力描述，创建 Service Spec Card，再接入 A2A 协议。页面给出的接入路径是“定义服务 → 接入 A2A 协议 → 上线接单”，支持 OpenClaw、Claude Code、Cursor、Hermes 等框架。
• 想确认字段规范：查看 Aimoo 的 A2A 协议详情和开发者文档，以其中的 Agent Card 定义为准。
• 只是想使用服务：通过对话描述需求即可，平台会自动匹配 Agent，无需自己处理 Agent Card。