Agentes

Un agente de Dialogflow CX es un agente virtual que controla las 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.

Crear un agente

Nota: Puedes crear varios agentes de CX para uno Proyecto de Google Cloud.

Para crear un agente, haz lo siguiente:

Console

1. Abre la consola de Dialogflow CX.
2. Crea o elige un proyecto de Google Cloud.
3. Haz clic en Create Agent.
4. Selecciona Generar automáticamente para crear un agente del almacén de datos o selecciona Crea uno propio para crear otros tipos de agentes.
5. 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 para un agente una vez que se crea.
6. Haz clic en Guardar.

API

Si aún no lo has configurado configuración de ubicación para tu proyecto, debes configurar estos parámetros con la consola antes de crear agentes con la API. Actualmente, no puedes establecer la configuración de ubicación con la API.

Para crear un agente, consulta el método create 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 de 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

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 Google Cloud 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:

• Intents
• Tipos de entidad
• Webhooks
• Flows
• Pages
• Grupos de rutas

Para obtener más información sobre cómo se aplican los datos en diferentes niveles, consulta el niveles de aplicación de datos.

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 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 de 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 a la Formato JSON:
  2. Descomprime el archivo descargado.
  3. Busca el archivo agent.json.
  4. Actualiza defaultLanguageCode y supportedLanguageCodes con los valores deseados.
  5. Restablecer el agente al mismo o a uno diferente del paso 1.
  6. Actualiza las frases de entrenamiento específicas de cada idioma y los valores de las entidades 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 Logging

  • 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 se habilite este parámetro de configuración, ya que dependen de los registros de tráfico.

  • Habilita la ocultación de entradas de usuarios finales 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 la entrada 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 esta configuración, no se ocultará ningún elemento.

    El consentimiento del usuario se recopila mediante un parámetro de sesión booleano: $session.params.conversation-redaction. Si se habilita este parámetro de configuración y el parámetro de sesión se establece en false, no se ocultará ningún elemento (se seguirán aplicando otras estrategias de ocultamiento). Si se habilita esta configuración y el parámetro de sesión se establece en true, se ocultará.

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

• 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 plantillas de carga útil personalizadas.

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:

• Permitir 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 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 (predeterminado): Tecnología de CLN avanzada. Este tipo de CLN funciona es mejor que el estándar, en especial para agentes y flujos grandes.
  • CLN estándar: Tecnología de CLN estándar. 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

  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.

  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.

• Entrenar CLN

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

Configuración de la IA generativa

Están disponibles las siguientes opciones de configuración de la IA generativa:

• General

  • 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ó la generación fracasará.

• 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 las versiones del modelo.

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

• Texto a voz

  • Selección de voz

    Puedes seleccionar el idioma y la voz que se usan 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 la voz personalizada 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 usas para llamar a Dialogflow tenga asignada la función “AutoML Predictor” en tu proyecto de voz personalizado.

