查询工具详情¶

接口用途¶

按工具 ID 查看工具详情；也可查询工作区工具的完整绑定信息。

请求方式¶

GET

接口地址¶

https://moi.matrixorigin.cn/newmoi/workspaces/<workspace_id>/tools/<tool_id>

身份认证¶

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

路径参数¶

名称	说明
`tool_id`	工具标识。

查询参数¶

名称	说明
`tool_workspace_id`	系统工具传 `system`；工作区工具可省略。

请求体¶

无请求体。

请求示例¶

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

查询工作区工具完整绑定信息时，也可使用：

curl -X GET 'https://moi.matrixorigin.cn/newmoi/workspaces/<workspace_id>/tools?catalog=workspace&view=full&query=<tool_name>' \
  -H 'X-API-Key: <WORKSPACE_API_KEY>' \
  -H 'Content-Type: application/json'

响应说明¶

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

工具详情：

字段	类型	说明
`id`	string	工具 ID
`workspace_id`	string	工作区 ID（系统工具可省略或为 system）
`name`	string	API 工具名
`description`	string	描述
`display_name`	string	显示名
`status`	string	状态，如 active / disabled / archived
`kind`	string	工具类型
`category`	string	分类
`tags`	array	标签
`source_ref`	object	`type` / `id` / `uri` / `version` / `config`
`input_schema`	object	输入 JSON Schema
`output_schema`	object	输出 JSON Schema
`side_effect_class`	string	副作用等级
`credential_ref`	string	凭据引用（勿展开明文）
`version`	integer	版本
`metadata`	object	扩展元数据
`created_at`	string	创建时间
`updated_at`	string	更新时间

智能体构建资源中常只有显示名，完整绑定信息以本接口或 catalog=workspace&view=full 为准。

使用限制¶

工作区与系统工具都按实际 tool id 查询。
不要把显示名误当成 tool id。