Integrar Google Dialogflow CX

Prerrequisitos

Para usar Google Dialogflow CX agentes virtualesClosed Una aplicación de software que maneja las interacciones del cliente en lugar de un agente humano en vivo. con NiCE CXone, necesita:

  • Una cuenta en la Plataforma de Google Cloud.

  • Un agente virtual de Google Dialogflow CX configurado y capacitado para ofrecer respuestas a las solicitudes de sus contactos. Para completar la integración en NiCE CXone, necesita el nombre del agente virtual desde la configuración del agente virtual en la consola de Google Dialogflow CX.

Alpha Visibility en Google

Alpha Visibility es un programa de Google que ofrece a los Proyectos de Google Cloud acceso a características que no están disponibles de otra manera. No se necesita Alpha Visibility para usar Dialogflow CX con NiCE CXone. Sin embargo, hay algunos casos en los que puede ser necesario tener habilitada la visibilidad alfa. Se requiere visibilidad alfa si desea:

  • Para que la última expresión del usuario sea devuelta desde el agente virtual de Dialogflow junto con la información de intención. Puede ver esta información en un seguimiento del script. Si la variable lastUserUtterance está vacía cuando debería contener datos, es posible que la visibilidad alfa no esté habilitada para su proyecto. Si requiere esta información, su Google Cloud Project debe tener la visibilidad alfa habilitada.

  • Para que la página actual se devuelva como parte de la carga útil personalizada de la respuesta.

  • Para que el campo de transcripción de Dialogflow se devuelva como parte de la carga útil de la respuesta.

Crear un script

Permisos requeridos: Vista de script de Studio, Crear/Editar

Necesita al menos un script de Studio para dirigir las interacciones hacia su agente virtual. Siga las pautas de script. Su script debe tener el tipo de soporte de mediosClosed Un medio, como voz, correo electrónico y chat, a través del cual un contacto se conecta con un destinatario previsto. de teléfono para un agente virtual de voz o el tipo de soporte de medios digital para un agente virtual de texto. Las acciones de agente virtual admitidas para este proveedor son:

Si va a configurar un agente virtual de voz y utiliza un servicio NiCE CXoneText-to-Speech (Cloud TTS Hub), incluya la acción CLOUD TTS en su script.

Puede obtener más información sobre la creación de scripts de Studio en las secciones Fundamentos y Referencia Técnica Guide de la ayuda en línea.

  • Dialogflow CX no utiliza contextos para pasar datos a Dialogflow intencionesClosed El significado o propósito detrás de lo que dice o escribe un contacto; lo que el contacto desea comunicar o lograr. como lo hace Dialogflow ES.
  • Puede pasar datos personalizados a Dialogflow CX utilizando pares clave-valor de JSON. En un Snippet acción en su script, cree un objeto dinámico customPayload y agregue los pares clave-valor a él. Por ejemplo:

    DYNAMIC customPayload
    customPayload.ani = ani
    customPayload.contactID = contactId
    customPayload.masterContactId = masterId
    customPayloadJSON = "{customPayload.asJSON()}"	
  • En la acción Exchange de su script, configure la propiedad customPayload con la variable que tiene la función asJSON() en su valor. Puede encontrar esta variable en el objeto customPayload.
  • Pase el JSON de customPayload al agente virtual mediante la propiedad Payload de QueryParameters. Consulte la documentación de Google sobre QueryParameters A square with an arrow pointing from the center out from the top right corner. para Google Dialogflow CX.
  • Los datos que se pasan a través de QueryParameters son recibidos por un webhook en Dialogflow CX.Puede escribir código en la Dialogflow Consola CX para manejar los datos pasados.
  • No anide un objeto dentro del objeto customPayload. Los objetos insertados se envían como cadenas literales.
  • Para transmitir datos personalizados desde su agente virtual Dialogflow CX devuelta al l script, usa el campo Carga útil personalizada en la consola Dialogflow CX.Asegúrese de estar en la consola del agente virtual que está usando con NiCE CXone. Asigne esto a su script usando la Variable customPayloadVarName (out) en la acción VOICEBOT EXCHANGE o TEXTBOT EXCHANGE Studio en su script. Por ejemplo, puede usar esto para establecer el comportamientos del siguiente aviso.
  • Para pasar datos personalizados a Dialogflow CX desde el script, use session_params en el objeto customPayload en una acción de Snippet. Por ejemplo:

    DYNAMIC customPayload
    customPayload.session_params.name = "Winnie le Pooh" 
    customPayload.session_params.job = "Food critic" 
    customPayload.session_params.location = "Hundred Acre Wood"	

    Accede a los parámetros de la sesión en la Dialogflowintención del agente CX con la siguiente sintaxis:

    $session.params.name = Winnie Le Pooh
    $session.params.job = Food critic
    $session.params.location = 100 Acre Wood 

    Los parámetros de sesión solo se utilizan con los agentes virtuales Dialogflow CX. Para lograr un resultado similar con Dialogflow ES, use contextos.

  • Configure las sugerencias de contexto de voz y un ID de conversación personalizado para transferir la conversación a un agente virtual de Dialogflow CX diferente en el snippet Carga útil personalizada .

  • Para configurar cuánto tiempo espera el agente virtual cuando el contacto hace una pausa al hablar, agregue el maxPostEnergySilenceMSparámetro a la Next Prompt Behaviorso Default Next Prompt BehaviorsSnippet acción.

