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.

Crea 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 de almacén de datos o selecciona Crear el tuyo 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 estableciste la configuración de ubicación para tu proyecto, debes configurarla con la consola antes de crear agentes con la API. Actualmente, no puedes configurar la ubicación con la API.

Si quieres 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 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
Rita 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 los 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 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
Rita 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 al formato JSON.
    2. Descomprime el archivo descargado.
    3. Busca el archivo agent.json.
    4. Actualiza los campos defaultLanguageCode y supportedLanguageCodes a los valores deseados.
    5. Restablece el agente en el mismo agente o en uno diferente del paso 1.
    6. Actualiza las frases de entrenamiento y los valores de la entidad específicos del lenguaje 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 registro

    • 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.

  • Exportación a BigQuery

    • Habilitar la exportación a BigQuery

      Indica si la exportación de BigQuery está habilitada.

    • 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 las sugerencias de intents.

  • Plantilla de carga útil personalizada

    En esta sección, puedes crear descripciones y cargas útiles para las plantillas de carga útil personalizada.

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 e 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:

  • Tren 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 IVR y voz

Los siguientes parámetros de configuración de voz e IVR están disponibles:

  • 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 Voz personalizada para tu agente. Para ello, selecciona la opción de voz personalizada en el buzón de selección de voz y especifica el nombre de la voz personalizada en el campo correspondiente. El nombre de voz personalizado 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 tenga el valor "AutoML Predictor" en tu proyecto de voz personalizado.
      • Para llamadas a la API normales, asegúrate de que la cuenta de servicio que se usa para llamar a Dialogflow tenga la función de “Predictor de AutoML” en tu proyecto de voz personalizado.
  • Speech-to-Text

    • Habilitar la adaptación de voz automática

      Consulta Adaptación de voz automática.

    • Configuración de voz avanzada

      En esta sección, se proporciona una configuración avanzada y adicional para las funciones de voz. Puedes activar o desactivar esta configuración avanzada.

      Esta configuración está disponible en la configuración del agente (se aplica a todo el agente), la configuración de flujo (se aplica a todo el flujo y anula la configuración del agente), la configuración de la página (se aplica a la página y anula la configuración del agente y el flujo) y la configuración de entrega (se aplica a la entrega y anula la configuración de la página, el flujo y el agente). Un subconjunto de esta configuración está disponible en cada nivel, según la relevancia de la configuración del nivel.

      La configuración actualizada a nivel del agente no se propaga al nivel del flujo, la página y la entrega cuando la opción Personalizar está seleccionada en estos niveles inferiores. Si la opción Personalizar abarca varias configuraciones y solo deseas actualizar algunas de ellas, es posible que también debas actualizar otras opciones de configuración si quieres que sean iguales a las de nivel de agente.

      • Selección de modelo (Speech-to-Text)

        Configura el modelo de voz que se utiliza para el reconocimiento de voz. Esta configuración es específica de un idioma, por lo que puedes seleccionar modelos diferentes para distintos idiomas. También puedes marcar Anular el modelo de voz a nivel de la solicitud, lo que hará que se use el modelo seleccionado incluso si una llamada a la API del entorno de ejecución especifica un modelo diferente.

        Para la puerta de enlace telefónica de Dialogflow CX, consulta las limitaciones.

        Para obtener más información, consulta Modelos de voz.

      • Sensibilidad al final de la voz

        Controla la sensibilidad para reconocer el final de la voz en la entrada de audio del usuario final. El valor varía de 0 (sensibilidad baja, menos probable que finalice la voz) a 100 (sensibilidad alta, más probable que finalice la voz).

      • Habilitar la sensibilidad de fin de voz avanzada basada en tiempo de espera

        Si se habilita esta configuración, el valor de configuración de Sensibilidad al final de la voz se usa como indicador a fin de establecer un tiempo de espera de silencio relativo de audio para determinar el final de la voz.

        Si esta configuración está inhabilitada (la opción predeterminada), el valor de configuración de Sensibilidad al final de la voz se usa para determinar el final de la voz mediante el modelo de AA que proporciona Google Cloud Speech-To-Text.

        Si bien la configuración de Sensibilidad del final de voz solo admite la etiqueta en-US de idioma de forma predeterminada, la configuración de Habilitar la sensibilidad de fin de voz avanzada basada en tiempo de espera permite configurar la sensibilidad del final de voz para todos los idiomas y modelos de voz compatibles con Dialogflow.

      • Sin tiempo de espera de voz

        El tiempo en segundos durante el cual Dialogflow dejará de esperar la entrada de audio del usuario final. El valor predeterminado es 5 segundos y el valor máximo es 60 segundos. Para este tiempo de espera, Dialogflow invoca un evento de no entrada.

      • Barcazas

        Cuando está habilitado, un usuario final puede interrumpir el audio de respuesta de Dialogflow. Cuando se interrumpe, Dialogflow dejará de enviar audio y procesará la siguiente entrada del usuario final.

        Si hay varios mensajes en la cola de mensajes y un mensaje se puso en cola mediante una entrega asociada con una página, un flujo o un agente que tiene habilitada la interrupción, todos los mensajes siguientes de la cola también tendrán habilitada la interrupción. En este caso, la integración dejará de reproducir el audio de todos los mensajes en cola con la interrupción habilitada.

      • Permitir la cancelación de la reproducción parcial de respuestas

        Cuando se habilita la respuesta parcial, esta configuración permite la cancelación de la reproducción de una respuesta parcial. Si una entrega que permite la cancelación crea un mensaje en la cola de mensajes, la reproducción del mensaje se cancela si se agrega otro mensaje a la cola. Esto es útil cuando quieres que un mensaje inicial inicie la reproducción, pero que esta se cancele si un webhook en funcionamiento produce otro mensaje antes de que se complete la reproducción del mensaje inicial.

      • Bucket de exportación de audio

        Si se proporciona, todos los datos de audio asociados con una solicitud se guardarán en el bucket de Cloud Storage:

        Se guardó el audio Solicitudes aplicables
        Entrada de audio del usuario final DetectIntent, StreamingDetectIntent, AnalyzeContent, StreamingAnalyzeContent
        Audio de texto a voz (TTS) sintetizado para una respuesta AnalyzeContent, StreamingAnalyzeContent

        Otorga la función creador de objetos de almacenamiento a las siguientes cuentas de servicio del proyecto:

        • A la cuenta de servicio con el formato one-click@df-cx-ALPHANUMERIC_VALUE-ALPHANUMERIC_VALUE.iam.gserviceaccount.com si usas una integración de telefonía incorporada para socios.

        • A la cuenta de servicio con el formato service-PROJECT_NUMBER@gcp-sa-dialogflow.iam.gserviceaccount.com si usas la integración de la Puerta de enlace telefónica de Dialogflow CX. Para encontrar esta cuenta de servicio en IAM, marca la opción Incluir asignaciones de funciones proporcionadas por Google.

      • DTMF: Consulta DTMF para integraciones de telefonía.

