Memicu Agen pada node Mobile untuk menjalankan tugas otomatisasi AI.
Coba sekarang
Test
RAM authorization
Sintaks permintaan
GET HTTP/1.1
Parameter permintaan
|
Parameter |
Type |
Required |
Description |
Example |
| InstanceIds |
array |
No |
Daftar ID node Mobile. Maksimal 100 node didukung per permintaan. |
|
|
string |
No |
ID node Mobile, misalnya acp-xxx. |
acp-5hh4a31emkt6u**** |
|
| UserPrompt |
string |
No |
Instruksi pengguna dalam bahasa alami. Agen melakukan operasi berdasarkan instruksi ini. |
Buka App Store dan unduh DingTalk |
| MaxSteps |
integer |
No |
Jumlah langkah eksekusi maksimum untuk tugas. Ini mencegah loop tak terbatas. Nilai valid: 30 hingga 1000. Nilai default: 1000. |
30 |
| TimeoutSeconds |
integer |
No |
Periode pengatur waktu habis tugas, dalam detik. Nilai valid: 300 hingga 3600. Nilai default: 3600. |
3600 |
| BizRegionId |
string |
No |
ID wilayah node Mobile. |
cn-shanghai |
| TaskConfigId |
string |
No |
ID konfigurasi tugas. Parameter ini digunakan untuk Pemicu tugas dengan konfigurasi yang ditentukan. |
tsk-260625-49be**** |
| ScheduleId |
string |
No |
ID rencana penjadwalan. Ketika ditentukan, catatan eksekusi dikaitkan dengan node terjadwal yang sesuai, yang memudahkan kueri agregat berdasarkan dimensi penjadwalan melalui agregasi. |
sch-260625-pbj2**** |
| RunConfig |
object |
No |
Konfigurasi waktu proses yang membawa parameter pengatur waktu (kemampuan) untuk tugas ini. |
{"Skills":["sk-abc","sk-def"]} |
| Skills |
array |
No |
Daftar ID kemampuan. Maksimal 10 ID kemampuan didukung. Hanya kemampuan pertama yang diteruskan selama pengiriman perintah. Semua kemampuan disimpan di task_skill_relation untuk pencarian balik. |
["sk-abc","sk-def"] |
|
string |
No |
|||
| Targets |
array<object> |
No |
Array objek target. Setiap elemen berisi InstanceId dan SessionId. |
|
|
object |
No |
Objek target. |
||
| InstanceId |
string |
No |
ID node Mobile, misalnya acp-xxx. |
acp-5hh4a31emkt6u**** |
| SessionId |
string |
No |
ID sesi. Tugas dengan ID sesi yang sama berbagi konteks, seperti ses-260702-21b****. |
ses-260702-21bh**** |
|
No |
Apakah akan menulis artefak tugas ke bucket OSS pengguna. |
true |
Elemen respons
|
Element |
Type |
Description |
Example |
|
object |
Skema Respons. |
||
| RequestId |
string |
ID permintaan. |
6C8439B9-7DBF-57F4-92AE-55A9B9D3**** |
| Code |
string |
Kode status operasi. |
Misalnya, "200" menunjukkan keberhasilan |
| Message |
string |
Paket tanggapan. |
Success |
| Count |
integer |
Jumlah tugas. |
1 |
| Tasks |
array<object> |
Daftar tugas. |
|
|
object |
Tugas. |
||
| TaskId |
string |
ID tugas, yang unik secara global. |
t-imr0fufqd7cle**** |
| InstanceId |
string |
ID node Mobile. |
acp-ek65k51zoxia3x8xz |
| UserPrompt |
string |
Instruksi pengguna dalam bahasa alami. Agen melakukan operasi berdasarkan instruksi ini. |
Buka App Store dan unduh DingTalk |
| CurrentStatus |
string |
Status saat ini tugas. Nilai valid: PENDING: Tugas sedang dibuat. RUNNING: Tugas sedang berjalan. COMPLETED: Tugas selesai. FAILED: Tugas gagal. TIMEOUT: Tugas mencapai pengatur waktu. CALL_FOR_USER: Menunggu aksi pengguna. PAUSING: Tugas sedang dijeda. PAUSED: Tugas dijeda. CANCELLING: Tugas sedang dibatalkan. CANCELED: Tugas dibatalkan. STOPPED: Tugas dihentikan. TIMEOUT: Tugas mencapai pengatur waktu. |
COMPLETED |
| RunningAt |
string |
Pengatur waktu saat tugas dibuat, dalam format ISO 8601. |
2026-04-13T17:42:19Z |
| SessionId |
string |
ID sesi. Tugas dengan ID sesi yang sama berbagi konteks. |
ses-260702-21bh**** |
Contoh
Respons sukses
JSONformat
{
"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****。"
}
]
}
Kode kesalahan
Lihat Error Codes untuk daftar lengkap.
Catatan rilis
Lihat Release Notes untuk daftar lengkap.