文档中心

AgentKit

A2A

GetA2aAgent - 查询A2A智能体详情

查询A2A智能体详情。

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action string 必选示例值：GetA2aAgent

要执行的操作，取值：GetA2aAgent。

Version string 必选示例值：2025-10-30

API的版本，取值：2025-10-30。

Id string 可选示例值：a-yeh4hhuscg30lppp****

A2A智能体的ID。

Name string 可选示例值：agent

A2A智能体的名称。

SpaceId string 必选示例值：as-yegj2ehvk0y0puxl****

A2A智能体空间的ID。

RuntimeId string 可选示例值：r-yehe28rh8g9d1og9****

A2A智能体运行时的ID。

返回参数

下方仅列出本接口特有的返回参数。更多信息请参见返回结构。

Id string 示例值：a-yeh4hhuscg30lppp****

A2A智能体的ID。

Source string 示例值：Runtime

A2A智能体的注册来源。

Runtime：通过智能体运行时的地址，将智能体运行时中的A2A智能体注册至A2A智能体空间。

Standard：通过导入注册A2A智能体的JSON文件或者AgentCard地址，将A2A智能体注册至A2A智能体空间。

A2aSpaceId string 示例值：as-yeglyhjytc3srhse****

A2A智能体空间的ID。

AgentCard string 示例值：ei6****

AgentCard的ID。

RuntimeConfig object 示例值：-

智能体运行时的配置。

RuntimeId string 示例值：r-yeh6nlafwgo2eybt****

A2A智能体运行时的ID。

NetworkType string 示例值：private

选择智能体运行时后，自动匹配智能体运行时的服务地址，支持根据业务需求选择公网或私网地址。

private：如果只需要私有网络内部通信，选择私网地址即可，私网连通不收取费用。

public：如果需要从互联网访问云资源，必须使用公网地址。

ProjectName string 示例值：default

智能体运行时的项目名称。

Tags object 示例值：-

标签。

Key string 示例值：key1

标签的键。

Value string 示例值：value1

标签的值。

DefaultVersion string 示例值：1.0.0

A2A智能体默认版本的版本号。

Status string 示例值：running

A2A智能体的状态。

running：注册成功。

failed：注册失败。

StandardConfig object 示例值：-

外部导入配置。

ImportType string 示例值：json

Source选择Standard是支持。通过导入注册A2A智能体的JSON文件或者AgentCard地址，将A2A智能体注册至A2A智能体空间。

json：通过导入符合A2A协议规范的JSON文件，将A2A智能体注册至A2A智能体空间。请提前准备好满足A2A协议规则的JSON文件，JSON文件各字段的具体定义、取值范围及校验规则等规范要求，参见A2A协议官网文档；JSON文件示例参见A2A智能体JSON文件示例。

url：通过A2A智能体的AgentCard地址，将A2A智能体注册至A2A智能体空间。请提前获取A2A智能体的AgentCard地址。

AgentCardUrl string 示例值：http://api.example.com/a2a/v1

注册A2A智能体的AgentCard地址。ImportType为url时需要填写。

Name string 示例值：agent

A2A智能体的名称。

OriginalAgentCard string 示例值：1.0.0

原始AgentCard的版本。

Reason string 示例值：-

错误信息。

请求示例

POST /?Action=GetA2aAgent&Version=2025-10-30 HTTP/1.1​
Host: agentkit.cn-beijing.volcengineapi.com​
Content-Type: application/json; charset=UTF-8​
X-Date: 20260309T122933Z​
X-Content-Sha256: 287e874e******d653b44d21e​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20260309/cn-beijing/agentkit/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
{​
  "Id": "a-yeh4hhuscg30lppp****",​
  "Name": "agent",​
  "SpaceId": "as-yegj2ehvk0y0puxl****",​
  "RuntimeId": "r-yehe28rh8g9d1og9****"​
}​

返回示例

{​
  "ResponseMetadata": {​
    "RequestId": "202603092029411811701761568F****",​
    "Action": "GetA2aAgent",​
    "Version": "2025-10-30",​
    "Service": "agentkit",​
    "Region": "cn-beijing"​
  },​
  "Result": {​
    "Id": "a-yeh4hhuscg30lppp****",​
    "Source": "Runtime",​
    "A2aSpaceId": "as-yeglyhjytc3srhse****",​
    "AgentCard": "ei6****",​
    "RuntimeConfig": {​
      "RuntimeId": "r-yeh6nlafwgo2eybt****",​
      "NetworkType": "private"​
    },​
    "ProjectName": "default",​
    "Tags": {​
      "Key": "key1",​
      "Value": "value1"​
    },​
    "DefaultVersion": "1.0.0",​
    "Status": "running",​
    "StandardConfig": {​
      "ImportType": "json",​
      "AgentCardUrl": "http://api.example.com/a2a/v1"​
    },​
    "EnableProxy": true,​
    "Name": "agent",​
    "OriginalAgentCard": "1.0.0",​
      }​
    },​
    "Reason": "-"​
  }​
}​

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	InvalidParameter	The specified parameter %s is invalid.	请求参数值不合法。请检查参数值的正确性后重试。
403	AccessDenied	You are not authorized to perform this action.	没有执行操作的权限。
404	ResourceNotFound	The specified resource cannot be found.	找不到对应资源。
500	InternalError	The request has failed due to an unknown error.	内部错误。

最近更新时间：2026.03.12 11:19:34

这个页面对您有帮助吗？

有用

无用