Independent briefing
什么是能力名片(Agent Card)
在公开的 A2A 规范里,Agent Card(能力名片)是一份 JSON 自述文件,用来说明一个 Agent 是谁、能做什么、在哪里调用、需要怎样认证。它便于发现和对照,但本身不是能力或收益的保证。
说明:本页依据公开的 A2A 文档解释 Agent Card,不是某家平台的产品说明书。官方产品请到 uumit.com 核实。
关键信息
- 定义:Agent Card 是 A2A 服务器发布的 JSON 元数据,描述身份、技能、服务端点和认证要求。
- 用来做什么:让其他 Agent 或客户端判断它是否合适、如何发请求、如何安全连接。
- 不是什么:不是银行卡或会员卡,也不是「已上架就能赚钱」的凭证。
- 何时重要:当宣传里出现能力名片、技能清单或「可被发现的 Agent」时。
公开规范里它是什么
根据 A2A 关于 Agent Discovery 的公开说明,Agent Card 是一份 JSON 文档,相当于 A2A 服务器(远程 Agent)的「电子名片」,用于发现和交互。其中通常包括:身份(名称、描述、提供方)、服务端点、所支持的协议能力(例如流式传输或推送通知)、认证方式,以及用技能(skills)描述它能承担的任务。
一种常见的公开发现方式,是把这份文件放在规范化地址,例如 https://{域名}/.well-known/agent-card.json。此外也可以通过目录、注册表或私有配置来分发。具体字段、必填项和版本以 A2A 规范的当前文本为准,产品海报上的「能力名片」不能代替这份规范。
阅读一份名片时看哪几类信息
- 身份与版本:它自称是谁、由谁提供、当前是哪一版。名称好听,不等于提供方可核验。
- 技能描述:它声明擅长哪些任务,输入和输出大概是什么。描述应当具体到可检验,而不是只有「全能」或「全球能力」。
- 端点与协议:请求要发到哪里,使用何种调用方式。没有可访问的接口说明,名片就只是一份文案。
- 认证与权限:需要什么身份证明,哪些能力是公开的,哪些要额外授权。公开规范也提醒:含敏感信息的名片应当受到访问控制,而不应把密钥写死在名片里。
名片帮助你「看见对方怎么介绍自己」,但不能代替实际调用、日志和失败处理。评估时仍应回到 如何评估 AI Agent 能力 里的问题:边界、权限、可观察性、撤回和费用。
它保证不了什么
一份写得很完整的 Agent Card,只说明对方愿意以某种结构描述自己。它不证明技能在你的数据上稳定可用,不证明结算或收益,也不证明某个「能力市场」已经按开放协议运行。把名片、上架、邀请名额直接写成投资结果,是把发现机制误当成履约保证。相关话术对照见 如何识别「能力市场」话术。
Agent Card 属于 A2A 这一层,用来帮助 Agent 被发现;它不负责把模型连接到本地文件或数据库,那是 MCP 更常覆盖的问题。三者怎样并列,见 对照页。
主要公开来源:A2A Agent Discovery 与 A2A 规范。
常见问题
没有 Agent Card,就说明它不是 Agent 吗?
不是。许多 Agent 只在内部系统里运行,不必发布公开名片。反过来,有一张宣传式「能力卡」,也不等于它实现了 A2A,或已经接受过独立验证。
能力名片和「能力市场里的商品页」是一回事吗?
不一定。公开规范里的 Agent Card 是一份结构化自述,用来发现和连接。市场上的商品介绍还可以包含定价、名额和推广文案,那些内容需要单独核对,不能自动等同于规范中的名片。