Añadir respuestas del asistente de IA

Cuando se activa una acción, el cuerpo de la misma se compone de múltiples pasos que conforman la conversación entre tu asistente de IA y tus usuarios. Una parte de cada paso es lo que el asistente de IA dice al cliente cuando se procesa el paso.

Para crear la respuesta de tu asistente de IA en un paso, utiliza la sección Asistente dice. Representa el texto o la voz que el asistente de IA transmite al usuario en un paso determinado. En función del paso, puede añadir una respuesta completa a la pregunta de un usuario o hacer una pregunta de seguimiento.

Puedes introducir una respuesta de texto simple simplemente introduciendo el texto que quieres que tu asistente de IA muestre al usuario. También puede añadir formato y contenido web, y puede hacer referencia a la información del usuario utilizando variables.

Formato de respuestas

Utilice las herramientas del editor de texto para aplicar al texto el estilo de font, por ejemplo negrita o cursiva, o para añadir enlaces.

De modo subyacente, el estilo de font y la sintaxis del enlace se almacenan en el formato Markdown. Si utilizas la integración del chat web, se admiten las etiquetas HTML y Markdown. Para más información, véase Formato Markdown.

Las etiquetas HTML (excepto los enlaces) se eliminan automáticamente de las respuestas de texto que se envían a las integraciones de Facebook, WhatsApp, y Slack, porque esos canales no admiten el formato HTML. Las etiquetas HTML se siguen gestionando en los canales que las admiten (como el chat web) y se almacenan en el historial de la sesión.

Si utiliza una aplicación cliente personalizada que no es compatible con Markdown, no aplique el estilo de texto a las respuestas de texto.

Adición y referencia de variables

Durante la conversación, tu asistente de IA almacena información en forma de variables. Las variables son contenedores de valores de datos que están disponibles en tiempo de ejecución. El valor de una variable puede cambiar con el tiempo. Las variables incluyen variables de acción, que solo persisten durante una acción determinada, y variables de sesión, que están disponibles para cualquier acción. Para obtener más información sobre las variables, consulte Gestión de la información durante la conversación.

En la salida de su asistente de IA, puede hacer referencia a variables para personalizar la conversación o incluir información que esté disponible en tiempo de ejecución. Para obtener más información sobre cómo hacer referencia a variables en lo que dice tu asistente de IA, consulta Utilizar variables para personalizar la conversación.

Probar las respuestas

Para comprobar que las respuestas del asistente AI están formateadas correctamente, puede utilizar Vista previa.

  1. Pulse el botón Vista previa.
  2. Para iniciar la acción, escriba su primera frase, por ejemplo: What are your store hours?.
  3. Cuando el asistente de IA responda, comprueba que el mensaje se muestra tal y como pretendías con el formato y el uso de variables.

Consejos para añadir respuestas

  • Cree respuestas cortas y útiles.
  • Refleje la intención del usuario en la respuesta. Esto asegura a los usuarios que el bot les está entendiendo, o, si no es así, les ofrece la oportunidad de corregir un malentendido de inmediato.
  • Incluya enlaces a sitios externos en las respuestas si la respuesta depende de datos que cambian con frecuencia.
  • Redacte las respuestas cuidadosamente. Puede cambiar la reacción de alguien a su sistema en función de cómo formule una respuesta. El hecho de modificar una línea de texto puede evitar que tenga que escribir varias líneas de código para implementar una solución programática compleja.

Añadir variaciones

Si sus usuarios recurren con frecuencia a su asistente de IA, podrían aburrirse de ver siempre los mismos saludos y respuestas. Puedes añadir variaciones de respuesta para que tu asistente de IA pueda responder a la misma solicitud de diferentes maneras.

Puede optar por rotar entre las variaciones de respuestas secuencialmente o en orden aleatorio. De forma predeterminada, las respuestas se rotan secuencialmente, como si fueran seleccionadas en una lista ordenada.

