文档中心

ArkClaw 企业版

请输入

应用中心

A2A 智能体 JSON 文件示例

平台支持通过导入 JSON 文件的方式，将 A2A 智能体注册到应用中心。本文为您提供适配该注册场景的 A2A 智能体 JSON 代码示例。

代码示例

如下示例按 0.3.0 版本的 A2A 协议编写，不同版本协议需要配置的核心字段、必填项等可能不同，请以实际版本为准。了解更多

注意

A2A 智能体 JSON 代码示例中，需要重点关注以下两点：

认证信息apiKeyAuth：通常无需手动填写认证信息，实际调用时以页面中配置的认证方式为准。

服务地址url：应填写当前可公网访问的 Agent 服务地址。

{​
  "capabilities": {​
    "streaming": true​
  },​
  "defaultInputModes": [​
    "text"​
  ],​
  "defaultOutputModes": [​
    "text"​
  ],​
  "description": "sample_agent",​
  "name": "sample_agent",​
  "preferredTransport": "JSONRPC",​
  "protocolVersion": "0.3.0",​
  "security": [​
    {​
      "apiKeyAuth": [​
        "apikey_5jrmt****" //调用 Agent 实际使用的 API Key，优先使用页面中配置的认证方式，无需手动填写认证信息。如果页面没有选择，才会使用这里的配置。​
      ]​
    }​
  ],​
  "securitySchemes": {​
    "apiKeyAuth": {​
      "type": "apiKey",​
      "description": "ApiKey client credentials",​
      "in": "header",​
      "name": "Authorization"​
    }​
  },​
  "skills": [​
    {​
      "description": "Chat",​
      "id": "0",​
      "name": "chat",​
      "tags": [​
        "chat"​
      ]​
    }​
  ],​
  "url": "https://example.volceapi.com/a2a/jsonrpc",​
  "version": "1.0.0"​
}​

参数说明

本节仅说明 0.3.0 版本 AgentCard 核心参数，供您参考使用，完整字段的定义、取值范围及校验规则等规范要求，请参见 A2A 0.3.0 AgentCard 规范。

参数	说明	示例值
基础信息
name	必填，智能体名称。	sample_agent
description	必填，智能体的功能描述。	sample_agent
version	必填，智能体自身的版本号，建议采用语义化版本格式，例如 1.0.0。	1.0.0
url	必填，智能体的 A2A 服务入口地址，调用方通过该地址发送请求。请填写当前可公网访问的 Agent 服务地址。	https://example.volceapi.com/a2a/jsonrpc
协议与传输
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"]
安全与鉴权
security	可选，访问智能体时需要满足的安全要求列表。 apiKeyAuth：引用名为 apiKeyAuth 的鉴权方案。说明列表中的名称必须引用 securitySchemes 中已定义的鉴权方案。通常无需手动填写认证信息，实际调用时以页面中配置的认证方式为准；页面未配置时，才使用此处填写的认证信息。	[{"apiKeyAuth":["apikey_5jrmt****"]}]
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.08 10:57:43

这个页面对您有帮助吗？

有用

无用