Bruke variabler

Viktig!

Power Virtual Agents-funksjoner er nå en del av Microsoft Copilot Studio etter betydelige investeringer i generativ kunstig intelligens og forbedrede integreringer på tvers av Microsoft Copilot.

Enkelte artikler og skjermbilder kan henvise til Power Virtual Agents når vi oppdaterer dokumentasjons- og opplæringsinnhold.

Du kan bruke variabler til å lagre kundesvar og bruke innholdet i dem på nytt senere i samtalen.

Du kan også bruke variabler til å lage logiske uttrykk som dynamisk ruter kunden gjennom forskjellige diskusjonsbaner. Du kan for eksempel lagre navnet på en kunde i en variabel kalt UserName, og kopiloten kan bruke kundenavnet når den henvender seg til kunden etter hvert som samtalen fortsetter.

Variabler kan også sendes til og returneres fra andre emner og Power Automate-flyter.

Webapp

Variabler kan eksistere på tre nivåer eller områder:

• Emnevariabler kan bare brukes i emnene de er opprettet i. Dette omfanget er standardområdet variabler du oppretter.
• Globale variabler kan brukes i alle emner. Du kan endre omfanget for et emne for å gjøre den til en global variabel.
• Systemvariabler opprettes automatisk med kopiloten. De gir mer kontekstavhengig informasjon om samtalen eller brukeren. De er tilgjengelige i alle emner.

Variabeltyper

En variabel er knyttet til en basistype. Typen fastsetter hvilke verdier variablene kan inneholde og operatorene du kan bruke når du konstruerer et logisk uttrykk med den.

Type	Bekrivelse
String	En sekvens med tegn som brukes til å representere tekst
Boolean	En logisk verdi som bare kan være true eller false
Nummer	Et reelt tall
Table	En liste med verdier, men alle verdier må være av samme type
Spill inn	En samling navneverdipar der verdier kan være av hvilken som helst type
Date/klokkeslett	En dato, et klokkeslett, en ukedag eller en måned i forhold til et tidspunkt
Valg	En liste over strengverdier som har tilknyttede synonymer
Tomt	En plassholder for ingen verdi eller ukjent verdi. Hvis du vil ha mer informasjon, kan du se Tomme verdier i Power Fx

Variabelens type angis første gang en verdi tildeles til den. Etter det blir typen for variabelen fast, og den kan ikke tildeles verdier av andre typer. En variabel der startverdien er 1 tilordnes eksempelvis typen Tall. Hvis du prøver å tilordne den til Streng-verdi i "apples", fører dette til en feil.

Når du tester en kopilot, kan en variabel vises midlertidig som typen ukjent. En ukjent variabel er ikke tilordnet en verdi ennå.

Rekkefølgen på variablene fastsettes fra topp til nederst på redigeringslerretet. Det vil si at noder øverst i redigeringslerretet vurderes før noder nederst. Når du oppretter grener med betingelsesnoder, ordnes grener fra venstre mot høyre. Det vil si at noder i grenen lengst til venstre vurderes før noder i grenen lengst til høyre.

Enheter

Microsoft Copilot Studio bruker enheter til å identifisere en bestemt type informasjon i svarene fra en bruker. Den identifiserte informasjonen lagres i en variabel av typen som er riktig for informasjonen. Tabellen nedenfor viser variabelbasistypen som er tilknyttet forhåndsbygde enheter.

Entity	Basistype for variabel
Flervalgsalternativer	Valg
Brukerens hele svar	String
Alder	Nummer
Boolean	Boolean
City	String
Color	String
Kontinent	String
Land eller område	String
Dato og klokkeslett	Date/klokkeslett
Email	String
Hendelser	String
Integer	Integer
Språk	String
Money	Nummer
Nummer	Nummer
Ordenstall	Nummer
Organisasjonen	String
Prosentsats	Nummer
Personnavn	String
Telefonnummer	String
Interessepunkt	String
Hastighet	Nummer
State	String
Gateadresse	String
Temperatur	Nummer
URL	String
Tykkelse	Nummer
Postnummer	String
Egendefinert entitet	Valg

