设为默认版本¶

将可运行版本设为智能体谱系的默认版本。

POST https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/agents/{agent_id}/versions/{version}/default

调用前准备¶

先查询智能体版本，确认要设为默认的版本号。准备有目标工作区访问权限的个人访问令牌、目标工作区 ID、智能体 ID 和版本号。

请求参数¶

请求示例

curl -X POST "https://api.moi.matrixorigin.cn/v5/workspaces/$WORKSPACE_ID/agents/$AGENT_ID/versions/$VERSION/default" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID"

参数说明

路径参数

字段	类型	必填	说明
`workspace_id`	string	是	当前工作区 ID。
`agent_id`	string	是	智能体 ID。
`version`	string	是	要设为默认版本的版本号。

成功响应¶

响应示例

{
  "code": 0,
  "data": {
    "workspace_id": "ws_01",
    "agent_id": "agent_01",
    "default_version": "v3",
    "created_at": "2026-01-15T10:00:00Z",
    "updated_at": "2026-01-15T10:00:00Z"
  }
}

字段说明

成功时返回 200。data 为更新后的版本谱系。

通用字段

字段	类型	说明
`code`	integer	成功时为 0。

响应数据

字段	类型	说明
`data.workspace_id`	string	智能体所属工作区和智能体 ID。
`data.agent_id`	string	智能体所属工作区和智能体 ID。
`data.default_version`	string	当前智能体谱系默认使用的版本。
`data.created_at`	string	版本谱系创建时间，使用 RFC 3339 格式。
`data.updated_at`	string	默认版本最后修改时间，使用 RFC 3339 格式。

错误响应¶

响应示例

{
  "code": 1500,
  "message": "<错误信息>"
}

字段说明

常见 HTTP 错误

字段	类型	说明
`400`	`2`（`INVALID_ARGUMENT`）	路径参数为空或格式无效，或目标版本不可作为默认版本。建议：检查工作区、智能体和版本标识；选择可运行版本。
`401`	`6`（`UNAUTHENTICATED`）	缺少有效身份凭据。建议：检查 API Key。
`403`	`5`（`PERMISSION_DENIED`）	当前调用者没有更新智能体权限。建议：检查工作区中的智能体授权。
`404`	`3`（`NOT_FOUND`）	智能体或版本不存在。建议：先查询智能体版本。
`503`	`15`（`UNAVAILABLE`）	智能体资源服务或其授权依赖暂不可用。建议：稍后重试。

后续操作¶

用同一智能体标识查询智能体版本确认默认版本，或查询智能体详情核对当前生效配置。

最后更新于 2026 年 9 月 6 日