查询自动化任务运行结果¶

读取一条自动化任务运行记录的结果投影。

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

调用前准备¶

准备运行记录 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/result" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID"

成功响应¶

成功时返回 200。当运行尚未结束时，应以 status 判断是否继续查询。

{
  "code": 0,
  "data": {
    "run_id": "run_01",
    "automation_task_id": "task_01",
    "status": "succeeded",
    "final_text": "今日输入内容共 12 条，要点如下……",
    "structured_output": {},
    "output_validation_status": "passed",
    "artifact_refs": [],
    "completed_at": "2026-08-18T04:05:00Z"
  }
}

响应字段如下。

字段	类型	说明
`code`	integer	成功时为 `0`。
`data.run_id`	string	运行和自动化任务标识。
`data.automation_task_id`	string	运行和自动化任务标识。
`data.status`	string	当前或最终运行状态。
`data.result_url`	string	可用时返回的结果地址。
`data.final_text`	string	已产生的最终文本、结构化输出和产物引用。
`data.structured_output`	object	已产生的最终文本、结构化输出和产物引用。
`data.artifact_refs`	array	已产生的最终文本、结构化输出和产物引用。
`data.output_validation_status`	string	输出校验状态和校验错误；未发生校验时不返回。
`data.output_validation_error`	string	输出校验状态和校验错误；未发生校验时不返回。
`data.error`	object	运行失败详情；运行失败时可返回。
`data.completed_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 日