Agentes

Un agente de agentes de conversación (Dialogflow CX) es un agente virtual que controla las conversaciones simultáneas con tus usuarios finales. Es un módulo de comprensión del lenguaje natural que comprende los matices del lenguaje humano. Los agentes conversacionales (Dialogflow CX) traducen el texto o el audio del usuario final durante una conversación a datos estructurados que tus apps y servicios pueden comprender. Un agente de agentes conversacionales (Dialogflow CX) se crea y diseña para manejar los tipos de conversaciones requeridas para tu sistema.

Un agente de agentes conversacionales (Dialogflow CX) es similar a un agente humano de un centro de llamadas. Lo entrenas para que se encargue de las situaciones de conversación esperadas; el entrenamiento no tiene que ser demasiado explícito.

Crear un agente

Nota: Puedes crear varios agentes de conversación (Dialogflow CX) para un proyecto de Google Cloud.

Para crear un agente, haz lo siguiente:

Console

1. Abre la consola de Dialogflow CX.
2. Crea o elige un proyecto de Google Cloud.
3. Haz clic en Create Agent.
4. Selecciona Generar automáticamente para crear un agente de almacén de datos o Crea tu propio agente para crear otros tipos de agentes.
5. Completa el formulario de configuración básica del agente.
   1. Puedes elegir cualquier nombre visible.
   2. Selecciona tu ubicación preferida. Haz clic en el botón Edit si deseas cambiar la configuración de la ubicación avanzada.
   3. Selecciona tu zona horaria preferida.
   4. Selecciona el idioma predeterminado para tu agente. No puedes cambiar el idioma predeterminado para un agente una vez que se crea.
6. Haz clic en Guardar.

API

Si aún no configuraste la configuración de ubicación para tu proyecto, debes configurarla con la consola antes de crear agentes con la API. Por el momento, no puedes configurar la configuración de ubicación con la API.

Si quieres crear un agente, consulta el método create para el tipo Agent. Ir a la referencia de la API de agente

Selecciona un protocolo y una versión para la Referencia del agente:

Protocolo	V3	V3beta1
REST	Recurso del agente	Recurso del agente
RPC	Interfaz del agente	Interfaz del agente
C++	AgentsClient	No disponible
C#	AgentsClient	No disponible
Go	AgentsClient	No disponible
Java	AgentsClient	AgentsClient
Node.js	AgentsClient	AgentsClient
PHP	No disponible	No disponible
Python	AgentsClient	AgentsClient
Ruby	No disponible	No disponible

Cerrar

Datos del agente

Los agentes de agentes conversacionales (Dialogflow CX) sirven como contenedores de nivel superior para la configuración y los datos de los agentes virtuales.

Sigue estos pasos para acceder a los datos de un agente:

Console

1. Abre la consola de Dialogflow CX.
2. Elige el proyecto de Google Cloud para el agente.
3. Busca el agente en la lista.
4. Haz clic en el nombre visible del agente.
5. Actualiza los flujos, las páginas, etc., como se describe en otras guías.

API

Consulta las guías para obtener los datos que deseas actualizar.

Los siguientes datos están asociados con los agentes:

• Intents
• Tipos de entidad
• Webhooks
• Flows
• Pages
• Grupos de rutas

Para obtener más información sobre cómo se aplican los datos en diferentes niveles, consulta los niveles de aplicación de datos.

Exporta y restablece un agente

Puedes exportar un agente a un archivo y, luego, restablecerlo con ese archivo.

Una exportación de agentes incluye todos los datos del agente, excepto los siguientes:

• Versiones de flujo: Solo los flujos de borrador se exportan a un archivo.
• Entornos: Los entornos personalizados no se exportan a un archivo.

Un restablecimiento de agente reemplaza todos los datos del agente de destino (incluidas todas las versiones de flujo), excepto los siguientes:

• Entornos: Todos los entornos personalizados no se modifican en el agente de destino. Las versiones de flujo a las que hacen referencia los entornos personalizados en el agente de destino seguirán existiendo, siempre que existan los entornos asociados. Sin embargo, estas versiones de flujo inactivas no se muestran ni se pueden seleccionar para el agente.
• Apps de Vertex AI Agents: La asociación con una app de Vertex AI Agents no cambia en el agente de destino. (en otras palabras, el valor de engine en GenAppBuilderSettings). Esto significa que los agentes de almacén de datos solo se pueden restablecer en otros agentes de almacén de datos existentes, ya que el agente resultante también debe tener una asociación con una app de agentes de Vertex AI.

