Översikt över variabler

Artikel
01/06/2025

Variabler kan finnas på fyra nivåer eller omfattningar:

Ämne variabler kan bara användas i de ämnen de skapas i. Denna omfattning är standard för variabler som du skapade.
Globala variabler kan användas i alla ämnen. Du kan ändra omfattningen för valfri ämnesvariabel att den blir en global variabel.
Systemvariabler skapas automatiskt med din agent. De ger mer sammanhangsbaserad information om konversationen eller användaren. De är tillgängliga i alla avsnitt.
Miljövariabler skapas i Power Platform och är skrivskyddade i Copilot Studio. De lagrar parameternycklarna och värdena som sedan används som indata för olika andra programobjekt, inklusive Copilot Studio. Genom att separera parametrarna från de tidskrävande objekten kan du ändra värdena i samma miljö eller när du migrerar lösningar till andra miljöer. Alternativet är att lämna hårdkodade parametervärden i de komponenter som använder dem.

Variabeltyper

En variabel associeras med en bastyp. Typen avgör vilka värden som variabeln kan innehålla och de operatorer du kan använda när du skapar ett logiskt uttryck med den.

Type	Beskrivning
String	En sekvens med tecken som används för att representera text
Booleskt	Ett logiskt värde som endast kan vara `true` eller `false`
Antal	Alla reella tal
Register	En lista med värden, men alla värden måste vara av samma typ
Post	En samling namn/värde-par där värden kan vara av valfri typ
Datum/tid	Datum, tid, veckodag eller månad i förhållande till en tidpunkt
Alternativ	En lista med strängvärden med associerade synonymer
Tom	En platshållare för ”inget värde” eller ”okänt värde”. Mer information finns i Tomma värden i Power Fx

En variabels typ anges första gången ett värde tilldelas den. Efter detta är typen för variabeln fast och kan inte tilldelas värden av någon annan typ. En variabel med startvärdet 1 tilldelad till exempel typen Nummer. Om du försöker tilldela det till ett strängvärde för "apples" resulterar det i ett fel.

När du testar en agent kan en variabel visas tillfälligt som typen okänd. En variabel av typen okänd har ännu inte tilldelats ett värde.

Variabelordningen fastställs uppifrån och ned på designytan. Noder högst upp på redigeringsarbetsytan beaktas före noderna längst ned.

När du skapar grenar med Villkor noder ordnas grenar från vänster till höger. Noder i grenen längst till vänster beaktas före noder i grenen längst till höger.

Copilot Studio använder entiteter för att identifiera en viss typ av information utifrån en användares svar. Den identifierade informationen sparas i en variabel av den typ som är lämplig för informationen. I följande tabell visas den variabelbastyp som är associerad med fördefinierade entiteter.

Enhet	Bastyp för variabel
Flervalsalternativ	Alternativ
Användarens fullständiga svar	String
Ålder	Antal
Booleskt	Booleskt
City	String
Color	String
Kontinent	String
Land eller region	String
Datum och tid	Datum/tid
Email	String
Event	String
Integer	Integer
Språk	String
Money	Antal
Antal	Antal
Ordning	Antal
Organisation	String
Procentandel	Antal
Personnamn	String
Telefonnummer	String
Orienteringspunkt	String
Hastighet	Antal
State	String
Gatuadress	String
Temperatur	Antal
webbadress	String
Grovlek	Siffra
Postnummer	String
Anpassad entitet	Alternativ

Copilot Studio använder entiteter för att identifiera en viss typ av information utifrån en användares svar. En variabeltyp associeras med den identifierade informationen när den sparas. Variabeltypen är likvärdig med entiteten.

Varje entitets- och variabeltyp mappar till en bastyp enligt följande tabell. Bastypen avgör vilka operatorer du kan använda när du skapar ett logiskt uttryck med motsvarande variabel. Detta avgör också om du kan mata in en variabel till ett flöde eller en Bot Framework-färdighet som en indataparameter.

En boolesk bastyp mappar till operatorn ”är lika med” med möjliga värden såsom Sant eller Falskt. Med en bastyp får du numeriska operatorer som ”är lika med”, ”är större än” eller ”är större än eller lika med”, och så vidare.

Enhet	Bastyp för variabel
Flervalsalternativ	String
Användarens fullständiga svar	String
Ålder	Antal
Boolean	Boolean
City	String
Color	String
Kontinent	String
Land eller region	String
Datum och tid	String
Duration	String
Email	String
Event	String
Språk	String
Money	String
Antal	String
Ordning	String
Organisation	String
Procentandel	Antal
Personnamn	String
Telefonnummer	String
Orienteringspunkt	String
Hastighet	Antal
State	String
Gatuadress	String
Temperatur	Antal
webbadress	String
Grovlek	Siffra
Postnummer	String
Anpassad entitet	String

