触发 Mobile 节点上 Agent 执行 AI 自动化任务。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
GET HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| InstanceIds |
array |
否 |
Mobile 节点 ID 列表。一次请求最多支持 100 个节点。 |
|
|
string |
否 |
Mobile 节点 ID，如 acp-xxx。 |
acp-5hh4a31emkt6u**** |
|
| UserPrompt |
string |
否 |
用户指令（自然语言），Agent 据此完成操作。 |
去应用宝下载钉钉 |
| MaxSteps |
integer |
否 |
Task 最大执行步骤数，防止无限循环。范围 30~1000，默认 1000。 |
30 |
| TimeoutSeconds |
integer |
否 |
任务超时时间（秒）。范围 300~3600，默认 3600。 |
3600 |
| BizRegionId |
string |
否 |
Mobile 节点所在的地域 ID。 |
cn-shanghai |
| TaskConfigId |
string |
否 |
任务配置 ID，用于触发指定配置的任务 |
tsk-260625-49be**** |
| ScheduleId |
string |
否 |
调度计划 ID，传入时执行记录关联到对应的定时任务，便于按调度维度聚合查询 |
sch-260625-pbj2**** |
| Targets |
array<object> |
否 |
Targets 是一个数组，每个元素是包含 InstanceId 和 SessionId 的对象。 |
|
|
object |
否 |
Target 对象。 |
||
| InstanceId |
string |
否 |
Mobile 节点 ID，如 acp-xxx。 |
acp-5hh4a31emkt6u**** |
| SessionId |
string |
否 |
会话 ID，同 sessionid 的任务共享上下文，如 ses-260702-21b****。 |
ses-260702-21bh****。 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
请求唯一 ID。 |
6C8439B9-7DBF-57F4-92AE-55A9B9D3**** |
| Code |
string |
接口状态码。 |
例如 "200" 表示成功。 |
| Message |
string |
接口返回信息。 |
Success. |
| Count |
integer |
任务数量。 |
1 |
| Tasks |
array<object> |
任务 list。 |
|
|
object |
任务。 |
||
| TaskId |
string |
任务 ID，全局唯一。 |
t-imr0fufqd7cle**** |
| InstanceId |
string |
Mobile 节点 ID。 |
acp-ek65k51zoxia3x8xz |
| UserPrompt |
string |
用户指令（自然语言），Agent 据此完成操作。 |
去应用宝下载钉钉 |
| CurrentStatus |
string |
任务当前状态，参考下方状态枚举，取值如下： PENDING 任务创建中。 RUNNING 任务运行中。 COMPLETED 任务已完成。 FAILED 任务失败。 TIMEOUT 任务执行超时。 CALL_FOR_USER 等待用户操作。 PAUSING 暂停中。 PAUSED 已暂停。 CANCELLING 取消中。 CANCELED 已取消。 STOPPED 已停止。 TIMEOUT 超时。 |
COMPLETED |
| RunningAt |
string |
任务创建时间，ISO 8601 格式。 |
2026-04-13T17:42:19Z |
| SessionId |
string |
会话 ID，同 sessionid 的任务共享上下文。 |
ses-260702-21bh****。 |
示例
正常返回示例
JSON格式
{
"RequestId": "6C8439B9-7DBF-57F4-92AE-55A9B9D3****",
"Code": "例如 \"200\" 表示成功。",
"Message": "Success.",
"Count": 1,
"Tasks": [
{
"TaskId": "t-imr0fufqd7cle****",
"InstanceId": "acp-ek65k51zoxia3x8xz",
"UserPrompt": "去应用宝下载钉钉",
"CurrentStatus": "COMPLETED",
"RunningAt": "2026-04-13T17:42:19Z",
"SessionId": "ses-260702-21bh****。"
}
]
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。