Tutorial: Incorporación de una base de conocimiento a Power Virtual Agents

Crea y extienda un bot de Power Virtual Agents para ofrecer respuestas desde su base de conocimiento.

En este tutorial, aprenderá a:

Integración de un agente con una base de conocimiento

Power Virtual Agents permite a los equipos crear bots eficaces mediante una interfaz gráfica guiada y sin código. No necesita científicos ni desarrolladores de datos.

En Power Virtual Agents, un agente se crea con una serie de temas (áreas temáticas), con el fin de responder a las preguntas de los usuarios mediante la realización de acciones. Si no se puede encontrar una respuesta, una reserva del sistema puede encargarse de devolverla.

Configure el agente para que envíe la pregunta a su base de conocimiento como parte de la acción de un tema o como parte de la ruta del tema System Fallback (Reserva del sistema). Ambos usan una acción para conectarse a la base de conocimiento y devolver una respuesta.

Power Automate se conecta a la acción GenerateAnswer

Para conectar un agente a una base de conocimiento, se usa Power Automate para crear la acción. Power Automate proporciona un flujo de procesos que se conecta a la API GenerateAnswer de QnA Maker.

Después de diseñar el flujo y guardarlo, está disponible desde cualquier solución de Power Automate. Use esa solución como una acción en el agente.

Conexión de un agente a la base de conocimiento

Esta es una introducción a los pasos para conectar un agente de Power Virtual Agents a una base de conocimiento en QnA Maker.

• En el portal de QnA Maker:
  • Se crea y publica la base de conocimiento.
  • Se copian los detalles de la base de conocimiento, lo que incluye el identificador, y la clave y el host del punto de conexión del entorno de ejecución.
• En el portal de Power Virtual Agents:
  • Se crea un tema del agente.
  • Se llama a una acción (en el flujo de Power Automate).
• En el portal de Power Automate:
  • Busque la plantilla Generate answer using QnA Maker (Generar respuesta con QnA Maker).
  • Use la plantilla para configurar el flujo para usar GenerateAnswer de QnA Maker.
    • Información de la base de conocimiento publicada por QnA Maker:
      • Id. de base de conocimiento
      • Host del punto de conexión de recursos de QnA Maker
      • Clave del punto de conexión de recursos de QnA Maker
    • Entrada: consulta del usuario
    • Salida: respuesta de la base de conocimiento
  • Cree una solución y agregue el flujo, o bien agregue el flujo a la solución existente.
• De vuelta a Power Virtual Agents:
  • Se selecciona la salida de la solución como un mensaje para un tema.

Crear y publicar una base de conocimiento

1. Siga el inicio rápido para crear una base de conocimiento. No complete la última sección sobre la creación de un bot. En su lugar, use este tutorial para crear un bot con Power Virtual Agents.

   

   Escriba la configuración de la base de conocimiento publicada que se encuentra en la página Settings (Configuración) del portal de QnA Maker. Necesitará esta información en el paso de Power Automate, para configurar la conexión de GenerateAnswer de QnA Maker.

2. En el portal de QnA Maker, en la página Settings (Configuración), busque la clave y el host del punto de conexión, y el identificador de la base de conocimiento.

Creación de un agente en Power Virtual Agents

1. Inicie sesión en Power Virtual Agents. Use su cuenta de correo electrónico profesional o educativa.

2. Si este es su primer bot, debería estar en la página principal del agente. Si no, seleccione el bot en el área superior derecha de la página y, después, seleccione + New Bot (+ Nuevo bot).

   

Temas incluidos en el bot

El agente usa la colección de temas para responder las preguntas sobre una materia. En este tutorial, el agente tiene muchos temas, que se dividen en temas de usuario y temas del sistema.

Seleccione Temas en el panel de navegación izquierdo para ver los temas que proporciona el bot.

Creación de un tema de reserva del sistema

