Configuración de agentes

En esta página, se describen las distintas opciones de configuración que puedes aplicar a un agente. Para tener acceso a la configuración, sigue estos pasos:

  1. Ve a la consola de Dialogflow ES.
  2. Selecciona tu agente cerca de la parte superior del menú de la barra lateral izquierda.
  3. Haz clic en el botón de configuración  que se encuentra junto al nombre del agente.

Edición del agente

De forma predeterminada, los agentes se crean para Dialogflow Trial Edition. Para cambiar la edición de un agente, sigue estos pasos:

Consola

  1. Desplázate hasta la parte inferior del menú de la barra lateral izquierda, en el que se muestra la edición del agente.
  2. Haz clic en el vínculo Editar o Actualizar.
  3. Selecciona un plan

API

Llama al método setAgent para el proyecto de recursos. Proporciona "TIER_ENTERPRISE" al campo tier para actualizar a la edición Dialogflow Essentials o "TIER_STANDARD" a la versión de prueba de Dialogflow.

Si usas varios proyectos, el proyecto de consumidor se usa para determinar la edición de quotas y cargos.

General

Para acceder a la configuración general, haz clic en la pestaña General.

Podrás configurar los siguientes parámetros:

  • Descripción: la descripción del agente
  • Zona horaria predeterminada: la zona horaria predeterminada del agente Las solicitudes de fecha y hora se resuelven con esta zona horaria si no se proporciona la zona horaria en las solicitudes a la API.
  • URI del avatar del agente: Un URI para el avatar de tu agente que usan algunas integraciones.
  • Proyecto de Google: El proyecto de GCP vinculado al agente.
  • Versión del protocolo de webhook de agentes: solo visible en los agentes heredados de la API de V1. Te permite cambiar al formato webhook de la API de V2.
  • Funciones Beta: Activa o desactiva las funciones Beta del agente.
  • Configuración de registros (Log Settings):

    • Registra interacciones en Dialogflow:

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

    • Registra interacciones en Google Cloud:

      Indica si el registro de Cloud está habilitado para el agente. Esta opción solo está disponible si Registrar interacciones en Dialogflow está habilitada. Si se inhabilita el registro de Dialogflow, también se inhabilitará esta configuración. También puedes hacer clic en el vínculo Abrir registros para abrir los registros de tu agente en Cloud Logging.

  • Borrar agente: Borra por completo el agente y no se puede deshacer. Si el agente se comparte con otros usuarios, debes quitar esos usuarios del agente para poder borrarlo. Consulta Administración de agentes.

Idiomas

Para acceder a la configuración de idioma, haz clic en la pestaña Idioma.

Puedes establecer el idioma predeterminado y varios idiomas adicionales. En algunos idiomas raíz, también puedes agregar una o más configuraciones regionales. Para obtener más información, consulta Agentes multilingües.

Configuración de AA (aprendizaje automático)

Si deseas acceder a la configuración de aprendizaje automático, haz clic en la pestaña ML Settings.

Los agentes de Dialogflow usan algoritmos de aprendizaje automático para comprender las expresiones del usuario final, hacerlas coincidir con intents y extraer datos estructurados. Un agente aprende de las frases de entrenamiento que le suministras 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 expresión del usuario final. Ese modelo es único para tu agente.

Según la configuración predeterminada, Dialogflow actualiza el modelo de aprendizaje automático de tu agente cada vez que modificas los intents y las entidades, así como cuando importas, restableces o entrenas un agente.

