VOICEBOT EXCHANGE

Esta página de ayuda es para Studio. Esta información también está disponible para Desktop Studio.

``` Ícono de VoiceBot Exchange: cabeza de robot verde azulado con una cara sonriente ```

Integra un agente virtualClosed A software application that handles customer interactions in place of a live human agent. de autoservicio con guiones de voz. Esta acción se utiliza en un bucle en el script. Un script debe contener al menos DOs acciones VoiceBot Exchange . Su agente virtual debe respaldar esta acción.

The Voicebot Exchange action is for complex virtual agents or when you need to customize the virtual agent's behavior from turn to turn. It monitors the conversation between the contact and the virtual agent, turn by turn. It sends each transcribed utteranceClosed What a contact says or types. to the virtual agent. The virtual agent analyzes the utterance for intentClosed The meaning or purpose behind what a contact says/types; what the contact wants to communicate or accomplish. and context and determines the response to give. The action passes the virtual agent's response to the contact. When the conversation is complete, the action continues the script.

If you want to configure barge in or no input, additional scripting is required.

Hacer doble clic en esta acción abre Virtual Agent Hub, donde puede administrar todos sus agentes virtuales.

Dependencias

  • Un script debe contener al menos DOs Intercambio de voicebot acciones conectadas en un bucle.
  • Para usar esta acción, su agente virtual debe ser compatible con la personalización de conversaciones turno a turno.
  • Un turno conversacional se define como:

    1. La expresión de contacto que se envía al agente virtual.
    2. El agente virtual procesa la expresión y define cualquier información de carga útil personalizada.
    3. La respuesta regresa al contacto.
    4. Cualquier acción adicional que se deba realizar (como una llamada a una base de datos o a una API externa) que se determina en la propiedad nextPromptBehaviors. También puede configurar el ciclo conversacional para salir cuando se completa la interacción o si se transfiere el contacto a un agente en vivo.
  • Si incluye una carga útil personalizada con los agentes virtuales Google Dialogflow ES o Google Dialogflow CX, siga las mejores prácticas y pautas de carga útil personalizada.Las pautas para CX y ES se proporcionan en esta página.

Tipos de secuencias de comandos compatibles

Ícono de auricular de teléfono violeta

Teléfono

Comparación de acciones similares

Las siguientes acciones tienen funciones similares, pero con algunas diferencias clave:

  • Textbot Exchange: Este acción se usa para interacciones complejas de agente virtual. Le permite incluir parámetros de intercambio y personalizar varios aspectos de la conversación entre el contacto y el agente virtual.
  • Voicebot Exchange: Esto acción se utiliza para interacciones complejas del agente virtual. Le permite incluir parámetros de intercambio y personalizar varios aspectos de la conversación entre el contacto y el agente virtual.
  • VOICEBOT STREAM: Esta acción admite la transmisión de audio en tiempo real entre NiCE CXone y el proveedor de agente virtual. No admite la personalización de la conversación entre turnos. Actualmente, el único agente virtual admitido es Google Dialogflow CX VoiceStream.

Agentes virtuales compatibles

Esta acción admite los siguientes agentes virtuales:

Antes de poder asignar un agente virtual a esta acción, debe agregar y configurar una aplicación para el agente virtual en Virtual Agent Hub. solo necesita una aplicación para cada agente virtual que use. Puede asignar la misma aplicación a múltiples acciones de agente virtual en sus Scripts. Consulte la página de ayuda del proveedor de agente virtual que está utilizando para obtener los detalles de configuración.

Es posible que se admitan otros proveedores de agentes virtuales, pero requieren integraciones personalizadas. Estos incluyen integraciones de DEVone y custom endpoints. Las integraciones personalizadas no se configuran usando Virtual Agent Hub.

Propiedades de entrada

Estas propiedades definen los datos que utiliza la acción al ejecutarse.

Una o más de las propiedades de esta acción requieren una acción Snippet con código personalizado.

Propiedad

Descripción

Agregar leyenda

Introduzca una frase corta que identifique de forma única esta acción en el script. La leyenda aparece en el lienzo del script debajo del ícono de acción.