• Speech-to-Text

  • Habilitar la adaptación de voz automática

    Consulta Adaptación de voz automática.

  • Configuración de voz avanzada

    Nota: La configuración de voz avanzada solo es compatible con integraciones de telefonía.

    En esta sección, se proporciona una configuración avanzada y adicional para las funciones de voz. Puedes activar o desactivar esta configuración avanzada.

    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 del flujo y del agente) y configuración de entrega (se aplica a la entrega y anula la configuración de la página, el flujo y el agente). Un subconjunto de esta configuración está disponible en cada nivel, según la relevancia de la configuración del nivel.

    La configuración actualizada a nivel del agente no se propaga al flujo, a la página y nivel de entrega cuando se selecciona la opción Personalizar en estas niveles. Si la opción Personalizar incluye varios parámetros de configuración y solo quieres actualizar algunas de ellas, es posible que también debas actualizar otros parámetros de configuración si quieres que sean iguales a la configuración a nivel del agente.

    • Selección de modelos (Speech-to-Text)

      Establece el modelo de voz que se usa para el reconocimiento de voz. Esta configuración es específica del idioma, para que puedas seleccionar modelos para distintos idiomas. También puedes consultar Anular el modelo de voz a nivel de la solicitud lo que hará que se use el modelo seleccionado incluso si una llamada a la API del entorno de ejecución especifica un modelo diferente.

      Para Dialogflow CX Phone Gateway, consulta limitaciones.

      Para obtener más información, consulta Modelos de voz.

    • Sensibilidad de fin de voz

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

      Nota: Este parámetro de configuración solo admite en-US. language, a menos que compruebes el parámetro de configuración Habilitar la sensibilidad avanzada de fin de voz basada en tiempo de espera.

    • Habilitar la sensibilidad avanzada de fin de voz basada en tiempo de espera

      Si habilitas esta configuración, el valor de configuración de Sensibilidad del fin de voz se usa como indicador para establecer un tiempo de espera de silencio de audio relativo para determinar el final del discurso.

      Si se inhabilita esta configuración (predeterminada), el valor de configuración de Sensibilidad del fin de voz se usa para determinar el final de la voz mediante el modelo de AA proporcionado por Google Cloud Speech-to-Text.

      El parámetro de configuración Sensibilidad al final de voz solo admite la etiqueta en-US language de forma predeterminada el parámetro de configuración Habilitar la sensibilidad avanzada de fin de voz basada en tiempo de espera permite configurar la sensibilidad de fin de voz para todos los idiomas y modelos de voz compatibles con Dialogflow.

    • Habilitar el extremo inteligente

      Si se habilita esta configuración, Dialogflow analizará entrada para determinar el final de la voz. Por ejemplo, si el usuario dice "Me gustaría y pausas, Dialogflow esperará al usuario para continuar la oración.

      Esto es particularmente útil para la recopilación de parámetros numéricos, en los que el usuario podría decir "1234" y detente antes de decir "5678". Para aplicar este parámetro de configuración a un parámetro específico, debes Configurar Extremos inteligentes en el formato del parámetro.

      Esta opción solo está disponible para la etiqueta de idioma en-US.

      Esta configuración está inhabilitada de forma predeterminada.

    • Sin 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, y el valor máximo es 60 segundos. Para este tiempo de espera, Dialogflow invoca un evento de no entrada.

    • Salto de entrada

      Cuando está habilitado, 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 se puso en cola mediante 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 interrupción. En este caso, La integración dejará de reproducir audio para todos los mensajes en cola. con las interrupciones habilitadas.

    • Permitir la cancelación de la reproducción de respuesta parcial

      Cuándo respuesta parcial esté habilitado, esta configuración permite cancelar la reproducción de una respuesta parcial. Si un mensaje en el fila de mensajes se crea con una entrega que permite la cancelación se cancela la reproducción del mensaje si se envía otro se agrega a la fila. Esto es útil cuando quieres enviar un mensaje inicial para comenzar la reproducción, pero para que esa reproducción se cancele si un webhook produce otro mensaje antes de que se complete la reproducción del mensaje inicial.

    • Bucket de exportación de audio

      Si se incluyen, los datos de audio asociados con una solicitud se guardarán en el bucket de Cloud Storage:

      Se guardó el audio	Solicitudes aplicables
      Entrada de audio del usuario final	DetectIntent, StreamingDetectIntent, AnalyzeContent y StreamingAnalyzeContent
      Audio de texto a voz (TTS) sintetizado para una respuesta	AnalyzeContent y StreamingAnalyzeContent

      Otorga la función creador de objetos de almacenamiento a las siguientes cuentas de servicio del 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 incorporada para socios.

      • A la cuenta de servicio con el formato [e-mail] si usas la integración de la Puerta de enlace telefónica de Dialogflow CX. Para encontrar esta cuenta de servicio en IAM, marca la opción Incluir asignaciones de funciones proporcionadas por Google.

    • DTMF: Consulta DTMF para integraciones de telefonía.

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.

Exporta y restablece un agente

Nota: Los tipos de agentes de Dialogflow ES y Dialogflow CX no son compatibles. No puedes restablecer un agente incompatible.

