You need to enable JavaScript to run this app.
文档中心
AgentKit

AgentKit

复制全文
下载 pdf
附录
A2A 智能体 JSON 文件示例
复制全文
下载 pdf
A2A 智能体 JSON 文件示例
平台支持通过导入 JSON 文件的方式,将 A2A 智能体注册至智能体空间。本文为您提供适配该注册场景的 A2A 智能体 JSON 代码示例。​
代码示例​
如下示例按 0.3.0 版本的 A2A 协议编写,不同版本协议需要配置的核心字段、必填项等可能不同,请以实际版本为准。了解更多​
​
{​
"capabilities": {​
"streaming": true​
},​
"defaultInputModes": [​
"text"​
],​
"defaultOutputModes": [​
"text"​
],​
"description": "hello world agent that can roll a dice of 8 sides and check prime numbers.",​
"name": "hello_world_agent",​
"preferredTransport": "JSONRPC",​
"protocolVersion": "0.3.0",​
"provider": {​
"organization": "agentkit",​
"url": ""​
},​
"security": [​
{​
"apiKeyAuth": []​
}​
],​
"securitySchemes": {​
"apiKeyAuth": {​
"type": "apiKey",​
"description": "ApiKey client credentials",​
"in": "header",​
"name": "Authorization"​
}​
},​
"skills": [​
{​
"description": "Chat",​
"id": "0",​
"name": "chat",​
"tags": [​
"chat"​
]​
}​
],​
"url": "https://sd6k****.com",​
"version": "1.0.0"​
}​
​
参数说明​
本节仅说明 0.3.0 版本 AgentCard 核心参数,供您参考使用,完整字段的定义、取值范围及校验规则等规范要求,请参见 A2A 0.3.0 AgentCard 规范。​
​
参数​
说明​
示例值​
基础信息​
​
​
name​
必填,智能体名称。​
hello_world_agent​
description​
必填,智能体的功能描述。​
hello world agent that can roll a dice of 8 sides and check prime numbers.​
version​
必填,智能体自身的版本号,建议采用语义化版本格式,例如 1.0.0。​
1.0.0​
url​
必填,智能体的 A2A 服务入口地址,调用方通过该地址发送请求。​
https://sd6k****.com​
协议与传输​
​
​
preferredTransport​
必填,智能体首选的传输协议,常用取值包括 JSONRPC、GRPC 和 HTTP+JSON。​
说明​
协议必须与 url 对应服务实际支持的协议一致。​
JSONRPC​
protocolVersion​
必填,智能体遵循的 A2A 协议版本。​
0.3.0​
能力声明​
​
​
capabilities​
必填,智能体支持的 A2A 可选能力集合,未声明的能力视为不支持。​
  • streaming:是否支持流式响应。取值:​
  • true:支持。​
  • false:默认值,不支持。​
{"streaming":true}​
技能列表​
​
​
skills​
必填,智能体具备的技能列表,至少配置 1 个技能。​
  • id:技能的唯一标识,在当前智能体内不得重复。​
  • name:技能名称。​
  • tags:技能标签数组,用于能力检索和分类;至少包含 1 个标签。​
  • description:技能说明。​
[{"description":"Chat","id":"0","name":"chat","tags":["chat"]}]​
输入输出模式​
​
​
defaultInputModes​
必填,智能体默认支持的输入媒体类型列表,例如 text。​
["text"]​
defaultOutputModes​
必填,智能体默认支持的输出媒体类型列表,例如 text。​
["text"]​
服务提供方​
​
​
provider​
可选,智能体服务提供方信息。​
  • organization:提供智能体服务的组织名称。​
  • url:服务提供方网页地址。​
{"organization":"agentkit","url":""}​
安全与鉴权​
​
​
security​
可选,访问智能体时需要满足的安全要求列表。​
  • apiKeyAuth:引用名为 apiKeyAuth 的鉴权方案。​
说明​
列表中的名称必须引用 securitySchemes 中已定义的鉴权方案。​
[{"apiKeyAuth":[]}]​
securitySchemes​
可选,智能体支持的鉴权方案定义集合。​
  • apiKeyAuth:鉴权方案名称,可自定义。​
  • name:承载 API Key 的请求头名称。​
  • in:API Key 在请求中的传递位置。支持 header、query 或 cookie。​
  • type:鉴权方案类型。​
  • description:鉴权方案说明。​
{"apiKeyAuth":{"type":"apiKey","description":"ApiKey client credentials","in":"header","name":"Authorization"}}​
​
​
最近更新时间:2026.09.02 14:56:00
这个页面对您有帮助吗?
有用
有用
无用
无用