查询智能体绑定资源¶

接口用途¶

查看智能体绑定的工具、消息渠道与知识库。

请求方式¶

GET

接口地址¶

https://moi.matrixorigin.cn/newmoi/workspaces/<workspace_id>/agents/<agent_id>/bindings

身份认证¶

使用工作区 API Key，在请求头中携带 X-API-Key: <WORKSPACE_API_KEY>，并设置 Content-Type: application/json。

路径参数¶

名称	说明
`agent_id`	目标智能体标识。

查询参数¶

无。

请求体¶

无请求体。

请求示例¶

curl -X GET 'https://moi.matrixorigin.cn/newmoi/workspaces/<workspace_id>/agents/<agent_id>/bindings' \
  -H 'X-API-Key: <WORKSPACE_API_KEY>' \
  -H 'Content-Type: application/json'

响应说明¶

除 A2A JSON-RPC 外，多数工作区接口成功响应形如 {"code":0,"data":...}；下列字段描述 data（或 HTTP 202 时的 data）。

绑定详情主要字段：

字段	类型	说明
`agent_id`	string	智能体 ID
`agent_version`	integer	版本
`runtime`	object	运行时目标
`skills`	array	技能绑定（含 id/name/status 等）
`tools`	array	工具绑定；页面工具数不等于运行时一定可用
`knowledge_bases`	array	知识库绑定
`warnings`	array	警告

使用限制¶

绑定信息只反映配置侧关联，不能替代运行时验证。