Data model · A2A Protocol · Agent Card

Agent Card 结构

Agent Card 是 A2A Server 发布在 /.well-known/agent-card.json 的 JSON 清单，描述代理的身份、端点、能力与技能，供客户端发现与安全接入。

A2A Agent Card 结构 实体关系图展示 Agent Card 的身份与端点字段，以及它与技能、能力、接口、提供方和扩展等子对象的关系。 1 0..* 1 0..1 1 1..* 1 0..1 1 0..* skills[] capabilities supportedInterfaces[] provider extensions[] ROOT · MANIFEST Agent Card name string description string version string supportedInterfaces[] Interface capabilities Capabilities defaultInputModes[] string defaultOutputModes[] string skills[] Skill SKILL 技能 # id string name string description string tags[] string examples[] string inputModes[] string outputModes[] string CAPABILITIES 能力 streaming bool pushNotifications bool extendedAgentCard bool extensions[] Extension EXTENSION 扩展 uri string description string required bool params object INTERFACE 接口 url string protocolBinding string protocolVersion string tenant string? PROVIDER 提供方 organization string url string LEGEND 聚合根 · Agent Card 子对象 / 实体 # 主键 1 / N 基数

身份与可达性

name / description / version 标识身份；supportedInterfaces[] 声明服务端点与协议绑定（JSONRPC / gRPC / HTTP+JSON）。

技能决定能力

skills[] 列出 AgentSkill：id / name / description / tags / examples 帮助客户端匹配任务。

能力与安全可协商

capabilities 声明 streaming / pushNotifications 等可选特性；securitySchemes 与 securityRequirements 声明认证要求。