Gemini Enterprise for Customer Experience API

Servicio: ces.googleapis.com

Para llamar a este servicio, te recomendamos que uses las bibliotecas cliente que proporciona Google. Si tu aplicación necesita usar tus propias bibliotecas para llamar a este servicio, usa la información que se indica más abajo cuando realices las solicitudes a la API.

Documento de descubrimiento

Un documento de descubrimiento es una especificación legible por máquinas para describir y consumir las APIs de REST. Se usa para compilar bibliotecas cliente, complementos IDE y otras herramientas que interactúan con las API de Google. Un servicio puede proporcionar varios documentos de descubrimiento. Este servicio proporciona el documento de descubrimiento siguiente:

Extremo de servicio

Un extremo de servicio es una URL base que especifica la dirección de red de un servicio de API. Un servicio puede tener varios extremos de servicio. Este servicio tiene el siguiente extremo, y todos los URI que se muestran a continuación son relativos a él:

  • https://ces.googleapis.com

Recurso de REST: tasks

Métodos
cancel POST /tasks/{id}:cancel
Cancela una tarea en curso.
get GET /tasks/{id}
Obtiene el estado más reciente de una tarea.
list GET /tasks
Enumera las tareas que coinciden con el filtro especificado.
subscribe GET /tasks/{id}:subscribe
Se suscribe a las actualizaciones de las tareas que no están en un estado terminal.

Recurso de REST: tasks.pushNotificationConfigs

Métodos
create POST /tasks/{taskId}/pushNotificationConfigs
Crea una configuración de notificaciones push para una tarea.
delete DELETE /tasks/{taskId}/pushNotificationConfigs/{id}
Borra una configuración de notificaciones push para una tarea.
get GET /tasks/{taskId}/pushNotificationConfigs/{id}
Obtiene una configuración de notificaciones push para una tarea.
list GET /tasks/{taskId}/pushNotificationConfigs
Obtiene una lista de las notificaciones push configuradas para una tarea.

Recurso de REST: v1.projects.locations

