Creación y edición de temas

En Copilot Studio, un tema define cómo se desarrolla una conversación de agente.

Para crear temas, puede describir lo que desea y hacer que la IA cree el tema por usted, o crear temas desde cero.

En Copilot Studio, un tema representa una parte de un hilo de conversación entre un usuario y un agente. Define y trabaje con temas sobre un lienzo de creación. Un tema contiene uno o varios nodos, que juntas definen las rutas conversacionales que puede tomar un tema. Cada nodo realiza una acción, como enviar un mensaje o hacer una pregunta.

Para obtener más información sobre los límites de agentes y temas, consulte Cuotas, límites, registro de aplicaciones, certificados y valores de configuración.

Requisitos previos

• Para crear un agente, consulte Inicio rápido: crear e implementar un agente.

Seleccionar el tema adecuado para responder a un usuario

Para determinar cómo responder a los usuarios, los agentes utilizan la orquestación generativa o la orquestación clásica.

Con la orquestación generativa, un agente determina la combinación más adecuada de temas, acciones y conocimientos que se debe utilizar para responder a las consultas de los usuarios o a los desencadenadores de eventos. Cada tema tiene una descripción que informa al agente de su propósito. Obtenga más información sobre las descripciones de creación.

En los agentes configurados para usar la orquestación clásica, cada tema tiene un conjunto de frase desencadenadoras: frases, palabras clave y preguntas que es probable que un cliente use para consultas relacionadas con un problema específico. Los agentes utilizan la comprensión del lenguaje natural, el mensaje de su cliente y las frases desencadenantes de todos sus temas para encontrar el mejor tema para activar. No es necesario que la entrada del cliente coincida exactamente con una frase desencadenante del tema para activar el tema. Por ejemplo, un tema sobre el horario de la tienda podría tener la frase desencadenadora "comprobar el horario de la tienda". Si un cliente escribe "ver el horario de apertura de la tienda", esta frase desencadena el tema del horario de la tienda. Más información sobre la creación de frases desencadenadoras.

Temas en Copilot Studio

Aplicación web

Un agente puede tener dos tipos de temas, temas del sistema y personalizados . Cada nuevo agente comienza con un conjunto de temas del sistema y temas personalizados predefinidos.

• Los temas del sistema admiten comportamientos esenciales, como una solicitud personalizada para hablar con una persona o finalizar la conversación. Algunos temas del sistema tienen frases desencadenantes, que puede personalizar para que se ajusten a las necesidades de su agente.

  • No puede crear temas del sistema.
  • No puede eliminar temas del sistema, pero se pueden deshabilitar.
  • Puede hacer cambios en los temas del sistemas. Sin embargo, hasta que no se sienta cómodo creando experiencias completas para los agentes, no le recomendamos que edite los temas del sistema.

  Para obtener más información, consulte Usar temas del sistema.

• Los temas personalizados predefinidos cubren comportamientos comunes, como saludar a un cliente, finalizar una conversación o reiniciar una conversación.

  • Puede realizar cambios en los temas personalizados predefinidos o eliminarlos por completo de su agente.
  • Todos los temas que cree son temas personalizados.

Tipos de nodo

Hay disponibles los siguientes tipos de nodos:

Tipo de nodo	Descripción
Nodo Message	Enviar un mensaje al cliente.
Nodo Pregunta	Formular una pregunta al cliente.
Nodo Tarjeta adaptable	Cree un fragmento JSON para intercambiar con otras aplicaciones.
Nodos Condición	Bifurcar la conversación según una condición.
Nodos Administración de variables	Establezca un valor, analice un valor o borre variables (incluida la capacidad de borrar el historial de conversaciones utilizado por el agente).
Administración de temas	Redirigir la conversación, transferir al usuario o finalizar el tema o la conversación.
Nodos Llamar a una herramienta	Llame a un flujo como Power Automate o Excel Online, o use un conector u otro tipo de herramienta.
Avanzado	Envíe respuestas generativas, solicitudes HTTP, eventos y más.

Propina

