创建自动化任务

接口用途

创建自动化任务。

请求方式

POST

接口地址

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

身份认证

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

路径参数

无。

查询参数

无。

请求体

创建自动化任务。Cron 创建时不要照旧示例携带 auth_policy。

字段	类型	必填	说明
name	string	是	任务名称
agent_id	string	是	绑定智能体
instruction_text	string	是	指令文本
trigger	object	是	必含 mode：api 或 cron
trigger.mode	string	是	api 或 cron
trigger.cron_expression	string	条件	Cron 表达式（mode=cron）
trigger.service_name	string	否	服务名（可由服务端生成）
trigger.input_schema	object	否	API 输入 schema
trigger.config	object	否	触发附加配置
agent_workspace_id	string	否	默认当前工作区
description	string	否	描述
auth_policy	object	否	API 鉴权策略；Cron 勿照旧示例携带
output_contract	object	否	输出约定
status	string	否	初始状态
labels	object	否	标签
id	string	否	可选指定 ID

请求示例

curl -X POST 'https://moi.matrixorigin.cn/newmoi/workspaces/<workspace_id>/agent-automation-tasks' \
  -H 'X-API-Key: <WORKSPACE_API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{"name":"daily-report","agent_id":"<agent_id>","instruction_text":"Summarize overnight alerts","trigger":{"mode":"api"},"status":"active"}'

响应说明

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

返回创建后的任务对象：

字段	类型	必填	说明
id	string		任务 ID
workspace_id	string		工作区 ID
agent_workspace_id	string		智能体所在工作区
name	string		任务名称
description	string		描述
agent_id	string		绑定智能体 ID
instruction_text	string		运行指令
trigger	object		mode 为 cron 或 api；可含 cron_expression、service_name、input_schema、config
auth_policy	object		API 触发鉴权策略；Cron 创建时不要照旧示例携带
output_contract	object		输出约定
status	string		draft / creating / active / failed / disabled / archived
version	integer		配置版本
api_summary	object		API 类型任务摘要（含 service_name 等）
next_trigger_at	string		下次 Cron 触发时间
created_at	string		创建时间
updated_at	string		更新时间

Cron 示例 body：{"name":"hourly-check","agent_id":"<agent_id>","instruction_text":"Run hourly check","trigger":{"mode":"cron","cron_expression":"0 * * * *"},"status":"active"}

使用限制

• 定时任务与 API 类型任务的触发方式不同，创建后按类型选择正确入口。

相关接口

• 查询自动化任务列表

• 触发 API 类型自动化任务

• 手动运行定时任务