Agentes

El agente CX de Dialogflow 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. 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 GCP.
  3. Haz clic en Create Agent.
  4. 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 de un agente una vez que se crea.
  5. Haz clic en Guardar.

API

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# No disponible No disponible
Go No disponible 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 GCP 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:

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 GCP.
  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 del agente Recurso del agente
RPC Interfaz del agente Interfaz del agente
C# No disponible No disponible
Go No disponible 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

    Un nombre legible para tu agente.

  • Zona horaria

    La zona horaria predeterminada del agente.

  • Idioma predeterminado

    El idioma predeterminado que admite el agente.

  • Habilitar Stackdriver Logging

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

  • Habilita el registro de interacciones

    Indica si se deben recopilar y almacenar las consultas de los usuarios finales. Algunas funciones, como los Experimentos, requieren que se habilite esta configuración. Las próximas funciones permitirán explorar estos registros de interacción.

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 para todos los idiomas compatibles con Dialogflow, pero actualmente se limita a regiones específicas.

    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:

    • Estándar: Tecnología estándar de NLU.
    • Avanzado: Tecnología avanzada de CLN. Este tipo de CLN funciona mejor que el estándar, en especial para los agentes y los flujos grandes. El entrenamiento de modelos tarda más, por lo que se inhabilita el entrenamiento automático. Debes entrenar los flujos de forma manual o mediante la API.
  • 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. Esta configuración no se puede habilitar para el tipo de CLU avanzado.

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

  • Entrena CLN

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

Configuración de IVR y voz

Las siguientes opciones de configuración de voz están disponibles:

  • Habilita la adaptación de voz

    Consulta Adaptación de voz automática.

  • Configuración avanzada de voz

    En esta sección, se proporcionan opciones de configuración avanzadas adicionales para las funciones de voz. Puedes activar o desactivar estas opciones de configuración avanzadas. Esta configuración está disponible en la configuración del agente (se aplica a todo el agente)Configuración de flujo (se aplica a todo el flujo y anula la configuración del agente)Configuración de la página (se aplica a la página y anula la configuración de flujo y agente) yconfiguración de las entregas (se aplica a la entrega y anula la configuración de la página, el flujo y el agente). Un subconjunto de estas opciones de configuración está disponible en cada nivel, según la relevancia de la configuración para el nivel.

    • Sensibilidad de voz

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

    • No hay 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. Para este tiempo de espera, Dialogflow invoca un evento sin entrada.

    • Interrupción

      Cuando está habilitada, 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 estuvo en cola por 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 opción de interrupción. En este caso, la integración dejará de reproducir audio para todos los mensajes en cola que tengan habilitada la opción de interrupción.

    • URI de Google Cloud Storage

      Si se proporcionan, las entradas de audio del usuario final se guardarán en el bucket de Cloud Storage.

      Otorga la función de creador de objetos de almacenamiento a las siguientes cuentas de servicio en tu 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 integrada por el socio.

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

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

Si restableces un agente, se reemplazan todos los recursos del agente de destino, excepto el entorno del agente.

Sigue estos pasos para exportar o restablecer un agente:

Console

  1. Abre la consola de Dialogflow CX.
  2. Elige el proyecto de GCP 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 del agente Recurso del agente
RPC Interfaz del agente Interfaz del agente
C# No disponible No disponible
Go No disponible 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, usa la opción de Cloud Storage para exportar y restablecer agentes.

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 GCP 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 del agente Recurso del agente
RPC Interfaz del agente Interfaz del agente
C# No disponible No disponible
Go No disponible No disponible
Java AgentsClient AgentsClient
Node.js AgentsClient AgentsClient
PHP No disponible No disponible
Python AgentsClient AgentsClient
Ruby No disponible No disponible