Un agente de Conversational Agents (Dialogflow CX) es un agente virtual que maneja 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 Conversational Agents (Dialogflow CX) se crea y diseña a fin de manejar los tipos de conversaciones requeridas para tu sistema.
Un agente de Conversational Agents (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
Para crear un agente, haz lo siguiente:
Console
- Abre la consola de Dialogflow CX.
- Crea o elige un proyecto de Google Cloud.
- Haz clic en Create Agent.
- Selecciona Generar automáticamente para crear un agente de almacén de datos o selecciona Crea tu propio para crear otros tipos de agentes.
- Completa el formulario de configuración básica del agente.
- Puedes elegir cualquier nombre visible.
- Selecciona tu ubicación preferida. Haz clic en el botón Edit si deseas cambiar la configuración de la ubicación avanzada.
- Selecciona tu zona horaria preferida.
- Selecciona el idioma predeterminado para tu agente. No puedes cambiar el idioma predeterminado para un agente una vez que se crea.
- Haz clic en Guardar.
API
Si aún no configuraste la configuración de ubicación para tu proyecto, debes hacerlo con la consola antes de crear agentes con la API. Actualmente, no puedes configurar la ubicación con la API.
Para crear un agente, consulta el método create
para el tipo Agent
.
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 |
Datos del agente
Los agentes de Conversational Agents (Dialogflow CX) sirven como contenedores de nivel superior para la configuración y los datos de los agentes virtuales. Los siguientes datos están asociados con los agentes:
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 restablecerlo con ese archivo.
La exportación de un agente incluye todos los datos del agente, excepto los siguientes:
- Versiones del flujo: Solo se exportan los flujos de borrador al archivo.
- Entornos: Los entornos personalizados no se exportan al archivo.
Cuando se restablece un agente, se reemplazan todos los datos del agente de destino (incluidas todas las versiones del flujo), excepto los siguientes:
- Entornos: Todos los entornos personalizados permanecen sin cambios 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 mientras existan los entornos asociados. Sin embargo, estas versiones obsoletas del flujo no se muestran ni se pueden seleccionar para el agente.
- Apps de Vertex AI Agents:
La asociación a una app de Vertex AI Agents permanece sin cambios 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 del almacén de datos existentes, ya que el agente resultante también debe tener una asociación con una app de Vertex AI Agents. 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 app, no es posible restablecer un agente con referencias al almacén de datos. Si intentas hacerlo, se mostrará un mensaje de error. Para solucionar este problema, puedes crear un nuevo agente de almacén de datos desde cero. (También puedes convertir tu agente existente en un agente de almacén de datos agregándole 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 a una app, todas las referencias del almacén de datos se actualizarán cuando se restablezcan: se actualizarán su ID y ubicación del proyecto de Google Cloud para que coincidan con la app del agente de destino. El ID de la colección y el ID del almacén de datos no cambiarán. 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 fuente 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 llamaprojects/321/locations/us-east1/collections/default_collections/engines/app123
, la referencia al almacén de datos resultante en el agente de destino será la siguiente:projects/321/locations/us-east1/collections/default_collection/dataStores/myDataStore1
Cuando exportes, podrás seleccionar el formato del archivo de exportación. Si usas el control de versiones del código fuente para los datos de tu agente, debes exportarlos en formato JSON. Cuando restableces un agente, Conversational Agents (Dialogflow CX) determina automáticamente el formato del archivo.
Sigue estos pasos para exportar o restablecer un agente:
Console
- Abre la consola de Dialogflow CX.
- Elige el proyecto de Google Cloud para el agente.
- Haz clic en el menú de opción more_vert de un agente de la lista.
- Haz clic en el botón para exportar o restablecer.
- Sigue las instrucciones para finalizar.
API
Consulta los métodos export
y restore
para el tipo Agent
.
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 |
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 restauración de GitHub.
Borra un agente
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
- Abre la consola de Dialogflow CX.
- Elige el proyecto de Google Cloud para el agente.
- Haz clic en el menú de opción more_vert de un agente de la lista.
- Haz clic en el botón deleteBorrar.
- Confirma la eliminación en el cuadro de diálogo.
API
Consulta el método delete
para el tipo Agent
.
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 |
Si borras tu proyecto, se borrarán de inmediato todos los agentes de Conversational Agents (Dialogflow CX) y los datos asociados con el proyecto.