Oversikt over variabler

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 agenten. De gir mer kontekstavhengig informasjon om samtalen eller brukeren. De er tilgjengelige i alle emner.
• Miljøvariabler opprettes i Power Platform og er skrivebeskyttet 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 som "apples" resulterer i en feil.

Når du tester en agent, 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

Webapp

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

Klassisk

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
Tykkelse	Nummer
Postnummer	String
Egendefinert entitet	String

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. En viktig forskjell er at miljøvariabler er skrivebeskyttet i Copilot Studio. Agentforfattere kan ikke endre miljøvariabler i Copilot Studio. Administratorer kan imidlertid endre verdien for miljøvariabler i Power Apps. I Copilot Studio kan du bruke Variabler-panelet til å vise informasjon om en miljøvariabel. Variabler-panelet har også en kobling til den opprinnelige redigeringsopplevelsen.

Den publiserte versjonen av en agent som bruker miljøvariabler, har verdiene som ble angitt for disse variablene da agenten ble publisert. Når en administrator oppdaterer miljøvariabler, må du publisere alle agenter som bruker disse variablene, på nytt for at endringene skal være effektive ved kjøretid. Det finnes imidlertid ett unntak: Du trenger ikke publisere agentene på nytt når verdien av en miljøvariabel av typen hemmelighet endres. I motsetning til andre miljøvariabler hentes hemmelige variabler ved kjøretid.

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

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

Notat

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

Systemvariabler

Hver agent kommer med innebygde systemvariabler som gir ytterligere informasjon om en samtale.

Notat

Hvis du vil ha mer informasjon om taleaktiverte agentvariabler, 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 agenten i kanalen. I telefonikanalkontekst er verdien for denne variabelen telefonnummeret som agenten 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 agenten
Bot.Id	string	ID-en til agenten
Bot.Name	string	Navnet på agenten
Bot.SchemaName	string	Skjemanavnet til agenten
Bot.TenantId	string	Leier-ID-en til agenten
ClientPluginActions	valgmulighet	Samling av handlinger for dynamisk klientprogramtillegg som bør vurderes for generativ orkestrering
Conversation.Id	string	Den unike ID-en for nåværende samtalen
Conversation.InTestMode	Bolsk	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. Feilmeldingen for den gjeldende feilen.
Error.Message	string	Feilmeldingen for den gjeldende feilen. Obs! Denne variabelen støttes bare hvis utløseren er On Error.
FallbackCount	Nummer	Denne variabelen teller antall ganger et emne ikke kunne samsvares med brukerinndata. Obs! Denne variabelen støttes bare hvis utløseren er On Unknown Intent.
InactivityTimer.Continue	Bolsk	Boolsk flagg som representerer om tidtakeren må fortsette. Obs! Denne variabelen støttes bare hvis utløseren er Inactivity.
InactivityTimer.Count	Nummer	Antall ganger OnInactivity-tidtakeren har blitt utløst på grunn av brukerinaktivitet etter konfigurert tid. Obs! Denne variabelen støttes bare hvis utløseren er 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. Obs! Denne variabelen støttes bare hvis utløseren er On Select Intent.
Recognizer.IntentOptions	valgmulighet	Representerer hensiktsalternativene når gjenkjenneren returnerer tvetydige resultater. Obs! Denne variabelen støttes bare hvis utløseren er On Select Intent.
Recognizer.SelectedIntent	valgmulighet	Representerer hensikten som er valgt fra gjenkjenneren. Obs! Denne variabelen støttes bare hvis utløseren er 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. Obs! Denne variabelen støttes bare hvis utløseren er On Select Intent.
SignInReason	valgmulighet	Brukes til å finne ut hvilket påloggingsalternativ som er nødvendig ved utløsing av emnet. Obs! Denne variabelen støttes bare hvis utløseren er On Sign In.
User.Language	valgmulighet	Denne variabelen brukes til å angi nasjonal innstilling for brukerspråk per diskusjon.

Variabler for integrert godkjenning (standard)

Følgende variabler er tilgjengelige for agenter som er konfigurert til å godkjenne med Microsoft. Denne konfigurasjonen bruker Microsoft Entra ID-godkjenning og er standard for nye agenter.

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

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

Variabler for manuell godkjenning med generisk OAuth 2

Følgende variabler er tilgjengelige agenter som er konfigurert til å bruke den generelle OAuth 2-tjenesteleverandøren.

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

Variabler for manuell godkjenning med Microsoft Entra ID

Følgende variabler er tilgjengelige agenter som er konfigurert til å bruke Microsoft Entra ID-tjenesteleverandørene (tidligere Azure Active Directory).

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

Variabler for taleaktiverte agenter

Følgende variabler er bare tilgjengelige for taleaktiverte agenter.

Notat

Hvis du vil ha mer informasjon om taleaktiverte agentvariabler, 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	Konfidensresultatet for Azure Site Recovery-hypotesen, fra 0 til 1.
Activity.SpeechRecognition.MinimallyFormattedText	string	Lett formatert tekst i resultatet av Azure Site Recovery-hypotesen. 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 brukerens siste inndata. Verdien kan være test, tale eller DTMF.
Conversation.OnlyAllowDTMF	Bolsk	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.