Agregar una aplicación a Virtual Agent Hub

Permisos requeridos: Connections Hub > Iniciar Connections Hub

Agregar una aplicación de configuración a Virtual Agent Hub establece la conexión entre NiCE CXone y su proveedor de agentes virtuales.

  1. En NiCE CXone, haga clic en el selector de aplicaciones y seleccione Otro > Connection Hub y luego haga clic en Virtual Agent Hub. También puede hacer doble clic en la acción de agente virtual en su script de Studio para iniciar Virtual Agent Hub.
  2. Haga clic en Añadir bot.
  3. Escriba un nombre de agente virtual (bot) y haga clic en Dialogflow CX en la lista de proveedores de agentes virtuales.

  4. Hacer clicpróximo.

  5. Complete los campos del formulario de configuración y haga clic en Siguiente. Puede encontrar detalles sobre este formulario en la sección Detalles de la Página de configuración en esta página.

  6. Hacer clicpróximo.

  7. Si está configurando un agente virtual de texto, seleccione Solo texto (sin Soporte de Voz) en la página Voz. Si está configurando un agente virtual de voz, consulte la sección Configurar las Opciones de integración de Voz en esta página.

  8. En la página Transcript, seleccione la opción que indica si desea que se capture la transcripción de la conversación y la información de intención. Si esta pestaña no está disponible, la función no está habilitada para su abonadoClosed Agrupación organizativa de alto nivel utilizada para administrar el soporte técnico, la facturación y la configuración global de su sistema NiCE CXone.. Comuníquese con su representante de cuenta para obtener más información sobre esta función. Esta opción solo está disponible para agentes virtuales de texto y agentes virtuales de voz basados en expresiones.

  9. Hacer clicpróximo.

  10. En la página Prueba + Agregar, puede probar la conexión de su bot enviando mensajes de voz o texto. Si sus mensajes de prueba no funcionan, haga clic en atrás para volver a la página de configuración y verificar la configuración.

  11. Hacer clicAgregar.

Google Dialogflow CX Detalles de la Página de configuración

Use la información de la siguiente tabla al completar la página de configuración. Verá esta página cuando agregue una aplicación en Virtual Agent Hub

Campo

Detalles

Versión de integración

Seleccione la versión de Virtual Agent Hub que desea usar. Esta opción le permite usar una versión anterior de Virtual Agent Hub hasta que esté listo para cambiar a una versión reciente. Las versiones disponibles son:

  • Versión 1.0.0: Esta es la primera versión de Virtual Agent Hub. El objeto de carga útil personalizada se devuelve como customPayload.payload.xxxx.
  • Versión 2.0.0: Esta versión actualizó los esquemas utilizados con Google Dialogflow CX. Esto afecta la estructura del objeto customPayload.
  • Versión 3.0.0: Esta versión introdujo StandardBot, que estandariza la forma en que NiCE CXone se comunica con los proveedores de agentes virtuales. El objeto customPayload se devuelve como una matriz, como customPayloadscriptPayloads[n].xxxx. Esta versión está disponible para todos los proveedores.

SIP configurado No habilite esta opción. NiCE CXone no admite una configuración de canal de retorno SIP con Google Dialogflow CX.
Cuenta de servicio JSON