Puedes exportar un agente a un archivo y restablecer un agente con ese archivo.

Una exportación de agente incluye todos los datos del agente, excepto los siguientes:

• Versiones de flujo: Solo los flujos en borrador se exportan al archivo.
• Entornos: Los entornos personalizados no se exportan al archivo.

Un restablecimiento de agente reemplaza todos los datos del agente de destino. (incluidas todas las versiones de flujo), excepto por lo siguiente:

• Entornos: Todos los entornos personalizados no se modifican en el agente de destino. Versiones de flujo a las que hacen referencia los entornos personalizados en el agente de destino seguirán existiendo, mientras existan los entornos asociados. Sin embargo, estas versiones de flujo inactivas no se enumeran ni se pueden seleccionar. de flujo de trabajo para el agente.
• Apps de agentes de Vertex AI: La asociación con una app de agentes de Vertex AI no se modifica en el agente de destino. (En otras palabras, el valor de engine en GenAppBuilderSettings) Esto significa que los agentes del almacén de datos solo se pueden restablecer en otros agentes de almacén de datos existentes, ya que el agente resultante también necesita tener una asociación con una app de agentes de Vertex AI.

• Almacenes de datos de los agentes de Vertex AI: Todas las referencias a los almacenes de datos se reemplazarán en el agente de destino según las siguientes reglas:

  • Si el agente de destino no está asociado con una aplicación, no es posible restablecer un agente que tenga referencias al almacén de datos. Si intentas hacerlo, obtendremos resultados un mensaje de error. Para solucionar ese problema, puedes hacer lo siguiente: Crea un agente de almacén de datos nuevo desde cero. (Como alternativa, puedes convertir tu agente existente en un agente de almacén de datos controlador de estado que se les asigna. En este caso, se te guiará para que agregues una aplicación asociada a tu agente).
  • Si el agente de destino está asociado con una app, todos los almacén de datos las referencias se actualizarán luego del restablecimiento: el ID del proyecto de Google Cloud y se actualizará para que coincida con la app del agente de destino. El El ID de colección y el ID de almacén de datos no se modificarán. Esto significa que debes agregar almacenes de datos para todos los IDs que tengan tipos coincidentes en la app del agente de destino antes de la operación de restablecimiento.

  Ejemplo: si el agente de origen hace referencia a un almacén de datos llamado projects/123/locations/eu-west2/collections/default_collection/dataStores/myDataStore1 y la app del agente de destino se llama projects/321/locations/us-east1/collections/default_collections/engines/app123, la referencia del almacén de datos resultante en el agente de destino se convertirá en: projects/321/locations/us-east1/collections/default_collection/dataStores/myDataStore1

Nota: En la API y en el contenido de los datos exportados, se puede La app de Vertex AI Agents se llama GenAppBuilder Engine. Para ejemplo en un paquete JSON exportado, puedes encontrar el nombre del motor en la agent.json en la clave genAppBuilderSettings.engine.

Cuando exportas, puedes seleccionar el formato de archivo de exportación. Si usas el control de versiones de control de origen para los datos de tu agente, deberías exportar en formato JSON. Cuando restableces un agente, Dialogflow determina automáticamente el formato del archivo.

Sigue estos pasos para exportar o restablecer un agente:

Console

1. Abre la consola de Dialogflow CX.
2. Elige el proyecto de Google Cloud 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.

Nota: Para restablecer un agente de almacén de datos, asegúrate de que el agente de destino haya creado como un agente del almacén de datos.

API

Consulta los métodos export y restore 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 de 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

Si el tamaño del agente excede el límite máximo, usa la opción de Cloud Storage para la exportación y el restablecimiento del agente.

Si usas GitHub, consulta también el Guía de exportación o restablecimiento de GitHub.

Borra un agente

Precaución: La acción de borrar un agente no se puede deshacer. Exporta el agente para tener una copia de seguridad si es necesario.

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 Google Cloud 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. 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 de 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

Si borrar tu proyecto Todos los agentes y datos de Dialogflow CX asociados con el proyecto se borran de inmediato.