查询运行状态¶

接口用途¶

查询单次运行记录状态，例如 queued、running、succeeded、failed。

请求方式¶

GET

接口地址¶

https://moi.matrixorigin.cn/newmoi/workspaces/<workspace_id>/agent-automation-runs/<run_id>

身份认证¶

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

路径参数¶

名称	说明
`run_id`	运行记录标识。

查询参数¶

无。

请求体¶

无请求体。

请求示例¶

curl -X GET 'https://moi.matrixorigin.cn/newmoi/workspaces/<workspace_id>/agent-automation-runs/<run_id>' \
  -H 'X-API-Key: <WORKSPACE_API_KEY>' \
  -H 'Content-Type: application/json'

响应说明¶

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

可用于观察 queued、running、succeeded、failed 等状态：

字段	类型	说明
`id`	string	运行 ID
`workspace_id`	string	工作区 ID
`automation_task_id`	string	所属任务 ID
`automation_task_version`	integer	任务版本快照
`trigger_type`	string	`cron` / `api` / `manual`
`trigger_config_snapshot`	object	触发配置快照
`status`	string	`queued` / `running` / `input_required` / `pending_approval` / `succeeded` / `failed` / `canceled` / `expired`
`final_text`	string	最终文本结果
`structured_output`	object	结构化输出
`output_validation_status`	string	`passed` / `failed` / `skipped`
`error`	object	失败信息
`started_at`	string	开始时间
`completed_at`	string	完成时间
`created_at`	string	创建时间
`updated_at`	string	更新时间

使用限制¶

状态为成功后，再取回结果更稳妥。