Adaptive Cards

NiCE CXone Bot Builder admite el uso de Adaptive Cards en respuestas del bot.Puede usarlos en historias Se usa para entrenar a un bot para el manejo de interacciones según la intención y el contexto., reglas Se usa para definir la respuesta de un bot a mensajes que no cambian según el contexto. y respaldo texto sin formato alternativo que se envía cuando el destino no admite contenido multimedia enriquecido..

Desarrollado por Microsoft, Adaptive Cards Un ícono de un cuadrado con una flecha que apunta desde el centro hacia la esquina superior derecha. son un método para crear contenido de mensajería enriquecida Elementos en la mensajería digital, como botones, imágenes, menús y selectores de opciones.. son un formato de intercambio de tarjetas abiertas que le permiten enviar contenido UI de forma común y congruente. Con Adaptive Cards, puede enviar mensajes interactivos más complejos y útiles que los que contienen solo elementos estándar de medios enriquecidos.

Actualmente, solo la conversación digital admite Adaptive Cards. Los canales de chat en vivo actualmente admiten tarjetas adaptables en MAX, pero no en Agente. Si se envían mensajes con Adaptive Cards en otros canales, se utiliza en su lugar el texto de alternativa texto sin formato alternativo que se envía cuando el destino no admite contenido multimedia enriquecido. designado.

Bot Builder No tiene ninguna Adaptive Cards disponible de manera predeterminada.Debe diseñar las suyas propias usando el diseñador Microsoft Adaptive Card, que está integrado en Bot Builder.

Con el diseñador de Adaptive Card, puede crear plantillas de Adaptive Card para usar con Bot Builder. Cuando un bot ejecuta una respuesta que incluye una plantilla de Adaptive Card, la plantilla se completa dinámicamente con la información apropiada para esa interacción y se envía al contacto La persona que interactúa con un agente, IVR o bot en su centro de contacto..

Glossary

