Agentes

Un agente de 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. Dialogflow traduce 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 Dialogflow se crea y diseña a fin de manejar los tipos de conversaciones requeridas para tu sistema.

Un agente de Dialogflow es similar a un agente de un centro de llamadas humano. 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

  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 lo has configurado configuración de ubicación para tu proyecto, debes configurar estos parámetros con la consola antes de crear agentes con la API. Actualmente, no puedes establecer la configuración de 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 de agente Recurso de 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 Dialogflow sirven como contenedores de un 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:

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

Configuración de agentes

Para acceder a la configuración del agente:

Console

  1. Abre la consola de Dialogflow CX.
  2. Elige tu proyecto de Google Cloud.
  3. Selecciona el agente.
  4. Haz clic en Configuración del agente.
  5. Actualiza la configuración como desees.
  6. Haz clic en Guardar.

API

Consulta los métodos get y patch/update para el 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 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

En las siguientes subsecciones, se describen las diferentes categorías de la configuración del agente.

Configuración general

Las siguientes opciones de configuración general están disponibles para los agentes:

  • Nombre visible

    Es el nombre legible para tu agente.

  • Zona horaria

    La zona horaria predeterminada del agente.

  • Idioma predeterminado

    El idioma predeterminado que admite el agente. Una vez que se crea un agente, no se puede cambiar el idioma predeterminado. Sin embargo, puedes hacer lo siguiente:

    1. Exporta tu agente a la Formato JSON:
    2. Descomprime el archivo descargado.
    3. Busca el archivo agent.json.
    4. Actualiza defaultLanguageCode y supportedLanguageCodes con los valores deseados.
    5. Restablecer el agente al mismo o a uno diferente del paso 1.
    6. Actualiza las frases de entrenamiento específicas de cada idioma y los valores de las entidades según sea necesario.

  • Bloqueo del agente

    • Bloquea el agente

      Indica si el agente está bloqueado. No se puede editar un agente bloqueado.

  • Configuración de Logging

    • Habilita Cloud Logging

      Indica si el registro de Cloud está habilitado para el agente.

    • Habilitar el registro de interacciones

      Indica si deseas que Google recopile y almacene consultas de usuario final ocultas para mejorar la calidad.

    • Habilita la ocultación de entradas de usuarios finales basada en el consentimiento

      Si este parámetro de configuración está habilitado, te permite usar un parámetro de sesión especial para controlar si la entrada y los parámetros del usuario final se ocultan del historial de conversaciones y de Cloud Logging. De forma predeterminada, el parámetro de sesión es true. Si se inhabilita esta configuración, no se ocultará ningún elemento.

      El consentimiento del usuario se recopila mediante un parámetro de sesión booleano: $session.params.conversation-redaction. Si se habilita este parámetro de configuración y el parámetro de sesión se establece en false, no se ocultará ningún elemento (se seguirán aplicando otras estrategias de ocultamiento). Si se habilita esta configuración y el parámetro de sesión se establece en true, se ocultará.

      Un ejemplo de flujo de solicitud de consentimiento podría ser: primero, preguntar al usuario si desea conservar la entrada del usuario final y hacer coincidir la respuesta con dos intents, uno es "sí, intent" y la otra es "sin intent". Luego, establece el parámetro de sesión en false (sin ocultamiento) en los ajustes predeterminados del parámetro del "intent de sí". ruta en entrega y a true (se oculta) en el ajuste predeterminado del parámetro de la operación ruta.

  • Exportación de BigQuery

    • Habilita la exportación a BigQuery

      Indica si Exportación de BigQuery esté habilitado.

    • Conjunto de datos de BigQuery

      El nombre del conjunto de datos de BigQuery.

    • Tabla de BigQuery

      El nombre de la tabla de BigQuery.

  • Sugerencias de intents

    Puedes habilitar Sugerencias de intents.

  • Plantilla de carga útil personalizada

    En esta sección puedes crear descripciones y cargas útiles plantillas de carga útil personalizadas.

Configuración del AA

Dialogflow usa algoritmos de aprendizaje automático (AA) para comprender las entradas del usuario final, hacerlas coincidir con intents y extraer datos estructurados. Dialogflow aprende de las frases de entrenamiento que le proporcionas y de los modelos de lenguaje compilados en Dialogflow. A partir de estos datos, compila un modelo para tomar decisiones sobre qué intent debe coincidir con determinada entrada del usuario final. Puedes aplicar opciones de configuración únicas del AA en cada flujo de un agente. El modelo que creó Dialogflow es único para cada flujo.