Opprett en variabel

Alle noder der du blir bedt om å velge en variabel som utdata, for eksempel som en spørsmål-node, oppretter automatisk en utdatavariabel av riktig type.

Velg en enhet du vil bruke

Spørsmålsnoder opprettes med flervalgsalternativer som standard. Hvis du vil bruke en annen forhåndsbygd eller egendefinert enhet, velger du Identifiser-boksen og typen informasjon kopiloten skal lytte etter.

Gi nytt navn til en variabel

Variabler tildeles automatisk et navn når du oppretter dem. En anbefalt fremgangsmåte er å gi variablene meningsfulle navn for å gjøre hensikten klar for alle andre som må vedlikeholde kopiloten.

1. Velg variabelen for å åpne den i ruten Variabelegenskaper.

2. Angi et nytt navn på variabelen under Variabelnavn.

Angi en variabel

Vanligvis bruker du en Spørsmål-node til å lagre brukerinndata i en variabel. Det kan imidlertid oppstå situasjoner der du vil angi verdien selv. I slike tilfeller bruker du noden Angi variabelverdi.

1. Velg Legg til node (+) for å legge til en node, og velg deretter Angi en variabelverdi.

2. Velg boksen under Angi variabel, og velg Opprett en ny variabel.

   

   Det opprettes en ny variabel. Typen er ukjent før du tildeler en verdi til den.

   

3. For Til verdi tilordner du en verdie ved å bruke et av følgende alternativer:

   • Skriv inn en litteralverdi.
   • Velg en eksisterende variabel av samme type. Denne handlingen angir variabelen til samme verdi som variabelen du velger.
   • Bruke en Power Fx-formel. Power Fx-formler er nyttig for mer komplekse typer der litterale verdier ikke kan brukes, for eksempel tabell- og oppføringstyper.

Bruke litteralverdier

I stedet for å velge en variabelverdi kan du angi en litteralverdi i en hvilken som helst variabel.

Noden prøver å tolke litterale verdier som en streng, et tall eller en boolsk type. 123 tolkes for eksempel som et tall. Hvis du vil at den skal tolkes som en strengverdi i stedet, kan du pakke inn verdien i doble anførselstegn, for eksempel "123".

For noen scenarioer, eller der du bruker mer komplekse typer, bruker du en Power Fx-formel til å angi en bestemt type.

Variabler-rute

I Variabler-ruten kan du vise alle variablene som er tilgjengelige i emnet, uavhengig av hvilke noder de er definert eller brukt i. For hver variabel kan du velge om den kan motta verdien fra andre emner, returnere verdien til andre emner eller begge deler. Du kan også velge en variabel for å redigere egenskapene i ruten Variabelegenskaper.

Hvis du vil åpne Variabler-ruten, velger du Variabler på menylinjen til emnet.

Ruten Egenskaper for variabel

I ruten Variabelegenskaper kan du gi nytt navn til en variabel, se hvor en variabel brukes, eller konvertere en variabel til en global variabel. Du kan imidlertid ikke konvertere den fra en global variabel tilbake til en emnevariabel. Du kan også velge om den kan motta verdier fra eller sende verdien til andre emner.

Hvis du vil åpne ruten Variabelegenskaper, velger du en variabel i Variabler-ruten. Du kan også åpne ruten Variabelegenskaper ved å velge en variabel i en hvilken som helst node.

Systemvariabler

Hver kopilot kommer med innebygde systemvariabler som gir tilleggsinformasjon om en samtale.

Ikke alle systemvariabler vises i listen. Du må få tilgang til disse skjulte systemvariablene med en Power Fx-formel.

Hvis du vil bruke systemvariabler i en Power Fx-formel, må du legge til System. før variabelnavnet. Hvis du for eksempel vil ta med systemvariabelen User.DisplayName i en formel, må du henvise til den som System.User.DisplayName.

