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 anvendes typisk til at skrive konfigurationsfiler og er mere læsevenligt end XML eller JSON. I YAML-filer bruges enten .yaml- eller .yml-filtypen. Du formaterer YAML-filer med mellemrum og indrykning for at repræsentere datastrukturer, såsom strenge, tal, booleske værdier, lister og dictionaries.

For at få adgang til kodeeditoren fra et emne, vælg (…) Mere på værktøjslinjen, og derefter Åbn kodeeditor.

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

Vigtige oplysninger

Alle skabere kan bruge kodeeditoren til at undersøge konfigurationen af et emne. Udviklere og avancerede brugere kan vælge at designe og redigere i kodeeditoren. Vær dog forsigtig, når du laver revisioner i kodeeditoren. Fejl i tegnsætning eller syntaks kan føre til komplekse fejlmeddelelser eller afbryde den igangværende samtale. Vores tekniske supportteams kan ikke hjælpe med at afhjælpe fejl i kodeeditoren. Hvis du er ny til at redigere YAML, lav en kopi af emnet før du foretager ændringer.

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.
  • Udviklere kan vælge at opdatere et Power Automate-flow-id i YAML i stedet for at vente på, at der synkroniseres med kald- og handlingsmenuen.
  • 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.
  • Udviklere kan vælge at lave enkle ændringer i kodeeditoren, f.eks. ved at tilføje et udtryk til emnesætninger, 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.

Skærmbillede af en blok med eksempel på YAML-kode i kodeeditoren.

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

  • Linje 1: Emnetypen.
  • Linje 2-3: Angiv starten på et samtalefremmende emne.
  • Linje 7: Angiver en generativ svarnode.
  • Linje 9: Den relevante variabel.
  • Linjerne 11-12: Detaljer om prompten og særlige instruktioner.
  • Linje 20-26: Links til videnkilder.
  • Linjer 28-32: Betingelsesgruppe. Hver betingelse har en unik ID sammen med betingelsens 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?"

  • Last updated on