• Almacenes de datos de los agentes de Vertex AI: Todas las referencias a almacenes de datos se reemplazarán en el agente de destino según las siguientes reglas:

  • Si el agente de destino no está asociado con una app, no es posible restablecer un agente con referencias de almacén de datos. Si intentas hacerlo, se mostrará un mensaje de error. Para solucionarlo, puedes crear un nuevo agente de almacén de datos desde cero. Como alternativa, puedes convertir tu agente existente en un agente de almacén de datos si le agregas un controlador de estado de almacén de datos. En este caso, se te guiará para agregar una app asociada a tu agente).
  • Si el agente de destino está asociado con una app, todas las referencias del almacén de datos se actualizarán durante el restablecimiento: su ID del proyecto de Google Cloud y su ubicación se actualizarán para que coincidan con la app del agente de destino. No cambiarán el ID de colección ni el ID del almacén de datos. Esto significa que debes agregar almacenes de datos para todos los IDs con tipos coincidentes en la app del agente de destino antes de la operación de restablecimiento.

  Ejemplo: Si el agente de origen hace referencia a un almacén de datos llamado projects/123/locations/eu-west2/collections/default_collection/dataStores/myDataStore1 y la app del agente de destino se llama projects/321/locations/us-east1/collections/default_collections/engines/app123, la referencia del almacén de datos resultante en el agente de destino será projects/321/locations/us-east1/collections/default_collection/dataStores/myDataStore1.

Nota: En la API y en el contenido de los datos exportados, una app de agentes de Vertex AI se denomina motor de GenAppBuilder. Por ejemplo, en un paquete JSON exportado, puedes encontrar el nombre del motor en el archivo agent.json, debajo de la clave genAppBuilderSettings.engine.

Cuando exportes, podrás seleccionar el formato de archivo de exportación. Si usas el control de versiones del control de código fuente para tus datos de agentes, debes exportarlos en formato JSON. Cuando restableces un agente, Agentes conversacionales (Dialogflow CX) determina automáticamente el formato de archivo.

Sigue estos pasos para exportar o restablecer un agente:

Console

1. Abre la consola de Dialogflow CX.
2. Elige el proyecto de Google Cloud para el agente.
3. Haz clic en el menú de opción de un agente de la lista.
4. Haz clic en el botón para exportar o restablecer.
5. Sigue las instrucciones para finalizar.

Nota: Para restablecer un agente de almacén de datos, asegúrate de que el agente de destino se haya creado como un agente de almacén de datos.

API

Consulta los métodos export y restore para el tipo Agent. Ir a la referencia de la API de agente

Selecciona un protocolo y una versión para la Referencia del agente:

Protocolo	V3	V3beta1
REST	Recurso del agente	Recurso del agente
RPC	Interfaz del agente	Interfaz del agente
C++	AgentsClient	No disponible
C#	AgentsClient	No disponible
Go	AgentsClient	No disponible
Java	AgentsClient	AgentsClient
Node.js	AgentsClient	AgentsClient
PHP	No disponible	No disponible
Python	AgentsClient	AgentsClient
Ruby	No disponible	No disponible

Cerrar

Si el tamaño del agente excede el límite máximo, usa la opción de Cloud Storage para la exportación y el restablecimiento del agente.

Si usas GitHub, consulta también la guía de exportación y restablecimiento de GitHub.

Borra un agente

Precaución: La acción de borrar un agente no se puede deshacer. Exporta el agente para tener una copia de seguridad si es necesario.

Para borrar un agente, necesitas una función que proporcione acceso completo o acceso de edición. Consulta la guía de control de acceso para obtener más información.

Para borrar un agente, sigue estos pasos:

Console

1. Abre la consola de Dialogflow CX.
2. Elige el proyecto de Google Cloud para el agente.
3. Haz clic en el menú de opción de un agente de la lista.
4. Haz clic en el botón Borrar.
5. Confirma la eliminación en el cuadro de diálogo.

API

Consulta el método delete para el tipo Agent. Ir a la referencia de la API de agente

Selecciona un protocolo y una versión para la Referencia del agente:

Protocolo	V3	V3beta1
REST	Recurso del agente	Recurso del agente
RPC	Interfaz del agente	Interfaz del agente
C++	AgentsClient	No disponible
C#	AgentsClient	No disponible
Go	AgentsClient	No disponible
Java	AgentsClient	AgentsClient
Node.js	AgentsClient	AgentsClient
PHP	No disponible	No disponible
Python	AgentsClient	AgentsClient
Ruby	No disponible	No disponible

Cerrar

Si borras tu proyecto, todos los agentes y datos de agentes de conversación (Dialogflow CX) asociados con el proyecto se borrarán de inmediato.