Navn	Type	Skjult	Definisjon
Activity.Channel	valgmulighet	synlig	Kanal-ID-en for gjeldende samtale
Activity.ChannelData	alle	skjult	Et objekt som inneholder kanalspesifikt innhold
Activity.ChannelId	string	skjult	Kanal-ID-en for gjeldende samtale, som en streng
Activity.From.Id	string	skjult	Kanalspesifikk unik ID for avsenderen
Activity.From.Name	string	skjult	Kanalspesifikt, brukervennlig navn på avsenderen
Activity.Name	string	synlig	Navnet på hendelsen
Activity.Text	string	synlig	Den siste meldingen sendt av brukeren
Activity.Type	valgmulighet	synlig	Type aktivitet
Activity.TypeId	string	skjult	Type aktivitet, som en streng
Activity.Value	alle	skjult	Verdi med åpen ende
Bot.Name	string	synlig	Navnet på kopiloten
Channel.DisplayName	string	skjult	Viser navnet på kanalen
Conversation.Id	string	synlig	Den unike ID-en for nåværende samtalen
LastActivity.Id	string	synlig	ID-en for den forrige sendte aktiviteten
LastMessage.Id	string	synlig	ID-en for den forrige meldingen sendt av brukeren
LastMessage.Text	string	synlig	Den forrige meldingen sendt av brukeren
Recognizer.TriggerMessage.Id	string	synlig	ID-en for brukermeldingen som utløste gjeldende emne
Recognizer.TriggerMessage.Text	string	synlig	Brukermeldingen som utløste gjeldende emne
User.DisplayName	string	synlig	Visningsnavnet til den påloggede brukeren

Send variabler mellom emner

Når du omdirigerer et emne til et annet, kan du sende verdiene for variablene mellom det opprinnelige emnet og målemnet. Det er spesielt nyttig å sende variabler mellom emner når et tidligere emne allerede har hentet inn informasjon som et senere emne trenger. Brukerne setter pris på at de slipper å svare på det samme spørsmålet igjen.

Motta verdier fra andre emner

Når et emne definerer en variabel (for eksempel i en Spørsmål-node), ber kopiloten brukeren om å fylle inn verdien for variabelen. Hvis kopiloten allerede har hentet verdien i et tidligere emne, er det ingen grunn til å stille spørsmålet på nytt. Du kan angi variabelen til Motta verdier fra andre emner i disse tilfellene. Når et annet emne omdirigeres til dette, kan det sende verdien for en variabel (eller en litteralverdi) til denne variabelen og hoppe over spørsmålet. Opplevelsen for sluttbrukeren som snakker med kopiloten, er sømløs.

I dette eksemplet skal vi bruke to emner, Hilsning og Snakk med kunde. Begge emnene ber om kundens navn. Hvis Hilsning-emnet kjører først, vil imidlertid Snakk med kunde-emnet hoppe over spørsmålet. I stedet bruker den verdien til variabelen som sendes fra Hilsning-emne.

Her er flyten i Snakk til kunde-emnet:

Som vist i ruten Test kopiloten, får brukeren spørsmålet «Hva skal jeg kalle deg?» hvis dette emnet utløses først. Den lagrer verdien i en strengvariabel kalt userName. Variabelen userName angis også slik at den får verdien fra andre emner. Emnet konkluderer med meldingen Jeg håper du får en fin dag, {userName}.

Her er flyten i Hilsning-emnet:

Som vist i ruten Test kopiloten, får brukeren spørsmålet «Hva heter du?» hvis dette emnet utløses først. Den lagrer verdien i en strengvariabel kalt UserName. Emnet sender meldingen Hyggelig å hilse på deg, {UserName}. Deretter blir det videresendt til Snakk til kunde-emne, som sender meldingen Jeg håper du får en fin dag, {userName}. Vær imidlertid oppmerksom på at Snakk til kunde-emnet hoppet over spørsmålet om brukerens navn. I stedet bruker den verdien til variabelen UserName som sendes fra Hilsning-emne.

Til slutt, her er den andre samtalen igjen, denne gangen fra perspektivet til Snakk til kunde-emnet:

La oss gå gjennom trinnene for å konfigurere et emne for å motta verdier fra andre emner. Vi skal bruke det gjeldende eksemplet, men de samme trinnene vil fungere når et emne må ha en verdi fra en tidligere emne.