Cambie el nombre de los nodos para que sea más fácil identificarlos. Seleccione el campo de nombre del nodo para actualizar el nombre directamente, o seleccione el icono Más (…) del nodo y seleccione Renombrar desde el menú. También puede renombrar nodos en el editor de código.

No es posible cambiar el nombre de los nodos Gatillo y nodos Ir al paso.

Los nombres de nodo pueden tener hasta 500 caracteres de largo.

Crear un tema

1. Vaya a la página Temas de su agente. Para una mejor visibilidad, cierre el panel de prueba por ahora.

2. Seleccione Agregar un tema y seleccione Desde el espacio en blanco.

   Aparece un nodo Desencadenador en un lienzo de creación de temas que de otro modo estaría vacío.

3. Selecciona el icono Más (…) del nodo Desencadenar y luego seleccione Propiedades. Aparece el panel Si es una intención reconocida.

4. En En propiedades de intención reconocidas, seleccione el área Frases. Aparece el panel secundario Frases.

5. En Agregar frases, introduzca una frase desencadenadora para su tema.

   Su agente necesita de 5 a 10 frases desencadenantes para entrenar a la IA para que comprenda las respuestas de sus clientes. Para agregar más frases desencadenantes, puede:

   • Seleccione el icono Agregar al lado del campo de texto e introduzca la frase deseada.
   • Pegue un conjunto de frases desencadenadoras, cada una en una línea independiente, y seleccione Entrar.
   • Escriba un conjunto de frases desencadenadoras, presione Mayús+Intro después de cada una para colocarla en una línea separada y seleccione Intro.
   • Cargue un archivo con una lista de las frases desencadenadoras que desea agregar para este tema.

   Puede incluir puntuación en una frase desencadenadora, pero lo mejor es utilizar frases cortas.

6. Seleccione Detalles en la barra de herramientas para abrir el panel Detalles del tema.

7. Agregue detalles para su tema:

   • Escriba un nombre para identificar el tema, como "Horario de la tienda". La página Temas enumera todos los temas definidos en su agente, con este nombre.
   • Si lo desea, escriba un nombre para mostrar al cliente cuando el agente no pueda determinar qué tema coincide con el mensaje del cliente.
   • Si lo desea, use el campo Descripción para describir el propósito de tema para usted y otros creadores de agentes en su equipo. Los clientes nunca ven las descripciones del tema.

8. Seleccione Guardar en la barra de menú superior para guardar su tema.

Importante

Evite el uso de puntos (.) en sus nombres de tema. No es posible exportar una solución que contenga un agente con puntos en el nombre de cualquiera de sus temas.

Cargar frases desencadenadoras para un tema

En el panel Frases del nodo Desencadenador de un tema, puede agregar o reemplazar el conjunto de frases desencadenadoras asociadas al tema.

1. Prepare un archivo de texto (máximo 3 MB) que enumere todas las frases desencadenadoras que desea agregar para su tema, con cada frase en una línea separada.

2. En Agregar frases, seleccione Cargar un archivo.

3. En Cargar un archivo, seleccione la opción que desee:

   • Si desea agregar nuevas frases desencadenadoras para su tema, seleccione Anexar.
   • Para reemplazar todas las frases desencadenadoras existentes con la lista de su archivo, seleccione Reemplazar.

4. Suelte el archivo en la ventana. También puede seleccionar hacer clic para examinar, navegar hasta el archivo y seleccionarlo.

5. Revise las frases desencadenadoras que aparecen y seleccione Agregar.

6. Guarde el tema.

Descargar frases desencadenadoras para un tema

En el panel Frases del nodo Desencadenador de un tema, puede descargar el conjunto de frases desencadenadoras asociadas al tema.

1. En Agregar frases, seleccione descargar.

2. Guarde el archivo de texto resultante o ábralo en un editor de texto para revisar su contenido. Cada frase desencadenadora aparece en una línea independiente.

Diseñar una ruta de conversación del tema

Cuando cree un tema, aparece el nodo Desencadenador automáticamente en los lienzos de creación. Luego puede agregar diferentes tipos de nodos para lograr la ruta de conversación deseada para su tema.

