Creación y edición de temas

En Copilot Studio, un tema define cómo progresa una conversación agente.

Para crear temas, puede personalizar las plantillas proporcionadas, crear temas desde cero o describir lo que quiere y dejar que la IA cree los tema para usted.

En Copilot Studio, un tema representa una parte de un hilo de conversación entre un usuario y un agente. Usted define y trabaja con temas en un lienzo de autoría. Un tema contiene uno o más nodos de conversación, que en conjunto definen los caminos conversacionales que puede tomar un tema. Cada nodo realiza una acción, como enviar un mensaje o hacer una pregunta.

A menudo, un tema tiene una serie de frases desencadenadoras: frases, palabras clave y preguntas que un cliente suele usar y están relacionadas con un tema específico. Copilot Studio Los agentes usan comprensión del lenguaje natural, el mensaje de su cliente y las frases Gatillo para todos sus temas para encontrar el mejor tema para Gatillo. No es necesario que el mensaje coincida exactamente con las frases desencadenantes de tema para activar tema. Por ejemplo, un tema sobre el horario de la tienda podría incluir la frase desencadenante check store hours. Si un cliente introduce "ver horario de apertura de la tienda", esta frase el tema sobre el horario de la tienda.

Requisitos previos

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

Reconocimiento de lenguaje natural

Un agente usa comprensión del lenguaje natural (NLU) para analizar lo que escribió un cliente y encontrar el mejor frase desencadenadora o nodo.

Por ejemplo, un usuario puede escribir "Horario de apertura". agente hace coincidir esa información con el Horario de la tienda tema, inicia una conversación que pregunta en qué tienda está interesado el cliente y luego muestra el horario de apertura de la tienda.

El panel de prueba agente muestra cómo progresa la conversación agente en cada paso. Puede utilizar el panel Prueba agente para ajustar un tema sin tener que salir del Copilot Studio portal.

Para conocer los límites de agente y tema, consulte Cuotas, límites, registro de aplicaciones, certificados y valores de configuración.

Temas en Copilot Studio

Aplicación web

Tipos de temas

Un agente puede incluir dos tipos de temas: de sistema y personalizados . Cada nuevo agente comienza con un conjunto de temas predefinidos y personalizados.

• 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 Gatillo que puedes personalizar para adaptarlas a las necesidades de tu 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 te sientas cómodo creando experiencias completas de agente, no recomendamos editar 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:

Opción	Description
Envío de un mensaje	Enviar un mensaje al cliente.
Formular una pregunta	Formular una pregunta al cliente.
Preguntar con tarjeta adaptable	Cree un fragmento JSON para intercambiar con otras aplicaciones.
Crear usando condiciones	Bifurcar la conversación según una condición.
Administración de variables	Establezca un valor, analice un valor o borre todas las variables.
Administrar temas	Redirigir, transferir o finalizar el tema o la conversación.
Llamar a un flujo	Llame a un flujo como Power Automate o Excel Online, o utilice un conector o un complemento.
Avanzado	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. Abra su agente desde la lista en la página de agentes . Para una mejor visibilidad, cierra el panel Prueba tu agente por ahora.

2. En la barra de menú superior, seleccione Temas.

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

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

5. En el panel de propiedades de Si es una intención reconocida, seleccione el área Frases. Aparece el panel secundario Frases.

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

   Tu agente necesita de 5 a 10 frases Gatillo para entrenar a la IA a comprender las respuestas de tus 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 Entrar.

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

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

8. Añade tus detalles agente tema:

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

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

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 una edición. Abra el menú Deshacer para revertir todas las acciones al último guardado o para rehacer 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 su agente usa el modo generativo, puede completar automáticamente las entradas 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 + Crear>Desde cero.

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. El nodo Pregunta ahora tiene muchas condiciones para la pregunta sobre el envío.

   

Prueba y publica tu agente

Prueba tu agente cuando realices cambios en tus temas, para asegurarte de que todo funcione como se espera.

Después de diseñar y probar su agente, publíquelo en la web, en aplicaciones móviles o nativas, o en Microsoft Bot Framework canales.

Clásico

Usar temas del sistema y de ejemplo

Cuando crea un bot, se crean varios temas para usted.

Estos temas creados automáticos se dividen en dos 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.

Crear un tema

