查询自动化任务运行详情¶

读取一条自动化任务运行记录的当前状态和已产生的输出。

GET https://moi.matrixorigin.cn/newmoi/workspaces/{workspace_id}/agent-automation-runs/{run_id}

调用前准备¶

准备运行记录 ID、有目标工作区访问权限的个人访问令牌和目标工作区 ID。

下方示例使用：

$AI_STUDIO_API_KEY：实际个人访问令牌，通过 X-API-Key Header 传递。
$WORKSPACE_ID：目标工作区 ID，通过 X-Workspace-ID Header 传递，同时作为路径中的 workspace_id。
$RUN_ID：要查询的运行记录 ID，作为路径中的 run_id。

路径参数¶

参数	类型	是否必填	说明
`workspace_id`	string	是	工作区 ID。
`run_id`	string	是	运行记录 ID。

请求示例¶

curl "https://moi.matrixorigin.cn/newmoi/workspaces/$WORKSPACE_ID/agent-automation-runs/$RUN_ID" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID"

成功响应¶

成功时返回 200。运行已产生输出时，可包含 final_text、structured_output、artifact_refs 或 error。

{
  "code": 0,
  "data": {
    "id": "run_01",
    "workspace_id": "ws_01",
    "automation_task_id": "task_01",
    "automation_task_version": 1,
    "trigger_type": "manual",
    "trigger_config_snapshot": {
      "mode": "cron"
    },
    "status": "running",
    "created_at": "2026-08-18T04:00:00Z",
    "updated_at": "2026-08-18T04:00:00Z"
  }
}

响应字段如下。

字段	类型	说明
`code`	integer	成功时为 `0`。
`data.id`	string	运行、工作区和自动化任务标识。
`data.workspace_id`	string	运行、工作区和自动化任务标识。
`data.automation_task_id`	string	运行、工作区和自动化任务标识。
`data.automation_task_version`	integer	创建该运行时使用的任务版本。
`data.trigger_type`	string	本次触发类型和触发配置快照。
`data.trigger_config_snapshot`	object	本次触发类型和触发配置快照。
`data.status`	string	运行状态。
`data.final_text`	string	已产生的最终文本、结构化输出和产物引用；未产生时不返回。
`data.structured_output`	object	已产生的最终文本、结构化输出和产物引用；未产生时不返回。
`data.artifact_refs`	array	已产生的最终文本、结构化输出和产物引用；未产生时不返回。
`data.error`	object	失败详情；运行失败时可返回。
`data.started_at`	string	运行时间点，使用 RFC 3339 格式；未到达对应阶段的字段不返回。
`data.completed_at`	string	运行时间点，使用 RFC 3339 格式；未到达对应阶段的字段不返回。
`data.created_at`	string	运行时间点，使用 RFC 3339 格式；未到达对应阶段的字段不返回。
`data.updated_at`	string	运行时间点，使用 RFC 3339 格式；未到达对应阶段的字段不返回。

错误响应¶

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

常见 HTTP 错误¶

HTTP 状态码	错误代码	常见原因	建议操作
`400`	`2`（`INVALID_ARGUMENT`）	路径参数无效。	检查工作区和运行 ID。
`401`	`6`（`UNAUTHENTICATED`）	缺少有效身份凭据。	检查 API Key。
`404`	`3`（`NOT_FOUND`）	运行记录不存在。	先查询运行列表。
`503`	`15`（`UNAVAILABLE`）	自动化任务服务不可用。	稍后重试。

后续操作¶

运行进入终态后，查询自动化任务运行结果；需要过程信息时查询自动化任务运行事件。

最后更新于 2026 年 8 月 22 日