Para agregar un nodo después de otro nodo o entre dos nodos en su lienzo de creación de tema:

1. Seleccione el icono Agregar nodo situado debajo del nodo bajo el que desea agregar un nuevo nodo.

2. Seleccione el tipo de nodo que desee de la lista que aparece.

   

Eliminar un nodo

Seleccione el icono de menú Más (...) del nodo que desea eliminar y, a continuación, seleccione Eliminar.

Controles para editar nodos en el lienzo

Puede utilizar los controles de la barra de herramientas para cortar, copiar, pegar y eliminar el nodo seleccionado o los nodos adyacentes seleccionados.

La barra de herramientas también tiene un control para deshacer las modificaciones. Seleccione el icono Deshacer y seleccione:

• Deshacer para deshacer el cambio más reciente
• Deshacer al último guardado para revertir todas las acciones al último guardado
• Rehacer para volver a hacer la acción anterior

Pegar nodos

Una vez que utilices las herramientas Cortar o Copiar para colocar uno o más nodos en el portapapeles, hay dos maneras. para pegarlos en el lienzo:

• Si selecciona un nodo y luego selecciona Pegar, los nodos en el portapapeles se insertan después del nodo seleccionado.

• Si selecciona "+" para ver el menú Agregar nodo, luego seleccione Pegar, el nodo del portapapeles se inserta en esa ubicación.

Agregar parámetros de entrada y salida para un tema

Los temas pueden tener parámetros de entrada y salida. Cuando un tema redirecciona a otro tema, puede usar estos parámetros para pasar información entre los temas.

Además, si el agente utiliza el modo generativo, puede rellenar automáticamente las entradas del tema desde el contexto de la conversación o después de generar preguntas para recopilar valores de los usuarios. Este comportamiento es similar a cómo funciona el llenado de espacios generativos para acciones.

Para obtener más información sobre los parámetros de entrada y salida de los temas, consulte Administrar tema entradas y salidas.

Editar temas con el editor de código

El editor de código muestra el tema en YAML, un lenguaje de marcas que es fácil de leer y comprender. Use el editor de código para copiar y pegar temas de otros bots, incluso los creados por otros autores.

Importante

El diseño de un tema completamente en el editor de código y el pegado de temas complejos no son totalmente compatibles.

En este ejemplo, copia y pega YAML en el editor de código para agregar rápidamente un tema que solicita al cliente información de envío.

1. En la página Temas , seleccione Agregar un tema>Desde en blanco.

2. En la esquina superior derecha del lienzo de creación, seleccione Más y luego seleccione Abrir editor de código.

   

3. Seleccione y elimine el contenido del editor de código. Luego copie y pegue el siguiente código YAML:

   kind: AdaptiveDialog
   beginDialog:
     kind: OnRecognizedIntent
     id: main
     intent:
       displayName: Lesson 3 - A topic with a condition, variables and a prebuilt entity
       triggerQueries:
         - Buy items
         - Buy online
         - Buy product
         - Purchase item
         - Order product
   
     actions:
       - kind: SendMessage
         id: Sjghab
         message: I am happy to help you place your order.
   
       - kind: Question
         id: eRH3BJ
         alwaysPrompt: false
         variable: init:Topic.State
         prompt: To what state will you be shipping?
         entity: StatePrebuiltEntity
   
       - kind: ConditionGroup
         id: sEzulE
         conditions:
           - id: pbR5LO
             condition: =Topic.State = "California" || Topic.State = "Washington" || Topic.State     = "Oregon"
   
         elseActions:
           - kind: SendMessage
             id: X7BFUC
             message: There will be an additional shipping charge of $27.50.
   
           - kind: Question
             id: 6lyBi8
             alwaysPrompt: false
             variable: init:Topic.ShippingRateAccepted
             prompt: Is that acceptable?
             entity: BooleanPrebuiltEntity
   
           - kind: ConditionGroup
             id: 9BR57P
             conditions:
               - id: BW47C4
                 condition: =Topic.ShippingRateAccepted = true
   
             elseActions:
               - kind: SendMessage
                 id: LMwySU
                 message: Thank you and please come again.
   

