Oversigt over variabler
Variabler kan findes på fire niveauer eller omfang:
- Emne-variabler kan kun refereres til i de emner, som de oprettes i. Dette er standardomfanget for oprettede variabler.
- Globale variabler kan bruges i alle emner. Du kan ændre omfanget af ethvert emne for at gøre det til en global variabel.
- Systemvariabler oprettes automatisk med din agent. De giver mere kontekstafhængige oplysninger om samtalen eller brugeren. De er som regel tilgængelige i alle emner.
- Miljøvariabler oprettes i Power Platform og er skrivebeskyttet i Copilot Studio. De lagrer parameternøglerne og -værdierne, som derefter fungerer som input til forskellige andre programobjekter, herunder Copilot Studio. Hvis du adskiller parametrene fra de forbrugende objekter, kan du ændre værdierne i det samme miljø, eller når du overfører løsninger til andre miljøer. Alternativet lader de hard-coded parameterværdier være inden for de komponenter, der bruger dem.
Variabeltyper
En variabel er knyttet til en basistype. Typen bestemmer, hvilke værdier som variablen kan indeholde, og de operatorer, du kan bruge, når du bygger et logisk udtryk med den tilsvarende variabel.
| Type | Beskrivelse |
|---|---|
| String | En række tegn, der bruges til at repræsentere tekst |
| Boolean | En logisk værdi, der kun kan være true eller false |
| Nummer | Ethvert reelt tal |
| Table | En liste over værdier, men alle værdier skal være af samme type |
| Post | En samling navneværdipar, hvor værdier kan være af en hvilken som helst type |
| Datetime | En dato, et klokkeslæt, en ugedag eller en måned i forhold til et tidspunkt |
| Choice | En liste over strengværdier med tilknyttede synonymer |
| Tom | En pladsholder for "ingen værdi" eller "ukendt værdi"; Du kan finde flere oplysninger under Tomme felter i Power Fx |
En variabels type indstilles, første gang en værdi tildeles. Derefter er typen for den pågældende variabel fast, og den kan ikke tildeles værdier af nogen anden type. En variabel, der tildeles startværdien 1, tildeles f.eks. typen Nummer. Forsøg på at tildele den til en strengværdi af "apples" resulterer i en fejl.
Når du tester en agent, vises en variabel muligvis midlertidigt som typen ukendt. En variabel af typen ukendt har endnu ikke fået tildelt en værdi.
Rækkefølgen af variabler bestemmes fra top til bund i oprettelseslærredet. Noder øverst på oprettelseslærredet overvejes før noder nederst.
Når du opretter grene med betingelsesnoder, sorteres grene fra venstre mod højre. Noder i grenen længst til venstre betragtes før noder i grenen yderst til højre.
Enheder
Copilot Studio bruger objekter til at identificere en bestemt type oplysninger fra en brugers svar. De identificerede oplysninger gemmes i en variabel af den type, der passer til oplysningerne. I følgende tabel vises den variable basistype, der er knyttet til færdigbyggede objekter.
| Enhed | Variabel basistype |
|---|---|
| Indstillinger med flere svarmuligheder | Choice |
| Brugerens fulde svar | String |
| Alder | Nummer |
| Boolean | Boolean |
| City | String |
| Color | String |
| Kontinent | String |
| Land eller område | String |
| Dato og klokkeslæt | Datetime |
| String | |
| Hændelse | String |
| Integer | Integer |
| Sprog | String |
| Money | Nummer |
| Nummer | Nummer |
| Ordenstal | Nummer |
| Organisation | String |
| Procentdel | Nummer |
| Personnavn | String |
| Telefonnummer | String |
| Interessepunkt | String |
| Hastighed | nummer |
| State | String |
| Adresse | String |
| Temperatur | Nummer |
| URL | String |
| Tykkelse | Nummer |
| Postnummer | String |
| Brugerdefineret objekt | Choice |
Miljøvariabler
Miljøvariabler er et Power Platform-koncept. Miljøvariabler aktiverer det grundlæggende ALM-scenario (Application Lifecycle Management) med at flytte et program mellem Power Platform-miljøer. I dette scenario forbliver programmet nøjagtigt det samme med undtagelse af nogle få eksterne referencer til nøgler, der er forskellige mellem kildemiljøet og destinationsmiljøet.
Brug miljøvariabler på samme måde som emne-, globale og systemvariabler. En bemærkelsesværdig forskel er, at miljøvariabler er skrivebeskyttede i Copilot Studio. Agentforfattere kan ikke ændre miljøvariabler i Copilot Studio. Men administratorer kan ændre værdien af miljøvariabler i Power Apps. I Copilot Studio kan du bruge Variabler-panelet til at se oplysninger om en miljøvariabel. Panelet Variabler har også et link til den oprindelige oprettelsesoplevelse.
Den publicerede version af en agent, der bruger miljøvariabler, indeholder de værdier, der blev angivet for disse variabler, da agenten blev publiceret. Når en administrator opdaterer miljøvariabler, skal du genudgive alle agenter, der bruger disse variabler, for at ændringerne kan træde i kraft under kørsel. Der er dog én undtagelse: Du behøver ikke at genudgive dine agenter, når værdien af en miljøvariabel af typen hemmelig ændres. I modsætning til andre miljøvariabler hentes hemmelige variabler under kørsel.
Miljøvariabeltyper i Copilot Studio knyttes til Power Apps-datatyper på følgende måde:
| Type i Copilot Studio | Type i Power Apps |
|---|---|
| Decimaltal | Nummer |
| JSON | Registrer typen fra værdien. Hvis ikke JSON=> Uspecificeret (valideringsfejl) |
| SMS-besked | String |
| Ja/Nej | Boolean |
| Datakilde | String |
| Hemmelighed | String |
Bemærk
Fejl i miljøvariabler kan ses i test-chatten, og når du publicerer. Disse fejl vises dog ikke på listen Emne, fordi de ikke er variable emner.
Systemvariabler
Alle agenter leveres med indbyggede systemvariabler, der giver flere oplysninger om en samtale.
Bemærk
Du kan finde flere oplysninger om stemmeaktiverede agentvariabler i Brug af stemmevariabler.
Ikke alle systemvariabler vises på listen. Du skal have adgang til disse skjulte systemvariabler med en Power Fx-formel.
Hvis du vil bruge systemvariabler i en Power Fx-formel, skal du tilføje System. før variabelnavnet. Hvis du f.eks. vil inkludere systemvariablen User.DisplayName i en formel, skal du referere til den som System.User.DisplayName.
| Navn | Type | Definition |
|---|---|---|
| Activity.Attachments | tabel | De vedhæftede filer, som brugeren har leveret |
| Activity.Channel | valgmulighed | Kanal-id for den aktuelle samtale |
| Activity.ChannelData | vilkårlig | Et objekt, der indeholder kanalspecifikt indhold |
| Activity.ChannelId | string | Kanal-id for den aktuelle samtale, som en streng |
| Activity.From.Id | string | Kanalspecifik entydigt id for afsenderen |
| Activity.From.Name | string | Kanalspecifikt brugervenligt navn på afsenderen |
| Activity.Name | string | Navnet på hændelsen |
| Activity.Recipient.Id | string | Egenskaben Type for den indgående aktivitet. |
| Activity.Recipient.Name | string | Repræsenterer det viste navn for agenten i kanalen. I telefonikanalsammenhæng er værdien af denne variabel det telefonnummer, som agenten er knyttet til. |
| Activity.Text | string | Den sidste meddelelse, der er sendt af brugeren |
| Activity.Type | valgmulighed | Type af aktivitet |
| Activity.TypeId | string | Type af aktivitet som en streng |
| Activity.Value | vilkårlig | Uafsluttet værdi |
| Bot.EnvironmentId | string | Miljø-id'et for agenten |
| Bot.Id | string | Agentens id |
| Bot.Name | string | Navnet på din agent |
| Bot.SchemaName | string | Skemanavnet for agenten |
| Bot.TenantId | string | Agentens lejer-id |
| ClientPluginActions | valgmulighed | Samling af Dynamisk klient-plug-in-handlinger, der skal overvejes i forbindelse med generativ orkestrering |
| Conversation.Id | string | Det entydige aktuelle samtale-id |
| Conversation.InTestMode | Boolean | Boolesk flag, der repræsenterer, om samtalen foregår på testlærredet. |
| Conversation.LocalTimeZone | string | Navnet på den tidszone, der skal bruges af brugeren i tidszonedatabaseformatet IANA |
| Conversation.LocalTimeZoneOffset | datetime | Tidsforskydningen fra UTC for den aktuelle lokale tidszone |
| Error.Code | string | Fejlkoden for den aktuelle fejl. Fejlmeddelelsen for den aktuelle fejl. |
| Error.Message | string | Fejlmeddelelsen for den aktuelle fejl. Bemærk: Denne variabel understøttes kun, hvis udløseren er On Error. |
| FallbackCount | nummer | Denne variabel tæller de gange, hvor en emne ikke kunne matches med brugerinputtet. Bemærk: Denne variabel understøttes kun, hvis udløseren er On Unknown Intent. |
| InactivityTimer.Continue | Boolean | Boolesk flag, der angiver, om timeren skal fortsætte. Bemærk: Denne variabel understøttes kun, hvis udløseren er Inactivity. |
| InactivityTimer.Count | nummer | Det antal gange, som OnInactivity-timeren er blevet aktiveret på grund af brugerinaktivitet efter den konfigurerede tid. Bemærk: Denne variabel understøttes kun, hvis udløseren er Inactivity. |
| LastMessage.Id | string | Id for den forrige meddelelse, der er sendt af brugeren |
| LastMessage.Text | string | Den forrige meddelelse, der er sendt af brugeren |
| Recognizer.ExtractedEntities | valgmulighed | Repræsenterer de udtrukne objekter fra udløsermeddelelsen. Bemærk: Denne variabel understøttes kun, hvis udløseren er On Select Intent. |
| Recognizer.IntentOptions | valgmulighed | Repræsenterer hensigtsindstillingerne, når genkendelsen returnerer tvetydige resultater. Bemærk: Denne variabel understøttes kun, hvis udløseren er On Select Intent. |
| Recognizer.SelectedIntent | valgmulighed | Repræsenterer den hensigt, der er valgt fra genkendelsen. Bemærk: Denne variabel understøttes kun, hvis udløseren er On Select Intent. |
| Recognizer.TriggeringMessage.Id | string | Id for den brugermeddelelse, der udløste det aktuelle emne |
| Recognizer.TriggeringMessage.Text | string | Brugermeddelelse, der udløste det aktuelle emne |
| Recognizer.MultipleTopicsMatchedReason | string | Bruges til at bestemme, hvorfor flere emner blev matchet. Bemærk: Denne variabel understøttes kun, hvis udløseren er On Select Intent. |
| SignInReason | valgmulighed | Bruges til at bestemme, hvilken logon-indstilling der er nødvendig, når emnet udløses. Bemærk: Denne variabel understøttes kun, hvis udløseren er On Sign In. |
| User.Language | valgmulighed | Denne variabel bruges til at angive landestandardens sprog for hver samtale. |
Variabler til integreret godkendelse (standard)
Følgende variabler er tilgængelige for agenter, der er konfigureret til godkendelse hos Microsoft. Denne konfiguration bruger Microsoft Entra ID-godkendelse og er standard for nye agenter.
Få flere oplysninger i Godkendelsesvariabler.
| Navn | Type | Definition |
|---|---|---|
| User.DisplayName | string | Det viste navn på den bruger, der i øjeblikket taler med Helpdesk-medarbejder. |
| User.Email | string | E-mail-adressen på den bruger, der i øjeblikket taler med Helpdesk-medarbejder. |
| User.FirstName | string | Fornavnet på den bruger, der i øjeblikket taler til agenten. |
| User.Id | string | Det entydige id for den bruger, der i øjeblikket taler med Helpdesk-medarbejder. |
| User.IsLoggedIn | Boolean | Boolesk flag, der repræsenterer, om den bruger, der i øjeblikket taler med agenten, er godkendt eller ej. |
| User.LastName | string | Familienavnet på den bruger, der i øjeblikket taler med agenten. |
| User.PrincipalName | string | Brugerens hovednavn for den bruger, der i øjeblikket taler til agenten. |
Variabler til manuel godkendelse med generisk OAuth 2
Følgende variabler er tilgængelige for agenter, der er konfigureret til at bruge den generiske OAuth 2-tjenesteudbyder.
| Navn | Type | Definition |
|---|---|---|
| User.AccessToken | string | Adgangstokenet for den bruger, der godkender med agenten. |
| User.DisplayName | string | Det viste navn på den bruger, der i øjeblikket taler med Helpdesk-medarbejder. |
| User.Id | string | Det entydige id for den bruger, der i øjeblikket taler med Helpdesk-medarbejder. |
| User.IsLoggedIn | Boolean | Boolesk flag, der repræsenterer, om den bruger, der i øjeblikket taler med agenten, er godkendt eller ej. |
Variabler til manuel godkendelse med Microsoft Entra ID
Følgende variabler er tilgængelige for agenter, der er konfigureret til at bruge Microsoft Entra ID-tjenesteudbydere (tidligere Azure Active Directory).
| Navn | Type | Definition |
|---|---|---|
| User.AccessToken | string | Adgangstokenet for den bruger, der godkender med agenten. |
| User.DisplayName | string | Det viste navn på den bruger, der i øjeblikket taler med Helpdesk-medarbejder. |
| User.Email | string | E-mail-adressen på den bruger, der i øjeblikket taler med Helpdesk-medarbejder. |
| User.FirstName | string | Fornavnet på den bruger, der i øjeblikket taler til agenten. |
| User.Id | string | Det entydige id for den bruger, der i øjeblikket taler med Helpdesk-medarbejder. |
| User.IsLoggedIn | Boolean | Boolesk flag, der repræsenterer, om den bruger, der i øjeblikket taler med agenten, er godkendt eller ej. |
| User.LastName | string | Familienavnet på den bruger, der i øjeblikket taler med agenten. |
| User.PrincipalName | string | Hovednavnet på den bruger, der i øjeblikket taler med agenten. |
Variabler for stemmeaktiverede agenter
Følgende variabler er kun tilgængelige for taleaktiverede agenter.
Bemærk
Du kan finde flere oplysninger om stemmeaktiverede agentvariabler i Brug af stemmevariabler.
| Navn | Type | Definition |
|---|---|---|
| Activity.InputDTMFKeys | string | Den rå DTMF-nøgleværdi, der blev modtaget fra telekommunikation. |
| Activity.SpeechRecognition.Confidence | nummer | Konfidensscoren for hele resultatet af Azure Site Recovery-hypotesen fra 0 til 1. |
| Activity.SpeechRecognition.MinimallyFormattedText | string | Let formateret tekst af hypoteseresultatet for Azure Site Recovery. Det kan f.eks. være "500 dollars". Ord staves helt ud, men der medfølger grundlæggende brug af store bogstaver og tegnsætningstegn. |
| Activity.UserInputType | valgmulighed | Inputtypen fra brugerens seneste input. Værdien kan enten være test, tale eller DTMF (Dual Tone Multiple-Frequency). |
| Conversation.OnlyAllowDTMF | Boolean | Boolesk flag, der angiver, om ISR skal angives til kun DTMF-tilstand under kørsel. |
| Conversation.SipUuiHeaderValue | string | Den UUI-overskriftsstreng, der bruges til at overføre kontekst til ISR ved opkaldsstart. |