UUMit 独立资讯官方站点 ↗

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 是一份结构化自述,用来发现和连接。市场上的商品介绍还可以包含定价、名额和推广文案,那些内容需要单独核对,不能自动等同于规范中的名片。

接下来读

站点名称 UUMit 用于本资讯站标识。本站是独立资讯站点,与官方产品没有从属或代理关系。官方平台请访问 uumit.com。