Concepto	Definición	Ejemplo	Qué hace el bot
Enunciado	Todo lo que un contacto La persona que interactúa con un agente, IVR o bot en su centro de contacto. dice en una interacción La conversación completa con un agente a través de un canal. Por ejemplo, una interacción puede ser una llamada de voz, un correo electrónico, un chat o una conversación de redes sociales.. A veces se denomina mensaje.	"Perdí MI contraseña." "¿Cuál es MI saldo?" "¿Eres un bot?"	El bot utiliza la Comprensión del Lenguaje Natural (NLU) para analizar cada enunciado de contacto y determinar su significado o intención.
Intención	Lo que el contacto quiere comunicar o lograr. Cada mensaje que envía el contacto tiene una intención.	"Perdí MI contraseña" tiene la intención de "restablecer la contraseña". "Hola" tiene la intención de "saludar".	El bot analiza el mensaje de un contacto utilizando NLU Este proceso amplía el Procesamiento de lenguaje natural (NLP) para tomar decisiones o actuar según lo que comprende. para determinar la intención. Una vez que sabe eso, puede responder con un mensaje propio. La respuesta que desea que su bot use para cada intención se configura.
Entidad	Información definida en el mensaje de un contacto.	Nombre de la persona o del producto, número de teléfono, número de cuenta, ubicación, etcétera.	El bot utiliza NLU para identificar entidades en el mensaje de un contacto. Las Entidades ayudan al bot a comprender qué significa el mensaje del contacto.
Espacio	Una entidad extraída del mensaje de un contacto y almacenada para su uso en las respuestas del bot. Similar a una variable.	La creación de un espacio para el nombre del contacto le permite al bot usar ese nombre en las respuestas durante una interacción, haciéndola más personal.	Cuando se configura para esto, el bot extrae una entidad de un mensaje de contacto y la guarda en un espacio. Usted puede hacer que su bot utilice esta información más adelante en la conversación.
Regla	Define las respuestas del bot a los mensajes que no cambian de significado con el contexto.	Interacciones de un solo turno con respuestas fijas: ¿Cuales son sus horarios? ¿Cual es tu dirección? Bloques básicos de la conversación: saludos, despedidas, agradecimientos y transiciones; preguntas sencillas de sí o no; y confirmaciones. Los bots de Bot Builder vienen con intenciones y reglas predeterminadas para varios de estos, incluidos los saludos, las solicitudes de transferencia La transferencia de un contacto desde un agente virtual a un agente en vivo. y más. Preguntas frecuentes Insultos y retos clásicos de bot	Las reglas son una de las dos formas en que puede configurar la manera en que su bot responde a una intención. Las Reglas son útiles para ciertos tipos de intenciones, pero no para todas.
Historia	Entrena a un bot para manejar una interacción según la intención del mensaje y el contexto conversacional.	En una interacción sobre una contraseña olvidada, el bot respondería a "¿Cómo hago eso?" de una manera. Si la interacción se tratara de crear una nueva cuenta, la respuesta sería bastante diferente, aun cuando en ambos casos el contacto esté usando las mismas palabras con la misma intención: obtener más información.	Las historias son la segunda de dos formas en que puede configurar cómo responde su bot a una intención. Las historias enseñan al bot cómo usar el contexto de la conversación para responder adecuadamente.
Acción del Bot	Todo lo que un bot dice o hace mientras maneja una interacción.	En una interacción sobre una contraseña olvidada, el bot responde enviando el enlace a las preguntas frecuentes para restablecer contraseñas en el sitio web. Cuando un contacto expresa frustración, como por ejemplo: "¡No entiendo!¡¡¡No está funcionando!!!" El bot responde con "Lo siento. ¿Quiere que le transfiera a un agente humano?" Cuando el contacto dice sí, el bot inicia la transferencia.	Las acciones del bot son las opciones que tiene al definir cómo desea que su bot responda a cada intención. Le brindan la flexibilidad de configurar cada respuesta para lograr el resultado que satisfaga las necesidades del contacto.

Compatibilidad de las Adaptive Card por Canal

Las Adaptive Cards sólo se pueden usar en canales que las admitan. Actualmente, solo admite canal de Digital chat.

Si su bot envía mensajes en canales que admiten Adaptive Cards, así como en canales que no lo hacen, debe configurar la alternativa texto sin formato alternativo que se envía cuando el destino no admite contenido multimedia enriquecido. de mensajería enriquecida. La alternativa se envía en lugar de los Adaptive Card en los canales que no los admiten. Puede configurar la alternativa de mensajería enriquecida para cada respuesta de bot que use Adaptive Cards.

Diseñador de Adaptive Card

El diseñador de Adaptive Card le permite crear plantillas de Adaptive Card para usar con Bot Builder. Cuando crea una historia, regla o alternativa, puede agregar la Adaptive Card acción de bot y luego elegir una de las Adaptive Cards que creó.

El diseñador de Adaptive Card es un producto de Microsoft integrado en Bot Builder. Hay documentación detallada sobre el uso del diseñador disponible en el Microsoft Adaptive Card sitio web Un ícono de un cuadrado con una flecha que apunta desde el centro hacia la esquina superior derecha. .

Puede usar cualquier elemento disponible de Adaptive Card en las tarjetas que desarrolle. Para personalizar un Adaptive Card de manera dinámica, puede usar variables de ranura Entidad extraída del mensaje del contacto y guardada para su uso en las respuestas del bot. Similar a una variable. . Si desea devolver datos a su bot, puede incluir datos de postback en las configuraciones de elementos tales como un botón. Por ejemplo, esto le permite devolver al bot la intención asociada con la elección del contacto.

Personalizar las Adaptive Cards con variables de ranura

