Arbeid med variabler

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.

Web-app

Variabler kan eksistere på fire nivåer, eller omfang:

• 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 copiloten. De gir mer kontekstavhengig informasjon om samtalen eller brukeren. De er tilgjengelige i alle emner.
• Miljøvariabler opprettes i og skrivebeskyttes Power Platform i Copilot Studio. De lagrer parameternøklene og verdiene, som deretter fungerer som inndata til forskjellige andre programobjekter, inkludert Copilot Studio. Hvis du skiller parameterne fra forbrukerobjektene, kan du endre verdiene i det samme miljøet eller når du overfører løsninger til andre miljøer. Alternativet er å la hardkodede parameterverdier være igjen i komponentene som bruker dem.

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 med 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. Forsøk på å tilordne den til en strengverdi resulterer "apples" i en feil.

Når du tester en copilot, 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. Noder øverst på redigeringslerretet vurderes før noder nederst.

Når du oppretter grener med betingelsesnoder, ordnes grener fra venstre mot høyre. Noder i grenen lengst til venstre vurderes før noder i grenen lengst til høyre.

Enheter

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 knyttet til 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.

Tips

Gi nytt navn til noder for å gjøre dem lettere å identifisere. Velg nodens navnefelt for å oppdatere navnet direkte, eller velg Mer-ikonet (...) for noden og Endre navn fra menyen. Du kan også gi nytt navn til noder i koderedigeringsprogrammet.

Det er ikke mulig å gi nytt navn til utløsernoder og Gå til trinn-noder .

Navn på noder kan være opptil 500 tegn.

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 Egenskaper for variabel.

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

Angi en variabel

Vanligvis bruker du en Spørsmål-node til å lagre brukerinndata til en variabel. Der kan imidlertid være situasjoner der du ønsker å sette verdien selv. I slike tilfeller bruker du noden Angi variabelverdi.

1. Velg Legg til node (+) for å legge til en node, og velg deretter Variabelbehandling>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.

Merk

Hvis det oppstår et misforhold mellom Angi variabel og Til-verdi når du angir en strengtypevariabel, vises en feilmelding og knappen Rett typeavvik . Velg knappen for å generere Copilot Studio en Power Fx formel som løser samsvaret automatisk.

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. 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 Egenskaper for variabel.

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 Egenskaper for variabel, velger du en variabel i Variabler-ruten. Du kan også åpne ruten Variabelegenskaper ved å velge en variabel i en hvilken som helst node.

Miljøvariabler

Miljøvariabler er et Power Platform konsept. Miljøvariabler muliggjør det grunnleggende scenarioet for administrasjon av applivssyklus (ALM) for flytting av en app mellom Power Platform-miljøer. I dette scenarioet forblir programmet nøyaktig det samme bortsett fra noen få viktige eksterne referanser som er forskjellige mellom kildemiljøet og målmiljøet.

Bruk miljøvariabler på samme måte som emnevariabler, globale variabler og systemvariabler. Én viktig forskjell er at du bare kan bruke miljøvariabler i skrivebeskyttet modus. Copilot-forfattere kan ikke endre miljøvariabelen i Copilot Studio. Administratorer kan imidlertid endre verdien på miljøvariabler i PowerApps-portalen.

Miljøvariabeltyper i Copilot Studio tildeles til PowerApps-datatyper på denne måten:

Type i Copilot Studio	Type i PowerApps
Desimaltall	Nummer
JSON	Finn typen fra verdien. Hvis ikke Json => Uspesifisert (valideringsfeil)
Tekstmelding	string
Ja/nei	Bolsk
Datakilde	string
Hemmelighet	String

Merk

Miljøvariabelfeil vises i testnettpraten og under publisering. Disse feilene vises imidlertid ikke i emnelisten fordi de ikke er emnevariabler.

Du kan ikke skrive eller redigere miljøvariabler i Copilot Studio. Du må bruke PowerApps-portalen til å endre eller angi miljøvariabler. Fra Copilot Studio kan du bruke ruten Variabler til å vise informasjon om en miljøvariabel. Ruten Variabler har også en kobling til den opprinnelige redigeringsfunksjonen.

Bruk miljøvariabler for Azure Key Vault-hemmeligheter

En miljøvariabel kan henvise til en hemmelighet i Key Vault. Dette er et spesielt tilfelle med miljøvariabler med unike vurderinger.

Hvis du vil opprette en hemmelig miljøvariabel i PowerApps-portalen, må du konfigurere Key Vault.

I tillegg til konfigurasjonen ovenfor må du utføre følgende handlinger for å autorisere Copilot Studio til å lese Key Vault:

1. Tildel rollen Key Vault Secrets User til programmet Microsoft Virtual Agents Service.

2. Hvis du vil autorisere alle kopiloter fra miljøet til å få tilgang til hemmeligheten, oppretter du et AllowedEnvironments-merke på hemmeligheten og legger til de tillatte miljø-ID-ene atskilt med komma.

