All Products
Search
Document Center

Cloud Phone:RunAgentTask

Last Updated:Aug 28, 2026

Memicu Agen pada node Mobile untuk menjalankan tugas otomatisasi AI.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

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.