Multimodal

Consulta Llamada complementaria.

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.

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.

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

  • Versiones de flujo: Solo los flujos de 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 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, siempre que existan los entornos asociados. Sin embargo, estas versiones de flujo inactivas no se enumeran ni son versiones de flujo seleccionables para el agente.
  • Apps de Vertex AI Conversation: La asociación con una app de Vertex AI Conversation App 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 necesita tener una asociación con una app de conversación de Vertex AI.
  • Almacenes de datos de conversaciones de Vertex AI: Todas las referencias a los almacenes de datos se reemplazarán en el agente de destino de acuerdo con 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 solucionar este problema, puedes crear 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 indicará cómo 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 después del restablecimiento: el ID y la ubicación del proyecto de Google Cloud se actualizarán para que coincidan con la app del agente de destino. El ID de colección y el ID del almacén de datos no se modificarán. Esto significa que debes agregar almacenes de datos para todos los ID 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 al almacén de datos resultante en el agente de destino se convertirá en la siguiente: projects/321/locations/us-east1/collections/default_collection/dataStores/myDataStore1

Cuando exportes, puedes seleccionar el formato de archivo de exportación. Si usas el control de versiones de control de fuente para los datos de tu agente, debes exportar en el formato JSON. Cuando restableces un agente, Dialogflow 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.

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 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
Rita 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, también consulta la guía de exportación y 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 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
Rita No disponible No disponible

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