Arbejd med variable

Du kan bruge variabler til at gemme kundernes svar og genbruge deres indhold senere i samtalen.

Du kan også bruge variable til at oprette logiske udtryk, der dynamisk omdirigerer kunden til andre samtalestier. Du kan for eksempel gemme en kundes navn i en variabel, der kaldes UserName, og copiloten kan kalde kunden ved navn, efterhånden som samtalen fortsætter.

Variabler kan også overføres til, og returneres fra, andre emner og Power Automate-flow.

Web-app

Variabler kan findes på fire niveauer eller omfang:

• Emner kan kun bruges i de emner, de er oprettet 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 copilot. De giver mere kontekstafhængige oplysninger om samtalen eller brugeren. De er som regel tilgængelige i alle emner.
• Miljøvariabler oprettes i og skrivebeskyttes Power Platform 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 resulterer "apples" i en fejl.

Når du tester en copilot, 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 længst 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 variabelbasistype, 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
Email	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

Opret en variabel

En hvilken som helst node, som beder dig om at vælge en variabel som et output, f.eks. Spørgsmåls-node, der automatisk opretter en outputvariabel til en passende type.

Tip

Omdøb noder for at gøre det nemmere at identificere dem. Vælg nodens navnefelt for at opdatere navnet direkte, eller vælg ikonet Flere (...) for noden, og vælg Omdøb i menuen. Du kan også omdøbe noder i kodeeditoren.

Det er ikke muligt at omdøbe udløsernoder og Gå til trin-noder .

Nodenavne kan være på op til 500 tegn.

Vælg, hvilket objekt der skal bruges

Spørgsmålsnoder oprettes som standard med multiple-choice-indstillinger. Hvis du vil bruge et andet forudbygget eller brugerdefineret objekt, skal du markere feltet Identificer og vælge den type oplysninger, som copiloten skal lytte efter.

Omdøb en variabel

Variabler tildeles automatisk et navn, når de oprettes. Den bedste fremgangsmåde er at give variablerne meningsfulde navne, så formålet med dem bliver klart for alle, der skal vedligeholde din copilot.

1. Vælg variablen for at åbne den i ruden Egenskaber for variabel.

2. Angiv et nyt navn til variablen for Variabelnavn.

Indstil en variabel

Typisk bruger du en spørgsmålsnode til at gemme brugerinput til en variabel. Der kan dog være situationer, hvor du selv vil sætte værdien. I disse tilfælde skal du bruge noden Angiv variabelværdi.

1. Vælg Tilføj node (+) for at tilføje en node og derefter vælge Variabel administration>Angiv en variabel værdi.

2. Vælg feltet under Angiv variabel, og vælg derefter Opret en ny variabel.

   

   Sådan oprettes en ny variabel. Dens type er ukendt, indtil du tildeler en værdi til den.

   

3. For Til værdi skal du tildele en værdi vha. en af følgende indstillinger:.

   • Angiv en konstantværdi.
   • Vælg en eksisterende variabel af samme type. Denne handling angiver din variabel til den samme værdi, som den variabel du vælger.
   • Brug en Power Fx-formel. Power Fx-formel er nyttig i forbindelse med mere komplekse typer, hvor der ikke kan bruges konstantværdier, f.eks. Tabel og Posttyper.

Bemærk

Hvis du støder på en uoverensstemmelse mellem Angiv variabel og Til-værdi, vises en fejlmeddelelse og knappen Ret typeuoverensstemmelse , når du angiver en strengtypevariabel. Vælg knappen for automatisk at generere Copilot Studio en Power Fx formel , der løser uoverensstemmelsen.

Brug konstantværdier

I stedet for at vælge en variabel værdi, kan du skrive en konstantværdi i feltet med variabelinput.

