Ö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.

Type Beskrivning
String En sekvens med tecken som används för att representera text
Boolean Ett logiskt värde som endast kan vara true eller false
Nummer 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
DateTime Datum, tid, veckodag eller månad i förhållande till en tidpunkt
Val En lista med strängvärden med associerade synonymer
Tom 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 uppifrån och ned i 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.

Entities

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.

Entity Bastyp av variabel
Flervalsalternativ Val
Användarens fullständiga svar String
Ålder Nummer
Boolean Boolean
Ort String
Färg String
Kontinent String
Land eller region String
Datum och tid DateTime
E-postmeddelande String
Event String
Heltal Heltal
Language String
Pengar Nummer
Nummer Nummer
Ordning Nummer
Organisation String
Procent Nummer
Personnamn String
Telefonnummer String
Intressepunkt String
Hastighet Nummer
Tillstånd String
Gatuadress String
Temperatur Nummer
URL String
Vikt Nummer
Postnummer String
Anpassad entitet Val

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 Nummer
JSON Identifiera typen från värdet. Om inte JSON => Ospecificerad (valideringsfel)
Text String
Ja/Nej Boolean
Datakälla String
Secret String

Note

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.

Note

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.

Name Type Definition
Activity.Attachments table De bifogade filer som användaren tillhandahåller.
Activity.Channel val Kanal-ID för aktuell konversation.
Activity.ChannelData any 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.
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 any 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 Boolean 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.
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 Boolean 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. Läs mer i Inactivity Trigger (Inaktivitetsutlösare ) om hur du konfigurerar inaktivitetsutlösare och använder dessa variabler.
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.
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.

Name Type 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.
Användare.Förnamn 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 Boolean 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.

Name Type 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 Boolean 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).

Name Type 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.
Användare.Förnamn 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 Boolean 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.

Note

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

Name Type Definition
Activity.InputDTMFKeys string Det råa DTMF-nyckelvärdet från telefoni.
Activity.SpeechRecognition.Confidence 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.
Conversation.OnlyAllowDTMF Boolean 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