查询智能体详情¶

接口用途¶

读取智能体详情，确认创建后状态、版本以及是否处于 active。

请求方式¶

GET

接口地址¶

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

身份认证¶

使用工作区 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>' \
  -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
`name`	string		名称
`description`	string		描述
`status`	string		`active` / `archived` / `disabled` / `draft` 等
`instruction`	object		指令相关；核心配置变更应走 Agent Builder
`runtime`	object		`provider` / `profile` / `config`
`model`	object	string
`binding`	object		工具/技能/知识库绑定摘要
`labels`	object		标签
`metadata`	object		元数据
`version`	integer		版本
`created_at`	string		创建时间
`updated_at`	string		更新时间

提交候选版本后可用此接口确认 status 是否为可运行状态。

使用限制¶

该接口用于读取状态，不用于修改 prompt、工具或知识库等核心配置。