4. Seleccione Guardar y después Cerrar el editor de código. Observe la lógica condicional que sigue a algunos de los nodos Pregunta.

   

Pruebe y publique su agente

Pruebe su agente cuando realice cambios en sus temas, para asegurarse de que todo funcione como se espera.

Una vez que esté satisfecho, publique su agente en los canales deseados.

Clásico/Teams

Cuando crea un bot, se crean varios temas para usted. Estos temas creados automáticamente se dividen en estas categorías:

• Los temas de lecciones le ayudan a comprender formas simples o complejas de usar nodos para crear conversaciones de bot.

  Puede editar los temas de lección o eliminarlos por completo.

• Los temas del sistema son temas que probablemente necesite durante una conversación de bot.

  No puede eliminar ni deshabilitar temas del sistema ni editar sus frases desencadenadoras. Sin embargo, puede personalizar los nodos en el lienzo de creación. Le recomendamos que no personalice estos temas hasta que se sienta cómodo con la creación de una conversación de bot de extremo a extremo.

Nota:

Temas sugeridos (heredado)

En un bot de chat para el que se usó la característica de sugerencia de tema en desuso, es posible que los temas sugeridos sigan pendientes de revisión. Puede ver estos temas, en una pestaña De temas sugeridos independiente, en la lista Temas del agente. Puede revisarlos y agregarlos al bot de chat si lo desea.

Crear un tema

1. Vaya a la lista temas del bot de chat.

2. Seleccione Nuevo tema>Desde en blanco. Copilot Studio inserta automáticamente un nodo Trigger y un nodo Message en blanco. Aparece el panel Frases desencadenadores .

3. Agregue las frases deseadas de activación para su tema.

   

   Puede especificar más de una frase desencadenante para tema, utilizando una nueva línea para cada frase. Puede incluir puntuación en una frase desencadenadora, pero lo mejor es utilizar frases cortas.

4. Escriba el mensaje deseado y agregue más nodos según sea necesario.

5. En la barra superior, edite el título de su tema para darle un nombre.

6. Seleccione el icono Detalles. Aquí puede editar el nombre y agregar un nombre para mostrar y una descripción.

   • El Nombre para mostrar indica al bot cuando necesita saber sobre qué tema pregunta la persona.
   • La Descripción describe el propósito de tema para usted y otros creadores de bots. La descripción no se muestra a los usuarios.

7. Seleccione Guardar para agregar el tema a la lista de temas.

Editar un tema

1. En la lista Temas del bot de chat, seleccione el tema que desea editar. Ve las frases desencadenantes de tema. Aquí define la ruta de conversación entre un cliente y el agente.

   Los temas tienen algunos nodos que se crean automáticamente. Estos nodos se pueden editar igual que editaría otros.

2. Para agregar un nodo, seleccione el icono Agregar nodo debajo del nodo en el que desea agregar un nuevo nodo y seleccione la opción deseada:

   • Haga una pregunta.
   • Agregar una condición: solo es posible en los temas en los que las variables están disponibles
   • Llamar a una herramienta
   • Mostrar un mensaje
   • Redirigir a otro tema
   • Finalizar la conversación: solo es posible al final de una trayectoria de conversación.

3. Para eliminar un nodo, seleccione el icono de menú (⋮) del nodo que desea eliminar y seleccione Eliminar.

4. Para cambiar las rutas entre nodos, arrastre el círculo pequeño sobre el nodo, es un ancla de nodo, a una nueva ubicación en el lienzo. La línea de puntos representa el camino original.

Formular una pregunta

Después de seleccionar Hacer una pregunta en el menú Agregar nodo , aparece un nuevo nodo Pregunta .

1. Escriba la pregunta deseada.

   Por ejemplo, si el usuario quiere conocer el horario de la tienda, el asistente virtual podría preguntar "¿Qué ubicación de la tienda necesita?"

2. En Identificar, seleccione una opción para la respuesta del usuario, como Opciones de opción múltiple.

   Esta opción determina qué debería escuchar el bot cuando el usuario responde. Para más información, vea Usar entidades en una conversación.