ID de agente virtual El nombre del agente virtual seleccionado en el Virtual Agent Hub. Cuando asigna una aplicación de agente virtual a una acción Studio en Virtual Agent Hub, esta propiedad se rellena de forma automática. El nombre es el valor utilizado en el campo Virtual Agent (Bot) Name en la aplicación Virtual Agent Hub. Puede usar la sustitución de variables en esta propiedad.
Carga útil personalizada

Configure esta propiedad solo si necesita transmitir datos de carga útil personalizada al agente virtual. El objeto carga útil personalizada se completa a partir del script Studio. Puede usarlo para transmitir información, como el nombre del contacto, desde una CRMClosed Third-party systems that manage such things as contacts, sales information, support details, and case histories. para usar en un mensaje de bienvenida.

Ingrese el nombre del objeto JSON que pasa datos del script al agente virtual. Debe definir el objeto de carga útil personalizada en una acción Snippet. El objeto se debe convertir a JSON, ya sea en el snippet o en la propiedad customPayload.

Requisitos para proveedores específicos de agentes virtuales:

No utilice esta propiedad si necesita procesar los datos que devuelve el agente virtual al script. En su lugar, utilice la variable customPayloadVarName (out).

Secuencia del siguiente mensaje

The response received from the virtual agent that will be played for the contact. Configure this property with the variable specified in nextPromptSequenceVarName (out) with the asJSON() function. You can also convert the contents of nextPromptSequenceVarName (out) to JSON in a Snippet action and configure this property with the variable that holds the JSON.

Comportamientos del siguiente mensaje

Especifica la configuración y el comportamiento del siguiente aviso en una conversación. Defina los comportamientos que desea ver mediante un Snippet acción y siguiendo el Comportamientos predeterminados de la siguiente instrucción o Next Prompt Behaviors.Este ejemplo describe las propiedades que puede usar para configurar el ruido de confort, la recopilación de Dtmf y permitir que el contacto hable mientras se reproduce el audio (interrupción).

Configure la propiedad nextPromptBehavior con el nombre del objeto que utilizó en el código del snippet. Esto transfiere la configuración a esta propiedad y a su acción. Por ejemplo, usando el ejemplo del snippet Next Prompt Behavior, ingresaría {nextPromptBehaviorsOutjson} para esta propiedad. solo necesita configurar esta propiedad si utiliza esta acción para permitir que un agente virtual de texto gestione interacciones de voz.

Estado de sesión del bot

Configure with the variable that holds the unique identifier for the conversation between the contact and the virtual agent. It is automatically assigned by the virtual agent provider. The identifier prevents a new session from being created with every turn in the conversation and helps the virtual agent maintain context between turns.

El proveedor crea el identificador cuando comienza la conversación y lo pasa al script con la primera respuesta. El script almacena el identificador en la variable indicada en la propiedad botSessionStateVarName (out) de esta acción. Finalmente, el script pasa el identificador del turno anterior desde la propiedad botSessionStateVarName (out) a la propiedad botSessionState.

Sus scripts nunca se deben escribir en esta propiedad ni en su variable. Su script debe estar configurado correctamente para usar el identificador de estado de sesión del bot.

Intención automatizada

Ingrese por nombre una intención específica a la que responda el agente virtual, en lugar de que el agente virtual interprete la entrada del usuario. Un caso de uso común para esto es obtener el mensaje de bienvenida inicial del agente virtual. Bienvenido es la cadena estándar para los saludos iniciales.

Propiedades de salida

Estas propiedades contienen variables que incluyen datos que se evuelven al ejecutar la acción. Están disponibles como referencia y para usarse cuando se completa la acción.

Propiedad

Descripción

Siguiente Nombre DE variable de Comportamientos de solicitud

Define los comportamientos para incitar al usuario en el siguiente turno de conversación.

Nombre DE variable de la siguiente Secuencia rápida

Retiene la respuesta del agente virtual y la transmite a la propiedad nextPromptSequence.

Carga útil personalizada VarName

