All Products
Search
Document Center

Cloud Phone:RunAgentTask

Last Updated:Jul 03, 2026

Memicu Agen untuk menjalankan tugas otomatisasi AI pada node Mobile.

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 menjalankan operasi berdasarkan instruksi ini.

去应用宝下载钉钉

MaxSteps

integer

No

Jumlah maksimum langkah eksekusi untuk tugas. Ini mencegah loop tak terbatas. Nilai valid: 30 hingga 1000. Nilai default: 1000.

30

TimeoutSeconds

integer

No

Periode pengatur waktu 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 yang digunakan sebagai Pemicu untuk tugas dengan konfigurasi tertentu.

tsk-260625-49be****

ScheduleId

string

No

ID rencana penjadwalan. Saat ditentukan, catatan eksekusi dikaitkan dengan node terjadwal yang sesuai, yang memfasilitasi kueri agregasi berdasarkan dimensi penjadwalan.

sch-260625-pbj2****

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, misalnya ses-260702-21b****.

ses-260702-21bh****。

Elemen respons

Element

Type

Description

Example

object

Skema Tanggapan.

RequestId

string

ID permintaan.

6C8439B9-7DBF-57F4-92AE-55A9B9D3****

Code

string

Kode status operasi.

例如 "200" 表示成功。

Message

string

Paket tanggapan.

Success.

Count

integer

Jumlah tugas.

1

Tasks

array<object>

Daftar tugas.

object

Tugas.

TaskId

string

ID tugas, yang bersifat unik secara global.

t-imr0fufqd7cle****

InstanceId

string

ID node Mobile.

acp-ek65k51zoxia3x8xz

UserPrompt

string

Instruksi pengguna dalam bahasa alami. Agen menjalankan operasi berdasarkan instruksi ini.

去应用宝下载钉钉

CurrentStatus

string

Status tugas saat ini. Nilai valid:

PENDING: Tugas sedang dibuat.

RUNNING: Tugas sedang berjalan.

COMPLETED: Tugas telah selesai.

FAILED: Tugas gagal.

TIMEOUT: Tugas mencapai pengatur waktu.

CALL_FOR_USER: Tugas 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.