Aunque el agente puede conectarse a su base de conocimiento desde cualquier tema, en este tutorial se usa el tema System Fallback (Reserva del sistema). El tema de reserva se usa cuando el agente no encuentra una respuesta. El agente pasa el texto del usuario a la API GenerateAnswer de QnA Maker, recibe la respuesta de la base de conocimiento y se la muestra al usuario en forma de mensaje.

1. En el portal de Power Virtual Agents, en la esquina superior derecha, seleccione Settings (Configuración) (el icono de engranaje). Después, seleccione System Fallback (Reserva del sistema).

   

2. Seleccione + Add (+ Agregar) para agregar un tema de reserva del sistema.

   

3. Una vez agregado el tema, seleccione Go to Fallback topic (Ir a tema de reserva) para crear el tema de reserva en el lienzo de creación.

   Sugerencia

   Si necesita volver a este tema, está disponible en la sección Topics (Temas), como parte de los temas System (Sistema).

Uso de un lienzo de creación para agregar una acción

Use el lienzo de creación de Power Virtual Agents para conectar el tema de reserva con la base de conocimiento. El tema comienza con el texto de usuario no reconocido. Agregue una acción que pase dicho texto a QnA Maker y, después, muestre la respuesta en forma de mensaje. El último paso para mostrar una respuesta se tratará como un paso independiente, más adelante en el tutorial.

En esta sección se crea un flujo de conversación del tema de reserva.

1. Es posible que la nueva acción de reserva tenga elementos del flujo de conversación. Elimine el elemento Escalate (Escalar), para lo que debe seleccionar el menú Options (Opciones).

   

2. Seleccione el conector + que fluye al cuadro Mensaje y, después, seleccione Call an action (Llamar a una acción).

   

3. Seleccione Create a flow (Crear un flujo). El proceso le llevará al portal de Power Automate.

   

   Power Automate se abre con una nueva plantilla. No usará esta nueva plantilla.

   

Creación de un flujo de Power Automate para conectarse a una base de conocimiento

En el procedimiento siguiente se crea un flujo de Power Automate que:

• Toma el texto de usuario de entrada y lo envía a QnA Maker.
• Devuelve la respuesta principal al agente.

1. En Power Automate, seleccione Plantillas en el panel de navegación izquierdo. Si se le pregunta si desea salir de la página del explorador, acepte Salir.

2. En la página de plantillas, busque la plantilla Generate answer using QnA Maker (Generar respuesta con QnA Maker) y, a continuación, selecciónela. Esta plantilla incluye todos los pasos necesarios para llamar a QnA Maker con la configuración de la base de conocimiento y devolver la respuesta principal.

3. En la nueva pantalla del flujo de QnA Maker, seleccione Continuar.

   

4. Seleccione el cuadro de acción Generate Answer (Generar respuesta) y rellene la configuración de QnA Maker de la sección anterior titulada Crear y publicar una base de conocimiento. El host del servicio de la imagen siguiente hace referencia al host de la base de conocimiento Host y tiene el formato https://YOUR-RESOURCE-NAME.azurewebsites.net/qnamaker.

   

5. Seleccione Guardar para guardar el flujo.

Creación de una solución e incorporación del flujo

Para que el agente encuentre el flujo y se conecte a él, este debe estar incluido en una solución de Power Automate.

1. En el portal de Power Automate, seleccione Solutions (Soluciones) en el panel de navegación izquierdo.

2. Seleccione + New solution (+ Nueva solución).

3. Escriba un nombre para mostrar. La lista de soluciones incluye todas y cada una de las soluciones de su organización o centro educativo. Elija una Convención de nomenclatura que le ayude a filtrar solo por sus soluciones. Por ejemplo, puede anteponer el correo electrónico al nombre de la solución: jondoe-power-virtual-agent-qnamaker-fallback.

4. Seleccione su editor en la lista de opciones.

5. Acepte los valores predeterminados del nombre y la versión.

6. Seleccione Create (Crear) para finalizar el proceso.

Incorporación del flujo a la solución