Devuelve datos JSON personalizados del agente virtual al script. Utilice esta variable cuando desee que el script procese los datos que proporciona el agente virtual. Puede contener datos de cumplimiento.

Si desea proporcionar datos al agente virtual, use la propiedad customPayload.

Error Detalles VarName

Solicita la secuencia de intento de error; puede dar lugar a una transferencia a un agente activo.

Intención Info VarName

Una variable que contiene los detalles del agente virtual que indica la intención actual del usuario.

Bot Session State VarName

Guarda la variable donde el script almacena el identificador del estado de la sesión bot que envía el proveedor de agente virtual. El contenido de la variable se pasa a la propiedad botSessionState.

Debe configurarse correctamente esta propiedad para que funcione correctamente su agente virtual. más información sobre cómo configurarlo está disponible en la página de ayuda de Bot Session State Snippet.

Condiciones de ramificación de resultados

Las condiciones de las ramas de resultado le permiten crear ramas en su script para manejar diferentes resultados cuando se ejecuta una acción.

Condición

Descripción

Por defecto ``` Path taken unless the script meets a condition that requires it to take one of the other branches. It is also taken if the action's other branches are not defined. ```
PromptAndCollectNextResponse

Ruta que se toma si el agente virtual ha determinado que la interacción debe continuar y está lista para recibir más entrada humana del contacto. Indica el siguiente turno de la conversación.

Error Path taken when there is an unexpected problem (for example, poor connectivity, syntax errors, and so forth). The _ERR variable should be populated with a condensed explanation of the problem.
ReturnControlToScript Ruta adoptada si el agente virtual indicó que terminó la conversación y devuelve el control al script Studio para transferir o finalizar la llamada. Puede haber datos de cumplimiento para ser procesados en elcustomPayload resultado.
DTMFBreakout

Ruta tomada cuando se cumplió una regla DTMFClosed Signaling tones that are generated when a contact presses a key on the telephone keypad. en el script.

UserInputTimeout

Ruta que se toma cuando no hay respuesta por parte del usuario en el tiempo especificado en el Snippet de Comportamiento de solicitud Default o Next.

Para Google Dialogflow, puede configurar el evento que desea que ocurra en la app Virtual Agent Hub Dialogflow. Para Dialogflow ES, configure el campo Evento de tiempo DE espera. Para DialogflowCX, configure el Controlador de eventos de tiempo DE espera. Si no se configura ningún Evento, el valor predeterminado es usar la intención alternativa predeterminada tal como está configurada en la consola de Dialogflow.

Si lo desea, puede configurar esta rama para usar diferentes eventos en diferentes puntos de su script.

UserInputNotUnderstood

Ruta que se toma cuando el agente virtual no entiende la respuesta del contacto o cuando el contacto agota el tiempo de espera.

Código de Acción SNIPPET requerido

Una o más propiedades de esta acción requieren una acción de Snippet action con el siguiente código personalizado:

Prácticas recomendadas para Cargas útiles personalizadas con Google Dialogflow CX

Al usar esta acción conGoogle Dialogflow CX siga estas prácticas recomendadas para integrar cargas útiles personalizadas:

  • Dialogflow CX no utiliza contextos para pasar datos a las intencionesClosed The meaning or purpose behind what a contact says/types; what the contact wants to communicate or accomplish. de Dialogflow como lo hace Dialogflow ES.
  • Puede pasar datos personalizados a Dialogflow CX mediante pares clave-valor en formato JSON. En un Snippet acción en su script, cree un objeto dinámico customPayload y agregue los pares clave-valor. 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 una variable que tenga 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 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 mediante la variable customPayloadVarName (out) en la acción VOICEBOT EXCHANGE o TEXTBOT EXCHANGE Studio de su script. Por ejemplo, puede usar esto para configurar el comportamientos del siguiente mensaje.
  • Para pasar datos personalizados a Dialogflow CX desde el script, use session_params en el objeto customPayload en una acción 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.

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

  • Para configurar cuánto tiempo espera el agente virtual cuando el contacto hace una pausa mientras habla, agregue el maxPostEnergySilenceMS parámetro a la Next Prompt Behaviorso la Default Next Prompt Behaviors Snippet acción.