Métodos
get GET /v1/{name=projects/*/locations/*}
Obtiene información sobre una ubicación.
list GET /v1/{name=projects/*}/locations
Enumera la información sobre las ubicaciones compatibles con este servicio.

Recurso de REST: v1.projects.locations.apps

Métodos
create POST /v1/{parent=projects/*/locations/*}/apps
Crea una app nueva en el proyecto y la ubicación determinados.
delete DELETE /v1/{name=projects/*/locations/*/apps/*}
Borra la app especificada.
executeTool POST /v1/{parent=projects/*/locations/*/apps/*}:executeTool
Ejecuta la herramienta proporcionada con los argumentos proporcionados.
exportApp POST /v1/{name=projects/*/locations/*/apps/*}:exportApp
Exporta la app especificada.
generateOnboardingSuggestions POST /v1/{name=projects/*/locations/*/apps/*}:generateOnboardingSuggestions
Genera sugerencias de capacitación personalizadas para el estado cero de Arc: clasifica al usuario que realiza la solicitud (nuevo, explorando o recurrente) a partir de su historial de sesiones de asistente en la app y devuelve chips de sugerencias (reanudar una sesión, continuar con el trabajo o comenzar algo nuevo) para renderizar antes de que se envíe cualquier mensaje.
get GET /v1/{name=projects/*/locations/*/apps/*}
Obtiene detalles de la app especificada.
getExtendedAgentCard GET /v1/{tenant=projects/*/locations/*/apps/*}/extendedAgentCard
Obtiene la tarjeta de agente extendida para el agente autenticado.
importApp POST /v1/{parent=projects/*/locations/*}/apps:importApp
Importa la app especificada.
list GET /v1/{parent=projects/*/locations/*}/apps
Enumera las apps en la ubicación y el proyecto determinados.
patch PATCH /v1/{app.name=projects/*/locations/*/apps/*}
Actualiza la app especificada.
retrieveToolSchema POST /v1/{parent=projects/*/locations/*/apps/*}:retrieveToolSchema
Recupera el esquema de la herramienta determinada.

Recurso de REST: v1.projects.locations.apps.agents

Métodos
create POST /v1/{parent=projects/*/locations/*/apps/*}/agents
Crea un agente nuevo en la app determinada.
delete DELETE /v1/{name=projects/*/locations/*/apps/*/agents/*}
Borra el agente especificado.
get GET /v1/{name=projects/*/locations/*/apps/*/agents/*}
Obtiene los detalles del agente especificado.
list GET /v1/{parent=projects/*/locations/*/apps/*}/agents
Enumera los agentes de la app determinada.
patch PATCH /v1/{agent.name=projects/*/locations/*/apps/*/agents/*}
Actualiza el agente especificado.

Recurso de REST: v1.projects.locations.apps.assistantSessions

Métodos
cancelAssistantTurn POST /v1/{name=projects/*/locations/*/apps/*/assistantSessions/*}:cancelAssistantTurn
Cancela el turno en curso de la sesión del asistente, si lo hay: la detención explícita del usuario para un turno que se ejecuta de forma independiente de cualquier transmisión.
streamChatAiAssistant POST /v1/{name=projects/*/locations/*/apps/*/assistantSessions/*}:streamChatAiAssistant
Ejecuta Arc, el asistente de IA, para la sesión de asistente especificada en un formato de transmisión.

Recurso de REST: v1.projects.locations.apps.changelogs

Métodos
get GET /v1/{name=projects/*/locations/*/apps/*/changelogs/*}
Obtiene el registro de cambios especificado.
list GET /v1/{parent=projects/*/locations/*/apps/*}/changelogs
Enumera los registros de cambios de la app especificada.

Recurso de REST: v1.projects.locations.apps.conversations

Métodos
batchDelete POST /v1/{parent=projects/*/locations/*/apps/*}/conversations:batchDelete
Borra por lotes las conversaciones especificadas.
delete DELETE /v1/{name=projects/*/locations/*/apps/*/conversations/*}
Borra la conversación especificada.
get GET /v1/{name=projects/*/locations/*/apps/*/conversations/*}
Obtiene los detalles de la conversación especificada.
list GET /v1/{parent=projects/*/locations/*/apps/*}/conversations
Enumera las conversaciones de la app determinada.

Recurso de REST: v1.projects.locations.apps.deployments

Métodos
create POST /v1/{parent=projects/*/locations/*/apps/*}/deployments
Crea una implementación nueva en la app determinada.
delete DELETE /v1/{name=projects/*/locations/*/apps/*/deployments/*}
Borra la implementación especificada.
get GET /v1/{name=projects/*/locations/*/apps/*/deployments/*}
Obtiene los detalles de la implementación especificada.
getExtendedAgentCard GET /v1/{tenant=projects/*/locations/*/apps/*/deployments/*}/extendedAgentCard
Obtiene la tarjeta de agente extendida para el agente autenticado.
list GET /v1/{parent=projects/*/locations/*/apps/*}/deployments
Enumera las implementaciones de la app determinada.
patch PATCH /v1/{deployment.name=projects/*/locations/*/apps/*/deployments/*}
Actualiza la implementación especificada.

Recurso de REST: v1.projects.locations.apps.deployments.message

Métodos
send POST /v1/{tenant=projects/*/locations/*/apps/*/deployments/*}/message:send
Envía un mensaje a un agente.
stream POST /v1/{tenant=projects/*/locations/*/apps/*/deployments/*}/message:stream
Envía un mensaje de transmisión a un agente, lo que permite la interacción en tiempo real y las actualizaciones de estado.

Recurso de REST: v1.projects.locations.apps.examples

Métodos
create POST /v1/{parent=projects/*/locations/*/apps/*}/examples
Crea un ejemplo nuevo en la app determinada.
delete DELETE /v1/{name=projects/*/locations/*/apps/*/examples/*}
Borra el ejemplo especificado.
get GET /v1/{name=projects/*/locations/*/apps/*/examples/*}
Obtiene detalles del ejemplo especificado.
list GET /v1/{parent=projects/*/locations/*/apps/*}/examples
Enumera los ejemplos de la app determinada.
patch PATCH /v1/{example.name=projects/*/locations/*/apps/*/examples/*}
Actualiza el ejemplo especificado.

Recurso de REST: v1.projects.locations.apps.guardrails

Métodos
create POST /v1/{parent=projects/*/locations/*/apps/*}/guardrails
Crea una nueva barandilla en la app determinada.
delete DELETE /v1/{name=projects/*/locations/*/apps/*/guardrails/*}
Borra la protección especificada.
get GET /v1/{name=projects/*/locations/*/apps/*/guardrails/*}
Obtiene los detalles de la protección especificada.
list GET /v1/{parent=projects/*/locations/*/apps/*}/guardrails
Enumera las protecciones de la app determinada.
patch PATCH /v1/{guardrail.name=projects/*/locations/*/apps/*/guardrails/*}
Actualiza la barandilla especificada.

Recurso de REST: v1.projects.locations.apps.message

Métodos
send POST /v1/{tenant=projects/*/locations/*/apps/*}/message:send
Envía un mensaje a un agente.
stream POST /v1/{tenant=projects/*/locations/*/apps/*}/message:stream
Envía un mensaje de transmisión a un agente, lo que permite la interacción en tiempo real y las actualizaciones de estado.

Recurso de REST: v1.projects.locations.apps.sessions

Métodos
generateChatToken POST /v1/{name=projects/*/locations/*/apps/*/sessions/*}:generateChatToken
Genera un token con alcance de sesión para que el widget de chat se autentique con las APIs de sesión.
runSession POST /v1/{config.session=projects/*/locations/*/apps/*/sessions/*}:runSession
Inicia una interacción de un solo turno con el agente de CES dentro de una sesión.
streamRunSession POST /v1/{config.session=projects/*/locations/*/apps/*/sessions/*}:streamRunSession
Inicia una interacción de un solo turno con el agente de CES.

Recurso de REST: v1.projects.locations.apps.tools

Métodos
create POST /v1/{parent=projects/*/locations/*/apps/*}/tools
Crea una herramienta nueva en la app determinada.
delete DELETE /v1/{name=projects/*/locations/*/apps/*/tools/*}
Borra la herramienta especificada.
get GET /v1/{name=projects/*/locations/*/apps/*/tools/*}
Obtiene detalles de la herramienta especificada.
list GET /v1/{parent=projects/*/locations/*/apps/*}/tools
Enumera las herramientas de la app determinada.
patch PATCH /v1/{tool.name=projects/*/locations/*/apps/*/tools/*}
Actualiza la herramienta especificada.

Recurso de REST: v1.projects.locations.apps.toolsets

Métodos
create POST /v1/{parent=projects/*/locations/*/apps/*}/toolsets
Crea un nuevo conjunto de herramientas en la app determinada.
delete DELETE /v1/{name=projects/*/locations/*/apps/*/toolsets/*}
Borra el conjunto de herramientas especificado.
get GET /v1/{name=projects/*/locations/*/apps/*/toolsets/*}
Obtiene los detalles del conjunto de herramientas especificado.
list GET /v1/{parent=projects/*/locations/*/apps/*}/toolsets
Enumera los conjuntos de herramientas de la app determinada.
patch PATCH /v1/{toolset.name=projects/*/locations/*/apps/*/toolsets/*}
Actualiza el conjunto de herramientas especificado.
retrieveTools POST /v1/{toolset=projects/*/locations/*/apps/*/toolsets/*}:retrieveTools
Recupera la lista de herramientas incluidas en el conjunto de herramientas especificado.

Recurso de REST: v1.projects.locations.apps.versions

Métodos
create POST /v1/{parent=projects/*/locations/*/apps/*}/versions
Crea una nueva versión de la app en la app determinada.
delete DELETE /v1/{name=projects/*/locations/*/apps/*/versions/*}
Borra la versión de la app especificada.
get GET /v1/{name=projects/*/locations/*/apps/*/versions/*}
Obtiene detalles de la versión de la app especificada.
getExtendedAgentCard GET /v1/{tenant=projects/*/locations/*/apps/*/versions/*}/extendedAgentCard
Obtiene la tarjeta de agente extendida para el agente autenticado.
list GET /v1/{parent=projects/*/locations/*/apps/*}/versions
Enumera todas las versiones de la app determinada.
patch PATCH /v1/{appVersion.name=projects/*/locations/*/apps/*/versions/*}
Actualiza la versión de la app especificada.
restore POST /v1/{name=projects/*/locations/*/apps/*/versions/*}:restore
Restablece la versión de la app especificada.

Recurso de REST: v1.projects.locations.apps.versions.message

Métodos
send POST /v1/{tenant=projects/*/locations/*/apps/*/versions/*}/message:send
Envía un mensaje a un agente.
stream POST /v1/{tenant=projects/*/locations/*/apps/*/versions/*}/message:stream
Envía un mensaje de transmisión a un agente, lo que permite la interacción en tiempo real y las actualizaciones de estado.

Recurso de REST: v1.projects.locations.operations

Métodos
cancel POST /v1/{name=projects/*/locations/*/operations/*}:cancel
Inicia la cancelación asíncrona de una operación de larga duración.
delete DELETE /v1/{name=projects/*/locations/*/operations/*}
Borra una operación de larga duración.
get GET /v1/{name=projects/*/locations/*/operations/*}
Obtiene el último estado de una operación de larga duración.
list GET /v1/{name=projects/*/locations/*}/operations
Enumera las operaciones que coinciden con el filtro especificado en la solicitud.