All Products
Search
Document Center

Cloud Phone:CreateScheduledTask

Last Updated:Aug 08, 2026

Membuat tugas terjadwal untuk agen.

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

POST  HTTP/1.1

Parameter permintaan

Parameter

Type

Required

Description

Example

TaskName

string

Yes

Nama tugas.

Balas otomatis Paket DingTalk.

UserPrompt

string

Yes

Prompt pengguna.

Buka DingTalk dan balas 5 Paket yang belum dibaca pertama.

CronExpression

string

Yes

Ekspresi cron.

0 0 * * *

InstanceIds

array

Yes

Daftar ID instans.

["ai-Instans-001"]

string

No

Daftar ID instans ponsel cloud. Anda dapat mengaitkan hingga 3 instans.

acp-5hh4a31emkt6u****

MaxExecutions

integer

No

Jumlah maksimum eksekusi.

1

RunConfig

object

No

Konfigurasi eksekusi.

{"maxSteps":10,"timeoutSeconds":3600}

Skills

array

No

Daftar ID skill, maksimal 1. Ditulis ke aim_task_config.run_config saat tugas terjadwal dibuat dan dibaca saat callback dikirimkan.

["sk-abc"]

string

No

MaxSteps

integer

No

Jumlah maksimum langkah eksekusi.

10

TimeoutSeconds

integer

No

Timeout dalam detik.

3600

ExtraParams

string

No

Parameter tambahan dalam bentuk string JSON.

{"batchSize":"1000"}

Elemen respons

Element

Type

Description

Example

object

ApiResponse

RequestId

string

ID permintaan.

9A51B1DF-96FF-3BCC-B08C-783161D3****

Code

string

Kode status API.

200

Message

string

Pesan respons.

Success.

TotalCount

integer

Jumlah total catatan.

1

Tasks

array<object>

Daftar hasil pembuatan.

array<object>

Tugas.

ScheduledId

string

ID tugas terjadwal.

sch-260705-agb*****

TaskConfigId

string

ID konfigurasi tugas.

tsk-260705-0jj*****

InstanceResults

array<object>

Daftar hasil pengiriman batch untuk tugas terjadwal instans.

object

Informasi hasil instans.

InstanceId

string

ID instans.

acp-iuyb1zv1ap6nb****

Success

boolean

Menunjukkan apakah operasi berhasil.

true.

ErrorMessage

string

Pesan error.

privateAccount not exist.

Contoh

Respons sukses

JSONformat

{
  "RequestId": "9A51B1DF-96FF-3BCC-B08C-783161D3****",
  "Code": "200",
  "Message": "Success.",
  "TotalCount": 1,
  "Tasks": [
    {
      "ScheduledId": "sch-260705-agb*****",
      "TaskConfigId": "tsk-260705-0jj*****",
      "InstanceResults": [
        {
          "InstanceId": "acp-iuyb1zv1ap6nb****",
          "Success": true,
          "ErrorMessage": "privateAccount not exist."
        }
      ]
    }
  ]
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.