手动运行定时任务¶

接口用途¶

手动执行定时任务（Cron）类型的自动化任务。

请求方式¶

POST

接口地址¶

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

身份认证¶

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

路径参数¶

名称	说明
`task_id`	自动化任务标识。

查询参数¶

无。

请求体¶

手动执行 Cron 类型任务。不适合 API 类型任务。

字段	类型	必填	说明
`payload`	object	否	本次运行输入
`trigger_context`	object	否	触发上下文

请求示例¶

curl -X POST 'https://moi.matrixorigin.cn/newmoi/workspaces/<workspace_id>/agent-automation-tasks/<task_id>/runs' \
  -H 'X-API-Key: <WORKSPACE_API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{"payload":{}}'

响应说明¶

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

返回新建的 run：

字段	类型	说明
`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	更新时间

使用限制¶

不适合 API 类型任务；API 任务使用 /dynamic-services/invoke。