Agentes

R Agente de agentes de conversación (Dialogflow CX) es un agente virtual que maneje 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. Los agentes de agentes conversacionales (Dialogflow CX) se crean y diseñan para manejar los tipos de conversaciones requeridas para tu sistema.

Un agente de agentes de conversación (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 uno. 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 del almacén de datos o selecciona Crea uno propio 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.

Para 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 conversación (Dialogflow CX) funcionan 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 restablecer un agente con ese archivo.

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

• Versiones de flujo: Solo los flujos en borrador se exportan al archivo.
• Entornos: Los entornos personalizados no se exportan al 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. Versiones de flujo a las que hacen referencia los entornos personalizados en el agente de destino seguirán existiendo, mientras existan los entornos asociados. Sin embargo, estas versiones de flujo inactivas no se muestran ni se pueden seleccionar para el agente.
• Apps de agentes de Vertex AI: La asociación con una app de agentes de Vertex AI no se modifica en el agente de destino. (En otras palabras, el valor de engine en GenAppBuilderSettings) Esto significa que los agentes del almacén de datos solo se pueden restablecer en otros agentes de almacén de datos existentes, ya que el agente resultante también necesita 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 los 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 aplicación, no es posible restablecer un agente que tenga referencias al almacén de datos. Si intentas hacerlo, obtendremos resultados un mensaje de error. Para solucionar ese problema, puedes hacer lo siguiente: Crea un agente de almacén de datos nuevo 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 que agregues una aplicación asociada a tu agente).
  • Si el agente de destino está asociado con una app, todos los almacén de datos las referencias se actualizarán luego del restablecimiento: el ID del proyecto de Google Cloud y se actualizará para que coincida 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 que tengan 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, se puede La app de agentes de Vertex AI se llama GenAppBuilder Engine. 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 exportas, puedes 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, Los agentes de conversación (Dialogflow CX) determinan 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 de 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 el Guía de exportación o 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 de 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 borrar tu proyecto Todos los agentes de Conversational Agents (Dialogflow CX) y los datos asociados con el proyecto se borran de inmediato.