Översikt över variabler

Variabler finns på fyra nivåer, eller omfång:

  • Ämnesvariabler som du bara kan använda i de ämnen där du skapar dem. Denna omfattning är standard för variabler som du skapade.
  • Globala variabler som du kan använda i alla ämnen. Du kan ändra omfattningen för valfri ämnesvariabel att den blir en global variabel.
  • Systemvariabler som Copilot Studio skapar automatiskt för en agent. De ger mer sammanhangsbaserad information om konversationen eller användaren. De är tillgängliga i alla ämnen.
  • Miljövariabler som du skapar i Power Platform. De är skrivskyddade i Copilot Studio. De lagrar parameternycklarna och värdena, som sedan kan fungera som indata till 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

Varje variabel har en bastyp. Typen avgör vilka värden variabeln kan ha och vilka operatorer du kan använda när du skapar ett logiskt uttryck med den.

Typ 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
Tabell 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
Blank En platshållare för "inget värde" eller "okänt värde"; för mer information, se Blank i Power Fx-dokumentationen

Du anger en variabels typ första gången du tilldelar den ett värde. Därefter är typen fast och du kan inte tilldela värden av någon annan typ. Om du till exempel tilldelar startvärdet 1 en variabel anger du dess typ till Tal. Om du sedan försöker tilldela ett Strängvärde som "apples" får du ett fel.

När du testar en agent kan en variabel tillfälligt visas med typen okänd. En okänd variabel har inget värde än.

Ordningen på variablerna bestäms i arbetsytan uppifrån och ned. 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.

Entiteter

Copilot Studio använder entiteter för att identifiera vissa typer 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 av variabel
Flervalsalternativ Alternativ
Användarens fullständiga svar String
Ålder Antal
Booleskt Booleskt
Stad String
Färg String
Kontinent String
Land eller region String
Datum och tid Datum/tid
Email String
Evenemang String
Integer Integer
Språk String
Pengar Antal
Antal Antal
Ordning Antal
Organisation String
Procentandel Antal
Personnamn String
Telefonnummer String
Orienteringspunkt String
Hastighet Antal
Tillstånd String
Gatuadress String
Temperatur Antal
webbadress String
Vikt Antal
Postnummer String
Anpassad entitet Alternativ

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 anmärkningsvärd 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 Variabelegenskaper har också en länk till Power Apps, redigeringsmiljön för miljövariabler.

Den publicerade versionen av en agent som använder miljövariabler har de värden som anges för dessa variabler när du publicerar agenten. 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 mappas till Power Apps datatyper på följande sätt:

Skriv i Copilot Studio Skriv in i Power Apps
Decimalnummer Antal
JSON Identifiera typen från värdet. Om inte JSON => Ospecificerad (valideringsfel)
Text String
Ja/Nej Booleskt
Datakälla String
Hemlig String

Obs

Miljövariabelfel visas i testchatten och vid publicering. Dessa fel visas dock inte i ämneslistan eftersom de inte är ämnesvariabler.

Systemvariabler

Varje agent har inbyggda systemvariabler som ger extra 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.

Copilot Studio visar inte alla systemvariabler. För att komma åt dolda systemvariabler, använd en Power Fx-formel.

Om du vill använda systemvariabler i en Power Fx-formel lägger du 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.

Namn Typ Definition
Aktivitet.Bilagor tabell De bifogade filer som användaren tillhandahåller.
Aktivitet.Kanal 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.
Aktivitet.Från.Id string Kanalspecifikt, unikt ID för avsändaren.
Aktivitet.Från.Namn string Kanalspecifikt användarnamn för avsändaren.
Activity.Name string Namnet på händelsen.
Activity.Recipient.Id string Typ-egenskapen för den inkommande aktiviteten.
Aktivitet.Mottagare.Namn string Representerar visningsnamnet för agenten inom kanalen. I telefonkanalskontext är värdet för variabeln det telefonnummer som agenten är bifogad till.
Aktivitet.Text string Det senaste meddelande användaren skickat.
Aktivitet.Typ val Aktivitetstyp.
Activity.TypeId string Typ av aktivitet, som en sträng.
Aktivitet.Värde någon Ospecificerat värde
Bot.MiljöId string Agentens miljö-ID.
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 av dynamiska klientplugin-åtgärder att överväga 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.LokalTidszon string Namnet på den tidszon som ska användas av användaren i databasformatet för IANA-tidszon.
Conversation.LocalTimeZoneOffset datumtid Tidsförskjutningen från UTC för den aktuella lokala tidszonen.
Fel.Kod string Felkoden för det aktuella felet.
Felmeddelandet för det aktuella felet.
Felmeddelande 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 användarinaktivitet efter den konfigurerade tiden.
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 (ingen översättning krävs; tekniskt gränssnitt). 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.
Inloggningsanledning 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.
Användare.Språk val Den här variabeln används för att ange användarens språklokal 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. Den här konfigurationen använder Microsoft Entra ID-autentisering och är standard för nya agenter.

Mer information finns i Autentiseringsvariabler.

Namn Typ Definition
User.DisplayName string Visningsnamnet på den användare som för tillfället pratar med agenten.
Användare.E-post 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.
Användar.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.
Användare.Efternamn 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 konfigurerats för att använda tjänstleverantören Generic OAuth 2.

Namn Typ Definition
User.AccessToken string Åtkomsttoken för användaren som autentiserar med agenten.
User.DisplayName string Visningsnamnet på den användare som för tillfället pratar med agenten.
Användar.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 konfigurerats för att använda tjänstleverantörerna Microsoft Entra ID (tidigare Azure Active Directory).

Namn Typ Definition
User.AccessToken string Åtkomsttoken för användaren som autentiserar med agenten.
User.DisplayName string Visningsnamnet på den användare som för tillfället pratar med agenten.
Användare.E-post 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.
Användar.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.
Användare.Efternamn 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

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

Namn Typ Definition
Aktivitet.InputDTMFKeys string Det råa DTMF-nyckelvärdet från telefoni.
Activity.SpeechRecognition.Tillförlitlighet Nummer Konfidenspoängen för Azure Site Recovery-hypotesens hela resultat, 0 till 1.
Activity.SpeechRecognition.MinimallyFormattedText string Något formaterad text av hypotesresultatet för Azure Site Recovery. Till exempel "Femhundra dollar". Orden skrivs ut, men grundläggande versaler och skiljetecken ingår.
Activity.UserInputType val Typen av senaste indata från agentanvändaren. Värdet kan vara antingen test, tal eller DTMF.
Samtal.EndastTillåtDTMF Booleskt Boolesk flagga som representerar om IVR-systemet ska ställas in på endast DTMF-läge vid körning.
Conversation.SipUuiHeaderValue string UUI-rubriksträngen som används för att skicka sammanhang till IVR vid samtalsstart.
  • Last updated on