Method: tasks.list

Elenca le attività che corrispondono al filtro specificato.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di query

Parametri
tenant

string

Facoltativo. Identificatore di routing opaco. Deve corrispondere al valore tenant di AgentInterface selezionato nella scheda dell'agente quando questo campo è impostato.
contextId

string

Filtra le attività in base all'ID contesto per ottenere le attività da una conversazione o sessione specifica.
status

enum (TaskState)

Filtra le attività in base al loro stato attuale.
pageToken

string

Un token di pagina, ricevuto da una precedente chiamata tasks.list. ListTasksResponse.next_page_token. Forniscilo per recuperare la pagina successiva.
statusTimestampAfter

string (Timestamp format)

Filtra le attività il cui stato è stato aggiornato dopo il timestamp fornito nel formato ISO 8601 (ad es. "2023-10-27T10:00:00Z"). Verranno restituite solo le attività con un timestamp di stato maggiore o uguale a questo valore.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
pageSize

integer

Il numero massimo di attività da restituire. Il servizio potrebbe restituire un numero di attività inferiore a questo valore. Se non specificato, verranno restituite al massimo 50 attività. Il valore minimo è 1. Il valore massimo è 100.
historyLength

integer

Il numero massimo di messaggi da includere nella cronologia di ogni attività.
includeArtifacts

boolean

Indica se includere gli artefatti nelle attività restituite. Il valore predefinito è false per ridurre le dimensioni del payload.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Oggetto risultato per il metodo tasks.list contenente un array di attività e informazioni di impaginazione.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

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

object (Task)

Obbligatorio. Array di attività che corrispondono ai criteri specificati.
nextPageToken

string

Obbligatorio. Un token per recuperare la pagina successiva di risultati o vuoto se non sono presenti altri risultati nell'elenco.
pageSize

integer

Obbligatorio. La dimensione della pagina utilizzata per questa risposta.
totalSize

integer

Obbligatorio. Numero totale di attività disponibili (prima dell'impaginazione).

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per saperne di più, consulta la Authentication Overview.