Miljövariabler

Miljövariabler är ett Power Platform-koncept. Miljövariabler möjliggör det grundläggande scenariot för hantering av appens livscykel (ALM) för att flytta en applikation mellan Power Platform-miljöer. I det här scenariot förblir programmet exakt samma förutom några viktiga externa referenser som skiljer sig mellan källmiljön och målmiljön.

Använd miljövariabler på samma sätt som ämnes-, globala och systemvariabler. En viktig skillnad är att miljövariabler är skrivskyddade i Copilot Studio. Agentförfattare kan inte ändra miljövariabler i Copilot Studio. Administratörer kan dock ändra värdet för miljövariabler i Power Apps. I Copilot Studio kan du använda Variabelpanelen för att visa information om en miljövariabel. Panelen Variabler har också en länk till den ursprungliga redigeringsupplevelsen.

Den publicerade versionen av en agent som använder miljövariabler har de värden som angetts för dessa variabler när agenten publicerades. När en administratör uppdaterar miljövariabler måste du publicera alla agenter som använder de här variablerna på nytt för att ändringarna ska vara effektiva vid körningen. Det finns emellertid ett undantag: du behöver inte publicera om dina agenter när värdet för en miljövariabel av typen hemlig ändras. Till skillnad från andra miljövariabler hämtas hemliga variablerna vid körning.

Miljövariabeltyper i Copilot Studio mappning till Power Apps datatyper enligt följande:

Typ i Copilot Studio	Typ i Power Apps
Decimalnummer	Siffra
JSON	Identifiera typen från värdet. Om inte JSON => Ospecificerad (valideringsfel)
Text	String
Ja/Nej	Booleskt
Data source	String
Hemlighet	String

Obs

Miljövariabelfel visas i testchatten och vid publicering. Dessa fel visas emellertid inte i listan Ämne eftersom de inte är ämnesvariabler.

Systemvariabler

Varje agent levereras med inbyggda systemvariabler som ger ytterligare information om en konversation.

Skärmbild av systemvariabler i ett agentämne.

Obs

Mer information om röstaktiverade agentvariabler finns i Använda röstvariabler.

Alla systemvariabler visas inte i listan. Du måste komma åt de dolda systemvariablerna med en Power Fx formel.

Om du vill använda systemvariabler i en Power Fx-formel måste du lägga till System. före variabelnamnet. Om du till exempel vill ta med systemvariabeln User.DisplayName i en formel refererar du till den som System.User.DisplayName.

Name	Type	Definition
Activity.Attachments	tabell	De bifogade filer som användaren bifogar
Activity.Channel	val	Kanal-ID för aktuell konversation
Activity.ChannelData	någon	Ett objekt som innehåller kanalspecifikt innehåll
Activity.ChannelId	string	Kanal-ID för aktuell konversation, som en sträng
Activity.From.Id	string	Kanalspecifikt, unikt ID för avsändaren
Activity.From.Name	string	Kanalspecifikt användarnamn för avsändaren
Activity.Name	string	Namnet på eventet
Activity.Recipient.Id	string	Egenskapen Typ för den inkommande aktiviteten.
Activity.Recipient.Name	string	Representerar visningsnamnet för agenten inom kanalen. I telefonkanalskontext är värdet för variabeln det telefonnummer som agenten är bifogad till.
Activity.Text	string	Det senaste meddelande nvändaren skickat
Activity.Type	val	Typ av Aktivitetstyp
Activity.TypeId	string	Typ av aktivitet, som en sträng
Activity.Value	någon	Öppet värde
Bot.EnvironmentId	string	Miljö-ID för agent
Bot.Id	string	ID på agenten
Bot.Name	string	Namnet på din agent
Bot.SchemaName	string	Schemanamnet för agenten
Bot.TenantId	string	Klient-ID för agenten
ClientPluginActions	val	Samling dynamiska plugin-åtgärder för klientprogram som ska övervägas för generativ orkestrering
Conversation.Id	string	Den aktuella konversationens unika ID
Conversation.InTestMode	Booleskt	Boolesk flagga som representerar om konversationen inträffar i testarbetsytan
Conversation.LocalTimeZone	string	Namnet på den tidszon som ska användas av användaren i databasformatet för IANA-tidszon
Conversation.LocalTimeZoneOffset	datetime	Tidsförskjutningen från UTC för den aktuella lokala tidszonen
Error.Code	string	Felkoden för det aktuella felet. Felmeddelandet för det aktuella felet.
Error.Message	string	Felmeddelandet för det aktuella felet. Obs! Den här variabeln stöds bara om utlösaren är `On Error`.
FallbackCount	Nummer	Den här variabeln räknar antalet gånger då en ämne inte kunde matchas mot användarindata. Obs! Den här variabeln stöds bara om utlösaren är `On Unknown Intent`.
InactivityTimer.Continue	Booleskt	Boolesk flagga som representerar om timern behöver fortsätta. Obs! Den här variabeln stöds bara om utlösaren är `Inactivity`.
InactivityTimer.Count	Nummer	Antal gånger som OnInactivity-timern har utlösts på grund av inaktivitet hos användaren efter konfigurerad tid. Obs! Den här variabeln stöds bara om utlösaren är `Inactivity`.
LastMessage.Id	string	ID för det föregående meddelande användaren skickat
LastMessage.Text	string	Det föregående meddelande som användaren skickat
Recognizer.ExtractedEntities	val	Representerar de extraherade entiteterna från det utlösande meddelandet. Obs! Den här variabeln stöds bara om utlösaren är `On Select Intent`.
Recognizer.IntentOptions	val	Representerar avsiktsalternativen när identifieringsobjektet returnerar tvetydiga resultat. Obs! Den här variabeln stöds bara om utlösaren är `On Select Intent`.
Recognizer.SelectedIntent	val	Representerar den avsikt som har valts från identifieringsobjektet. Obs! Den här variabeln stöds bara om utlösaren är `On Select Intent`.
Recognizer.TriggeringMessage.Id	string	ID för användarmeddelandet som utlöste aktuellt ämne
Recognizer.TriggeringMessage.Text	string	Användarmeddelandet som utlöste aktuellt ämne
Recognizer.MultipleTopicsMatchedReason	string	Används för att avgöra varför flera ämnen matchades. Obs! Den här variabeln stöds bara om utlösaren är `On Select Intent`.
SignInReason	val	Används för att avgöra vilket inloggningsalternativ som krävs när ämnet utlöses. Obs! Den här variabeln stöds bara om utlösaren är `On Sign In`.
User.Language	val	Den här variabeln används för att ange användarspråket per konversation.