1. En la lista de soluciones, seleccione la que acaba de crear. Debería estar la primera de la lista. Si no lo está, busque por nombre de correo electrónico, que es parte del nombre de la solución.

2. En la solución, seleccione + Add existing (+ Agregar existente) y, luego, Flow (Flujo) en la lista.

3. Busque el flujo en la lista Outside solutions (Soluciones externas) y, a continuación, seleccione Agregar para finalizar el proceso. Si hay muchos flujos, examine la columna Modified (Modificado) para encontrar el flujo más reciente.

Incorporación del flujo de una solución a Power Virtual Agents

1. Vuelva a la pestaña del explorador con el agente en Power Virtual Agents. El lienzo de creación debería estar aún abierto.

2. Para insertar un nuevo paso en el flujo, encima del cuadro de acción Mensaje, seleccione el conector + . A continuación, seleccione Call an action (Llamar a una acción).

3. En la ventana emergente Flujo, seleccione el nuevo flujo llamado Generate answers using QnA Maker knowledge base (Generar respuestas con la base de conocimiento de QnA Maker). La nueva acción aparece en el flujo.

   

4. Para establecer correctamente la variable de entrada en la acción de QnA Maker, elija Seleccionar una variable y, a continuación, bot.UnrecognizedTriggerPhrase.

   

5. Para establecer correctamente la variable de salida en la acción de QnA Maker, en la acción Mensaje, seleccione UnrecognizedTriggerPhrase, el icono para insertar una variable, {x}, y, a continuación, FinalAnswer.

6. En la barra de herramientas contextual, seleccione Save (Guardar) a fin de guardar los detalles del lienzo de creación para el tema.

Este es el aspecto final del lienzo del agente.

Prueba del agente

1. En el panel del prueba, alterne Track between topics (Seguimiento entre temas). De este modo puede ver la progresión tanto entre los temas como en un tema individual.

2. Pruebe el agente; para ello, escriba el texto del usuario en el orden siguiente. En el lienzo de creación, los pasos correctos tienen una marca de comprobación verde.

   Orden de pregunta	Preguntas de prueba	Propósito
   1	Hola	Empezar conversación
   2	Horario de la tienda	Tema de ejemplo. Se configura automáticamente, por lo que no tiene que hacer nada más.
   3	Sí	En respuesta a Did that answer your question?
   4	Excelente	En respuesta a Please rate your experience.
   5	Sí	En respuesta a Can I help with anything else?
   6	¿Cómo puedo mejorar el rendimiento de las predicciones de consulta?	Esta pregunta desencadena la acción de reserva, que envía el texto a la base de conocimiento para responder. A continuación, se muestra la respuesta. Las marcas de verificación verdes de las acciones individuales indican la correcta finalización de cada acción.

   

Publicar el bot

Para que el agente esté disponible para todos los miembros del centro educativo o de la organización, es preciso que lo publique.

1. En el panel de navegación de la izquierda, seleccione Publish (Publicar). A continuación, seleccione Publish (Publicar) en la página.

2. Pruebe su bot en el sitio web de demostración (busque el vínculo en Publish [Publicar]).

   Se abre una nueva página web con su bot. Realice la misma pregunta de prueba al bot: How can I improve the throughput performance for query predictions?

   

Uso compartido de un bot

Para compartir el sitio web de demostración, configúrelo como si fuera un canal.

1. En el panel de navegación de la izquierda, seleccione Manage > Channels (Administrar > Canales).

2. Seleccione Demo website (Sitio web de demostración) en la lista de canales.

3. Copie el vínculo y seleccione Save (Guardar). Pegue el vínculo al sitio web de demostración en un correo electrónico dirigido a los miembros de su organización o centro educativo.

Limpieza de recursos

Cuando haya terminado con la base de conocimiento, elimine los recursos de QnA Maker en Azure Portal.

Paso siguiente

Obtener análisis en la base de conocimiento

Más información sobre:

• Power Virtual Agents
• Power Automate
• Conector de QnA Maker y la configuración del conector