Del via

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

  • Artikkel

Emner kan skrives og redigeres i redigeringsprogrammet for kode, som støtter bruk av YAML, som står for «YAML Ain't Markup Language™». YAML brukes til å skrive konfigurasjonsfiler og er ofte lettere å lese enn XML eller JSON. YAML-filer bruker enten filtypen YAML eller YML. YAML-filer formateres med mellomrom og innrykk for å representere datastrukturer, for eksempel strenger, tall, boolsk, lister og ordlister.

Du kan få tilgang til redigeringsprogrammet for kode fra et emne ved å velge Mer-ikonet (…) og deretter velge Åpne redigeringsprogram for kode.

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

Viktig!

Alle utviklere kan bruke redigeringsprogrammet for kode til å visualisere et øyeblikksbilde av en enkeltside av den fullstendige konfigurasjonen for gjeldende emne. Utviklere og avanserte brukere kan velge å utforme og redigere i redigeringsprogrammet for kode. Vi anbefaler imidlertid at du bruker forsiktighet når du foretar revisjoner i koderedigeringsprogrammet, fordi feil i tegnsetting og andre syntaksmønstre kan føre til komplekse feilmeldinger, og dette kan bryte den gjeldende samtalen. Vær oppmerksom på at kundestøtteteam ikke kan hjelpe til å rette feil i redigeringsprogrammet for kode. Hvis du er en nybegynner når det gjelder å revidere YAML, lager du derfor en kopi av emnet før du gjør endringer.

Når skal redigeringsprogrammet for kode brukes

Du trenger aldri å skrive YAML fra grunnen 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 noen eksempler på hvordan du bruker redigeringsprogrammet for kode:

  • Redigeringsprogrammet for kode viser hele konfigurasjonen for et emne uten at du trenger å samhandle med eller navigere i de enkelte dialogboksene i emnet. Dette er det ene stedet der alle innstillingene i en dialogboks vises.
  • Utviklere kan kopiere bestemte noder fra et emne og lime dem inn i andre emner i stedet for å bruke ikonene for kopiering/innliming. Det kan være enklere enn å velge flere noder i en konfigurasjon.
  • Utviklere kan oppdatere en Power Automate-flyt-ID i YAML i stedet for å vente på synkroniseringen med menyen for oppkall og handling.
  • Utviklere kan klone og revidere spørsmål eller meldinger når de ligner på hverandre. I dette tilfellet er det imidlertid svært viktig å sikre at alle ID-ene og variablene holdes unike. I dette scenarioet må du huske å revidere klonede ID-er til unike ID-er.
  • Utviklere kan gjøre enkle revideringer, for eksempel føye en term til emneuttrykk, i redigeringsprogrammet for kode siden du kan skrive eller kopiere og lime inn teksten i YAML-en.

Forstå YAML i redigeringsprogrammet for kode

Følgende kode er et eksempel på en typisk blokk med YAML. Hvis du vil ha mer informasjon om hvordan denne koden gjelder for dialogboksen på lerretet, kan du se beskrivelser.

YAML

Skjermbilde av redigeringsprogrammet for kode der det vises et eksempel på en kodeblokk.

Descriptions

  • Linje 1: dialogtypen
  • Linje 2–3: angir starten på et systememne for samtaleforsterkning
  • Linje 7: angir en generativ svarnode
  • Linje 10: den relevante variabelen
  • Linje 11–13: detaljer om spørsmålet og spesialinstruksjonene
  • Linje 14–21: koblinger til kunnskapskilder
  • Linje 23–27: betingelsesgruppe – hver betingelse har en unik ID sammen med betingelsens formeldetaljer og omdirigeringer

Test YAML i redigeringsprogrammet for kode

Hvis du vil teste denne koden, kan du utføre følgende trinn i Copilot Studio:

  1. Opprett en eksempelagent.

  2. I agentens innstillinger, velg fanen Generativ kunstig intelligens og deretter Generativ (forhåndsversjon).

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

  4. Åpne redigeringsprogrammet for kode.

  5. Kopier YAML-eksempelkoden i denne artikkelen, og lim den inn i stedet for YAML-koden for det eksisterende emnet Samtaleforsterkning.

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

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

Relatert innhold