Para añadir variaciones de respuesta:

  1. En Asistente dice, haga clic en el icono Añadir variaciones de respuesta ' Añadir variaciones de respuesta.

  2. Para Tipo de variación de respuesta, elija si desea rotar a través de las variaciones de respuesta secuencialmente o en orden aleatorio. Para más información, véase Secuencial o aleatorio.

    Variaciones de respuestas
    Variaciones de respuestas

  3. Añada cada variación en su propio campo. Por ejemplo:

    Número de respuesta Variación
    Respuesta 1 ¿En qué puedo ayudarle?
    Respuesta 2 ¿Qué puedo hacer hoy por usted?
    Respuesta 3 Dime en qué puedo ayudarte.
    Respuesta 4 ¿Puedo ayudarle?

  1. Cuando hayas terminado, haz clic en Aplicar. Las variaciones aparecen como un bloque dentro de Asistente dice. Puede hacer clic en el icono Editar para actualizar las variaciones, o en el icono Eliminar para eliminar todas las variaciones. Además, puede añadir varios conjuntos de variaciones de respuesta a un paso.

    Variaciones de respuesta en Assistant dice
    Variaciones de respuesta en Assistant dice

Secuencial o aleatorio

Para el tipo de variación de respuesta, puede elegir Secuencial o Aleatorio.

Secuencial devuelve la primera variación de respuesta la primera vez que se dispara la acción, la segunda variación de respuesta la segunda vez que se dispara la acción, y así sucesivamente, en el mismo orden en que introdujo las variaciones. Esto da lugar a respuestas devueltas en el siguiente orden cuando se procesa el nodo:

  • Primera vez:

    How can I help you?

  • Segunda vez:

    What can I do for you today?

  • Tercera vez:

    Tell me what I can help with.

  • Cuarta vez:

    Can I help you?

Aleatoriamente selecciona la variación la primera vez que se activa la acción, y aleatoriamente selecciona otra variación la siguiente vez, pero sin repetir la misma variación consecutivamente. Este ejemplo muestra el orden en que pueden aparecer las respuestas:

  • Primera vez:

    Tell me what I can help with.

  • Segunda vez:

    Can I help you?

  • Tercera vez:

    How can I help you?

  • Cuarta vez:

    What can I do for you today?

Respuestas de los medios de comunicación

Además de las respuestas de texto, puede utilizar otros tipos de respuesta para enviar respuestas que incluyan elementos multimedia o interactivos.

El editor de acciones admite los siguientes tipos de respuesta multimedia:

  • Imagen: Se incluye una imagen en la respuesta. El archivo de imagen de origen debe estar alojado en algún lugar y debe tener un URL que se puede utilizar para hacer referencia al mismo. No puede ser un archivo que esté almacenado en un directorio que no sea accesible al público.
  • Vídeo: incluye un reproductor de vídeo en la respuesta. El vídeo de origen debe estar alojado en algún lugar, ya sea como un vídeo que se puede reproducir en un servicio de transmisión de vídeo compatible o como un archivo de vídeo al que se puede hacer referencia con un URL. No puede ser un archivo que esté almacenado en un directorio que no sea accesible al público.
  • Audio: incluye un clip de audio en la respuesta. El archivo de audio de origen debe estar alojado en algún lugar y tener un URL con el que hacer referencia al archivo. No puede ser un archivo que esté almacenado en un directorio que no sea accesible al público.
  • iframe: incluye en la conversación, directamente, contenido de un sitio web externo, como un formulario u otro componente interactivo. El contenido de origen debe ser de acceso público mediante HTTP y debe poder incorporarse como un elemento iframe HTML.

Las diferentes integraciones de canales tienen diferentes capacidades para mostrar las respuestas de los medios de comunicación. Para ver qué integraciones de canal admiten qué tipos de respuesta, consulte ' Soporte de integración de canales para tipos de respuesta.

