当您使用 Services API 向 Agent Registry 显式注册代理或 Model Context Protocol (MCP) 服务器时，必须提供描述其功能的配置文件。
Agent Registry 会先根据外部开源规范验证您上传的文件，然后再对其编制索引，以发现智能体 A2A 技能和 工具。
本文档提供了代理卡片和 MCP 工具规范的预期 JSON 结构的示例和链接。
代理卡片架构
注册符合 A2A 标准的代理时，您的 agent-card.json 载荷必须
遵循官方
Agent2Agent (A2A) 规范。
规范文件的文件大小上限为 10 KB。
skills 数组字段支持关键字搜索索引。
Agent Registry 支持 0.3 和 1.0 版本的 A2A
代理卡片。
1.0 版架构（推荐）
对于 1.0 版本的 A2A 代理卡片，载荷必须遵循官方 A2A
v1.0 规范。在此规范中，您可以在 supportedInterfaces 数组中声明传输端点。
{
"name": "string",
"description": "string",
"version": "string",
"supportedInterfaces": [
{
"url": "string",
"protocolBinding": "string",
"protocolVersion": "string",
"tenant": "string"
}
],
"capabilities": {
"streaming": false,
"pushNotifications": false,
"extendedAgentCard": false
},
"defaultInputModes": [
"text/plain"
],
"defaultOutputModes": [
"text/plain"
],
"skills": [
{
"id": "string",
"name": "string",
"description": "string",
"tags": [
"string"
],
"examples": [
"string"
]
}
]
}
字段定义（1.0 版）
name：代理的直观易懂的名称。description：代理用途的概要总结。version：代理的版本，例如1.0.0。supportedInterfaces：支持的传输和网址组合的数组。 每个接口都包含以下内容：url：此接口的端点网址。protocolBinding：此网址支持的协议绑定，例如HTTP+JSON、JSONRPC或GRPC。protocolVersion：此接口公开的 A2A protocol 版本，例如1.0.0。tenant：可选。代理所有者的标识符。
capabilities：可选。指定支持的运营功能，例如：extensions：可选。协议扩展程序的数组。streaming：可选。一个布尔值，指示代理是否支持流式响应。pushNotifications：可选。一个布尔值，指示是否支持任务更新的推送通知。extendedAgentCard：可选。一个布尔值，指示代理在经过身份验证后是否提供扩展的代理卡片。
defaultInputModes：可选。一个数组，其中包含接受作为输入的 MIME 类型。defaultOutputModes：可选。一个数组，其中包含作为输出生成的 MIME 类型。skills：代理拥有的功能数组：id：技能的唯一程序化标识符。name：技能的直观易懂的名称。description：技能功能的详细说明。tags：用于对技能进行分类的关键字字符串数组。examples：示例提示或场景的数组。
0.3 版架构
对于 0.3 版本的 A2A 代理卡片，载荷必须遵循
v0.3.0 规范。在此规范中，主要推理网址和协议版本声明为顶级字段。
{
"name": "string",
"description": "string",
"version": "string",
"protocolVersion": "string",
"url": "string",
"skills": [
{
"id": "string",
"name": "string",
"description": "string",
"tags": [
"string"
],
"examples": [
"string"
]
}
],
"capabilities": {
"streaming": false,
"pushNotifications": false,
"stateTransitionHistory": false
},
"defaultInputModes": [
"text/plain"
],
"defaultOutputModes": [
"text/plain"
]
}
字段定义（0.3 版）
name：代理的直观易懂的名称。description：代理用途的概要总结。version：代理的版本，例如1.0.2。protocolVersion：代理实现的 A2A protocol 的版本。由于 1.0 版已弃用此顶级字段，因此此 架构的值必须为0.3或任何0.3补丁版本，例如0.3.1。url：代理的端点网址。capabilities：可选。一个对象，用于指定代理支持的运营功能，例如streaming、pushNotifications或stateTransitionHistory。defaultInputModes：可选。一个字符串数组，用于定义代理接受作为输入的默认 MIME 类型，例如["text/plain"]。defaultOutputModes：可选。一个字符串数组，用于定义默认 MIME 类型，代理作为输出生成，例如["text/plain"]。skills：代理拥有的描述性 A2A 技能数组：id：A2A 技能的唯一程序化标识符。name：A2A 技能的直观易懂的名称。description：A2A 技能功能的详细说明。tags：用于对 A2A 技能进行分类的关键字字符串数组。examples：此 A2A 技能处理的示例提示或场景的数组。
MCP 工具架构
注册 MCP 服务器时，您的 toolspec.json 载荷必须包含符合
MCP Tool 对象架构的工具列表
。
预期载荷是具有单个 tools 字段的 JSON 对象，与标准 MCP 工具或列表请求
返回的
载荷完全相同。
此规范文件的文件大小上限为 10 KB。
{
"tools": [
{
"name": "string",
"description": "string",
"inputSchema": {
"type": "object",
"properties": {}
},
"annotations": {
"title": "string",
"readOnlyHint": false,
"destructiveHint": true,
"idempotentHint": false,
"openWorldHint": true
}
}
]
}
字段定义
tools：服务器提供的工具数组：name：工具的程序化标识符。description：工具用途的直观易懂的说明。inputSchema：一个 JSON 架构对象，用于定义工具的预期参数。annotations：行为提示，用于指导编排器代理如何与工具交互：title：工具的直观易懂的标题。readOnlyHint：如果为true，则工具仅检索数据，而不修改其环境。默认值为false。destructiveHint：如果为true，则工具执行可能会导致永久更改的操作。默认值为true。idempotentHint：如果为true，则重复调用该工具不会产生其他影响。默认值为false。openWorldHint：如果为true，则工具与外部系统交互。默认值为true。