Compartir a través de

Utilice el editor de código para escribir y editar YAML en temas

  • Artículo

Los temas se pueden escribir y editar en el editor de código, que admite el uso de YAML, que significa "YAML Ain't Markup Language™." YAML se utiliza para escribir archivos de configuración y tiende a ser más fácil de leer que XML o JSON. Los archivos YAML utilizan la extensión de archivo .yaml o .yml. Los archivos YAML tienen formato con espaciado y sangría para representar estructuras de datos, como cadenas, números, valores booleanos, listas y diccionarios.

Para acceder al editor de código desde un tema, seleccione el icono Más (…) y luego seleccione Abrir editor de código.

Vea este vídeo para obtener una descripción general de cómo utilizar YAML en el editor de código:

Importante

Todos los creadores pueden aprovechar el editor de código para visualizar una instantánea de una sola página de la configuración completa del tema actual. Los desarrolladores y usuarios avanzados pueden optar por diseñar y editar dentro del editor de código. Sin embargo, se recomienda tener precaución al realizar revisiones en el editor de código, ya que los errores de puntuación y otros patrones de sintaxis pueden dar lugar a mensajes de error complejos y podrían interrumpir la conversación actual. Tenga en cuenta que los equipos de soporte técnico no pueden ayudar a corregir los errores del editor de código. Por lo tanto, si es principiante en la revisión de YAML, haga una copia del tema antes de realizar cualquier cambio.

Cuándo usar el editor de código

Copilot Studio nunca requiere que escriba YAML desde cero. En cambio, YAML se genera automáticamente cuando crea objetos en el lienzo del tema. Luego puede revisar la configuración en el editor de código para comprender mejor la configuración o puede optar por realizar cambios al YAML. Los siguientes son algunos ejemplos de uso del editor de código:

  • El editor de código muestra la configuración completa de un tema sin la necesidad de interactuar o navegar por los cuadros de diálogo individuales del tema. Es una ventanilla única para mostrar todas las configuraciones en un cuadro de diálogo.
  • Los creadores pueden optar por copiar nodos específicos de un tema y pegarlos en otros temas, en lugar de utilizar los íconos de copiar y pegar. Puede que sea más fácil que seleccionar varios nodos de una configuración.
  • Los desarrolladores pueden optar por actualizar un ID de flujo Power Automate en YAML, en lugar de esperar la sincronización con el menú Llamar y Acción.
  • Los creadores pueden optar por clonar y revisar preguntas o mensajes cuando sean similares. Sin embargo, en este caso, es fundamental garantizar que todos los ID y variables sigan siendo únicos. En este escenario, recuerde convertir los ID clonados en ID únicos.
  • Los creadores pueden optar por realizar revisiones simples, como agregar un término a las frases de tema, dentro del editor de código, ya que puede escribir o copiar y pegar el texto en YAML.

Comprender YAML en el editor de código

El siguiente código es un ejemplo de un bloque típico de YAML. Para obtener más información sobre cómo se aplica ese código al cuadro de diálogo en el lienzo, consulte las descripciones.

YAML

Captura de pantalla del editor de código, que muestra un bloque de código de muestra.

Descripciones

  • Línea 1: El tipo de diálogo
  • Línea 2-3: Indica el inicio de un tema del sistema de impulso conversacional
  • Línea 7: Indica un nodo de respuestas generativas
  • Línea 10: la variable relevante
  • Línea 11-13: Detalles sobre el aviso y las instrucciones especiales
  • Línea 14-21: enlaces a fuentes de conocimiento
  • Línea 23-27: Grupo de condiciones: cada condición tiene un ID único, junto con los detalles de la fórmula de la condición y las redirecciones.

Probar YAML en el editor de código

Si desea probar este código, realice los siguientes pasos en Copilot Studio:

  1. Ejemplo de creación de un agente.

  2. En la configuración del agente, seleccione la pestaña IA generativa y seleccione Generativa (versión preliminar).

  3. Vaya a la página Temas, seleccione Sistema y seleccione el tema Impulso conversacional.

  4. Abrir el editor de código.

  5. Copie el código YAML de muestra de este artículo y péguelo en lugar del tema Impulso conversacional existente del código YAML.

     kind: AdaptiveDialog
 beginDialog:
  kind: OnUnknownIntent
  id: main
  priority: -1
  actions:
    - kind: SearchAndSummarizeContent
      id: search-content
      userInput: =System.Activity.Text
      variable: Topic.Answer
      moderationLevel: Medium
      tone: Friendly
      additionalInstructions: Include emojis to make responses more fun.
      publicDataSource:
        sites:
          - "www.chessusa.com/"
          - "www.chess.com/"
          - "www.lichess.org/"

      sharePointSearchDataSource: {}

    - kind: ConditionGroup
      id: has-answer-conditions
      conditions:
        - id: has-answer
          condition: =!IsBlank(Topic.Answer)
          actions:
            - kind: EndDialog
              id: end-topic
              clearTopicQueue: true

  6. Seleccione Guardar y cierre el editor de código.

  7. Pruebe al agente en el panel Prueba haciendo una pregunta relacionada con el ajedrez, como "¿Cómo se mueve un caballo?"

Contenido relacionado