跳到主内容
快讯直播
AI智模界
AI 词典

Agent Card:智能体之间递的那张名片

一句话定义

Agent Card(智能体名片)是 A2A(Agent2Agent,智能体间协作协议)中的一份机器可读文档,通常写成 JSON,用来回答四个问题:你是谁、你会做什么、我到哪找你、我该怎么证明自己有资格调用你。

名片上都印了什么

一份典型的名片包含几块内容:

  • 身份区:名称、用途描述、提供方、版本。让人和程序都能一眼看出它是“财务报销助手”,而非“通用聊天机器人”。
  • 能力清单(skills):这是最关键的一块。每项能力都有自己的名字、说明、适用场景示例,以及输入输出是什么形态(纯文本、结构化数据、文件、音视频等)。
  • 端点(endpoint):一个 URL。对方拿着这个地址就能直接发起任务,不用再问“你们接口在哪”。
  • 交互方式:支持哪些传输方式和消息格式。
  • 认证要求:需要 API Key 还是 OAuth,用哪种安全方案。

打个比方

这就像你出差时递出去的名片,只不过收名片的是另一个软件。名片上得有公司名和职务(身份),有主营业务范围(能力清单),有地址和前台电话(端点),还有“来访请先预约登记”(认证要求)。更贴近的比喻是写字楼大堂的水牌:上面按楼层列着每家公司做什么、在几楼、电话多少。想找做商标注册的,扫一眼就能直接上楼,不必挨个敲门问。

为了让人不用问路就能找到,名片一般放在服务域名下一个约定俗成的固定路径里(.well-known 那一类约定)。具体路径与字段名以官方规范页面为准。也可以由目录服务把一堆名片汇总登记,供人检索。

和相邻概念的区别

概念主要回答的问题主要给谁看
Agent Card这个智能体是谁、会什么、在哪、怎么认证其他智能体、调度程序
OpenAPI 文档这个 HTTP 接口每个路径收什么、返回什么开发者、代码生成工具
官网介绍页 / README这个产品好不好、怎么上手人
AI 词典:系统提示词">系统提示词(system prompt)这个模型此刻该怎么表现模型自己

一句话分辨:OpenAPI 说的是“这个接口怎么调”,Agent Card 说的是“这个智能体是谁、值不值得把活交给它、交过去之后敲哪扇门”。前者是接口层,后者是能力与合作语义层。

对从业者的意义

第一,能力描述相当于你写给机器看的关键词。任务派发方很多时候就是靠读这段文字做路由决策的,写“我能处理文档”远不如写“把扫描版 PDF 转成结构化表格,支持中英文”,否则别人根本不知道你还有这个能力。第二,端点和认证写错,等于名片上印错电话号码:被发现得再顺利,最后一步连不上也白搭。第三,名片具有约定作用,写上去的能力要真能兑现;对方会严格照你的描述构造请求,名不副实就会直接失败。

对普通人的意义

你大概永远不会亲手打开它。但当你说“帮我把这份合同里的付款条款挑出来”时,你的助手会先去翻一圈名片,挑一个自称会干这事的,再按名片上的地址去敲门。名片写得含糊的智能体,哪怕本事不小,也可能一直没人找上门。

AI 生成本文由 AI 基于公开信息自动生成,仅供参考。