3. Hvis du bare vil autorisere bestemte kopiloter fra miljøet til å bruke Key Vault, oppretter du et AllowedCopilots-merke og plasserer kopilotidentifikatoren i formatet {envId}/{schemaName}. Skill verdiene med komma for flere verdier.

Hvis du når maksimalt antall tegn, men likevel trenger å legge til flere kopiloter, legger du til et nytt merke med et beskrivende, men unikt navn (eksempel: AllowedCopilots2).

Den hemmelige verdien bufres i dialogens kjøretid i fem minutter. Mislykkede lesinger bufres i 30 sekunder.

Advarsel!

Ved å legge til hemmeligheten i kopiloten kan du vise verdien av denne hemmeligheten for alle brukere som kan redigere kopiloten i miljøet, fordi slike brukere kan redigere kopiloten til å returnere verdien i SendMessage-noden.

Systemvariabler

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

Merk

Hvis du vil ha mer informasjon om taleaktiverte kopilotvariabler, kan du se Bruk talevariabler.

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 inkludere systemvariabelen User.DisplayName i en formel, henviser du til den som System.User.DisplayName.

Name	Type	Definisjon
Activity.Attachments	tabell	Filvedleggene som leveres av brukeren
Activity.Channel	valgmulighet	Kanal-ID-en for gjeldende samtale
Activity.ChannelData	alle	Et objekt som inneholder kanalspesifikt innhold
Activity.ChannelId	string	Kanal-ID-en for gjeldende samtale, som en streng
Activity.From.Id	string	Kanalspesifikk unik ID for avsenderen
Activity.From.Name	string	Kanalspesifikt, brukervennlig navn på avsenderen
Activity.Name	string	Navnet på hendelsen
Activity.Recipient.Id	string	Type-egenskapen for den innkommende aktiviteten.
Activity.Recipient.Name	string	Representerer visningsnavnet for kopiloten i kanalen. I telefonikanalkontekst vil verdien av denne variabelen være telefonnummeret som kopiloten er knyttet til.
Activity.Text	string	Den siste meldingen sendt av brukeren
Activity.Type	valgmulighet	Type aktivitet
Activity.TypeId	string	Type aktivitet, som en streng
Activity.Value	alle	Verdi med åpen ende
Bot.EnvironmentId	string	Miljø-ID-en til kopiloten
Bot.Id	string	ID-en til kopiloten
Bot.Name	string	Navnet på kopiloten
Bot.SchemaName	string	Skjemanavnet til kopiloten
Bot.TenantId	string	Leier-ID-en til kopiloten
ClientPluginActions	valgmulighet	Samling av programtilleggshandlinger i den dynamiske klienten som skal vurderes for generative handlinger
Conversation.Id	string	Den unike ID-en for nåværende samtalen
Conversation.InTestMode	boolean	Boolsk flagg som representerer hvis diskusjonen skjer på testlerretet
Conversation.LocalTimeZone	string	Navnet på tidssonen som skal brukes av brukeren i databaseformatet for IANA-tidssone
Conversation.LocalTimeZoneOffset	datetime	Tidsforskyvningen fra UTC for gjeldende lokale tidssone
Error.Code	string	Feilkoden for nåværende feil. Merk: Denne variabelen støttes bare hvis utløseren er det On Error.
Error.Message	string	Feilmeldingen for den nåværende feilen. Merk: Denne variabelen støttes bare hvis utløseren er det On Error.
FallbackCount	Nummer	Denne variabelen teller antall ganger et emne ikke kunne samsvares med brukerinndata. Merk: Denne variabelen støttes bare hvis utløseren er det On Unknown Intent.
InactivityTimer.Continue	boolean	Boolsk flagg som representerer om tidtakeren må fortsette. Merk: Denne variabelen støttes bare hvis utløseren er det Inactivity.
InactivityTimer.Count	Nummer	Antall ganger OnInactivity-tidtakeren har blitt utløst på grunn av brukerinaktivitet etter konfigurert tid. Merk: Denne variabelen støttes bare hvis utløseren er det Inactivity.
LastMessage.Id	string	ID-en for den forrige meldingen sendt av brukeren
LastMessage.Text	string	Den forrige meldingen sendt av brukeren
Recognizer.ExtractedEntities	valgmulighet	Representerer de utpakkede enhetene fra en utløsingsmelding. Merk: Denne variabelen støttes bare hvis utløseren er det On Select Intent.
Recognizer.IntentOptions	valgmulighet	Representerer hensiktsalternativene når gjenkjenneren returnerer tvetydige resultater. Merk: Denne variabelen støttes bare hvis utløseren er det On Select Intent.
Recognizer.SelectedIntent	valgmulighet	Representerer hensikten som er valgt fra gjenkjenneren. Merk: Denne variabelen støttes bare hvis utløseren er det On Select Intent.
Recognizer.TriggeringMessage.Id	string	ID-en for brukermeldingen som utløste gjeldende emne
Recognizer.TriggeringMessage.Text	string	Brukermeldingen som utløste gjeldende emne
Recognizer.MultipleTopicsMatchedReason	string	Brukes til å finne ut hvorfor flere emner ble samsvart. Merk: Denne variabelen støttes bare hvis utløseren er det On Select Intent.
User.Language	valgmulighet	Denne variabelen brukes til å angi nasjonal innstilling for brukerspråk per diskusjon.
SignInReason	valgmulighet	Brukes til å finne ut hvilket påloggingsalternativ som er nødvendig ved utløsing av emnet. Merk: Denne variabelen støttes bare hvis utløseren er det On Sign In.