Prácticas recomendadas para Cargas útiles personalizadas con Google Dialogflow ES

Al usar esta acción conGoogle Dialogflow ES, siga estas prácticas recomendadas para integrar cargas útiles personalizadas:

  • CustomPayload se usa para pasar el contexto de una intenciónClosed The meaning or purpose behind what a contact says/types; what the contact wants to communicate or accomplish.. El Contexto ayuda al agente virtual a comprender la intención del usuario. Los Contextos no SOn obligatorios, pero ayudan al agente virtual a relacionar un enunciadoClosed What a contact says or types. con una intención.
  • En una acción de Snippet en su script, cree un objeto customPayload que siga el formato descrito en la documentación de Google Dialogflow ES Icono que indica que el enlace va a un sitio web externo para REST Resource: projects.agent.sessions.context. La ayuda en línea de Studio proporciona información adicional sobre los objetos de datos dinámicos.
  • También puede transmitir datos personalizados con customPayload sin contextos. Para hacer esto, incluya pares clave-valor JSON estándar en un objeto de datos dinámicos.
  • Los contextos de voz se pasan en la carga útil personalizada en el parámetro speech_contact. Puede ver el contenido de este parámetro en las trazas de Studio y en los registros de la aplicación.
  • El objeto Dinámico customPayload se transmite como un parámetro de agente virtual en formato JSON, como se observa en el script de ejemplo.
  • Configure los indicios de contexto de voz en el Snippet de Carga útil personalizada.

Consejos y trucos

Si no se puede escuchar el audio de voz entre Virtual Agent Hub y el agente virtual, revise el rastro del script para ver si hay alguna transcripción. De haberlo, requiere ajustarse el agente virtual Google Dialogflow.

Ejemplo de Script

Este es un ejemplo para demostrar cómo se puede utilizar esta acción en los scripts. No pretende ser un script completo. Es posible que se requiera scripting adicional.

Las acciones de VoiceBot Exchange deben usarse en un bucle.Esto significa que debe usar al menos DOs en un script. La primera acción inicia la llamada al API del agente virtual y debe estar precedida por la Comportamiento de solicitud siguiente predeterminado acción Snippet. La primera acción es el valor predeterminado de bienvenida, que comienza el primer bucle con guion, o un "turno" conversacional.

Un ejemplo de un script que usa la acción VoicebotExchange.

Descargar este script.

Script de ejemplo para CustomPayload con Google Dialogflow ES

Este es un ejemplo para demostrar cómo se puede utilizar esta acción en los scripts. No pretende ser un script completo. Es posible que se requiera scripting adicional.

Este script es un ejemplo de cómo integrar cargas útiles personalizadas con agentes virtuales de Google Dialogflow ES. Este script usa la acción Voicebot Exchange, pero también funcionará si en su lugar usa TEXTBOT EXCHaNGE.

Un script de ejemplo que muestra cómo manejar la carga útil personalizada con Google Dialogflow CX.

Descargue este script.

Ejemplo de script para Eventos DE tiempo límite alternativos

Este es un ejemplo para demostrar cómo se puede utilizar esta acción en los scripts. No pretende ser un script completo. Es posible que se requiera scripting adicional.

Puede usar diferentes eventos de tiempo DE espera en diferentes puntos de su script. Por ejemplo, es posible que desee utilizar diferentes eventos de tiempo DE espera la primera y la segunda vez que tiempo DE espera de entrada de usuariose activa la propiedad. Este script de ejemplo muestra una forma posible de hacer que esto suceda.

En este script, las acciones de Snippet se utilizan para crear e incrementar un contador de tiempo límite. Después del segundo tiempo límite, se utiliza una acción de Snippet para establecer un evento DE tiempo límite diferente. El evento DE tiempo límite alternativo se transmite desde la acción de Snippet a la acción del voicebot a través de la propiedad automaticIntent .

Example script handling a voicebot action on user input timeout

Descargue este script.