Las siguientes opciones de configuración del AA de todo el agente están disponibles:

  • Permite que el AA corrija la ortografía

    Si esta función está habilitada y la entrada del usuario final tiene un error ortográfico o gramatical, se establecerá la coincidencia con un intent como si se hubiera escrito correctamente. La respuesta del intent de detección contendrá la entrada del usuario final corregida. Por ejemplo, si un usuario final ingresa "Quiero una manzaana", se procesará como si hubiera escrito "Quiero una manzana". Esto también se aplica a las coincidencias que involucran entidades personalizadas y del sistema.

    La corrección ortográfica está disponible en alemán, español, francés, inglés y italiano. Está disponible en todas las regiones de Dialogflow CX.

    Advertencias y prácticas recomendadas:

    • La corrección ortográfica no puede corregir errores de ASR (reconocimiento de voz automático), por lo que no recomendamos habilitarla para agentes que usen entradas de ASR.
    • Es posible que la entrada corregida coincida con un intent equivocado. Esto puede solucionarse agregando frases habituales con coincidencias incorrectas a los ejemplos negativos.
    • La corrección ortográfica aumenta levemente el tiempo de respuesta del agente.
    • Si se define a un agente con jerga específica de un dominio, es posible que las correcciones no sean adecuadas.

Las siguientes opciones de configuración del AA específicas para los flujos están disponibles:

  • Tipo de CLN

    Puede ser uno de los siguientes:

  • Entrenamiento automático

    Si está habilitado, el flujo se entrena cada vez que se actualiza con la consola. En flujos grandes, esto puede causar retrasos en la IU de la consola, por lo que debes inhabilitar esta configuración y realizar el entrenamiento de forma manual según sea necesario.

  • Umbral de clasificación

    A fin de filtrar los resultados falsos positivos y obtener una variedad de entradas de lenguaje natural coincidentes para tu agente, puedes ajustar el umbral de clasificación de aprendizaje automático. Esta configuración controla la confianza de detección de intents mínima requerida para una coincidencia de intents.

    Si la puntuación de confianza de una coincidencia de intent es menor que el valor límite, se invocará un evento de no coincidencia.

  • Estado del entrenamiento

    Indica si el flujo se entrenó desde la última actualización de los datos del flujo.

  • Entrenar CLN

    Usa este botón para entrenar el flujo de forma manual.

Configuración de la IA generativa

Están disponibles las siguientes opciones de configuración de la IA generativa:

Configuración de IVR y voz

Están disponibles los siguientes parámetros de configuración de voz e IVR:

  • Texto a voz

    • Selección de voz

      Puedes seleccionar el idioma y la voz que se usan para la síntesis de voz.

      Puedes habilitar la opción Voz personalizada para para tu agente seleccionando la opción de voz personalizada dropbox de selección y especifica el nombre de la voz personalizada en el . El nombre de la voz personalizada debe seguir el siguiente patrón: projects/PROJECT_ID/locations/LOCATION/models/MODEL_NAME

      • Si usas una puerta de enlace de telefonía, asegúrate de que la cuenta de servicio del agente de servicio de Dialogflow service-PROJECT_NUMBER@gcp-sa-dialogflow.iam.gserviceaccount.com se otorga con “AutoML Predictor” en tu proyecto de voz personalizado.
      • Para las llamadas a la API normales, asegúrate de que la cuenta de servicio que usas para llamar a Dialogflow tenga asignada la función “AutoML Predictor” en tu proyecto de voz personalizado.

  • Speech-to-Text

DTMF

Consulta DTMF para integraciones de telefonía para más información.

Multimodal

Consulta Complementario de llamadas.

Configuración de uso compartido

Consulta Control de acceso.

Configuración de idiomas

Agrega asistencia adicional de idiomas a tu agente. Para ver la lista completa de los idiomas, consulta la referencia de idiomas.

Detección automática de idioma

Cuando configuras detección automática de idiomas, tu agente de chat detectará automáticamente el idioma del usuario final y cambiará ese idioma. Consulta la documentación sobre la detección automática de idiomas para conocer los detalles.

Configuración de seguridad

Consulta Configuración de seguridad.

Configuración avanzada

En la actualidad, la única configuración avanzada es para el análisis de opiniones.

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.

El restablecimiento de un agente reemplaza todos los datos del agente de destino. (incluidas todas las versiones de flujo), excepto por lo siguiente:

  • 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 enumeran ni se pueden seleccionar. de flujo de trabajo 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 controlador de estado que se les asigna. 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. El El ID de colección y el ID de almacén de datos no se modificarán. 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 se convertirá en: projects/321/locations/us-east1/collections/default_collection/dataStores/myDataStore1

Cuando exportas, puedes seleccionar el formato de archivo de exportación. Si usas el control de versiones de control de origen para los datos de tu agente, deberías exportar en formato JSON. Cuando restableces un agente, Dialogflow determina automáticamente el formato del 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.

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 de agente Recurso de 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 el Guía de exportación o restablecimiento 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

  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.

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

Protocolo V3 V3beta1
REST Recurso de agente Recurso de 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 borrar tu proyecto Todos los agentes y datos de Dialogflow CX asociados con el proyecto se borran de inmediato.

Anterior
Información general sobre la consola
Siguiente
Agentes multilingües