Noden forsøger at fortolke bogstavelige værdier som en streng, et tal eller en boolesk værdi. F.eks. 123 fortolkes som et tal. Hvis du i stedet ønsker, at denne værdi skal opfattes som en strengværdi, kan du omslutte denne værdi i dobbelte anførselstegn, f.eks. "123".

I visse scenarier, eller hvor du bruger mere komplekse typer, skal du bruge en Power Fx-formel til at angive en bestemt type.

Ruden Variabler

I ruden Variabler kan du se alle de variabler, der er tilgængelige i emne, uanset hvilke noder de defineres eller bruges i. For hver variabel kan du vælge, om den kan modtage værdien fra andre emner, returnere værdien til andre emner eller begge dele. Du kan også vælge en variabel for at redigere egenskaberne i ruden Egenskaber for variabel.

Vælg Variabler i emnet menulinje for at åbne ruden Variabler.

Ruden Egenskaber af variabler

I ruden Egenskaber for variabel kan du omdøbe en variabel, se, hvor en variabel bruges, eller konvertere en variabel til en global variabel. Du kan dog ikke konvertere den fra en global variabel tilbage til emne variabel. Du kan også vælge, om den kan modtage værdier fra eller overføre dens værdi til andre emner.

Hvis du vil åbne ruden Egenskaber for variabel, skal du vælge en variabel i ruden Variabler. Du kan også åbne ruden med variable egenskaber ved at vælge en variabel i en hvilken som helst node.

Miljøvariabler

Miljøvariabler er et Power Platform begreb. 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, Global og Systemvariabler. Én væsentlig forskel er, at du kun kan bruge miljøvariabler i skrivebeskyttet tilstand. Copilot kan ikke ændre miljøvariablen i Copilot Studio. Men administratorer kan ændre værdien af miljøvariabler på PowerApps-portalen.

Miljøvariabeltyper i Copilot Studio knyttes til PowerApps-datatyper på følgende måde:

Type i Copilot Studio	Type i PowerApps
Decimaltal	Nummer
JSON	Registrer typen fra værdien. Hvis ikke Json => Unspecified (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.

Du kan ikke oprette eller redigere miljøvariabler i Copilot Studio. Du skal bruge portalen til PowerApps for at ændre eller angive miljøvariabler. Fra Copilot Studio kan du bruge ruden Variabler til at få vist oplysninger om en miljøvariabel. Ruden Variabler indeholder også et link til den indbyggede oprettelsesoplevelse.

Brug miljøvariabler til Azure Key Vault-hemmeligheder

En miljøvariabel kan referere til en hemmelighed i Key Vault. Dette er et specielt tilfælde med miljøvariabler med særlige overvejelser.

Hvis du vil oprette en hemmelig miljøvariabel på PowerApps portalen, skal du konfigurere Key Vault.

Ud over konfigurationen ovenfor skal du udføre følgende handlinger for at godkende, at Copilot Studio læser denne Key Vault:

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

2. Hvis du vil tillade, at alle copiloter fra miljøet får adgang til hemmeligheden, skal du oprette en kode AllowedEnvironments på hemmeligheden og tilføje de tilladte miljø-id'er, der er adskilt af kommaer.

3. Hvis du kun vil tillade, at bestemte copiloter fra miljøet bruger denne Key Vault, skal du oprette en kode AllowedCopilots og angive copilot-id i formatet {envId}/{schemaName}. I forbindelse med flere værdier skal du adskille værdierne med kommaer.

Hvis du har nået det maksimale antal tegn, men stadig har brug for at tilføje flere copiloter, kan du tilføje endnu en kode med et beskrivende, men entydigt navn (f.eks.: AllowedCopilots2).

Den hemmelige værdi cachelagres under kørsel af Dialog i fem minutter. Mislykkede læsninger cachelagres i 30 sekunder.

Advarsel!

Hvis du tilføjer hemmeligheden i Copilot, får du måske vist værdien af denne hemmelighed for alle brugere, der kan redigere Copilot i miljøet, fordi disse brugere kan redigere Copilot for at returnere værdien i SendMessage-noden.

Systemvariabler

Alle copiloter leveres med indbyggede systemvariabler, der giver flere oplysninger om en samtale.

Bemærk

Du kan finde flere oplysninger om stemmeaktiverede Copilot-variabler 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.

Name	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 copiloten i kanalen. I forbindelse med telekommunikationskanal er værdien af denne variabel det telefonnummer, som copiloten 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 Copilot
Bot.Id	string	Id for Copilot
Bot.Name	string	Navnet på din copilot
Bot.SchemaName	string	Skemanavnet på Copilot
Bot.TenantId	string	Lejer-id'et for Copilot
ClientPluginActions	valgmulighed	Samling af Dynamisk klient-plug-in-handlinger til, der skal overvejes i forbindelse med generative handlinger
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. Bemærk: Denne variabel understøttes kun, hvis udløseren er det On Error.
Error.Message	string	Fejlmeddelelsen for den aktuelle fejl. Bemærk: Denne variabel understøttes kun, hvis udløseren er det 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 det 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 det 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 det 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 det 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 det 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 det 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 finde ud af, hvorfor flere emner blev matchet. Bemærk: Denne variabel understøttes kun, hvis udløseren er det On Select Intent.
User.Language	valgmulighed	Denne variabel bruges til at angive landestandardens sprog for hver samtale.
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 det On Sign In.

Variabler til integreret godkendelse (standard)

Følgende variabler er tilgængelige, når du har konfigureret copilot til godkendelse hos Microsoft. Derved bruges Entra ID-godkendelse, og kun Teams og PowerApps-kanaler tillades. Dette er standarden for nye copiloter.

Du kan finde flere oplysninger under Godkendelsesvariabler.

Name	Skriv	Definition
User.DisplayName	string	Det viste navn på den bruger, der i øjeblikket taler til copiloten.
User.Email	string	Mailadressen på den bruger, der i øjeblikket taler til copiloten.
User.FirstName	string	Fornavnet på den bruger, der i øjeblikket taler til copiloten.
User.Id	string	Det entydige id for den bruger, der i øjeblikket taler til copiloten.
User.IsLoggedIn	boolean	Boolesk flag, der repræsenterer, om den bruger, der i øjeblikket taler med copiloten, er godkendt eller ej.
User.LastName	string	Efternavnet på den bruger, der i øjeblikket taler til copiloten.
User.PrincipalName	string	Brugerens hovednavn for den bruger, der i øjeblikket taler til copiloten.

Variabler til manuel godkendelse med Generisk OAuth 2

Følgende variabler er tilgængelige, når du har konfigureret din copilot til at bruge Generic OAuth 2-tjenesteudbyderen.

Name	Skriv	Definition
User.AccessToken	string	Adgangstokenet for den bruger, der godkender med copiloten.
User.DisplayName	string	Det viste navn på den bruger, der i øjeblikket taler til copiloten.
User.Id	string	Det entydige id for den bruger, der i øjeblikket taler til copiloten.
User.IsLoggedIn	boolean	Boolesk flag, der repræsenterer, om den bruger, der i øjeblikket taler med copiloten, er godkendt eller ej.

Variabler til manuel godkendelse med Microsoft Entra ID

Følgende variabler er tilgængelige, når du har konfigureret din copilot til at bruge tjenesteudbyderen Microsoft Entra ID (tidligere Azure Active Directory).

Name	Type	Definition
User.AccessToken	string	Adgangstokenet for den bruger, der godkender med copiloten.
User.DisplayName	string	Det viste navn på den bruger, der i øjeblikket taler til copiloten.
User.Email	string	Mailadressen på den bruger, der i øjeblikket taler til copiloten.
User.FirstName	string	Fornavnet på den bruger, der i øjeblikket taler til copiloten.
User.Id	string	Det entydige id for den bruger, der i øjeblikket taler til copiloten.
User.IsLoggedIn	boolean	Boolesk flag, der repræsenterer, om den bruger, der i øjeblikket taler med copiloten, er godkendt eller ej.
User.LastName	string	Efternavnet på den bruger, der i øjeblikket taler til copiloten.
User.PrincipalName	string	Brugerens hovednavn for den bruger, der i øjeblikket taler til copiloten.

Variabler for stemmeaktiverede copiloter

Følgende variabler er kun tilgængelige i stemmeaktiverede copiloter.

Bemærk

Du kan finde flere oplysninger om stemmeaktiverede Copilot-variabler i Brug af stemmevariabler.

Name	Type	Definition
Activity.InputDTMFKeys	string	Den rå DTMF-nøgleværdi, der blev modtaget fra telekommunikation.
Activity.SpeechRecognition.Confidence	nummer	Konfidensscoren for hele ASR-hypoteseresultatet, 0 til 1.
Activity.SpeechRecognition.MinimallyFormattedText	string	Let formateret tekst til ASR-hypoteseresultatet. 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 slutbrugerens 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.

Overføre variabler mellem emner

Når du omdirigerer emne til en anden, kan du overføre værdierne for variabler mellem den oprindelige emne og destinationsadressen emne. Det er især nyttigt at overføre variabler mellem emner, når du allerede har oplysninger, som emnet skal bruge. Brugerne vil sætte pris på, at de ikke behøver at besvare samme spørgsmål igen.

Modtag værdier fra andre emner

Når et emne definerer en variabel (for eksempel en spørgsmålsnode), beder copiloten brugeren om at angive variablens værdi. Hvis copiloten allerede har hentet værdien i et tidligere emne, er der ingen grund til at stille spørgsmålet igen. I disse tilfælde kan du indstille variablen som Modtag værdier fra andre emner. Når et andet emne omdirigeres til dette emne, kan det overføre en variabelværdi (eller en bogstavelig værdi) til denne variabel og springe hele spørgsmålet over. Oplevelsen for den slutbruger, der taler med copiloten, er problemfri.

I dette eksempel bruger vi to emner: Hilsen og Kontakt kunde. I begge emner anmodes der om kundens navn. Men hvis hilsenen kører emne, springes spørgsmålet i emnet Kontakt til kunde over. I stedet bruges værdien af den variabel, der er overført fra Velkommen-emnet.

Her er flowet for Kontakt til kunde-emne:

Som det fremgår af ruden Test copilot, og emne startes først, bliver brugeren spurgt: "Hvad skal jeg kalde dig?" Værdien gemmes i en strengvariabel, der kaldes userName. Variablen userName er også indstillet til at hente værdien fra andre emner. Meddelelsen emne afsluttes med meddelelsen "Jeg håber, du har en god dag!" {userName}.

Her er flowet for Velkommen-emnet:

Som det fremgår af ruden Test copilot, og emne startes først, bliver brugeren spurgt: "Hvad er dit navn?" Værdien gemmes i en strengvariabel, der kaldes UserName. Meddelelsen emne meddelelsen "Glad for at møde dig!" {UserName}. Derefter omdirigeres til meddelelsen Kontakt til kunde-emne, der sender meddelelsen "Jeg håber, du har det godt!" {userName}. Bemærk dog, at Kontakt til kunde-emnet sprang over at bede om brugerens navn igen. I stedet bruges værdien af variablen UserName er overført fra Velkommen-emnet.

Til sidst er der den anden samtale igen, denne gang ud fra perspektivet i Kontakt til kunde-emne:

Lad os gennemgå trinnene til at konfigurere et emne til at modtage værdier fra andre emner. Vi bruger det aktuelle eksempel, men de samme trin fungerer, hver gang et emne skal have en værdi fra en tidligere emne.

Konfigurer destinationens emne

Destinationens emne er det emne, der omdirigeres til, som modtager værdier fra andre emner. I eksemplet er det Kontakt til kunde.

1. Opret eller gå til destinationens emne.

2. Tilføj en Spørgsmålsnode, og angiv What should I call you? for meddelelsen.

3. Under Identificer skal du vælge foruddefinerede objekters Personnavn.

4. Vælg variablen for at åbne den i ruden Variable egenskaber. Navngiv userName, og vælg Modtag værdier fra andre emner.

   

5. Tilføj en meddelelsesnode.

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

7. Vælg Indsæt variabel-ikon ({x}), og vælg userName.

8. Vælg mellemrum efter variablen og skriv !.

9. Gem emnet.

Konfigurer kildenemne

Kildenemnet er det emne, der omdirigerer, det, der leverer den værdi, der sendes til destinationens emne. I vores eksempel er det Velkommen.

1. Gå til kildenemne.

2. Tilføj en omdirigeringsnode , og vælg destinationens emne.

3. Vælg + Tilføj input, og vælg variablen fra destinationsemnet, du vil overføre værdien til.

   

4. Vælg ikonet > , og vælg derefter den variabel, hvis værdi du vil overføre.

   

   Omdiriger-noden skulle se sådan ud:

   

5. Gem emnet.

Returner værdier til oprindelige emner

Når et emne omdirigeres til og opnår en variabel ved at bede om et spørgsmål eller på anden måde får en variabel fra en handling, kan variablen returneres til det oprindelige emne. Variablen bliver en del af det oprindelige emne og kan bruges som enhver anden variabel. De oplysninger, copiloten indhenter er således tilgængelige på tværs af emner, hvilket reducerer behovet for globale variabler.

Lad os fortsætte med eksemplet fra den forrige sektion. Vi stiller et nyt spørgsmål i Kontakt til kunde-emne og returnerer derefter Velkommen-emne.

Konfigurere kildedata for emne returnerede variabel

Når du returnerer en variabel til et emne, kildeemnet er det emne, der omdirigeres til, det, der indeholder den værdi, der sendes tilbage til det oprindelige emne. I eksemplet er det Kontakt til kunde.

1. Gå til kildenemne.

2. Tilføj en Spørgsmålsnode, og angiv What city do you live in? for meddelelsen.

3. Under Identificer skal du vælge foruddefinerede objekters By.

4. Vælg variablen for at åbne den i ruden Variable egenskaber. Navngiv userCity, og vælg Returner værdier til oprindelige emner.

   

5. Gem emnet.

Konfigurere destinationsemnet for en returneret variabel

Når du returnerer en variabel til et emne, er destinationsemnet det emne, der omdirigerer, det, der modtager værdier fra andre emner. I vores eksempel er det Velkommen.

1. Gå til destinationsemne.

2. Den variabel, du har valgt i kildeemnet, vises i noden Omdiriger som en outputvariabel.

   

3. Gem emnet.

Klassisk

Objekt- og variabeltype

Copilot Studio bruger objekter til at identificere en bestemt type oplysninger fra en brugers svar. En variabeltype knyttes til de identificerede oplysninger, når de gemmes. Variabeltypen svarer til objektet.

De enkelte objekt- eller variabeltyper knyttes til en basistype som angivet i følgende tabel. Basistypen bestemmer, hvilke operatorer du kan bruge, når du bygger et logisk udtryk med den tilsvarende variabel. Den bestemmer også, om du kan indføre en variabel til et flow eller en Bot Framework-færdighed som en inputparameter.

En boolesk basistype knyttes for eksempel til operatoren "er lig med", hvor de mulige værdier er Sand eller Falsk. Basistypen tal giver dig numeriske operatorer, for eksempel "er lig med", "er større end", "er større end eller lig med" osv.

Objekt	Variabel basistype
Indstillinger med flere svarmuligheder	String
Brugerens fulde svar	String
Alder	nummer
Boolean	Boolean
City	String
Color	String
Kontinent	String
Land eller område	String
Dato og klokkeslæt	String
Duration	String
Email	String
Hændelse	String
Sprog	String
Money	String
nummer	String
Ordenstal	String
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	String

Opret en variabel

Tilføj en spørgsmålsnode i et robotoprettelseslærred. Der oprettes automatisk en variabel i noden.

1. Gå til din robots emneside , og åbn det emne, du vil føje en variabel til.

2. Vælg Tilføj node (+), og vælg derefter Stil et spørgsmål.

   

   Der oprettes automatisk en variabel, der indeholder brugerens svar.

   

Vælg, hvilket objekt der skal bruges

Som standard oprettes der en spørgsmålsnode med indstillinger for flere valgmuligheder. Hvis du vil bruge et andet forudbygget eller brugerdefineret objekt, skal du vælge, hvad der skal identificeres fra noden.

Omdøb en variabel

Automatisk oprettede variabler leveres med et standardnavn. Hvis du vil omdøbe en variabel, skal du vælge variablenavnet, skrive et nyt navn og vælge Udført.

Brug variabler i handlingsnoder

Når du bruger en variabel i en handlingsnode, og basistypen svarer til en parametertype, der er angivet for et flow eller en Bot Framework-færdighed, kan du overføre den til den pågældende parameter. Outputtet fra handlingsnoder genererer nye variabler.

Bruge bogstavelige værdier i handlingsnoder

Du kan skrive en bogstavelig værdi i feltet med variabelinput i en handlingsnode i stedet for at vælge en variabel i menuen.

Opdel værdinode

Du kan bruge noden Opdel værdi til at konvertere en værdi af én type til en værdi af en anden type. Når du føjer en node til et emne, skal du vælge Tilføj node (+), derefter Variabel administration og Opdel værdi.

Nøglescenarier, hvor noden Opdel værdi bruger fokus på konvertering af rå JSON- eller ikke-indtastede variabler (hvis værdi eller struktur først kendes under kørsel, f.eks. ChannelData) til hierarkityper.

Processen starter, når et flow kaldes, som igen kalder en API. API'en returnerer et resultat. Du skal som regel opdele dette svar og returnere en eller flere primitive variabler til Copilot Studio. Med noden Opdel værdi kan du sende hele API-resultatet som en streng:

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

Den strengvariabel, du har nu, kan konverteres til en postvariabel med fuld IntelliSense-support i Power Fx ved hjælp af denne nye node. Et eksempel, hvor der bruges eksempeldata, kan hjælpe dig med at illustrere denne proces.

Eksempel på brug af noden Opdel værdi

1. Tilføj en Opdel værdi-node, og vælg den variabel, du vil opdele.

   

2. Vælg datatypen. I dette tilfælde skal du vælge "Fra eksempeldata".

   

3. Nu kan du give JSON ved at klikke på 'Hent skema fra Eksempel JSON'. Hvis du klikker på dette, åbnes en editor, hvor du kan indsætte eksemplet.

   

4. Til sidst skal du angive, hvilken variabel du vil placere den opdelte værdi i. Normalt skal du oprette en ny variabel til dette.

   

   Bemærk, at outputvariablen nu er af den korrekte type – post.

   

Du kan nu bruge den nye variabel. Her i editoren Power Fx kan du se, at du får alt det, du kan bruge til de forskellige egenskaber.

Ud over at fortolke JSON-strenge bruges nøglen til Opdel værdi-noden til opdeling af UntypedObjects under kørsel. De mest almindelige af disse er, når du modtager en hændelse, og du skal fortolke hændelsesværdien. Du kan også fortolke egenskaben System.Activity.ChannelData, som varierer under kørsel efter kanal.

Hvis begivenheden kommer fra Teams i følgende eksempel, skal du bruge dokumentationen til Teams-udvikleren til at finde et eksempel på, hvordan den indgående hændelse ser ud, og derefter bruge eksempeldata som skitseret i dette afsnit.

Overføre variabler mellem emner

Når du omdirigerer til andre emner, kan du overføre værdier til variabler i destinationsemnet eller hente variabler tilbage fra det. Det er især nyttigt at overføre variabler mellem emner, når du allerede har oplysninger, som emnet skal bruge. Brugerne vil sætte pris på, at de ikke behøver at besvare spørgsmålet igen. Det er også nyttigt, når du omstrukturerer og adskiller dine emner i komponenter, der kan genbruges, og du vil overføre variabler på tværs af emnerne.

Bemærk

Variabler af typen Custom Entity, Date and Time, Duration og Multiple-choice kan ikke overføres mellem emner.

Modtag værdier fra andre emner

Når et emne definerer en variabel (for eksempel en spørgsmålsnode), beder robotten brugeren om at angive variablens værdi. Hvis robotten allerede har hentet værdien, er der ingen grund til at stille spørgsmålet igen. I disse tilfælde kan du definere variablen som Modtag værdier fra andre emner. Når et andet emne omdirigeres til dette emne, kan det overføre en variabel (eller bogstavelige værdier) til denne variabel og springe hele spørgsmålet over. Oplevelsen for den slutbruger, der taler med robotten, er problemfri.

Hvis du vil modtage værdier fra andre emner, skal du angive variablens egenskab:

1. Vælg den variabel, du vil modtage værdier i andre emner fra, i noden Spørgsmål.

2. Vælg Modtag værdier fra andre emner under Emne (begrænset omfang) i ruden Egenskaber for variabler.

   

3. Gem emnet.

4. Gå til et emne, du vil omdirigere til. Følg trinnene under Omdiriger til et andet emne for at omdirigere til det rette emne.

5. Vælg Tilføj input til destinationsemne.

   

6. Vælg en variabel i det omdirigerede emne, du vil overføre variablen til.

   

7. Under Angiv eller vælg en værdi skal du vælge variablen i det aktuelle emne, som du vil overføre til det omdirigerede emne.

   

   Variablen vises i den omdirigerede node.

   

Returner værdier til oprindelige emner

Når et emne stiller et spørgsmål eller på anden måde får en variabel fra en handling, kan variablen returneres til det oprindelige emne, der blev omdirigeret til det.

I dette tilfælde bliver variablen også en del af det oprindelige emne og kan bruges som enhver anden variabel. Det hjælper dig med at opbygge emnet, så oplysninger, som robotten henter, er tilgængelige på tværs af emner, hvilket reducerer behovet for globale variabler.

Hvis du vil returnere en variabel til det oprindelige emne, skal du angive variablens egenskab:

1. Vælg den variabel, du vil modtage værdier i andre emner fra, i noden Spørgsmål.

2. Vælg Returner værdier til oprindelige emner under Emne (begrænset omfang) i ruden Variabler.

   

3. Gem emnet.

4. Gå til et emne, du vil omdirigere til. Følg trinnene under Omdiriger til et andet emne for at omdirigere til det rette emne.

   Den variabel, der returneres til emnet, vises i det omdirigerede emne. Brug den returnerede variabel i dit emne.

   

Bruge ruden med variabler

Brug ruden Variabler til at vælge modtager- eller returstatus for flere variabler på én gang.

1. Vælg Variabler i emnets menulinje.

   

2. Vælg for de enkelte variabler i emnet, om værdierne skal overføres, modtages eller begge dele mellem emner.

   

Bruge bogstavelige værdier på variable input

Du kan overføre bogstavelige værdier og variabler til et emne. Hvis du vil overføre en bogstavelig værdi, skal du skrive den værdi, du vil bruge som input, i stedet for at vælge en variabel.

Relateret indhold

• Brug variabler til at overføre indhold på tværs af emner
• Tilpas udseendet og følelsen af en andenpilot