提交可运行版本¶

接口用途¶

提交候选版本，生成可运行的 package version。这是创建可运行智能体的关键步骤。

请求方式¶

POST

接口地址¶

https://moi.matrixorigin.cn/newmoi/workspaces/<workspace_id>/agent-builder/candidates/<agent_id>/candidate-versions/<candidate_version>/commit

身份认证¶

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

路径参数¶

名称	说明
`agent_id`	智能体标识。
`candidate_version`	待提交的候选版本标识。

查询参数¶

无。

请求体¶

提交候选版本，生成可运行 package version。

字段	类型	必填	说明
`source_digest`	string	是	来自 candidate 响应的摘要
`metadata`	object	否	提交元数据
`binding`	object	否	可选绑定覆盖（skill/tool/kb ids 或 refs）

请求示例¶

curl -X POST 'https://moi.matrixorigin.cn/newmoi/workspaces/<workspace_id>/agent-builder/candidates/<agent_id>/candidate-versions/<candidate_version>/commit' \
  -H 'X-API-Key: <WORKSPACE_API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{"source_digest":"<source_digest>"}'

响应说明¶

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

提交结果：

字段	类型	说明
`workspace_id`	string	工作区 ID
`agent_id`	string	智能体 ID
`name`	string	名称
`load_version`	string	可运行版本
`source_digest`	string	源摘要
`package_digest`	string	包摘要

使用限制¶

提交后应再查询智能体详情确认 active/runnable，并用发送消息做调用验证。