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. Ir a la referencia de la API de agente

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

Cerrar

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.

    Nota: Algunas funciones, como Experimentos, Historial de conversaciones, BigQuery Export, Analytics y la mejora del modelo de CLN, requieren que esta configuración esté habilitada, ya que se basan en los registros de tráfico.

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

  Nota: Si las entradas originales y corregidas del usuario coinciden con distintos intents, se selecciona el intent que coincide con la entrada original del usuario.

  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:

  • CLN avanzada (predeterminada): Tecnología avanzada de CLN. Este tipo de CLN funciona es mejor que el estándar, en especial para agentes y flujos grandes.
  • CLN estándar: Tecnología estándar de CLN. Testamento ya no recibirán mejoras de calidad ni funciones nuevas.

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

  Nota: Antes de ajustar este valor, intenta agregar ejemplos negativos.

• 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

  Nota: Este parámetro de configuración tiene acceso restringido.

  • 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

  • Configuración de instrucciones de texto

    Consulta Resguardo generativo: define tu propia instrucción.

• 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 [e-mail] 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

  • Habilita la adaptación de voz automática

    Consulta Adaptación de voz automática.

  • Configuración de voz avanzada

    Para obtener detalles sobre las opciones de voz avanzadas, consulta la guía de configuración de voz avanzada.

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.