AgentCard定义规范

name

string

是

64

Agent的可读名称

A2A标准字段

"出行助手智能体"

description

string

是

512

Agent的可读描述，帮助用户和其他Agent理解其用途

A2A标准字段，一句话描述

"出行助手智能体，提供路线规划、语音出行、服务伴随等服务"

agentId

string

是

64

内部Agent ID，非全局唯一，在同包名下唯一

不支持导入导出（内部存储时，采用平台的agentId）

"XXPHONE_TRAFFIC_AGENT"

version

string

是

32

AgentCard定义的版本号

A2A标准字段，建议遵循语义化版本

"1.0.0"

iconUrl

string

是

512

Agent图标的URL

A2A标准字段，建议使用 HTTPS

"智能体的icon地址"

capabilities

AgentCapabilities

否

-

Agent支持的A2A能力集合

包括streaming、pushNotifications、extensions 等，不约束扩展

{"streaming": true, "pushNotifications": false, "stateTransitionHistory": false}

defaultInputModes

string[]

是

-

Agent在所有技能中支持的默认输入交互模式（媒体类型）

可在单个技能中覆盖，数组元素为MIME类型

["text/plain"]

defaultOutputModes

string[]

是

-

Agent支持的默认输出媒体类型

数组元素为MIME类型

["text/plain"]

skills

AgentSkill[]

是

-

Agent的技能列表。

需要拓宽字段定义

[{"id": "travel_scene_recommend", "name": "景点推荐", ...}]

provider

AgentProvider

否

-

Agent的服务提供商信息

包含organization和url

{"organization": "XXPAY", "url": "https://www.XXpay.com/"}

documentationUrl

string

否

512

提供有关Agent额外文档的URL

不涉及

"" (空字符串)

extension

string

否

51200

扩展信息，按JSON存储，详情见ExtInfo

扩展字段，例如隐私等。IDE可考虑支持string或结构化配置

-

appInfo

AppInfo

是

-

应用相关信息

在此承载应用相关信息。不支持导入导出。

-

url

string

是

512

接口的URL，生产环境必须是有效的HTTPS URL

protocolBinding

string

是

32

支持的协议绑定类型，核心支持: JSONRPC

protocolVersion

string

是

16

A2A协议版本，例如: "0.3"、"1.0"

streaming

boolean

可选

是否支持流式响应

pushNotifications

boolean

可选

是否支持异步任务更新的推送通知

extension

string

否

Agent支持的协议扩展列表，JSON String

extendedAgentCard

boolean

可选

是否支持身份验证后提供扩展的AgentCard

id

string

是

64

技能的唯一标识符

name

string

是

128

技能的可读名称

description

string

是

512

技能的详细描述

tags

string[]

是

32

描述技能能力的关键词集合

examples

string[]

否

256

此技能可以处理的示例提示或场景

inputModes

string[]

否

-

此技能支持的输入媒体类型（覆盖Agent默认值）

outputModes

string[]

否

-

此技能支持的输出媒体类型（覆盖Agent默认值）

extension

string

否

-

扩展信息

organization

string

是

128

提供商的组织名称

url

string

是

512

提供商网站或相关文档的URL

introduction

string

是

256

Agent开场白，用于用户初次交互

reqMetaRequired

string[]

否

-

Request中meta必须携带的字段列表

securityInfo

Object

否

-

认证信息

protocolVersion

string

是

-

协议版本，初始默认 1.0

supportedInterfaces

AgentInterface[]

否

-

支持的接口列表（有序），第一个是首选接口

developmentType

string

否

64

开发类型：NATIVE（缺省）、PROCODE、LOWCODE

deviceTypes

string

否

128

设备类型，逗号分隔。没配置则同APP类型。

bundleName

string

否

255

应用包名

moduleName

string

条件

255

模块名称

abilityName

string

条件

255

Ability名称

minAppVersion

string

否

32

最小APP版本要求