Variabler for integrert godkjenning (standard)

Variablene nedenfor er tilgjengelige når du har konfigurert kopiloten til å godkjenne med Microsoft. Dette bruker Entra ID-godkjenning og tillater bare Teams- og PowerApps-kanaler. Dette er standard for nye kopiloter.

Hvis du vil ha mer informasjon, kan du se Godkjenningsvariabler.

Name	Type	Definisjon
User.DisplayName	string	Visningsnavnet til brukeren som snakker med kopiloten.
User.Email	string	E-postadressen til brukeren som snakker med kopiloten.
User.FirstName	string	Fornavnet til brukeren som snakker med kopiloten.
User.Id	string	Den unike ID-en til brukeren som snakker med kopiloten.
User.IsLoggedIn	boolean	Boolsk flagg som representerer om brukeren som for øyeblikket snakker med kopiloten, er godkjent eller ikke.
User.LastName	string	Etternavnet til brukeren som snakker med kopiloten.
User.PrincipalName	string	Brukerhovednavnet til brukeren som snakker med kopiloten.

Variabler for manuell autentisering med Generisk OAuth 2

Følgende variabler er tilgjengelige når du har konfigurert copiloten til å bruke Generic OAuth 2-tjenesteleverandøren.

Name	Type	Definisjon
User.AccessToken	string	Tilgangstokenet for brukeren som godkjenner med kopiloten.
User.DisplayName	string	Visningsnavnet til brukeren som snakker med kopiloten.
User.Id	string	Den unike ID-en til brukeren som snakker med kopiloten.
User.IsLoggedIn	boolean	Boolsk flagg som representerer om brukeren som for øyeblikket snakker med kopiloten, er godkjent eller ikke.

Variabler for manuell godkjenning med Microsoft Entra ID

Variablene nedenfor er tilgjengelige når du har konfigurert kopiloten til å bruke Microsoft Entra ID-tjenesteleverandører (tidligere Azure Active Directory).

Name	Type	Definisjon
User.AccessToken	string	Tilgangstokenet for brukeren som godkjenner med kopiloten.
User.DisplayName	string	Visningsnavnet til brukeren som snakker med kopiloten.
User.Email	string	E-postadressen til brukeren som snakker med kopiloten.
User.FirstName	string	Fornavnet til brukeren som snakker med kopiloten.
User.Id	string	Den unike ID-en til brukeren som snakker med kopiloten.
User.IsLoggedIn	boolean	Boolsk flagg som representerer om brukeren som for øyeblikket snakker med kopiloten, er godkjent eller ikke.
User.LastName	string	Etternavnet til brukeren som snakker med kopiloten.
User.PrincipalName	string	Brukerhovednavnet til brukeren som snakker med kopiloten.

Variabler for taleaktiverte kopiloter

Følgende variabler er bare tilgjengelige i taleaktiverte kopiloter.

Merk

Hvis du vil ha mer informasjon om taleaktiverte kopilotvariabler, kan du se Bruk talevariabler.

Name	Type	Definisjon
Activity.InputDTMFKeys	string	Den rå DTMF-nøkkelverdien som ble mottatt fra telefoni.
Activity.SpeechRecognition.Confidence	Nummer	Hele konfidensresultatet for ASR-hypotesen, 0 til 1.
Activity.SpeechRecognition.MinimallyFormattedText	string	Lett formatert tekst i ASR-hypoteseresultatet. For eksempel fem hundre dollar. Ordene staves ut, men grunnleggende bruk av små og store bokstaver og tegnsetting er inkludert.
Activity.UserInputType	valgmulighet	Inndatatypen fra sluttbrukerens nyeste inndata. Verdien kan være test, tale eller DTMF.
Conversation.OnlyAllowDTMF	boolean	Boolsk flagg som representerer om IVR skal angis til modusen Bare DTMF ved kjøretid.
Conversation.SipUuiHeaderValue	string	UUI-overskriftsstrengen som brukes til å sende kontekst til IVR ved samtalestart.

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 meldingsnode.

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ål-emnet.

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

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 robotens Emner-side , 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 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.

Relatert innhold

• Bruke variabler til å overføre innhold på tvers av emner
• Tilpass utseendet og følelsen til en copilot