Method: tasks.list

Mencantumkan tugas yang cocok dengan filter yang ditentukan.

Permintaan HTTP

GET https://ces.googleapis.com/tasks

URL menggunakan sintaks gRPC Transcoding.

Parameter kueri

Parameter
tenant

string

Opsional. ID perutean buram. Harus cocok dengan nilai tenant dari AgentInterface yang dipilih di Kartu Agen saat kolom tersebut ditetapkan.
contextId

string

Memfilter tugas berdasarkan ID konteks untuk mendapatkan tugas dari percakapan atau sesi tertentu.
status

enum (TaskState)

Memfilter tugas berdasarkan status saat ini.
pageToken

string

Token halaman, yang diterima dari panggilan tasks.list sebelumnya. ListTasksResponse.next_page_token. Berikan token ini untuk mengambil halaman berikutnya.
statusTimestampAfter

string (Timestamp format)

Memfilter tugas yang memiliki status yang diperbarui setelah stempel waktu yang diberikan dalam format ISO 8601 (misalnya, "2023-10-27T10:00:00Z"). Hanya tugas dengan waktu stempel waktu status yang lebih besar dari atau sama dengan nilai ini yang akan ditampilkan.

Menggunakan RFC 3339 yang outputnya akan selalu dikonversi ke format Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
pageSize

integer

Jumlah maksimum tugas yang akan ditampilkan. Layanan dapat menampilkan nilai yang lebih kecil dari nilai ini. Jika tidak ditentukan, paling banyak 50 tugas akan ditampilkan. Nilai minimumnya adalah 1. Nilai maksimumnya adalah 100.
historyLength

integer

Jumlah maksimum pesan yang akan disertakan dalam histori setiap tugas.
includeArtifacts

boolean

Apakah akan menyertakan artefak dalam tugas yang ditampilkan. Nilai defaultnya adalah false untuk mengurangi ukuran payload.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Objek hasil untuk metode tasks.list yang berisi array tugas dan informasi penomoran halaman.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "tasks": [
    {
      object (Task)
    }
  ],
  "nextPageToken": string,
  "pageSize": integer,
  "totalSize": integer
}
Kolom
tasks[]

object (Task)

Wajib diisi. Array tugas yang cocok dengan kriteria yang ditentukan.
nextPageToken

string

Wajib diisi. Token untuk mengambil hasil halaman berikutnya, atau kosong jika tidak ada lagi hasil dalam daftar.
pageSize

integer

Wajib diisi. Ukuran halaman yang digunakan untuk respons ini.
totalSize

integer

Wajib diisi. Jumlah total tugas yang tersedia (sebelum penomoran halaman).

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/ces

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.