Variabler för integrerad autentisering (standard)

Följande variabler är tillgängliga för agenter som har konfigurerats för autentisering med Microsoft. I den här konfigurationen använder Microsoft Entra ID autentisering och är standard för nya agenter.

Mer information finns i Autentiseringsvariabler.

Name	Type	Definition
User.DisplayName	string	Visningsnamnet för användaren som för närvarande talar med agenten.
User.Email	string	E-postadressen för användaren som för närvarande talar med agenten.
User.FirstName	string	Det första namnet för användaren som för närvarande talar med agenten.
User.Id	string	Unikt ID för användaren som för närvarande talar med agenten.
User.IsLoggedIn	Booleskt	Boolesk flagga som representerar om användaren som för närvarande talar med agenten autentiseras eller inte.
User.LastName	string	Familjenamnet för den användare som för närvarande pratar med agenten.
User.PrincipalName	string	Användarens huvudnamn för användaren som för närvarande talar med agenten.

Variabler för manuell autentisering med Generic OAuth 2

Följande variabler är tillgängliga för agenter som har konfigurerats att använda Generisk OAuth 2-tjänstleverantör.

Name	Type	Definition
User.AccessToken	string	Åtkomsttoken för användaren som autentiserar med agenten.
User.DisplayName	string	Visningsnamnet för användaren som för närvarande talar med agenten.
User.Id	string	Unikt ID för användaren som för närvarande talar med agenten.
User.IsLoggedIn	Booleskt	Boolesk flagga som representerar om användaren som för närvarande talar med agenten autentiseras eller inte.

Variabler för manuell autentisering med Microsoft Entra ID

Följande variabler är tillgängliga för agenter som har konfigurerats att använda Microsoft Entra ID (tidigare Azure Active Directory) tjänstleverantör.

Name	Type	Definition
User.AccessToken	string	Åtkomsttoken för användaren som autentiserar med agenten.
User.DisplayName	string	Visningsnamnet för användaren som för närvarande talar med agenten.
User.Email	string	E-postadressen för användaren som för närvarande talar med agenten.
User.FirstName	string	Det första namnet för användaren som för närvarande talar med agenten.
User.Id	string	Unikt ID för användaren som för närvarande talar med agenten.
User.IsLoggedIn	Booleskt	Boolesk flagga som representerar om användaren som för närvarande talar med agenten autentiseras eller inte.
User.LastName	string	Familjenamnet för den användare som för närvarande pratar med agenten.
User.PrincipalName	string	Huvudnamnet för den användare som för närvarande pratar med agenten.

Variabler för röstaktiverade agenter

Följande variabler är endast tillgängliga för röstaktiverade agenter.

Obs