Konfigurer målemnet

Målemnet er emnet det omdirigeres til, det som mottar verdier fra andre emner. I vårt eksempel er det Snakk til kunde.

1. Opprett eller gå til målemnet.

2. Legg til en Spørsmål-node, og skriv inn What should I call you? for meldingen.

3. Velg den forhåndsbygde enheten Personnavn under Identifiser.

4. Velg variabelen for å åpne den i ruten Variabelegenskaper. Gi den navnet userName, og velg deretter Motta verdier fra andre emner.

   

5. Legg til en Melding-node.

6. Skriv inn I hope you're having a wonderful day, i meldingsboksen.

7. Velg ikonet Sett inn variabel ({x}), og velg deretter userName.

8. Velg mellomrommet etter variabelen og skriv inn !.

9. Lagre emnet.

Sett opp kildeemnet

Kildeemnet er emne som foretar omdirigeringen, det som angir verdien som sendes til målemnet. I vårt eksempel er det Hilsning.

1. Gå til kildeemnet.

2. Legg til en omdirigeringsnode og velg målemnet.

3. Velg + Legg til inndata og velg variabelen fra målemnet som du vil sende en verdi til.

   

4. Velg ikonet >, og velg deretter variabelen du vil sende verdi for.

   

   Omdirigeringsnoden skal se slik ut:

   

5. Lagre emnet.

Returner verdier til opprinnelige emner

Når et emne omdirigeres til og henter en variabel ved å stille et spørsmål eller på en annen måte, kan variabelen returneres til det opprinnelige emnet. Variabelen blir en del av det opprinnelige emnet og kan brukes som en hvilken som helst annen variabel. Informasjon som kopiloten henter, er dermed tilgjengelig på tvers av emner, slik at behovet for globale variabler reduseres.

La oss fortsette med eksemplet fra forrige del. Vi stiller et nytt spørsmål i Snakk til kunde-emne, og vi returnerer deretter svaret til Hilsning-emne.

Konfigurer kildeemnet for en returnert variabel

Når du returnerer en variabel til et emne, er klideemnet emnet det omdirigeres til, det som angir verdien som sendes tilbake til den opprinnelige emne. I dette eksemplet er det Snakk til kunde.

1. Gå til kildeemnet.

2. Legg til en Spørsmål-node, og skriv inn What city do you live in? for meldingen.

3. Velg den forhåndsbygde enheten Poststed under Identifiser.

4. Velg variabelen for å åpne den i ruten Variabelegenskaper. Gi den navnet userCity, og velg deretter Returner verdier til opprinnelige emner.

   

5. Lagre emnet.

Konfigurer målemnet for en returnert variabel

Når du returnerer en variabel til et emne, er målemnet emnet som omdirigerer, det som mottar verdier fra andre emner. I vårt eksempel er det Hilsning.

1. Gå til målemnet.

2. Variabelen du valgte i kildeemnet, skal vises i Omdirigering-noden som en utdatavariabel.

   

3. Lagre emnet.

Klassisk

Enhets- og variabeltype

Microsoft Copilot Studio bruker enheter til å identifisere en bestemt type informasjon i svarene fra en bruker. En variabeltype knyttes til den identifiserte informasjonen når den lagres. Variabeltypen er analog med enheten.

Hver enhets- eller variabeltype tilordnes til en basistype, som angitt i tabellen nedenfor. Basistypen fastsetter operatorene du kan bruke når du konstruerer et logisk uttrykk med den tilsvarende variabelen. Den fastsetter også om du kan sende en variabel til en flyt eller Bot Framework-ferdighet som en inndataparameter.

En boolsk basistype tilordnes for eksempel til operatoren «er lik» der mulige verdier er True eller False. Basistypen tall gir deg numeriske operatorer, for eksempel «er lik», «er større enn» eller «er større enn eller lik» og så videre.

