Bruk redigeringsprogrammet for kode til å skrive og redigere YAML i emner

Emner kan skrives og redigeres i redigeringsprogrammet for kode, som støtter bruk av YAML. YAML står for "YAML Ain't Markup Language." YAML brukes vanligvis til å skrive konfigurasjonsfiler og er lettere å lese enn XML eller JSON. YAML-filer bruker enten filtypen YAML eller YML. Du formaterer YAML-filer med mellomrom og innrykk for å representere datastrukturer, for eksempel strenger, tall, boolske verdier, lister og ordbøker.

For å få tilgang til redigeringsprogrammet for kode fra et emne, velg (…) Mer på verktøylinjen, og velg deretter Åpne redigeringsprogram for kode.

Se denne videoen for å få en oversikt over hvordan du bruker YAML i redigeringsprogrammet for kode:

Viktig!

Alle opprettere kan bruke redigeringsprogrammet for kode til å utforske konfigurasjonen av et emne. Utviklere og avanserte brukere kan velge å utforme og redigere i redigeringsprogrammet for kode. Vær imidlertid forsiktig når du redigerer i redigeringsprogrammet for kode. Feil i tegnsetting eller syntaks kan føre til komplekse feilmeldinger eller avbryte den pågående samtalen. Våre tekniske supportteam kan ikke hjelpe med å rette feil i redigeringsprogrammet for kode. Hvis du er ny på å revidere YAML, lag en kopi av emnet før du gjør endringer.

Når skal redigeringsprogrammet for kode brukes

Du trenger ikke å skrive YAML fra bunnen av i Copilot Studio. YAML genereres i stedet automatisk når du oppretter objekter på emnelerretet. Du kan enten se gjennom konfigurasjonen i redigeringsprogrammet for kode for å få en bedre forståelse av innstillingene, eller du kan gjøre endringer i YAML-en. Her er eksempler på brukstilfeller for redigeringsprogrammet for kode:

  • Redigeringsprogrammet for kode viser den fullstendige konfigurasjonen av et emne uten at du trenger å samhandle med individuelle dialogelementer i emnet. Det er en alt-i-ett-løsning for å vise alle innstillingene i et emne.
  • Utviklere kan kopiere bestemte noder fra et emne og lime dem inn i andre emner i stedet for å bruke ikonene for Kopier og Lim inn. Det kan være enklere enn å velge flere noder i en konfigurasjon.
  • Utviklere kan velge å oppdatere en Power Automate-flyt-ID i YAML i stedet for å vente på synkroniseringen med Kall og Handling-menyen.
  • Utviklere kan klone og revidere Spørsmål-noder eller Melding-noder når de ligner på hverandre. Det er imidlertid avgjørende å sørge for at alle ID-er og variabler forblir unike i slike tilfeller. Husk å revidere klonede ID-er for å gjøre dem om til unike ID-er.
  • Utviklere kan velge å gjøre enkle endringer i redigeringsprogrammet for kode, for eksempel å legge til et begrep i emneuttrykk, siden det kan være raskere å skrive eller kopiere og lime inn teksten i YAML-koden.

Forstå YAML i redigeringsprogrammet for kode

Følgende bilde viser et eksempel på en typisk blokk med YAML.

Skjermbilde av et eksempel på en blokk med YAML-kode i redigeringsprogrammet for kode.

Her ser du hvordan denne koden anvendes på det tilsvarende emnet slik det vises på lerretet.

  • Linje 1: Emnetypen.
  • Linje 2-3: Angir starten på et samtaleforbedringsemne.
  • Linje 7: angir en generativ svarnode.
  • Linje 9: den relevante variabelen.
  • Linje 11-12: Detaljer om spørringen og spesielle instruksjoner.
  • Linje 20–26: Koblinger til kunnskapskilder.
  • Linje 28-32: Betingelsesgruppe. Hver betingelse har en unik ID samt betingelsens formeldetaljer og omdirigeringer.

Test YAML i redigeringsprogrammet for kode

Hvis du vil teste denne koden, følger du disse trinnene i Copilot Studio:

  1. Opprett en agent.

  2. Gå til Innstillinger-siden for agenten, velg Generativ kunstig intelligens, og velg Generativ.

  3. Gå til Emner-siden, velg System, og velg emnet Samtaleforbedring.

  4. Åpne redigeringsprogrammet for kode.

  5. Erstatt den eksisterende koden med følgende eksempelkode i YAML-format.

     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. Velg Lagre, og lukk redigeringsprogrammet for kode.

  7. Test agenten i Test-panelet ved å stille et sjakkrelatert spørsmål, for eksempel «Hvordan flyttes en hest?»

  • Last updated on