DescribeAgentTask - Cloud Phone - Alibaba Cloud Documentation Center

Mengkueri informasi tentang tugas 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

GET  HTTP/1.1

Parameter permintaan

Parameter	Type	Required	Description	Example
TaskIds	array	No	Daftar ID tugas.
	string	No	ID tugas.	t-bp67acfmxazb4p****

Elemen respons

Element	Type	Description	Example
	object	Skema respons.
RequestId	string	ID permintaan.	310A783E-CC46-5452-A8A3-71AE5DB5****
Code	string	Kode status API.	Misalnya, "200" menunjukkan keberhasilan
Message	string	Paket tanggapan.	Success
Count	integer	Jumlah tugas.	1
Tasks	array<object>	Daftar tugas.
	array<object>	Tugas.
TaskId	string	ID tugas, yang bersifat unik secara global.	t-imr0fufqd7cle****
InstanceId	string	ID node Mobile.	acp-anzzuho371azi44xr
UserPrompt	string	Instruksi pengguna dalam bahasa alami. Agen melakukan operasi berdasarkan instruksi ini.	Download DingTalk from App Store
CurrentStatus	string	Status saat ini dari tugas. Nilai valid: PENDING: Tugas sedang dibuat. RUNNING: Tugas sedang berjalan. COMPLETED: Tugas selesai. FAILED: Tugas gagal. TIMEOUT: Eksekusi tugas habis pengatur waktu.	COMPLETED
RunningAt	string	Pengatur waktu pembuatan tugas, dalam format ISO 8601.	2026-04-13T17:42:19Z
Steps	string	Jumlah langkah yang dieksekusi.	30
TaskResult	string	Hasil tugas dalam keadaan yang diinginkan. Bidang ini hanya dikembalikan ketika CurrentStatus adalah COMPLETED atau FAILED.	Download DingTalk succeeded
TaskDuration	string	Durasi tugas. Bidang ini hanya dikembalikan ketika CurrentStatus adalah FAILED atau COMPLETED.	50
TaskDigest	string	Teks ringkasan tugas, hingga 25 karakter.
DigestSource	string	Sumber ringkasan. Nilai valid: PROMPT_AUTO: dibuat otomatis. RESULT_AUTO: penyempurnaan hasil. USER: diedit pengguna.
Reason	string
ArtifactCount	integer	Jumlah artefak tugas.	2
Artifacts	array<object>	Daftar artefak tugas yang diunggah.
	object	Informasi artefak.
Name	string	Nama file.	screenshot.png
Size	integer	Ukuran file dalam byte.	1024
ContentType	string	Tipe MIME.	image/png
DownloadUrl	string	URL unduh bertanda tangan pra-OSS.	https://bucket.oss-cn-hangzhou.aliyuncs.com/..
UpdatedTime	string	Waktu unggah dalam format ISO 8601.	2026-08-05T10:00:00+08:00

Contoh

Respons sukses

JSONformat

{
  "RequestId": "310A783E-CC46-5452-A8A3-71AE5DB5****",
  "Code": "For example, \"200\" indicates success.",
  "Message": "Success.",
  "Count": 1,
  "Tasks": [
    {
      "TaskId": "t-imr0fufqd7cle****",
      "InstanceId": "acp-anzzuho371azi44xr",
      "UserPrompt": "Download DingTalk from App Store",
      "CurrentStatus": "COMPLETED",
      "RunningAt": "2026-04-13T17:42:19Z",
      "Steps": "30",
      "TaskResult": "Download DingTalk succeeded.",
      "TaskDuration": "50",
      "TaskDigest": "",
      "DigestSource": "",
      "Reason": "",
      "ArtifactCount": 2,
      "Artifacts": [
        {
          "Name": "screenshot.png",
          "Size": 1024,
          "ContentType": "image/png",
          "DownloadUrl": "https://bucket.oss-cn-hangzhou.aliyuncs.com/...",
          "UpdatedTime": "2026-08-05T10:00:00+08:00"
        }
      ]
    }
  ]
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.