Configuración de agentes

Los agentes tienen muchos parámetros de configuración que afectan el comportamiento. Cada consola proporciona una configuración diferente.

Configuración del agente de la consola de Dialogflow CX

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 del 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 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. Restaura el agente al mismo agente o a uno diferente del paso 1.
    6. Actualiza las frases de entrenamiento y los valores de las entidades específicos para el idioma 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 registros

    • 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 del usuario final 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 las entradas 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 este parámetro de configuración, no se realizará ninguna ocultación.

      El consentimiento del usuario se recopila mediante un parámetro de sesión booleano: $session.params.conversation-redaction. Si este parámetro está habilitado y el parámetro de sesión se establece en false, no se realizará ninguna ocultación (se seguirán aplicando otras estrategias de ocultación). Si este parámetro de configuración está habilitado y el parámetro de sesión se establece en true, se produce la ocultación.

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

  • 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 para plantillas de cargas útiles personalizadas.

Configuración del AA

Los agentes conversacionales (CX de Dialogflow) usan algoritmos de aprendizaje automático (AA) para comprender las entradas del usuario final, hacerlas coincidir con intents y extraer datos estructurados. Los agentes conversacionales (Dialogflow CX) aprenden de frases de entrenamiento que proporcionas y los modelos de lenguaje integrados en los agentes de conversación (Dialogflow CX). A partir de estos datos, compila un modelo para tomar decisiones sobre qué intent debe coincidir con determinada entrada del usuario final. Puedes aplicar una configuración de AA única para cada flujo de un agente y el modelo que crean los agentes conversacionales (Dialogflow CX) 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 agentes de conversación (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

    Para filtrar resultados falsos positivos y aun así obtener variedad en coinciden con las entradas de lenguaje natural para tu agente, puedes ajustar la de clasificación de aprendizaje. Este parámetro de configuración controla el intent mínimo la confianza de detección necesaria para un coincidencia de intent:

    Si la puntuación de confianza de una coincidencia de intent es menor que el umbral. un valor, luego un evento sin coincidencias se invocará.

    Puedes configurar un valor de umbral de clasificación independiente para cada flujo en cada idioma habilitado para el agente. Esto es para adaptarse a diferentes idiomas con distintos umbrales de clasificación. Para obtener más información sobre cómo crear un agente multilingüe, consulta la documentación sobre agentes multilingües.

  • 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 IA generativa

Los siguientes parámetros de configuración de IA generativa están disponibles:

  • General

    • Frases prohibidas

      Es la lista de frases prohibidas para la IA generativa. Si aparece una frase prohibida en la instrucción o la respuesta generada, la generación fallará.

    • Filtros de seguridad

      Configura los niveles de sensibilidad de los filtros de seguridad en relación con las diferentes categorías de IA responsable (RAI). El contenido se evaluará en función de las siguientes cuatro categorías:

      Categoría Descripción
      Incitación al odio o a la violencia Comentarios negativos o dañinos que se orientan a la identidad o los atributos protegidos.
      Contenido peligroso Promueve o habilita el acceso a bienes, servicios y actividades perjudiciales.
      Contenido sexual explícito Incluye referencias a actos sexuales o a otro contenido obsceno.
      Acoso Comentarios maliciosos, intimidantes, de bullying o abusivos dirigidos a otra persona.

      El contenido se bloquea en función de la probabilidad de que sea dañino. Puedes personalizar el nivel de sensibilidad seleccionando las opciones Bloquear pocos, Bloquear algunos y Bloquear la mayoría para cada categoría. También puedes obtener acceso a la opción restringida Bloquear ninguno, que inhabilita las verificaciones de RAI para la categoría después de enviar una solicitud de acuse de recibo de riesgo para tu proyecto y recibir la aprobación.

      Para obtener más información, consulta Cómo configurar los atributos de seguridad.

    • Seguridad inmediata

      Puedes verificar el parámetro de configuración Habilitar verificación de seguridad inmediata para habilitar las verificaciones de seguridad inmediatas. Cuando se habilita, el agente intentará evitar ataques de inserción de instrucciones. Estos ataques se pueden usar para revelar partes de la instrucción del agente o para proporcionar respuestas que el agente no debería proporcionar. Para ello, se envía una instrucción de LLM adicional que comprueba si la consulta del usuario es potencialmente maliciosa.

      Este parámetro de configuración está habilitado de forma predeterminada para los agentes nuevos. Si tu agente se creó antes del lanzamiento de este parámetro de configuración, el parámetro no está habilitado.

  • Agente generativo

    • Selección de modelos generativos

      Selecciona el modelo que usan las funciones generativas. Para obtener más información, consulta Versiones de modelos.

  • Resguardo generativo

  • Almacén de datos

    Consulta Configuración del agente del almacén de datos.

Configuración de IVR y voz

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

  • Text-to-Speech

    • Selección de voz

      Puedes seleccionar el idioma y la voz que se usarán 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 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 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 se usa para llamar a los agentes de conversación (Dialogflow CX) se otorgue con “AutoML Predictor” en tu proyecto de voz personalizado.

  • Texto a voz

DTMF

Consulta DTMF para integraciones de telefonía para obtener 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.

Configuración de la consola de Agent Builder

En esta sección, se describe la configuración disponible para las apps de agente.

General

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

  • Nombre visible

    Un nombre legible por humanos para tu app de agente.

  • Ubicación

    La región de la app del agente.

  • Bloqueo de apps

    Si está habilitada, no se permiten cambios en la app del agente.

Logging

La siguiente configuración de registro está disponible para las apps de agentes:

  • Habilitar Cloud Logging

    Si se habilita, se enviarán a Cloud Logging.

  • Habilita el historial de conversaciones

    Si se habilita, historial de conversaciones estarán disponibles. Indica si quieres que Google recopile y almacene consultas ocultas de los usuarios finales. para mejorar la calidad. Este parámetro de configuración no afecta si se usa el historial de conversaciones para generar respuestas del agente.

  • Habilitar BigQuery Export

    Si se habilita, el historial de conversaciones a BigQuery. También debe estar habilitado el parámetro de configuración Habilitar el historial de conversaciones.

IA generativa

Los siguientes parámetros de configuración de IA generativa están disponibles para las apps de agentes:

  • Selección de modelos generativos

    Selecciona el modelo generativo que los agentes deben usar de forma predeterminada.

  • Límite de tokens de entrada

    Selecciona el límite de tokens de entrada para el modelo generativo. Este es el tamaño máximo de token para la entrada enviada al modelo. Según el modelo, un token puede estar entre un carácter y una palabra. Los límites de tokens más pequeños generan una latencia más baja pero el tamaño de entrada del modelo es limitado. Los límites de tokens más altos generan una latencia más alta pero el tamaño de entrada del modelo puede ser mayor.

  • Límite de tokens de salida

    Selecciona el límite de tokens de salida para el modelo generativo. Este es el tamaño máximo de token para la salida recibida del modelo. Según el modelo, un token puede ser de entre un carácter y una palabra. Los límites de tokens más pequeños tienen una latencia más baja, pero el tamaño de salida del modelo es limitado. Los límites de tokens más altos generan una latencia más alta pero el tamaño de salida del modelo puede ser mayor.

  • Temperatura

    La temperatura de un LLM te permite controlar qué tan creativas son las respuestas. Un valor bajo proporciona respuestas más predecibles. Un valor alto proporciona respuestas más creativas o aleatorias.

  • Frases bloqueadas

    Lista de frases prohibidas para la IA generativa. Si aparece una frase prohibida en la instrucción o en la respuesta que se generó el agente mostrará una respuesta de resguardo.

  • Filtros de seguridad

    Configura los niveles de sensibilidad de los filtros de seguridad con respecto a las diferentes categorías de IA responsable (RAI). El contenido se evaluará en función de las siguientes cuatro categorías:

    Categoría Descripción
    Incitación al odio o a la violencia Comentarios negativos o dañinos que se orientan a la identidad o los atributos protegidos.
    Contenido peligroso Promueve o habilita el acceso a bienes, servicios y actividades perjudiciales.
    Contenido sexual explícito Incluye referencias a actos sexuales o a otro contenido obsceno.
    Acoso Comentarios maliciosos, intimidantes, de bullying o abusivos dirigidos a otra persona.

    El contenido se bloquea en función de la probabilidad de que sea dañino. Para personalizar el nivel de sensibilidad, elige una de las siguientes opciones para cada categoría: Bloquear poco (solo se bloquean instancias de contenido dañino con alta probabilidad), Bloquear algo (instancias de probabilidad media y alta) y Bloquear la mayoría (probabilidad baja, media y alta). También puedes obtener acceso a la opción restringida Bloquear ninguno, que inhabilita las verificaciones de RAI para la categoría después de enviar una solicitud de acuse de recibo de riesgo para tu proyecto y recibir la aprobación.

    Para obtener más información, consulta Cómo configurar los atributos de seguridad.

  • Seguridad de los mensajes

    Puedes consultar el parámetro de configuración Habilitar la verificación de seguridad de los mensajes. para habilitar comprobaciones de seguridad rápidas. Cuando se habilita, el agente intentará evitar ataques de inserción de instrucciones. Estos ataques pueden usarse para revelar partes del mensaje del agente que el agente no debería brindar. Para ello, se envía un mensaje LLM adicional que comprueba si la consulta del usuario es posiblemente maliciosa.

    Este parámetro de configuración está habilitado de forma predeterminada para los agentes nuevos. Si el agente se creó antes del lanzamiento de este parámetro de configuración, el parámetro de configuración no está habilitado.

Git

Esta configuración proporciona una integración con Git. Sigue las instrucciones para configurar la integración.