Si desea definir diferentes respuestas personalizadas para diferentes canales, puede hacerlo editando la respuesta mediante el editor JSON. Para obtener más información, consulte Definición de destino de integraciones específicas.

Al editar sus respuestas en el editor JSON, también puede acceder a más tipos de respuesta para gestionar interacciones específicas del canal.

Para obtener más información sobre cómo editar respuestas mediante el editor JSON, consulte Definición de respuestas mediante el editor JSON.

Añadir una respuesta de imagen

Añade una respuesta de Imagen para mostrar una imagen al cliente.

El tipo de respuesta Imagen es compatible con las siguientes integraciones de canal:

  • Conversación web
  • SMS
  • Slack
  • Microsoft Teams
  • Facebook
  • WhatsApp

Para añadir una respuesta de Imagen, complete los siguientes pasos:

  1. En el campo Asistente dice, haga clic en el icono de imagen ' Imagen.

  2. En el campo Fuente URL, escriba la dirección URL completa de la imagen alojada.

    La imagen debe estar en formato ' JPEG' , ' GIF, o ' PNG. El archivo de imagen debe almacenarse en una ubicación a la que pueda acceder públicamente una dirección https: URL (como https://www.example.com/assets/common/logo.png).

    Para acceder a una imagen almacenada en IBM Cloud® Object Storage, habilite el acceso público al objeto de almacenamiento de imágenes individual y, a continuación, haga referencia a él especificando el origen de la imagen con una sintaxis como la siguiente: https://s3.eu.cloud-object-storage.appdomain.cloud/your-bucket-name/image-name.png.

  3. Si lo desea, puede especificar el título, la descripción y el texto alternativo de la imagen en los campos correspondientes. En la integración del chat web, el título y la descripción se muestran junto con la imagen.

    No se admiten referencias a variables. Algunos canales de integración ignoran títulos o descripciones.

  4. Haga clic en Aplicar.

Añadir una respuesta de audio

Añada una respuesta de audio para incluir palabras habladas u otro contenido audible. En el chat web, una respuesta de audio se representa como un reproductor de audio incrustado. En la integración telefónica, una respuesta de audio se reproduce por teléfono.

El tipo de respuesta Audio es compatible con las siguientes integraciones de canal:

  • Conversación web
  • Teléfono
  • SMS
  • Slack
  • Facebook
  • WhatsApp

Para añadir una respuesta de Audio, complete los siguientes pasos:

  1. En el campo "Assistant says ", haga clic en el icono de audio " Audio ".

  2. En el campo Fuente URL, escriba la dirección URL completa del clip de audio alojado:

    • Para crear un enlace directo con un archivo de audio, especifique el URL a un archivo con cualquier formato estándar, como MP3 o WAV. En el chat web, el clip de audio vinculado se muestra como un reproductor de audio incrustado.

    • Para crear un enlace a un clip de audio en un servicio de alojamiento de audio admitido, especifique el URL al clip de audio. En el chat web, el clip de audio vinculado se reproduce mediante el reproductor integrado del servicio de alojamiento.

      Especifique el URL que utilizaría para acceder al archivo de audio en su navegador (por ejemplo, https://soundcloud.com/ibmresearch/fallen-star-amped). No es necesario que convierta el URL en un formato incrustable; el chat web lo hace automáticamente.

      Puede incluir audio alojado en los siguientes servicios:

  3. Si lo desea, puede especificar un título, una descripción y un texto alternativo en los campos correspondientes. En la integración del chat web, el título y la descripción se muestran junto con el reproductor de audio.

    No se admiten referencias a variables. Algunos canales de integración ignoran títulos o descripciones.

Añadir una respuesta de vídeo

Añada una respuesta de vídeo para mostrar una demostración práctica, un clip promocional u otro contenido de vídeo. En la conversación web, una respuesta de vídeo se representa como un reproductor de vídeo incluido.

El tipo de respuesta Vídeo es compatible con las siguientes integraciones de canal:

  • Conversación web
  • SMS
  • Slack
  • Facebook
  • WhatsApp

Para añadir una respuesta de Vídeo, complete los siguientes pasos:

  1. En el campo "Assistant says ", haga clic en el icono de vídeo " Vídeo ".

  2. En el campo Fuente URL, escriba la dirección URL completa del vídeo alojado:

    • Para crear un enlace directo con un archivo de vídeo, especifique el URL a un archivo con cualquier formato estándar, como MPEG o AVI. En el chat web, el vídeo enlazado se muestra como un reproductor de vídeo incrustado.

      Los vídeos de transmisión HLS (.m3u8) y DASH (MPD) no se admiten.

    • Para crear un enlace con un vídeo alojado en un servicio de alojamiento de vídeos admitido, especifique el URL del vídeo. En el chat web, el vídeo enlazado se reproduce utilizando el reproductor incrustable del servicio de alojamiento.

      Especifique el URL que utilizaría para ver el vídeo en su navegador (por ejemplo, https://www.youtube.com/watch?v=52bpMKVigGU). No es necesario que convierta el URL en un formato incrustable; el chat web lo hace automáticamente.

      Puedes incrustar vídeos alojados en los siguientes servicios:

  3. Si lo desea, puede especificar un título de vídeo, una descripción y un texto alternativo en los campos correspondientes. En la integración del chat web, el título y la descripción se muestran junto con el reproductor de vídeo.

    No se admiten referencias a variables. Algunos canales de integración ignoran títulos o descripciones.

  4. Si quiere escalar el vídeo a un tamaño de pantalla concreto, especifique un número en el campo Altura base.

Añadir una respuesta iframe

Añada una respuesta iframe para incrustar contenido de otro sitio web directamente dentro de la ventana de chat como un elemento HTML ' iframe '. Una respuesta iframe resulta útil si se quiere permitir que los clientes interactúen con un servicio externo sin salir de la conversación. Por ejemplo, puede utilizar una respuesta iframe para mostrar los siguientes ejemplos dentro del chat web:

En el chat web, hay dos formas de incluir el iframe:

  • Como una tarjeta de vista previa que describe el contenido incrustado. Los clientes pueden pulsar esta tarjeta para visualizar el marco e interactuar con el contenido.
  • Inline, es decir, dentro de la conversación. Esta opción es buena para piezas más pequeñas de contenido iframe.

El tipo de respuesta iframe es compatible con las siguientes integraciones de canal:

  • Conversación web
  • Facebook

Para añadir un tipo de respuesta iframe, siga estos pasos:

  1. En el campo Assistant says, haga clic en el icono iframe (iframe).

  2. Añada el URL completo al contenido externo en el campo Origen de iframe.

    El URL debe especificar contenido que se pueda incorporar a un elemento HTML iframe. Los distintos sitios tienen diferentes restricciones para incrustar contenidos y diferentes procesos para generar URL incrustables. Un URL incorporable es aquel que se puede especificar como valor del atributo src del elemento iframe.

    Por ejemplo, para incrustar un mapa interactivo que utilice Google Maps, puede utilizar la API de incrustación de Google Maps. Para obtener más información, consulte Descripción general de la API de incrustación de mapas. Otros sitios cuentan con procesos diferentes para crear contenido incorporable.

    Para conocer los detalles técnicos del uso de ' Content-Security-Policy: frame-src ' que te da permiso para incrustar el contenido del sitio web en tu asistente de IA, consulta CSP: frame-src.

  3. Si quiere, añada un título descriptivo en el campo Título.

    En el chat web, el título que añada se mostrará en la tarjeta de vista previa. El cliente hace clic en la tarjeta de vista previa para visualizar el contenido externo.

    Si no se especifica un título, el chat web intenta recuperar los metadatos de la dirección URL especificada y muestra el título del contenido según lo especificado en la fuente.

    No se admiten referencias a variables.

  4. Para mostrar el iframe en el flujo de la conversación, en lugar de como una tarjeta de vista previa, establece Mostrar iframe en línea en Activado. También puede establecer la altura del iframe. El valor predeterminado es 180 píxeles.

Detalles técnicos: sandboxing iframe

El contenido que se carga en un iframe mediante el chat web está aislado, lo que significa que restringe los permisos que reducen las vulnerabilidades de seguridad. La conversación web utiliza el atributo sandbox del elemento iframe para otorgar solo los permisos siguientes:

Permiso Descripción
allow-downloads Permite descargar archivos de la red, si es el usuario quien inicia la descarga.
allow-forms Permite enviar formularios.
allow-scripts Permite ejecutar scripts, pero no abrir ventanas emergentes.
allow-same-origin Permite que el contenido acceda a su propio almacenamiento de datos (como cookies) y permite un acceso limitado a las API de JavaScript.

Un script que se ejecuta dentro de un iframe aislado no puede cambiar ningún contenido fuera del iframe, si la página exterior y el iframe tienen orígenes diferentes. Ten cuidado si utilizas una respuesta iframe para incrustar contenido que tenga el mismo origen que la página donde está alojado tu widget de chat web. En esta situación, el contenido incrustado puede vencer el sandboxing y acceder al contenido fuera del marco. Para más información sobre esta posible vulnerabilidad, consulte la documentación del atributo ' sandbox '.

Ficha técnica: tarjeta de vista previa iframe

El tipo de respuesta ' iframe ' en el chat web muestra la tarjeta Vista previa, que incluye una imagen, un título y una descripción de la página web que el usuario visita en el chat web.

Para mostrar una imagen, título y descripción en la tarjeta de vista previa, la página web necesita las siguientes etiquetas ' <meta> ' dentro de la etiqueta ' <head> ':

<meta property="og:image" content="https://.../image.jpg" />
<!--or-->
<meta property="og:image:url" content="https://.../image.jpg" />

<meta property="og:title" content="The webpage title" />
<meta property="og:description" content="The webpage description" />

Estas propiedades de metadatos especificadas proceden de The Open Graph Protocol.

Los metadatos son opcionales. El chat web muestra una tarjeta de vista previa con la url de la página web y los metadatos, que el chat web ha obtenido correctamente.

Pausa respuesta

Utilice una respuesta de pausa para que su asistente de IA espere un intervalo especificado antes de la siguiente respuesta. Esta pausa da tiempo a que se complete una solicitud, o actúa como un agente en directo que hace una pausa entre respuestas. La pausa debe tener una duración cualquiera entre " 0 " y " 60 segundos, que puede incluir decimales de segundo para configurar la pausa hasta " milliseconds.

La respuesta Pausa suele utilizarse en combinación con otras respuestas. Por defecto, durante la pausa aparece una animación indicadora de escritura para simular a un agente en directo.

El tipo de respuesta Pausa es compatible con las siguientes integraciones de canal:

  • Conversación web
  • Facebook
  • WhatsApp

Con el canal telefónico, puede añadir una pausa incluyendo el elemento SSML ' break en la salida del asistente AI. Para más información, consulte la documentaciónText to Speech.

Para añadir una respuesta de Pausa:

  1. En el campo Asistente dice, haga clic en el icono Pausa ' Pausa.

  2. En el campo Duración, introduzca la duración de la pausa en " seconds.

    La duración no debe ser superior a ' 60 seconds. Además, puede introducir los decimales de " second en el campo Duración para pausar la respuesta hasta " milliseconds. Por ejemplo, si introduce " 10.50 seconds, la respuesta se detiene en " 10500 milliseconds. Los clientes suelen estar dispuestos a esperar unos 8 segundos a que alguien introduzca una respuesta.

  3. El indicador de escritura está activado por defecto. Si lo desea, puede desactivarlo.

    Añada otro tipo de respuesta, como por ejemplo un tipo de respuesta de texto, después de la pausa para indicar claramente que se ha terminado la pausa.