El archivo de clave de cuenta de servicio que creó y descargó desde su Console de Google Cloud. Copie y pegue todo el contenido del archivo de claves en este campo, incluidas las llaves que rodean la clave. Este campo es visible solo si está utilizando su propioGoogle Dialogflow CX cuenta. Si el campo no está visible cuando debería estarlo, pida a su representante de cuenta de NiCE CXone que revise la configuración de su sistema.

La clave de la cuenta de servicio es un objeto JSON similar al siguiente ejemplo:

{

"type": "service_account",
"project_id": "ic-demo2-aai-gcp",
"private_key_id": "sdv80sdf08ssd9sdf0sdf8sdfsdf90sdf8",
"private_key": "-----BEGIN PRIVATE KEY-----
nMIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQCzgrS8vp
<private key has been truncated for this example>
----END PRIVATE KEY-----\n",
"client_email": "your@client_email-gcp.iam.gserviceaccount.com",
"client_id": "123456789",
"auth_uri": "https://accounts.google.com/o/oauth2/auth",
"token_uri": "https://oauth2.googleapis.com/token",
"auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
"client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/dialogflow-dthjop%40ic-demo2-aai-gcp.iam.gserviceaccount.com"
}

La cuenta de servicio JSON debe tener el rol de Admin de Dialogflow API A square with an arrow point from the center out to the upper right corner..

Idioma

El idioma que desea que use este agente virtual. Este es el lenguaje que entiende el agente virtual. Este es un campo requerido. Seleccione None para suprimir el código de idioma en las solicitudes de API. Use esta opción cuando el agente virtual administra la detección de idioma por sí mismo o no requiere un código de idioma.

Región

La región donde se encuentra el Google Dialogflow CX agente virtual al que se está agregandoVirtual Agent Hub se encuentra. Este es un campo requerido.

Agente

El nombre de Google Dialogflow CX agente virtual al que desea agregarVirtual Agent Hub. Puede encontrar el nombre en la consola CX de Dialogflow del agente virtual y hacer clic en Copiar nombre para copiarlo al portapapeles. Este es un campo requerido.

Entorno

Ingrese el GUID del entorno que desea que esta Dialogflow aplicación a usar. En Dialogflow CX, las diferentes versiones del mismo agente virtual se denominan entornos. Puede encontrar el GUID para sus entornos en la consola de Google Dialogflow CX en la configuración de agente.

Realizar Salida de TTS

Haga clic en el control deslizante hasta la posición On si desea utilizar el servicio Google Dialogflow CX de texto a voz (TTSClosed Permite a los usuarios ingresar avisos grabados como texto y utilizar una voz generada por computadora para reproducir el contenido.). Configurar las opciones de TTS para Google.

Si no desea usar el servicio TTS de Google Dialogflow CX, deje este campo configurado como Nula. Puede usar un servicio NiCE CXoneText-to-Speech (Cloud TTS Hub).

Si se trata de un agente virtual de texto, deje esta opción desactivada.

Controlador de evento de tiempo límite Nombre del evento Google Dialogflow CX que desea activar al llegar al tiempo límite.
Patrón de Receso DTMF Si se presionan los caracteres especificados, el guión salta directamente a la rama OnDTMFBreakout.
Realizar análisis de Sentimiento

Haga clic en el control deslizante para colocarlo en Activado si desea recibir los resultados del análisis de sentimiento de Google. Esta opción requiere que tenga esta opción habilitada en su proyecto de Google Cloud. Usted es responsable de configurar cómo se utilizan los datos del análisis de sentimiento con su agente virtual.

Tiempo límite del proveedor externo

Ingrese la cantidad de segundos que desea que el script espere una respuesta de Dialogflow CX. Cuando se alcanza el tiempo límite, el control regresa al script, el cual toma la ramificación de Error.

Perfil de conversación

Ingrese el ID del perfil de conversación de Dialogflow CX que desea que use este perfil de Virtual Agent Hub. Si no especifica un ID, el sistema crea un perfil nuevo. Puede encontrar el id de perfil de conversación en su consola de administración de proyectos de Google.

Si cambia los campos Agente o Entorno, el campo Conversation Profile se borra. Esto se debe a que los Perfiles de conversación son específicos para el agente y el entorno.

Configurar Google Dialogflow CX Salida de TTS

Permisos requeridos: Connections Hub > Iniciar Connections Hub

