Agentes

Un agente conversacional (Dialogflow CX) es un agente virtual que gestiona conversaciones simultáneas con tus usuarios finales. Es un módulo de comprensión del lenguaje natural que entiende los matices del lenguaje humano. Los agentes conversacionales (Dialogflow CX) traducen el texto o el audio de los usuarios finales durante una conversación en datos estructurados que tus aplicaciones y servicios pueden entender. Diseñas y creas un agente de Conversational Agents (Dialogflow CX) para gestionar los tipos de conversaciones que requiere tu sistema.

Un agente de Conversational Agents (Dialogflow CX) es similar a un agente humano de un centro de llamadas. Entrénalos a ambos para que gestionen las situaciones de conversación previstas. No es necesario que el entrenamiento sea demasiado explícito.

Crear un agente

Para crear un agente, sigue estos pasos:

Consola

  1. Abre la consola de Dialogflow CX.
  2. Crea o elige un proyecto de Google Cloud.
  3. Haz clic en Crear agente.
  4. Selecciona Generar automáticamente para crear un agente de almacenamiento de datos o Crea el tuyo para crear otros tipos de agentes.
  5. Rellena el formulario de configuración básica del agente:
    1. Puedes elegir el nombre visible que quieras.
    2. Selecciona la ubicación que prefieras. Haz clic en el botón Editar si quieres cambiar los ajustes de ubicación avanzados.
    3. Selecciona la zona horaria que prefieras.
    4. Selecciona el idioma predeterminado de tu agente. No puedes cambiar el idioma predeterminado de un agente una vez que se haya creado.
  6. Haz clic en Guardar.

API

Si aún no has configurado los ajustes de ubicación de tu proyecto, debes hacerlo con la consola antes de crear agentes con la API. Actualmente, no puedes configurar los ajustes de ubicación con la API.

Para crear un agente, consulta el método create del tipo Agent.

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

Protocolo V3 V3beta1
REST Recurso de agente Recurso de agente
RPC Interfaz de agente Interfaz de 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) actúan como contenedores de nivel superior para la configuración y los datos de los agentes virtuales. Los siguientes datos están asociados a los agentes:

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

Exportar y restaurar un agente

Puedes exportar un agente a un archivo y restaurar un agente con ese archivo.

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

Al restaurar un agente, se sobrescriben todos los datos del agente de destino (incluidas todas las versiones del flujo), excepto los siguientes:

  • Entornos: Todos los entornos personalizados se mantienen sin cambios en el agente de destino. Las versiones de flujo a las que hagan referencia los entornos personalizados del 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.
  • Aplicaciones de agentes de Vertex AI: La asociación a una aplicación de agentes de Vertex AI no cambia en el agente de destino. Es decir, el valor de engine en GenAppBuilderSettings. Esto significa que los agentes de almacén de datos solo se pueden restaurar en otros agentes de almacén de datos, ya que el agente resultante también debe tener una asociación con una aplicación de agentes de Vertex AI.
  • Almacenes de datos de agentes de Vertex AI: Todas las referencias a almacenes de datos se sobrescribirán en el agente de destino según las siguientes reglas:

    • Si el agente de destino no está asociado a una aplicación, no se podrá restaurar un agente con referencias de almacén de datos en él. Si lo intentas, se mostrará un mensaje de error. Para solucionarlo, puedes crear un agente de almacén de datos desde cero. También puedes convertir tu agente en un agente de almacén de datos añadiéndole un gestor de estado. En este caso, se te guiará para añadir una aplicación asociada a tu agente.
    • Si el agente de destino está asociado a una aplicación, todas las referencias de almacén de datos se actualizarán al restaurar: su ID de proyecto de Google Cloud y su ubicación se actualizarán para que coincidan con la aplicación del agente de destino. El ID de colección y el ID de almacén de datos no cambiarán. Esto significa que debes añadir almacenes de datos para todos los IDs con tipos coincidentes en la aplicación del agente de destino antes de la operación de restauración.

    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 aplicación del agente de destino se llama projects/321/locations/us-east1/collections/default_collections/engines/app123, la referencia al almacén de datos resultante en el agente de destino será: projects/321/locations/us-east1/collections/default_collection/dataStores/myDataStore1

Al exportar, puedes seleccionar el formato de archivo de exportación. Si utilizas el control de versiones de código fuente para los datos de tu agente, debes exportarlos en formato JSON. Cuando restauras un agente, Conversational Agents (Dialogflow CX) determina automáticamente el formato del archivo.

Para exportar o restaurar un agente, sigue estos pasos:

Consola

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

API

Consulta los métodos export y restore del tipo Agent.

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

Protocolo V3 V3beta1
REST Recurso de agente Recurso de agente
RPC Interfaz de agente Interfaz de 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 supera el límite máximo, utiliza la opción de Cloud Storage para exportar y restaurar el agente.

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

Eliminar un agente

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

Para eliminar un agente, sigue estos pasos:

Consola

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

API

Consulta el método delete del tipo Agent.

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

Protocolo V3 V3beta1
REST Recurso de agente Recurso de agente
RPC Interfaz de agente Interfaz de 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 eliminas tu proyecto, se eliminarán inmediatamente todos los agentes y datos de agentes conversacionales (Dialogflow CX) asociados al proyecto.