Enhet	Basistype for variabel
Flervalgsalternativer	String
Brukerens hele svar	String
Alder	Nummer
Boolean	Boolean
City	String
Color	String
Kontinent	String
Land eller område	String
Dato og klokkeslett	String
Duration	String
Email	String
Seminar/konferanse	String
Språk	String
Money	String
Nummer	String
Ordenstall	String
Organisasjonen	String
Prosentsats	Nummer
Personnavn	String
Telefonnummer	String
Interessepunkt	String
Hastighet	Nummer
State	String
Gateadresse	String
Temperatur	Nummer
URL	String
Vekt	Nummer
Postnummer	String
Egendefinert entitet	String

Opprett en variabel

Legg til en spørsmålsnode på redigeringslerretet for roboter. En variabel opprettes automatisk i noden.

1. Gå til Emnesiden for roboten, og åpne emnet du vil legge til en variabel i.

2. Velg Legg til node (+), og velg deretter Still et spørsmål.

   

   Det opprettes automatisk en variabel som inneholder brukerens svar.

   

Velg en enhet du vil bruke

Det opprettes som standard en spørsmålsnode med flervalgsalternativer. Hvis du vil bruke en annen forhåndsbygd eller egendefinert enhet, velger du hva du vil identifisere fra noden.

Gi nytt navn til en variabel

Variabler som opprettes automatisk, får et standardnavn. Hvis du vil gi en variabel nytt navn, velger du variabelnavnet, angir et nytt navn og velger Fullført.

Bruke variabler i handlingsnoder

Når du bruker en variabel i en handlingsnode og basistypen for den samsvarer med en parametertype som er angitt for en flyt eller Bot Framework-ferdighet, kan du sende den til denne parameteren. Utdataene fra handlingsnoder genererer nye variabler.

Bruke litterale verdier i handlingsnoder

Du kan skrive inn en litteral verdi i feltet for variabelinndata i en handlingsnode i stedet for å velge en variabel på menyen.

Analyser verdi-node

Med Analyser verdi-noden kan du konvertere en verdi av én type til en verdi av en annen type. Når du legger til en node i et emne velger du Legg til node (+), deretter Variabelbehandling og Analyser verdi.

Nøkkelscenarier som bruker nodene Analyser verdi til å konvertere JSON-verdier eller variabler som ikke er skrevet inn (hvis verdi eller struktur ikke er kjent før kjøretid, for eksempel ChannelData) til konkrete typer.

Prosessen starter når en flyt kalles, som i sin tur kaller en API. API-en returnerer et beregnet resultat. Vanligvis må du analysere dette svaret og returnere én eller flere primitive variabler til Microsoft Copilot Studio. Med noden Analyser verdi kan du sende hele API-resultatet som en streng:

{
    "Name": "Gary",
    "Position": "PM",
    "Company": "Microsoft",
    "FormerPositions": [{
            "Position": "Engineer"
        }
    ]
}

Strengvariabelen du har nå, kan konverteres til en Registrer variabel, med full intellisense-støtte i Power Fx ved hjalp av denne nye noden. Eksempel på bruk av eksempeldata hjelper deg med å illustrere denne prosessen.

Eksempel på bruk av Analyser verdi-noden

1. Legg til en Analyser verdi-node, og velg variabelen du vil analysere.

   

2. Velg datatype. I dette tilfellet velger du Fra eksempeldata.

   

3. Nå kan du angi JSON ved å klikke Hent skjema fra eksempel-JSON. Når du klikker dette, åpnes et redigeringsprogram der du kan lime inn eksemplet.

   

4. Til slutt angir du hvilken variabel du vil plassere verdien i. Vanligvis oppretter du en ny variabel for dette.

   

   Vær oppmerksom på at utdatavariabelen nå er av riktig type – Oppføring.

   

Du kan nå bruke den nye variabelen. Her i redigeringsprogrammet for Power Fx kan du se at du får full oversikt over de ulike egenskapene.

I tillegg til å analysere JSON-strenger, vil en nøkkelbruk av noden Analyser verdi være analysering av UntypedObjects ved kjøretid. Den vanligste av disse er når du mottar en hendelse og må analysere hendelsesverdien. Du kan også analysere egenskapen System.Activity.ChannelData, som varierer ved kjøretid etter kanal.