Complete los pasos de esta sección si desea usar el servicio TTS de Google. Los campos que se muestran en la siguiente imagen aparecen cuando habilita la opción Realizar TTS de Salida en la página de configuración de CX Dialogflow en Virtual Agent Hub.

  1. En Virtual Agent Hub, agregue una nueva aplicación de configuración y configúrela según los pasos que se indican en la sección Agregar una aplicación a Virtual Agent Hub de esta página.
  2. HabilitarRealizar Salida TTS.
  3. Para usar un modelo de voz personalizado, active Usar Voz personalizada e ingrese el nombre del modelo de AutoML que desea usar en el campo Modelo de Voz personalizado.

  4. Si desea usar un modelo de voz Google, seleccione el nombre de Voz TTS del menú desplegable.

  5. Seleccione el Modelo y la Variante de modelo de aprendizaje automático que desea que usen los servicios TTS de Google al sintetizar la voz.

  6. Para agregar un silencio al inicio de la respuesta de audio del agente virtual, ingrese el número de milisegundos de silencio que desea en el campo Agregar silencio inicial. El silencio recomendado es de 500 milisegundos.

  7. Ingrese la Velocidad de habla, el Tono y el Aumento de volumen para configurar el sonido que desea que tenga la voz TTS.

  8. Regrese a la sección Agregar una app a Virtual Agent Hub en esta página para finalizar la adición de la app de configuración.

Configurar las Opciones de Integrar Voz

Permisos requeridos: Connections Hub > Iniciar Connections Hub

Si está configurando un agente virtual de texto, puede saltar esta sección.

  1. En Virtual Agent Hub, agregue una nueva aplicación de configuración y configúrela según los pasos de la sección Agregar una aplicación a Virtual Agent Hub en esta página.
  2. Haga clic en Siguiente en la página de configuración.

  3. En la página Voz, en Opciones de Integrar de Voz, seleccione Turn by Turn Control (CXone Voicebot Gateway).
  4. En Opciones de Transcription, seleccione la Opción del servicio de transcripción que desea usar.

  5. Si decide usar un perfil Turn-by-Turn Transcription, haga clic en Turn-by-Turn Transcription Perfil para seleccionar el que desea usar. Haga clic en Agregar nuevo perfil de transcripción por turnos Transcription para crear un Perfil nuevo.
  6. Bajo las opciones de Transcription, seleccione un Transcription Profile o haga clic en Add New Turn by Turn Transcription Profile para crear un nuevo perfil.
  7. Hacer clicpróximo.
  8. Return to the Add an App to Virtual Agent Hub section en esta página para terminar de agregar la aplicación de configuración.

Asignar la aplicación Google Dialogflow CX a una Acción

Permisos requeridos: Vista de script de Studio, Crear/Editar

Cuando la aplicación del agente virtualClosed El significado o propósito detrás de lo que dice o escribe un contacto; lo que el contacto desea comunicar o lograr. esté configurada en Virtual Agent Hub, deberá asignarla a la acción de agente virtual en su script. Esto conecta la acción y el script a su proveedor de agente virtual.

  1. En Studio, abra el script que desea modificar.
  2. Si aún no lo ha hecho, haga clic en la pestaña Tools , expanda la categoría Automation and AI y agregue la acción de agente virtual que desea utilizar. Asegúrese de colocarlo en la ubicación correcta en su script. Si no ve la acción que espera, verifique que su tipo de soporte de medios de script sea correcto.Por ejemplo, si está creando un script para un agente virtual de voz, el script debe ser un script de teléfono.

  3. Haga clic en Abrir editor en la acción para abrir Virtual Agent Hub.

  4. En la columna izquierda, ubique el perfil de agente virtual que desea asignar a la acción y haga clic en la marca de verificación Un ícono de un círculo con una marca de verificación adentro. que está junto a él.

    Una alternativa a usar la marca de verificación es crear una variable en su script de Studio. Use la variable para pasar el nombre de la aplicación del agente virtual a la propiedad ID de Agente virtual de la acción Virtual Agent Hub que está utilizando.

  5. Haga clic en Cerrar.

Cambiar el Perfil de Transcription

Permisos requeridos: Connections Hub > Iniciar Connections Hub