3. En Opciones para el usuario, ingrese las respuestas esperadas a la pregunta del bot.

   Por ejemplo, si elige Opciones de opción múltiple en Identificar, las opciones pueden incluir ubicaciones de tiendas como Seattle, Bellevue o Kirkland.

   

   Copilot Studio crea automáticamente una ruta de acceso condicional para cada opción. Puede agregar nodos a la lógica de bifurcación y especificar cómo debe responder el bot para cada ruta de acceso o valor.

   Durante una conversación, cada opción aparece como un botón en el chat, pero los usuarios también pueden escribir su respuesta.

4. (Opcional) cambie el nombre de la variable que contiene la respuesta del usuario y configure sus propiedades. Para obtener más información, consulte Trabajar con variables.

Agregar una condición

En los temas en los que las variables están disponibles, puede agregar lógica de bifurcación basada en valores de variable. Por ejemplo, si configura la autenticación de usuario, es posible que quiera que el bot de chat muestre un mensaje diferente si el usuario ha iniciado sesión.

Después de seleccionar Agregar una condición en el menú Agregar nodo , aparece un menú.

• Para agregar una ruta de acceso basada en un valor de variable específico, seleccione Rama basada en una condición y configure la condición deseada.
• Para agregar la trayectoria que cubre todos los demás valores, seleccione Opción para todas las otras condiciones.

Llamar a una herramienta

Para llamar a flujos de Power Automate o insertar nodos de autenticación, seleccione Llamar a una herramienta en el menú Agregar nodo y seleccione la herramienta deseada o cree una nueva.

Si el bot tiene funcionalidades basadas en voz, hay más herramientas disponibles.

Mostrar un mensaje

Después de seleccionar Mostrar un mensaje en el menú Agregar nodo , aparece un nuevo nodo Mensaje .

Introduzca el mensaje que quiere que diga el bot en el cuadro de texto. Puede aplicar algunos formatos básicos, como negrita, cursiva, listas ordenadas y no ordenadas e hipervínculos. También puede usar las variables que haya definido en algún otro lugar en la conversación de bot.

Redirigir a otro tema

Después de seleccionar Redirigir a otro tema en el menú Agregar nodo , aparece una lista de temas.

Seleccione el tema al que debe desviarse el bot. Por ejemplo, es posible que desee enviar al usuario a un tema sobre la hora de cierre de una tienda si pregunta sobre el horario de esa tienda.

Aparece un nodo De redireccionamiento .

Puede considerar el tema redirigido como un subtema. Puede insertar más nodos en el nodo Redireccionamiento . Cuando finalice la ruta de conversación para el subtema, el bot volverá al tema original. Luego, el bot seguirá los nodos que se encuentran debajo del nodo del subtema.

Sin embargo, si redirige a cualquiera de los siguientes temas del sistema, finaliza toda la conversación:

• Fin de la conversación
• Éxito confirmado
• Error confirmado
• Despedida
• Remitir a alguien superior
• Comenzar de nuevo (también restablece cualquier variable global)

Finalizar la conversación

Cuando finaliza la conversación, puede hacer que una encuesta pregunte al usuario si se ha respondido o resuelto su pregunta o problema. Esta respuesta se recopila en la página de análisis de satisfacción del cliente.

También puede hacer que la conversación se entregue a un agente por chat si está utilizando un portal servicio al cliente adecuado, como la Plataforma Omnicanal para Customer Service.

Al final de una ruta de conversación que resuelve un problema o responde a una pregunta, al seleccionar Finalizar la conversación en el menú Agregar nodo, aparece un menú:

• Para finalizar con una encuesta de satisfacción del cliente, seleccione Finalizar con encuesta.

• Para insertar un nodo de transferencia que vincula a su producto de transferencia configurado, seleccione Transferir a agente. Opcionalmente, escriba un mensaje privado para el representante del servicio de atención al cliente.

Pruebe y publique su bot

Siempre que realice cambios en los temas, pruebe el bot para asegurarse de que todo funciona según lo previsto.

Una vez que esté satisfecho, publíquelo en los canales deseados.