Brug kodeeditoren til at skrive og redigere YAML i emner

Emner kan skrives og redigeres i kodeeditoren, som understøtter brugen af YAML. YAML står for "YAML Ain't Markup Language" (YAML Ain't Markup Language). YAML bruges typisk til at skrive konfigurationsfiler og er lettere at læse end XML eller JSON. I YAML-filer bruges enten .yaml- eller .yml-filtypen. Du formaterer YAML-filer med afstand og indrykninger for at repræsentere datastrukturer, såsom strenge, tal, booleske værdier, lister og ordbøger.

For at få adgang til kodeeditoren fra et emne, vælg (...) Mere på værktøjslinjen og vælg derefter Open Code editor.

Se denne video for at få en oversigt over, hvordan du bruger YAML i kodeeditoren:

Hvornår skal du bruge kodeeditoren?

Copilot Studio kræver ikke, at du skriver YAML fra bunden. I stedet oprettes YAML automatisk, når du opretter objekter på emnelærredet. Du kan derefter enten gennemse konfigurationen i kodeeditoren for bedre at forstå indstillingerne, eller du kan vælge at foretage ændringer af YAML. Her er nogle eksempler på use cases for kodeeditoren:

• Kodeeditoren viser den komplette konfiguration af et emne uden behov for at interagere med individuelle dialogelementer i emnet. Det er en central butik til visning af alle indstillinger i et emne.
• Udviklere kan vælge at kopiere bestemte noder fra et emne og indsætte dem i andre emner i stedet for at bruge ikonerne Kopiér og Sæt ind. Det kan være nemmere end at vælge flere noder i en konfiguration.
• Oprettere kan vælge at opdatere et Power Automate flow-id i YAML i stedet for at vente på synkroniseringen til menuen Kald og handling.
• Udviklere kan vælge at klone og revidere spørgsmålsnoder eller meddelelsesnoder, når de ligner hinanden. I sådanne tilfælde er det dog vigtigt at sikre, at alle id'er og variabler forbliver entydige. Husk at revidere klonede id'er for at gøre dem til entydige id'er.
• Skabere kan vælge at lave simple revisioner i kodeeditoren, såsom at tilføje et ord til emnefraser, da det kan være hurtigere at skrive eller kopiere og indsætte teksten i YAML-koden.

Forståelse af YAML i kodeeditoren

Følgende billede viser et eksempel på en typisk YAML-blok.

Sådan anvendes koden på det tilsvarende emne, som det vises på lærredet.

• Linje 1: Typen af emne.
• Linjer 2-3: Angiv starten på et samtaleboostende emne.
• Linje 7: Angiver en generativ svarnode.
• Linje 9: Den relevante variabel.
• Linjerne 11-12: Detaljer om prompten og særlige instruktioner.
• Linjerne 20-26: Videnskilde-links.
• Linjer 28-32: Tilstandsgruppe. Hver tilstand har en unik ID sammen med tilstandens formeldetaljer og omdirigeringer.

Test af YAML i kodeeditoren

Hvis du vil teste denne kode, skal du udføre følgende trin i Copilot Studio:

1. Opret en agent.

2. Gå til siden Settings for din agent, og vælg Generativ AI og Generativ.

3. Gå til siden Emner, vælg System, og vælg emnet Samtale-boosting.

4. Åbn kodeeditoren.

5. Erstat den eksisterende kode med følgende eksempel på YAML-kode.

    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. Vælg Gem, og luk kodeeditoren.

7. Test agenten i panelet Test ved at stille et skakrelateret spørgsmål, f.eks. "Hvordan flyttes en konge?"

Relaterede oplysninger

• YAML Ain't Markup Language (YAML™) revision 1.2.2
• YAML Checker – YAML-syntaksvalideringen
• YAML til JSON-konvertering