Un perfil de transcripción le permite utilizar un servicio de transcripción diferente del que ofrece el proveedor del agente virtual. Cada agente virtual puede tener un perfil de transcripción. solo debe seguir los pasos de esta sección si está trabajando con un agente virtual de voz y necesita cambiar el perfil de transcripción.

  1. En NiCE CXone, haga clic en el selector de aplicaciones y seleccione Otro > Connection Hub y luego haga clic en Virtual Agent Hub. También puede hacer doble clic en la acción de agente virtual en su script de Studio para iniciar Virtual Agent Hub.
  2. En la lista de aplicaciones de configuración de agente virtual, en el lado izquierdo de la página Virtual Agent Hub, haga clic en la que desea modificar.
  3. En el centro de la página de propiedades de la aplicación de agente virtual, haga clic en la pestaña Voz.
  4. Bajo Transcription Opciones, seleccione Usar Perfil Turn-by-Turn Transcription si no está ya seleccionado.

  5. Seleccione el Perfil Transcriptionde Turn by Turn que desea que use esta integración de agente virtual. Si la opción que desea usar no está ahí, puede agregarla.

  6. Hacer clicGuardar.
  7. Ponga a prueba su servicio de transcripción usando la opción de micrófono en la sección Prueba de la página de propiedades de la aplicación de agente virtual.

Pruebe su Agente virtual

Permisos requeridos: Connections Hub > Iniciar Connections Hub

Puede probar muchos aspectos de su agente virtual para asegurarse de que todo funcione según lo previsto. Puede ejecutar pruebas desde la página de propiedades de la aplicación del agente virtual en Virtual Agent Hub. Al realizar la prueba, puede:

  • Verificar que la aplicación del agente virtual está correctamente configurada para comunicarse con el proveedor del agente virtual.
  • Agregar JSON de carga útil personalizada para probar el manejo del agente virtual de los datos de carga útil personalizados.
  • Active un evento de intención de bienvenida para probar cómo el agente virtual inicia una conversación.
  • Active un evento de intención personalizado para probar cualquier evento personalizado que haya creado para su agente virtual.
  • Activar un evento de tiempo de espera para probar cómo responde el agente virtual cuando se agota el tiempo de espera del contacto.
  • Probar cómo el agente virtual maneja la entrada DTMFClosed Tonos de señalización que se generan cuando un contacto presiona una tecla en el teclado telefónico..

La siguiente imagen es un ejemplo de la página de propiedades para una aplicación de agente virtual en Virtual Agent Hub (no Dialogflow CX). Muestra las pestañas configuración y Voz y el panel Prueba.

  1. En NiCE CXone, haga clic en el selector de aplicaciones y seleccione Otro > Connection Hub y luego haga clic en Virtual Agent Hub. También puede hacer doble clic en la acción de agente virtual en su script de Studio para iniciar Virtual Agent Hub.
  2. Haga clic para seleccionar la aplicación de configuración para el agente virtual que desea probar de la lista de la izquierda.
  3. En el panel Prueba, escriba un mensaje de prueba en el campo Escriba un mensaje y presione intro para enviarlo. También puede hacer clic en MicrófonoUn ícono con forma de micrófono. y hablar en el micrófono de su computadora.

  4. Haga clic en Comience con intención de bienvenida para iniciar una conversación de prueba desde el principio. El agente virtual responde con su mensaje de bienvenida predeterminado. Puede ingresar mensajes de prueba.
  5. Haga clic en Más opcionesUn ícono con tres puntos verticales. para probar otros aspectos de su agente virtual.

  6. Haga clic en Restablecer para comenzar su prueba de nuevo.
  7. Si necesita realizar cambios en función de los resultados de su prueba, puede:

    • Modifique los scripts de Studio para el agente virtual.
    • Modifique los ajustes de configuración de la aplicación del agente virtual en Virtual Agent Hub.
    • Modifique la configuración del agente virtual en la consola del proveedor. Haga clic en el botón cuadrado grande en la página de propiedades de la aplicación en Virtual Agent Hub. El ejemplo al comienzo de esta sección muestra la aplicación Google Dialogflow CX con el botón del proveedor. It has the Un icono que tiene un cuadrado con una flecha superpuesta encima. La flecha apunta desde el centro del cuadrado hacia la esquina superior derecha del cuadrado. icono en él para indicar que el enlace abre un sitio externo.
  8. Pruebe exhaustivamente al agente virtual después de cada cambio en sus Scripts o en cualquier configuración.
  9. Cuando termine la prueba, haga clic en Close.