Se usó la API de Cloud Translation para traducir esta página.
Switch to English

Agents

Un agente de Dialogflow CX es un agente virtual que maneja las conversaciones 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.
    5. De manera opcional, habilita Stackdriver Logging.
  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. Haga clic en Save.

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 Cloud Logging está habilitado para el agente.

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 admitidos en Dialogflow.

    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 adicionales y avanzadas para las funciones de voz. Esta configuración solo se aplica a las integraciones de telefonía y a las integraciones de socios especializadas. 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) y configuración de la página (se aplica a la página y anula la configuración del flujo y del agente). Puedes activar y desactivar estas opciones de configuración avanzada.

    • Fin de sensibilidad del habla

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

    • Sin tiempo de espera de voz

      El tiempo en segundos durante el que 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.

    • Inicio de banda

      Cuando se habilita, 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.

    • URI de Google Cloud Storage

      Si se proporciona, el audio de la respuesta de Dialogflow se guardará en el depósito de Cloud Storage.

Configuración de uso compartido

Consulta Control de acceso.

Configuración de la versión

Consulta Versiones y entornos.

Configuración del entorno

Consulta Versiones y entornos.

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 avanzada

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

Configuración de seguridad

Puedes aplicar opciones de configuración de seguridad específicas del agente para controlar el ocultamiento de datos y la retención de datos. Para establecer la configuración de seguridad, haz lo siguiente:

Console

API

Consulta el campo security_settings 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

Exporta y restablece un 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 opciones para 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

Borra un agente

Para borrar un agente, necesitas una función Propietario del proyecto de IAM, Editor de proyecto de IAM o Administrador de agente de Dialogflow que proporciona "acceso completo". 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 opciones para 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