You can include slot variables en su Adaptive Cards. Esto le permite mostrar la entidad Una pieza de información recopilada de los mensajes del contacto durante las Conversaciones con un bot. asociada con la ranura Entidad extraída del mensaje del contacto y guardada para su uso en las respuestas del bot. Similar a una variable. en la tarjeta cuando dicha tarjeta se envía a un contacto.

Una variable de ranura se construye usando el nombre de la entidad asociada con la ranura entre llaves. Por ejemplo, {phone_number}. Puede usar variables de ranura en las propiedades de un elemento en el diseñador de Adaptive Card. También puede buscar el elemento en la sección editor de Carga útil de la tarjeta del diseñador de Adaptive Card y agregar la variable de ranura al elemento. Por ejemplo, "text": "Phone Number: {phone_number}".

Botones interactivos

Puede incluir botones interactivos en sus Adaptive Card. Los puede agregar a cualquier elemento con una sección Acciones en sus propiedades. Hay varios tipos de botones en el diseñador de Adaptive Card que puede usar. Los siguientes tipos de botones son particularmente útiles con Bot Builder:

Botón de URL: El botón abre una URL. El JSON para este tipo de botón se ve como en el siguiente ejemplo:
```
{
  "type": "Action.OpenUrl",
  "title": "View",
  "url": "http://www.nice.com"
}
```
Botón de postback: El botón envía datos de postback al bot cuando el cliente hace clic o toca el botón. Puede usarlo para enviar una intención El significado o propósito detrás de lo que dice o escribe un contacto; lo que el contacto desea comunicar o lograr. de regreso al bot. El JSON para este tipo de botón se ve como en el siguiente ejemplo:
```
{
 "type": "Action.Submit",
 "title": "Connect with agent",
 "data": {
	"text": "/[intentName]"
 }
```

Crear una Adaptive Card

Las Adaptive Cards nuevas comienzan con un conjunto de elementos de ejemplo de manera predeterminada. Puede modificar los elementos de ejemplo o eliminarlos a todos para construir una tarjeta desde cero.

Después de crear un Adaptive Card, puede usarlo en una respuesta de bot.

En NiCE CXone, haga clic en el selector de aplicaciones y seleccione Otros > Bot Builder.
Haga clic en el bot con el que desea trabajar.
Haga clic en Preferencias > Adaptive Cards.
Para crear una carpeta, haga clic en el signo más e ingrese un nombre, luego presione intro.
En la carpeta a la que desea agregar un Adaptive Card, haga clic en el signo más .
Escriba un nombre para la tarjeta y pulse intro.
Add elements to your card:
- Haga doble clic en una opción dentro de Elementos de tarjeta para agregarla.
- Arrastre y suelte un elemento de la sección Card Elements en la vista previa de la tarjeta.
- Haga clic en la brújula del elemento en la vista previa de la tarjeta y arrastre el elemento a una nueva ubicación.
Configure your element's properties:
- Seleccione un elemento en la vista previa o en la sección Estructura de la tarjeta. La sección Propiedades del elemento muestra las propiedades del elemento seleccionado. Modifíquelas según sea necesario. Cada elemento tiene un conjunto distinto de propiedades.
- Use el Card Payload editor para ver, configurar o modificar las propiedades de un elemento.
- Haga clic en X de la esquina superior derecha de la vista previa para eliminar un elemento.
Utilice una ranura en un elemento al ingresar el nombre de entidad en un campo de propiedad de elemento. Escriba el nombre entre llaves.Por ejemplo, {phone_number}.
To add an interactive button to the card, configure an action in your card as follows:
- Abrir una URL: Seleccione Action.OpenURL como el Tipo de acción e ingrese la URL.
- Enviar datos de postback: Seleccione Action.Submit como el Tipo de acción y escriba el nombre de la intención en el campo Data con el formato {"text":"/[intentName]"}.
Para probar el aspecto de su tarjeta en la sección de vista previa, reemplace los datos predeterminados en la sección editor de datos de muestra con datos de ejemplo para su tarjeta.
Los cambios se guardan de forma automática.