Hvis hendelsen kom fra Teams i følgende eksempel, må du bruke utviklerdokumentasjonen for Teams til å finne et eksempel på hvordan den innkommende hendelsen kommer til å se ut, og deretter bruke fra eksempeldata som beskrevet i denne delen.

Sende variabler mellom emner

Når du omdirigerer til andre emner, kan du sende verdier til variabler i målemnet eller hente variabler fra det. Det er spesielt nyttig å sende variabler mellom emner når du allerede har informasjon som emnet trenger. Brukerne setter pris på at de slipper å svare flere ganger på spørsmålet. Det er også nyttig når du refaktorerer og deler emnene inn i komponenter som kan brukes på nytt, og vil sende variabler mellom emnene.

Merk

Variabler av typen Custom Entity, Date and Time, Duration og Multiple-choice kan ikke sendes mellom emner.

Motta verdier fra andre emner

Når et emne definerer en variabel (for eksempel med en spørsmålsnode), ber roboten brukeren om å fylle inn verdien for variabelen. Hvis roboten allerede har hentet verdien, er det ingen grunn til å stille spørsmålet på nytt. Du kan definere variabelen som Motta verdier fra andre emner i disse tilfellene. Når et annet emne omdirigeres til dette, kan det sende en variabel (eller litterale verdier) til denne variabelen og hoppe over spørsmålet. Opplevelsen for sluttbrukeren som snakker med roboten, er sømløs.

Angi egenskapen for variabelen hvis du vil motta verdier fra andre emner:

1. Velg variabelen du vil skal motta verdier fra andre emner, i Spørsmål-noden.

2. Velg Motta verdier fra andre emner under Emne (begrenset omfang) i ruten Variabelegenskaper.

   

3. Lagre emnet.

4. Gå til et emne du vil omdirigere til. Følg fremgangsmåten i Omdiriger til et annet emne for å omdirigere til riktig emne.

5. Velg + Legg til inndata for målemne.

   

6. Velg en variabel i det omdirigerte emnet du vil sende variabelen til.

   

7. Under Angi eller velg en verdi velger du variabelen i det gjeldende emnet du vil sende til det omdirigerte emnet.

   

   Variabelen vises i den omdirigerte noden.

   

Returner verdier til opprinnelige emner

Når et emne stiller et spørsmål eller henter en variabel fra en handling på en annen måte, kan variabelen returneres til det opprinnelige emnet som omdirigerte til det.

I dette tilfellet blir variabelen også en del av det opprinnelige emnet og kan brukes som en hvilken som helst annen variabel. Dette hjelper deg å konstruere emnet slik at informasjonen roboten henter, er tilgjengelig på tvers av emner, slik at behovet for globale variabler reduseres.

Hvis du vil returnere en variabel til det opprinnelige emnet, angir du egenskapen for variabelen:

1. Velg variabelen du vil skal motta verdier fra andre emner, i Spørsmål-noden.

2. Velg Returner verdier til opprinnelige emner under Emne (begrenset omfang) i ruten Variabelegenskaper.

   

3. Lagre emnet.

4. Gå til et emne du vil omdirigere til. Følg fremgangsmåten i Omdiriger til et annet emne for å omdirigere til riktig emne.

   Variabelen som returneres til emnet, vises i det omdirigerte emnet. Bruk den returnerte variabelen i emnet.

   

Bruke Variabler-ruten

Bruk Variabler-ruten til å velge mottaks- eller returstatus for flere variabler samtidig.

1. Velg Variabler på menylinjen for emnet.

   

2. Velg om du vil at verdiene skal sendes, mottas eller begge deler mellom emnene, for hver variabel i emnet.

   

Bruke litterale verdier i variabelinndata

Du kan sende litterale verdier og variabler til en emne. Hvis du vil sende en litteral verdi, skriver du inn verdien du vil bruke som inndata, i stedet for å velge en variabel.

Beslektede emner

• Bruk variabler på tvers av emner
• Tilpass utseendet og funksjonaliteten til en kopilot