Podrás configurar los siguientes parámetros:

  • Umbral de clasificación de AA (ML Classification Threshold): Para filtrar los falsos positivos y, aun así, obtener variedad en las 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.

  • Automatic Spell Correction:

    Si esta función está habilitada y la entrada del usuario tiene un error ortográfico o gramatical, se establecerá la coincidencia con un intent como si se hubiera escrito correctamente. La respuesta de la detección de intent contendrá la entrada del usuario corregida. Por ejemplo, si un usuario escribe “Quiero una mansana”, se procesará como si hubiese 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 se puede solucionar si agregas frases habituales con coincidencias incorrectas a los ejemplos negativos.
    • La corrección ortográfica aumenta un poco el tiempo de respuesta del agente.
    • La corrección ortográfica no debe usarse con Actions on Google.
    • La corrección ortográfica se entrena a partir de las consultas generales de los usuarios. Si se define a un agente mediante jerga específica del dominio, es posible que las correcciones no sean adecuadas.
  • Automatic Training: Habilita o inhabilita el entrenamiento automático de agentes cada vez que se modifique el agente.

  • Agent Validation: Consulta la guía de validación del agente.

Importar y exportar

Para acceder a la configuración de importación y exportación, haz clic en la pestaña Export and Import.

Esta función te permite exportar o importar un agente en un archivo ZIP para crear copias de seguridad de los agentes o transferirlos de una cuenta a otra. Si bien puedes editar los archivos JSON directamente y volver a importarlos, la edición debe hacerse mediante la API o la consola de Dialogflow. Esto garantiza que el sistema valide los cambios y se reduzca al mínimo la cantidad de problemas que deban solucionarse.

Las siguientes opciones están disponibles:

  • Export as ZIP: Exporta el agente como un archivo zip.
  • Restore from ZIP: Reemplaza el agente actual por el archivo zip proporcionado.
  • Import from ZIP: Agrega intents y entidades al agente actual desde el archivo zip proporcionado. Si alguno de los intents o las entidades existentes tienen el mismo nombre que los del archivo zip, se los reemplazará.

Estas opciones se aplican al borrador del agente. Para exportar una versión del agente, cárgala en borrador primero.

Las siguientes acciones se incluyen en la exportación de un agente:

  • Intents
  • Entidades
  • La mayoría de los parámetros de configuración del agente (consulta la lista a continuación para ver la configuración excluida)

Los siguientes elementos no se incluyen en la exportación de un agente y no se reemplazan cuando se importan o restablecen:

El tamaño máximo de los agentes (contenido sin comprimir) para la importación y restablecimiento de agentes no debe superar los 50 MB.

Entornos

Para acceder a la configuración de entornos, haz clic en la pestaña Entornos.

Las versiones y los entornos te permiten implementar varias versiones de tu agente en entornos separados y personalizables. Para obtener más información, consulta Versiones y entornos.

Voz

Para acceder a la configuración de voz, haz clic en la pestaña Speech.

Estas son las opciones de configuración para el reconocimiento y la síntesis de voz. Podrás configurar los siguientes parámetros:

  • Mejorar la calidad del reconocimiento de voz
  • Texto a voz
    • Enable Automatic Text to Speech: Convierte las respuestas de texto predeterminadas a voz de forma automática en todas las conversaciones. Consulta Detecta intents con respuesta de voz.
    • Configuración de voz:
      • Idioma del agente: elige el idioma predeterminado para la síntesis de voz.
      • Voz: elige un modelo de síntesis de voz.
      • Velocidad de habla: ajusta la velocidad a la que hablará el agente.
      • Tono (Pitch): ajusta el tono de voz.
      • Aumento de volumen (Volume Gain): ajusta el aumento de volumen del audio.
      • Perfil de efectos de audio (Audio Effects Profile): selecciona los perfiles de efectos de audio que deseas aplicar a la voz sintetizada. El audio de voz se optimiza para los dispositivos asociados con los perfiles seleccionados (por ejemplo, auriculares, bocina grande, llamada telefónica). Si deseas obtener una lista de los perfiles disponibles, consulta Usa perfiles de dispositivos para el audio generado en la documentación de Text-To-Speech.

Compartir

Para acceder a la configuración de uso compartido, haz clic en la pestaña Compartir.

Esta configuración se usa para compartir el acceso a agentes con otros desarrolladores. Consulta Control de acceso para obtener más información.

Avanzado

Para acceder a la configuración avanzada, haz clic en la pestaña Avanzado.

Actualmente, solo una función se controla desde esta configuración. Para obtener más información, consulta Análisis de opiniones.