エージェントをトリガーして、モバイルノードで AI 自動化タスクを実行します。
今すぐお試しください
テスト
RAM 認証
リクエスト構文
GET HTTP/1.1リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| InstanceIds |
array |
任意 |
モバイルノード ID のリスト。1 リクエストあたり最大 100 ノードがサポートされます。 |
|
|
string |
任意 |
モバイルノード ID。例: acp-xxx。 |
acp-5hh4a31emkt6u**** |
|
| UserPrompt |
string |
任意 |
自然言語によるユーザー命令。エージェントはこの命令に基づいて操作を実行します。 |
去应用宝下载钉钉 |
| MaxSteps |
integer |
任意 |
タスクの実行ステップ数の最大値。無限ループを防止します。有効な値: 30～1000。デフォルト値: 1000。 |
30 |
| TimeoutSeconds |
integer |
任意 |
タスクのタイムアウト期間（秒単位）。有効な値: 300～3600。デフォルト値: 3600。 |
3600 |
| BizRegionId |
string |
任意 |
モバイルノードのリージョン ID。 |
cn-shanghai |
| TaskConfigId |
string |
任意 |
指定された構成でタスクをトリガーするために使用されるタスク構成 ID。 |
tsk-260625-49be**** |
| ScheduleId |
string |
任意 |
スケジューリングプラン ID。指定すると、実行レコードが対応するスケジュールされたノードに関連付けられ、スケジューリングディメンションによる集約クエリが容易になります。 |
sch-260625-pbj2**** |
| Targets |
array<object> |
任意 |
ターゲットオブジェクトの配列。各要素には InstanceId と SessionId が含まれます。 |
|
|
object |
任意 |
ターゲットオブジェクト。 |
||
| InstanceId |
string |
任意 |
モバイルノード ID。例: acp-xxx。 |
acp-5hh4a31emkt6u**** |
| SessionId |
string |
任意 |
会話 ID。同じ会話 ID を持つタスクはコンテキストを共有します。例: ses-260702-21b****。 |
ses-260702-21bh****。 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
応答のスキーマ。 |
||
| RequestId |
string |
リクエスト ID。 |
6C8439B9-7DBF-57F4-92AE-55A9B9D3**** |
| Code |
string |
操作の状態コード。 |
例如 "200" 表示成功。 |
| Message |
string |
応答メッセージ。 |
Success. |
| Count |
integer |
タスクの数。 |
1 |
| Tasks |
array<object> |
タスクのリスト。 |
|
|
object |
タスク。 |
||
| TaskId |
string |
グローバルに一意なタスク ID。 |
t-imr0fufqd7cle**** |
| InstanceId |
string |
モバイルノード ID。 |
acp-ek65k51zoxia3x8xz |
| UserPrompt |
string |
自然言語によるユーザー命令。エージェントはこの命令に基づいて操作を実行します。 |
去应用宝下载钉钉 |
| 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。同じ会話 ID を持つタスクはコンテキストを共有します。 |
ses-260702-21bh****。 |
例
成功レスポンス
JSONJSON
{
"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****。"
}
]
}エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。