查询运行时清单

查询指定运行时清单。

GET https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/agent-runtime-manifests/{manifest_id}

调用前准备

准备可访问目标工作区的个人访问令牌和目标工作区 ID。

请求参数

将示例中的 $WORKSPACE_ID、$MANIFEST_ID、$AI_STUDIO_API_KEY 替换为实际值。

输入示例

curl "https://api.moi.matrixorigin.cn/v5/workspaces/$WORKSPACE_ID/agent-runtime-manifests/$MANIFEST_ID" -H "X-API-Key: $AI_STUDIO_API_KEY" -H "X-Workspace-ID: $WORKSPACE_ID"

参数说明

参数	类型	是否必填	说明
workspace_id	string	是	读取清单的工作区 ID。
manifest_id	string	是	运行时清单 ID。

查询参数

参数	类型	是否必填	说明
agent_id	string	否	智能体 ID。
agent_workspace_id	string	否	当前工作区或 system。省略时不限定智能体来源。

省略 agent_id 或 agent_workspace_id 时，不按对应条件限定智能体来源。填写 agent_workspace_id 时，只接受当前工作区或 system，不能传空值。

此接口不接受重复的智能体来源参数。

成功响应

响应示例

{
  "code": 0,
  "data": {
    "id": "manifest_01",
    "workspace_id": "",
    "task_id": "",
    "agent_id": "",
    "agent_version": "",
    "runtime_provider": "",
    "runtime_profile": "",
    "created_at": "2026-08-21T07:00:00Z"
  }
}

字段说明

字段	类型	说明
data.id	string	清单 ID。
data.workspace_id	string	所属工作区 ID。
data.agent_workspace_id	string	智能体来源工作区。当前工作区或 system，筛选省略时不限定。
data.task_id	string	关联的运行时任务 ID。
data.agent_id	string	智能体 ID。
data.agent_version	string	智能体版本。
data.runtime_provider	string	本次运行选择的提供方。
data.runtime_profile	string	本次运行选择的 Profile。
data.instruction	object	任务指令。
data.model_config	object	模型配置。
data.skills	object（对象数组）	技能集合。
data.tools	object（对象数组）	工具集合。
data.tools[].id	string	标识。
data.tools[].name	string	名称。
data.tools[].kind	string	类别。
data.tools[].description	string	说明。
data.tools[].side_effect_class	string	副作用类别。取值：read、write、external_effect。
data.tools[].input_schema	object	输入字段结构。
data.tools[].output_schema	object	输出字段结构。
data.tools[].metadata	object	扩展元数据。
data.tools[].credential_ref	string	凭据引用。
data.knowledge_bases	object（对象数组）	知识库引用。
data.knowledge_bases[].id	string	标识。
data.knowledge_bases[].name	string	名称。
data.knowledge_bases[].description	string	说明。
data.knowledge_bases[].metadata	object	扩展元数据。
data.knowledge_bases[].catalog_asset_refs	object（对象数组）	Catalog 资产引用。
data.body	object	请求内容。
data.created_at	string	创建时间。RFC 3339 时间。

错误响应

目标不存在或与指定智能体来源不匹配时，返回 HTTP 404，错误代码为 3。权限拒绝返回 HTTP 403，错误代码为 5。身份认证层的错误包络与本接口的业务错误包络不同。

响应示例

{
  "code": 3,
  "message": "manifest not found"
}

字段说明

字段	类型	说明
code	integer	错误代码。
message	string	面向调用者的错误信息。

最后更新于 2026 年 10 月 19 日