Snippet de carga útil personalizada

La información de esta página de ayuda se aplica tanto a Studio como a Desktop Studio.

El snippet Custom Payload es obligatorio en su script cuando se usan acciones que tienen la propiedad customPayload, como Voicebot Exchange o Textbot Conversation. Se utiliza para pasar datos de NiCE CXone a su proveedor de agente virtualClosed A software application that handles customer interactions in place of a live human agent.. Si necesita recibir datos personalizados de su agente virtual, use la variable customPayloadVarName (out). Use la información de esta página para crear el snippet Carga útil personalizada que cumpla con los requisitos de la implementación del agente virtual de su organización.

Este fragmento es necesario para los siguientes agentes virtuales:

Para todos los demás agentes virtuales, solo debe incluir el fragmento si tiene datos de carga útil personalizada que necesita transmitir al bot. Si utiliza Dialogflow CX, siga las prácticas recomendadas para incluir la carga útil personalizada. Si no incluye un Snippet de carga útil personalizada, asegúrese de pasar un parámetro de marcador.

Pasar un Marcador

Si utiliza un agente virtual que no necesita que se le pase información, como Amazon Lex V2 o Amazon Lex V1, siga este ejemplo:

DYNAMIC customPayload 
 customPayload.placeholder=""

Transmitir datos

Para todos los proveedores de agente virtual que deben pasar información al agente virtual, siga este ejemplo. Reemplace los parámetros del ejemplo con la información que necesite transmitir.

DYNAMIC customPayload
ASSIGN customPayload.context.id="information"
ASSIGN customPayload.context.lifespan=1
ASSIGN customPayload.context.parameters.name="Fenrir"
ASSIGN customPayload.context.parameters.age="19"
ASSIGN customPayload.context.parameters.date="20201020"			

Google Dialogflow CX Carga útil personalizada

  • 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()}"	
  • 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 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.

Pistas de Contexto de voz para Dialogflow CX

Sugerencias de contexto de voz se pueden pasar en el snippet Carga útil personalizada en el parámetro speechContexts. El valor de speechContexts.phrases debe ser un token de clase Google Un cuadrado con una flecha que apunta desde el centro hacia la esquina superior derecha. para la sugerencia que desea proporcionar. El token debe coincidir con el idioma y la configuración regional de sus contactos. Por ejemplo:

DYNAMIC customPayload
customPayload.speechContexts.phrases="$OOV_CLASS_ALPHANUMERIC_SEQUENCE"
customPayload.speechContexts.boost=10		

Configure estos parámetros de la siguiente manera:

  • speechContexts.phrases: El token de clase Google Un cuadrado con una flecha que apunta desde el centro hacia la esquina superior derecha. para la sugerencia que desea proporcionar. El token debe coincidir con el idioma y la configuración regional de sus contactos. Si desea agregar varios tokens, agregue un parámetro speechContexts.phrases para cada token.
  • speechContexts.boost: Un valor numérico ponderado entre 1-20 para el phrase especificado. El servicio de transcripción utiliza este valor al seleccionar una transcripción posible para las palabras en los datos de audio. Cuanto más alto sea el valor, mayor será la probabilidad de que el servicio de transcripción elija esa palabra o frase entre las alternativas.

Puede ver el contenido de este parámetro en Studio rastreos y en los registros de la aplicación.

Transferencia de contactos entre Agentes virtuales de CX de Dialogflow

Para configurar la transferencia de un contacto de un agente virtual de Dialogflow CX a otro agente virtual de Dialogflow CX, incluya la siguiente línea en el snippet Carga útil personalizada. Reemplace custom_value con el nombre DE variable que contiene el ID de la conversación:

{
  “cxone_override_conversation“: {custom_value} 
}		

Asegúrese de configurar su script para completar la variable que utiliza con este parámetro.

Su script debe configurarse cuidadosamente para que

El parámetro cxone_override_conversation es similar al id de estado de la sesión del bot establecido en el snippet Bot Session State. Ambos ayudan al agente virtual a mantener el contexto de la conversación entre turnos. Su script debe configurarse cuidadosamente para que los valores de id de estado de la sesión del bot y de ID de conversación aparezcan en las ubicaciones correctas. El estado de la sesión del bot siempre tiene prioridad sobre el parámetro cxone_override_conversation. Configure su script de la siguiente manera:

Agente virtual # N.º de turno Configuración
1 1 La propiedad botSessionState de la acción Voicebot EXCHANGE o Textbot EXCHANGE está vacía. El turno devuelve un id de estado de sesión de bot y completa botSessionStateVarName (out). Este es el id de estado de sesión de bot n.º 1.

1

2 y turnos posteriores con este agente virtual El script envía el id de estado de sesión del bot #1 al agente virtual de CX Dialogflow #1. El mismo ID se devuelve al script.
2 3 (primero con este agente virtual)

La propiedad botSessionState de la acción Voicebot EXCHANGE o Textbot EXCHANGE está vacía.

La fragmento de carga útil personalizada para este turno contiene cxone_override_conversation = [variable].

El turno devuelve un id de estado de sesión de bot único y completa botSessionStateVarName (out), sobrescribiendo cualquier valor que ya contenga. Este es el id de estado de sesión de bot n.º 2.

2 4 (segundo turno con este agente virtual) El script envía el id de estado de sesión de bot #2 al agente virtual de CX Dialogflow #2. El mismo ID se devuelve al script.

Si usa más que DOs instancias de Dialogflow CX, el patrón continúa como se estableció en la tabla anterior.

Este método para transferir entre agentes virtuales solo es necesario cuando se realiza una transferencia entre DOs o más agentes virtuales de Dialogflow CX. Si está transfiriendo entre otros proveedores de agentes virtuales, puede usar el Id de estado de la sesión del bot.

Google Dialogflow ES Carga útil personalizada

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

Sugerencias de Contexto de voz para Dialogflow ES

Sugerencias de contexto de voz se pueden pasar en el snippet Carga útil personalizada en el parámetro speechContexts. El valor de speechContexts.phrases debe ser un token de clase Google Un cuadrado con una flecha que apunta desde el centro hacia la esquina superior derecha. para la sugerencia que desea proporcionar. El token debe coincidir con el idioma y la configuración regional de sus contactos. Por ejemplo:

DYNAMIC customPayload
customPayload.speechContexts.phrases="$OOV_CLASS_ALPHANUMERIC_SEQUENCE"
customPayload.speechContexts.boost=10		

Configure estos parámetros de la siguiente manera:

  • speechContexts.phrases: El token de clase Google Un cuadrado con una flecha que apunta desde el centro hacia la esquina superior derecha. para la sugerencia que desea proporcionar. El token debe coincidir con el idioma y la configuración regional de sus contactos. Si desea agregar varios tokens, agregue un parámetro speechContexts.phrases para cada token.
  • speechContexts.boost: Un valor numérico ponderado entre 1-20 para el phrase especificado. El servicio de transcripción utiliza este valor al seleccionar una transcripción posible para las palabras en los datos de audio. Cuanto más alto sea el valor, mayor será la probabilidad de que el servicio de transcripción elija esa palabra o frase entre las alternativas.

Puede ver el contenido de este parámetro en Studio rastreos y en los registros de la aplicación.