Creación y edición de temas

Note

Este artículo describe características utilizadas en agentes o flujos de agentes alimentados por el arnés estándar.

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

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

Obtenga más información en Cuotas y límites.

Seleccionar el tema adecuado para responder a un usuario

Para determinar cómo responder a los usuarios, los agentes impulsados por el arnés estándar utilizan orquestación generativa o orquestación clásica.

Con la orquestación generativa, un agente responde consultas de usuarios o desencadenadores de eventos seleccionando la combinación más apropiada de temas, herramientas y conocimientos. Cada tema tiene una descripción que informa al agente de su propósito. Obtenga más información sobre la redacción de descripciones.

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. Estos agentes utilizan la comprensión del lenguaje natural, el mensaje del cliente y las frases desencadenantes relativas al tema para encontrar el mejor tema. 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. Aprende más en Diseñar frases desencadenantes efectivas.

Temas de Copilot Studio

En Copilot Studio, un tema representa una parte de una conversación entre un usuario y un agente. Define los temas en un lienzo de autoría. Un tema contiene uno o más nodos, que juntos determinan las rutas conversacionales que puede seguir el tema. Cada nodo realiza una acción, como enviar un mensaje o hacer una pregunta.

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

  • Los temas del sistema apoyan comportamientos esenciales, como una petición para hablar con una persona o para terminar la conversación.

    • No se pueden crear temas de sistema.
    • No puede eliminar temas del sistema, pero puede desactivarlos.
    • Puede realizar cambios en los temas del sistema. Sin embargo, debe esperar hasta que le resulte cómodo crear experiencias completas del agente antes de empezar a editar temas del sistema.

    Obtenga más información en Uso de 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 Mensaje Enviar un mensaje al cliente.
nodo "Pregunta" Formular una pregunta al cliente.
nodo Adaptive Card Mostrar una tarjeta interactiva con uno o varios botones de respuesta o campos de entrada.
Condición nodo Bifurcar la conversación según una condición.
nodos de Gestió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).
Gestión de temas Redirigir la conversación, transferir al usuario o finalizar el tema o la conversación.
Nodos de herramientas Llame a un flujo como Power Automate o Excel Online, o use un conector u otro tipo de herramienta.
Advanced Envíe respuestas generativas, solicitudes HTTP, eventos y más.

Tip

Cambie el nombre de los nodos para que sea más fácil identificarlos. Selecciona el campo de nombre del nodo para actualizar el nombre directamente, o selecciona los tres puntos (...) del nodo y selecciona Renombrar en el menú. También puede renombrar nodos en el editor de código.

No es posible cambiar el nombre a los nodos Desencadenante y 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 mejorar la visibilidad, cierre el panel de pruebas.

  2. Selecciona Añadir un tema y, después, selecciona En blanco. Aparece un nodo Trigger en un lienzo de creación de temas que estaría vacío de otra manera.

  3. Seleccione los tres puntos (...) del nodo Desencadenador y, a continuación, seleccione Propiedades. Aparece el panel de las propiedades de Intención Reconocida.

  4. En On Recognized Intent properties, configura el activador para tu tema.

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

  6. Agregue detalles para su tema:

    • Escriba un nombre para identificar el tema, como "Horas de almacenamiento". En la página Temas se enumeran todos los temas definidos en el agente por 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.
  7. Seleccione Guardar en la barra de menú superior para guardar su tema.

Importante

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

Editar un tema

Cuando creas un tema, el nodo Desencadenador aparece automáticamente en el entorno 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 en el nodo después del cual desea agregar un nuevo nodo.

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

Eliminar un nodo

Selecciona los tres puntos (...) del nodo que quieres eliminar y luego selecciona Eliminar.

Controles para editar nodos en el lienzo

Use 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
  • Volver al último guardado para revertir todas las acciones al último guardado
  • Rehacer para repetir la acción anterior

Pegar nodos

Después de usar las herramientas Cortar o Copiar para colocar uno o varios nodos en el Portapapeles, puede pegarlos en el lienzo de dos maneras:

  • Si seleccionas un nodo y luego seleccionas Pegar, insertas los nodos en el portapapeles después del nodo seleccionado.

  • Si seleccionas "+" para ver el menú Añadir nodo y luego seleccionas Pegar, insertas el nodo en el portapapeles 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.

Si tu agente utiliza orquestación generativa, puede rellenar automáticamente las entradas de temas 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 relleno generativo de ranuras en las herramientas. Obtenga más información en Administración de entradas y salidas de temas.

Edita los temas usando 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. Utiliza el editor de código para copiar y pegar temas de otros agentes, incluso de 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 autoría, selecciona Más y luego Abrir editor de código.

    Captura de pantalla de cómo abrir el editor de código de un tema.

  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. Tenga en cuenta la lógica condicional que sigue a algunos de los nodos de preguntas.

    Captura de pantalla de una conversación creada a partir de YAML en el editor de código de Copilot Studio.

Probar y publicar

Prueba a tu agente cuando hagas cambios en tus temas, para asegurarte de que todo funciona como se espera.

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