Triggers an Agent on Mobile nodes to execute an AI automation task.
Try it now
Test
RAM authorization
Request syntax
GET HTTP/1.1Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| InstanceIds |
array |
No |
The list of Mobile node IDs. A maximum of 100 nodes are supported per request. |
|
|
string |
No |
The Mobile node ID, such as acp-xxx. |
acp-5hh4a31emkt6u**** |
|
| UserPrompt |
string |
No |
The user instruction in natural language. The Agent performs operations based on this instruction. |
Go to App Store and download DingTalk |
| MaxSteps |
integer |
No |
The maximum number of execution steps for the task. This prevents infinite loops. Valid values: 30 to 1000. Default value: 1000. |
30 |
| TimeoutSeconds |
integer |
No |
The task timeout period, in seconds. Valid values: 300 to 3600. Default value: 3600. |
3600 |
| BizRegionId |
string |
No |
The region ID of the Mobile node. |
cn-shanghai |
| TaskConfigId |
string |
No |
The task configuration ID. This parameter is used to trigger a task with the specified configuration. |
tsk-260625-49be**** |
| ScheduleId |
string |
No |
The scheduling plan ID. When specified, the execution record is associated with the corresponding scheduled node, which facilitates aggregate query by scheduling dimension through aggregation. |
sch-260625-pbj2**** |
| RunConfig |
object |
No |
The runtime configuration that carries the runtime parameters (skills) for this task. |
{"Skills":["sk-abc","sk-def"]} |
| Skills |
array |
No |
The list of skill IDs. A maximum of 10 skill IDs are supported. Only the first skill is passed through during command delivery. All skills are stored in task_skill_relation for reverse lookup. |
["sk-abc","sk-def"] |
|
string |
No |
|||
| Targets |
array<object> |
No |
An array of target objects. Each element contains an InstanceId and a SessionId. |
|
|
object |
No |
The target object. |
||
| InstanceId |
string |
No |
The Mobile node ID, such as acp-xxx. |
acp-5hh4a31emkt6u**** |
| SessionId |
string |
No |
The session ID. Tasks with the same session ID share context, such as ses-260702-21b****. |
ses-260702-21bh****。 |
|
No |
Specifies whether to write the task artifacts to the user's OSS bucket. |
true |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
Schema of Response |
||
| RequestId |
string |
The request ID. |
6C8439B9-7DBF-57F4-92AE-55A9B9D3**** |
| Code |
string |
The status code of the operation. |
For example, "200" indicates success |
| Message |
string |
The response message. |
Success. |
| Count |
integer |
The number of tasks. |
1 |
| Tasks |
array<object> |
The list of tasks. |
|
|
object |
The task. |
||
| TaskId |
string |
The task ID, which is globally unique. |
t-imr0fufqd7cle**** |
| InstanceId |
string |
The Mobile node ID. |
acp-ek65k51zoxia3x8xz |
| UserPrompt |
string |
The user instruction in natural language. The Agent performs operations based on this instruction. |
Go to App Store and download DingTalk |
| CurrentStatus |
string |
The current status of the task. Valid values: PENDING: The task is being created. RUNNING: The task is running. COMPLETED: The task is completed. FAILED: The task failed. TIMEOUT: The task timed out. CALL_FOR_USER: Waiting for user action. PAUSING: The task is being paused. PAUSED: The task is paused. CANCELLING: The task is being canceled. CANCELED: The task is canceled. STOPPED: The task is stopped. TIMEOUT: The task timed out. |
COMPLETED |
| RunningAt |
string |
The time when the task was created, in ISO 8601 format. |
2026-04-13T17:42:19Z |
| SessionId |
string |
The session ID. Tasks with the same session ID share context. |
ses-260702-21bh****。 |
Examples
Success response
JSON format
{
"RequestId": "6C8439B9-7DBF-57F4-92AE-55A9B9D3****",
"Code": "For example, \"200\" indicates success",
"Message": "Success.",
"Count": 1,
"Tasks": [
{
"TaskId": "t-imr0fufqd7cle****",
"InstanceId": "acp-ek65k51zoxia3x8xz",
"UserPrompt": "Go to App Store and download DingTalk",
"CurrentStatus": "COMPLETED",
"RunningAt": "2026-04-13T17:42:19Z",
"SessionId": "ses-260702-21bh****。"
}
]
}Error codes
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.