Utiliser l’éditeur de code pour écrire et modifier YAML dans les rubriques

Les rubriques peuvent être rédigées et modifiées dans l’éditeur de code, qui prend en charge l’utilisation de YAML. YAML signifie « YAML Ain’t Markup Language ». YAML est généralement utilisé pour écrire des fichiers de configuration et est plus facile à lire que XML ou JSON. Les fichiers YAML utilisent l’extension de fichier .yaml ou .yml. Vous formatez des fichiers YAML avec un espacement et une indentation pour représenter des structures de données, telles que des chaînes, des nombres, des valeurs booléennes, des listes et des dictionnaires.

Pour accéder à l’éditeur de code à partir d’une rubrique, sélectionnez (…) Plus dans la barre d’outils, puis sélectionnez Ouvrir l’éditeur de code.

Regardez cette vidéo pour avoir un aperçu de la façon d’utiliser YAML dans l’éditeur de code :

Important

Tout créateur peut utiliser l’éditeur de code pour explorer la configuration d’une rubrique. Les développeurs et les utilisateurs avancés peuvent choisir de concevoir et de modifier dans l’éditeur de code. Cependant, soyez prudent lors des modifications dans l’éditeur de code. Des erreurs de ponctuation ou de syntaxe peuvent entraîner des messages d’erreur complexes ou interrompre la conversation en cours. Nos équipes de support technique ne peuvent pas remédier aux erreurs de l’éditeur de code. Si vous débutez dans la modification de YAML, faites une copie de la rubrique avant d’apporter toute modification.

Quand utiliser l’éditeur de code

Copilot Studio ne nécessite pas que vous écriviez du YAML à partir de zéro. À la place, YAML est généré automatiquement lorsque vous créez des objets dans le canevas de rubrique. Vous pouvez ensuite soit examiner la configuration dans l’éditeur de code pour mieux comprendre les paramètres, soit choisir d’apporter des modifications à YAML. Voici des exemples de cas d’utilisation pour l’éditeur de code :

  • L’éditeur de code affiche la configuration complète d’une rubrique sans qu’il soit nécessaire d’interagir avec les éléments de boîte de dialogue individuels de la rubrique. Il s’agit d’un guichet unique permettant d’afficher tous les paramètres d’une rubrique.
  • Les créateurs peuvent choisir de copier des nœuds spécifiques d’une rubrique et de les coller dans d’autres rubriques, plutôt que d’utiliser les icônes Copier et Coller. Cela peut être plus simple que de sélectionner plusieurs nœuds d’une configuration.
  • Les créateurs peuvent choisir de mettre à jour un ID de flux Power Automate dans YAML, plutôt que d’attendre la synchronisation avec le menu Appel et action.
  • Les créateurs peuvent choisir de cloner et de réviser les nœuds Question ou les nœuds Message lorsqu’ils sont similaires. Cependant, dans de tels cas, il est crucial de veiller à ce que tous les identifiants et variables demeurent uniques. N’oubliez pas de réviser les identifiants clonés pour les transformer en identifiants uniques.
  • Les créateurs peuvent choisir d’effectuer des modifications simples dans l’éditeur de code, comme ajouter un terme aux phrases de rubrique, car il peut être plus rapide de saisir, ou de copier-coller, le texte dans le code YAML.

Comprendre YAML dans l’éditeur de code

L’image suivante présente un exemple de bloc de code YAML typique.

Capture d’écran d’un exemple de bloc de code YAML dans l’éditeur de code.

Voici comment ce code s’applique à la rubrique correspondante telle qu’elle apparaît sur le canevas.

  • Ligne 1 : type de rubrique.
  • Lignes 2 à 3 : indiquez le début d’une rubrique d’optimisation conversationnelle.
  • Ligne 7 : indique un nœud de réponses génératives.
  • Ligne 9 : variable pertinente.
  • Lignes 11 à 12 : détails sur la requête et instructions spéciales.
  • Lignes 20 à 26 : liens vers les sources de connaissances.
  • Lignes 28-32 : Groupe de conditions. Chaque condition possède un identifiant unique, ainsi que les détails de sa formule et ses redirections.

Tester YAML dans l’éditeur de code

Si vous souhaitez tester ce code, suivez les étapes suivantes dans Copilot Studio :

  1. Créez un agent.

  2. Accédez à la page Paramètres de votre agent, sélectionnez IA générative et sélectionnez Générative.

  3. Accédez à la page Rubriques, sélectionnez Système et sélectionnez la rubrique Optimisation conversationnelle.

  4. Ouvrez l’éditeur de code.

  5. Remplacez le code existant par l’exemple de code YAML suivant.

     kind: AdaptiveDialog
 beginDialog:
  kind: OnUnknownIntent
  id: main
  priority: -1
  actions:
    - kind: SearchAndSummarizeContent
      id: search-content
      userInput: =System.Activity.Text
      variable: Topic.Answer
      moderationLevel: Medium
      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. Sélectionnez Enregistrer et fermez l’éditeur de code.

  7. Testez l’assistant dans le volet Test en lui posant une question liée aux échecs, par exemple « Comment un cavalier se déplace-t-il ? »

  • Last updated on