- Solicitud HTTP
- Parámetros de ruta
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- Permisos de IAM
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 |
Obligatorio. La app para la que se ejecutará el asistente. Formato: |
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 |
Obligatorio. Es la sesión del asistente que se usará para ejecutarlo. Formato: |
message |
Obligatorio. Es el mensaje que se enviará al agente de asistencia. |
attachedGcsUris[] |
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 |
Es opcional. Es el token de contexto de integración opaco que devuelve |
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 ( |
| Campos | |
|---|---|
eventId |
Identificador único para el evento. |
eventTime |
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: |
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 |
Token de texto (para transmitir las respuestas de Gemini palabra por palabra) |
statusMessage |
Actualización de estado simple |
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-platformhttps://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.