Method: projects.locations.apps.chatAiAssistant

Ejecuta Arc, el asistente de IA, para la sesión de asistente especificada.

Solicitud HTTP

POST https://ces.googleapis.com/v1beta/{app=projects/*/locations/*/apps/*}:chatAiAssistant

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

Parámetros de ruta

Parámetros
app

string

Obligatorio. La app para la que se ejecutará el asistente. Formato: projects/{project}/locations/{location}/apps/{app}

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON
{
  "assistantSession": string,
  "message": string,
  "attachedGcsUris": [
    string
  ],
  "contextToken": string
}
Campos
assistantSession

string

Obligatorio. Es la sesión del asistente que se usará para ejecutarlo. Formato: projects/{project}/locations/{location}/apps/{app}/assistantSessions/{assistantSession}

message

string

Obligatorio. Es el mensaje que se enviará al agente de asistencia.

attachedGcsUris[]

string

Es opcional. Son los URIs de Cloud Storage para los archivos que subió el usuario durante este turno. Ejemplo: "gs://cxas-transient-uploads/uuid/prd.pdf"

contextToken

string

Es opcional. Es el token de contexto de integración opaco que devuelve SessionService.GenerateOnboardingSuggestions. Cuando se establece y aún está actualizado, el servidor reutiliza la instantánea de incorporación calculada para el estado cero en lugar de volver a calcularla para el primer turno de conversación.

Cuerpo de la respuesta

Mensaje de respuesta para AssistantService.ChatAiAssistant.

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

Representación JSON
{
  "eventId": string,
  "eventTime": string,
  "uiEvent": {
    object (UiEvent)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "textChunk": string,
  "statusMessage": string,
  "sessionCheckpoint": {
    object (SessionCheckpoint)
  }
  // End of mutually exclusive fields.
}
Campos
eventId

string

Identificador único para el evento.

eventTime

string (Timestamp format)

Es la marca de tiempo de cuando ocurrió el evento.

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".

uiEvent

object (UiEvent)

Es opcional. Es la carga útil del evento de IU.

Es la carga útil del evento. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
textChunk

string

Token de texto (para transmitir las respuestas de Gemini palabra por palabra)

statusMessage

string

Actualización de estado simple

sessionCheckpoint

object (SessionCheckpoint)

Es el evento de resumen de compactación o punto de control de la sesión que contiene la intención del usuario y el resumen continuo.

Fin de los campos mutuamente excluyentes.

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.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso app:

  • ces.apps.update

Para obtener más información, consulta la documentación de IAM.