创建智能体定时任务。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
POST HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| TaskName |
string |
是 |
任务名称。 |
自动回复钉钉消息 |
| UserPrompt |
string |
是 |
用户 Prompt。 |
打开钉钉，回复前5个未读消息 |
| CronExpression |
string |
是 |
Cron 表达式。 |
0 0 * * * |
| InstanceIds |
array |
是 |
实例 ID 列表。 |
["ai-instance-001"] |
|
string |
否 |
云手机实例 ID 列表，当前最多可关联 3 个实例。 |
acp-5hh4a31emkt6u**** |
|
| MaxExecutions |
integer |
否 |
最大执行次数。 |
1 |
| RunConfig |
object |
否 |
运行配置。 |
{"maxSteps":10,"timeoutSeconds":3600} |
| Skills |
array |
否 |
技能 ID 列表，最多 1 个；定时任务创建时写入 aim_task_config.run_config，回调下发时读取 |
["sk-abc"] |
|
string |
否 |
|||
| MaxSteps |
integer |
否 |
最大执行步数。 |
10 |
| TimeoutSeconds |
integer |
否 |
超时秒数。 |
3600 |
| ExtraParams |
string |
否 |
扩展参数 JSON 字符串。 |
{"batchSize":"1000"} |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
ApiResponse |
||
| RequestId |
string |
请求 ID。 |
9A51B1DF-96FF-3BCC-B08C-783161D3**** |
| Code |
string |
接口状态码。 |
200 |
| Message |
string |
接口返回信息。 |
Success. |
| TotalCount |
integer |
总记录数。 |
1 |
| Tasks |
array<object> |
创建结果列表。 |
|
|
array<object> |
任务。 |
||
| ScheduledId |
string |
定时任务 ID。 |
sch-260705-agb***** |
| TaskConfigId |
string |
任务配置 ID。 |
tsk-260705-0jj***** |
| InstanceResults |
array<object> |
实例定时任务批量下发结果列表。 |
|
|
object |
实例结果信息。 |
||
| InstanceId |
string |
实例 ID。 |
acp-iuyb1zv1ap6nb**** |
| Success |
boolean |
是否成功。 |
true |
| ErrorMessage |
string |
错误信息。 |
privateAccount not exist. |
示例
正常返回示例
JSON格式
{
"RequestId": "9A51B1DF-96FF-3BCC-B08C-783161D3****",
"Code": "200",
"Message": "Success.",
"TotalCount": 1,
"Tasks": [
{
"ScheduledId": "sch-260705-agb*****",
"TaskConfigId": "tsk-260705-0jj*****",
"InstanceResults": [
{
"InstanceId": "acp-iuyb1zv1ap6nb****",
"Success": true,
"ErrorMessage": "privateAccount not exist."
}
]
}
]
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。