1. En el menú de navegación, seleccione Temas, después + Nuevo tema, después Desde el espacio en blanco.

   Se abrirá el panel Frases desencadenadoras.

2. Agregue varias frases desencadenantes para su tema en la sección Agregar frases.

   

   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.

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

   

4. Pulse Entrar o seleccione el icono Guardar para guardar todos los cambios.

5. Seleccione el icono Detalles. Aquí también 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.

   

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

Diseñar la ruta de conversación del tema

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

   Para los temas existentes o del sistema, se crean automáticamente varios nodos. Estos nodos se pueden editar igual que editaría otros.

   Cuando crea un tema nuevo, un nodo Desencadenador y un nodo Mensaje en blanco se insertan para usted.

2. Para agregar un nodo, seleccione "+", Agregar nodo, ubicado entre o después de los nodos.

   

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

   

Insertar nodos

Cuando agrega un nodo después del nodo Frases desencadenadoras o entre nodos de Mensaje, puede:

• Formular una pregunta
• Llamar a una acción
• Mostrar un mensaje
• Redirigir a otro tema
• Finalizar la conversación

Formular una pregunta

1. Seleccione la opción Hacer una pregunta del menú "+" Agregar nodo para agregar un nuevo nodo Pregunta. Aparece un nodo de pregunta.

   

2. Escriba una frase de pregunta en el campo Formular una pregunta.

   Por ejemplo, si el usuario quiere saber el horario de la tienda, la pregunta del bot podría ser ¿Qué ubicación de tienda necesita?

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

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

   

   Cada opción se presenta al usuario como un botón de selección múltiple en el chat, pero los usuarios también pueden escribir su respuesta.

5. (Opcional) Guardar la respuesta del usuario en una variable para usarla más adelante.

El editor de conversaciones crea rutas independientes en la conversación, según la respuesta del cliente. La ruta de conversación lleva al cliente a la resolución adecuada en función de cada respuesta. Puede agregar nodos para crear una lógica de ramificación y especificar con qué debe responder el bot para cada ruta o variable.

Llamar a una acción

Para llamar a los flujos de Power Automate e insertar nodos de autenticación, seleccione Llamar una acción del menú "+" Agregar nodo.

Si las capacidades basadas en voz están habilitadas para su bot, verá mas acciones.

Mostrar un mensaje

1. Para especificar una respuesta del bot, seleccione "+" Agregar nodo para agregar un nodo y luego seleccione Mostrar un mensaje para agregar un nuevo nodo Mensaje.

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

1. Para que el bot se desplace a un tema diferente, seleccione "+" Agregar nodo para agregar un nodo y seleccione Redirigir a otro tema. Aparecerá una lista de temas.

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

   

El tema redirigido es un subtema.

Puede insertar más nodos debajo del nodo del subtema.

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.

Si redirige a cualquiera de estos temas del sistema, sin embargo, toda la conversación terminará.

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

Finalizar la conversación

Cuando finalice la conversación, puede hacer que una encuesta pregunte a los usuario si su pregunta o problema se respondió o resolvió. 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 respuesta que resuelve el problema del usuario o responde a la pregunta, agregue un nodo Finalizar la conversación.

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

  (Opcional) Escriba un mensaje privado al agente.

  

Agregar una condición

1. Para agregar lógica de ramificación basada en variables, seleccione "+" Agregar nodo para agregar un nodo.

2. Seleccione Agregar una condición.

3. Seleccione Rama basada en una condición.

4. Seleccione la variable que determinará si la conversación del bot debe ramificarse en este punto.

   Por ejemplo, si configura autenticacion de usuario, es posible que desee un mensaje diferente si el usuario ha iniciado sesión.

Eliminar nodos

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

Pruebe y publique su bot

Pon a prueba tu agente cuando realices cambios en tus temas para asegurarte de que todo funcione como se espera.

Una vez que haya diseñado y probado su bot, publíquelo en la Web, aplicaciones móviles o nativas, o canales de Microsoft Bot Framework.

Teams

Diseñar la ruta de conversación del tema - Teams

