Method: tasks.list

Muestra una lista de las tareas que coinciden con el filtro especificado.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de consulta

Parámetros
tenant

string

Es opcional. Es un identificador de enrutamiento opaco. Debe coincidir con el valor tenant de la AgentInterface seleccionada en la tarjeta de agente cuando se establece ese campo.

contextId

string

Filtra las tareas por ID de contexto para obtener tareas de una conversación o sesión específica.

status

enum (TaskState)

Filtra las tareas por su estado actual.

pageToken

string

Un token de página, recibido desde una llamada tasks.list anterior. ListTasksResponse.next_page_token. Proporciona esto para recuperar la página siguiente.

statusTimestampAfter

string (Timestamp format)

Filtra las tareas que tienen un estado actualizado después de la marca de tiempo proporcionada en formato ISO 8601 (p.ej., "2023-10-27T10:00:00Z"). Solo se mostrarán las tareas con una marca de tiempo de estado mayor o igual que este valor.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

pageSize

integer

La cantidad máxima de tareas que se devolverán. El servicio puede mostrar menos que este valor. Si no se especifica, se devolverán, como máximo, 50 tareas. El valor mínimo es 1. El valor máximo es 100.

historyLength

integer

La cantidad máxima de mensajes que se incluirán en el historial de cada tarea.

includeArtifacts

boolean

Indica si se deben incluir artefactos en las tareas que se muestran. El valor predeterminado es false para reducir el tamaño de la carga útil.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Objeto de resultado para el método tasks.list que contiene un array de tareas y la información de paginación.

Si se ejecuta correctamente, el cuerpo de la respuesta contiene datos con la siguiente estructura:

Representación JSON
{
  "tasks": [
    {
      object (Task)
    }
  ],
  "nextPageToken": string,
  "pageSize": integer,
  "totalSize": integer
}
Campos
tasks[]

object (Task)

Obligatorio. Es un array de tareas que coinciden con los criterios especificados.

nextPageToken

string

Obligatorio. Es un token para recuperar la siguiente página de resultados o está vacío si no hay más resultados en la lista.

pageSize

integer

Obligatorio. Es el tamaño de página que se usa para esta respuesta.

totalSize

integer

Obligatorio. Es la cantidad total de tareas disponibles (antes de la paginación).

Permisos de autorización

Se necesita uno de los siguientes permisos de OAuth:

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

Para obtener más información, consulta Authentication Overview.