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

AgentKit

请输入
  • 文档首页
    • AgentKitAgentKit开发者指南API 参考A2ASearchAgentCards - 通过语义检索查询智能体
复制全文
下载 pdf
我的收藏
A2A
SearchAgentCards - 通过语义检索查询智能体
复制全文
下载 pdf
我的收藏
SearchAgentCards - 通过语义检索查询智能体
通过语义检索查询在A2A智能体空间中的A2A智能体。​
请求参数​
下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。​
Action string 必选 示例值：SearchAgentCards​
要执行的操作，取值：SearchAgentCards。​
​
Version string 必选 示例值：2025-10-30​
API的版本，取值：2025-10-30。​
​
SpaceId string 必选 示例值：as-yeglyhjytc3srhse****​
A2A智能体的空间。​
​
Prompt string 必选 示例值：write a book​
在A2A智能体空间中的搜索目标A2A智能体的提示词。​
​
TopK integer 必选 示例值：10​
限制返回的智能体数量，仅返回匹配度最高的前TopK个结果。​
​
​
​
返回参数​
下方仅列出本接口特有的返回参数。更多信息请参见返回结构。​
TotalCount integer 示例值：6​
返回A2A智能体的总数。​
​
AgentCards string 示例值：--​
A2A智能体的JSON文本。​
​
​
​
请求示例​
​
POST /?Action=SearchAgentCards&Version=2025-10-30 HTTP/1.1​
Host: agentkit.cn-beijing.volcengineapi.com​
Content-Type: application/json; charset=UTF-8​
X-Date: 20260309T124821Z​
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​
​
{​
"SpaceId": "as-yeglyhjytc3srhse****",​
"Prompt": "write a book",​
"TopK": 10​
}​
​
返回示例​
​
{​
"ResponseMetadata": {​
"RequestId": "20260309204825168158121125B****",​
"Action": "SearchAgentCards",​
"Version": "2025-10-30",​
"Service": "agentkit",​
"Region": "cn-beijing"​
},​
"Result": {​
"TotalCount": 6,​
"AgentCards": "--"​
}​
}​
​
错误码​
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。​
​
状态码​
错误码​
错误信息​
说明​
500​
InternalError​
The request has failed due to an unknown error.​
内部错误。​
​
​
最近更新时间：2026.03.12 11:19:34
这个页面对您有帮助吗？
有用
有用
无用
无用