1. En la lista tema de tu agente, Seleccionar se encuentra el tema que deseas editar. Por ejemplo, es posible que desee editar el archivo tema Horario de la tienda.

   

   Una vez abierto, verá las frases desencadenantes de tema. Este lienzo de creación es donde se define la ruta de conversación entre un cliente y el bot.

   Cuando crea un tema nuevo, un nodo Frases desencadenadoras y un nodo Mensaje en blanco se insertan para usted.

   Para los temas existentes o del sistema, se crean automáticamente varios nodos con cada tema nuevo. Puede editar estos nodos, si es necesario.

2. Puede agregar más nodos seleccionando "+" Agregar nodo entre nodos o después de un nodo.

   

3. Para cambiar las rutas entre nodos, arrastre el ancla del nodo, un pequeño círculo en la parte superior del nodo. Verá una línea de puntos que indica la ruta original.

   

Insertar nodos - Teams

Al agregar un nodo a un nodo de frases desencadenantes, elija entre cinco opciones diferentes:

• Formular una pregunta
• Llamar a una acción
• Mostrar un mensaje
• Redirigir a otro tema
• Finalizar la conversación

Si quiere redirigir un tema, puede ir a otro tema.

Formular una pregunta - Teams

1. Seleccione la opción Hacer una pregunta del menú "+" Agregar nodo para agregar un nuevo nodo Pregunta. Aparece un nodo de pregunta.

   

2. Escriba una frase de pregunta en el campo Formular una pregunta.

   Por ejemplo, si el usuario quiere saber el horario de la tienda, la pregunta del bot podría ser ¿Qué ubicación de tienda necesita?

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

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

   

   Cada opción se presenta al usuario como un botón de selección múltiple en el chat, pero los usuarios también pueden escribir su respuesta.

5. (Opcional) Guardar la respuesta del usuario en una variable para usarla más adelante.

El editor de conversaciones crea rutas independientes en la conversación, según la respuesta del cliente. La ruta de conversación lleva al cliente a la resolución adecuada en función de cada respuesta. Puede agregar nodos para crear una lógica de ramificación y especificar con qué debe responder el bot para cada ruta o valor.

Agregar una condición - Teams

En algunos tipos de nodos, puede agregar una condición.

1. Para agregar lógica de ramificación basada en variables, seleccione el menú "+" Agregar nodo y luego, seleccione Agregar una condición para agregar un nodo nuevo. Aparecen un par de nodos de condición.

2. Elija la variable que desea usar para determinar si la conversación del bot debe ramificarse en este punto.

   

Llamada a la acción - Teams

Puede llamar a los flujos de Power Automate seleccionando Llamar una acción en el menú "+" Agregar nodo.

Mostrar un mensaje - Teams

Un mensaje puede especificar una respuesta de su bot al usuario.

1. Seleccione el menú "+" Agregar nodo, luego seleccione Mostrar un mensaje para agregar un nuevo nodo Mensaje.

2. Introduzca lo 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.

Finalizar la conversación - Teams

Puede elegir Finalizar la conversación como nodo final de la conversación de su bot.

Existen dos opciones:

• Finalizar con encuesta muestra una encuesta que pregunta al usuario si su pregunta o problema se respondió o resolvió correctamente. Esta información se recopila bajo la página de análisis de satisfacción del cliente.

  

• Transferir al agente le permite escribir un mensaje privado a un agente que inicia su contacto con el usuario.

Redirigir a otro tema - Teams

Para que el bot se desplace automáticamente a un tema diferente, seleccione Agregar nodo (+) para agregar un nodo y luego Redirigir a otro tema.

En el menú desplegable, seleccione el tema al que debe desviar el bot. Por ejemplo, es posible que desee enviar al usuario a un tema específico sobre la hora de cierre de una tienda si pregunta sobre el horario de esa tienda.

Cuando el bot va a otro tema, el bot seguirá la ruta de conversación para ese tema y luego regresará al tema original, en el lugar donde lo dejó.

Puede considerar el tema redirigido como un subtema.

Si redirige a cualquiera de los siguientes temas del sistema, sin embargo, toda la conversación terminará:

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

Uso de variables

Puede usar las variables que haya definido en algún otro lugar en la conversación de bot.

Eliminar nodos - Teams

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

Pruebe y publique su bot - Teams

Después de realizar cambios en sus temas, pruebe su agente para asegurarse de que todo funcione como se espera.

Una vez que haya terminado de diseñar y probar su bot, puede publicarlo, para que otros miembros del equipo puedan usarlo.