Ö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 Description
Sträng 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
Bord 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
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 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.

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.

Enhet Bastyp av variabel
Flervalsalternativ Val
Användarens fullständiga svar Sträng
Ålder Nummer
Boolean Boolean
Ort Sträng
Färg Sträng
Kontinent Sträng
Land eller region Sträng
Datum och tid Datum/tid
E-post Sträng
Händelse Sträng
Heltal Heltal
Språk Sträng
Pengar Nummer
Nummer Nummer
Ordinal Nummer
Organisation Sträng
Procent Nummer
Personnamn Sträng
Telefonnummer Sträng
Intressepunkt Sträng
Hastighet Nummer
Stat Sträng
Gatuadress Sträng
Temperatur Nummer
URL Sträng
Vikt Nummer
Postnummer Sträng
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 Sträng
Ja/Nej Boolean
Datakälla Sträng
Secret Sträng

Anmärkning

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.

Anmärkning

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
Aktivitet.Bilagor table 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 sträng Kanal-ID för aktuell konversation, som en sträng.
Aktivitet.Från.Id sträng Kanalspecifikt, unikt ID för avsändaren.
Aktivitet.Från.Namn sträng Kanalspecifikt användarnamn för avsändaren.
Activity.Name sträng Namnet på händelsen.
Activity.Recipient.Id sträng Typ-egenskapen för den inkommande aktiviteten.
Aktivitet.Mottagare.Namn sträng Representerar visningsnamnet för agenten inom kanalen. I telefonkanalskontext är värdet för variabeln det telefonnummer som agenten är bifogad till.
Aktivitet.Text sträng Det senaste meddelande användaren skickat.
Aktivitet.Typ val Aktivitetstyp.
Activity.TypeId sträng Typ av aktivitet, som en sträng.
Aktivitet.Värde någon Ospecificerat värde
Bot.MiljöId sträng Agentens miljö-ID.
Bot.Id sträng ID på agenten.
Bot.Name sträng Namnet på din agent.
Bot.SchemaName sträng Schemanamnet för agenten.
Bot.TenantId sträng Klient-ID för agenten.
ClientPluginActions val Samling av dynamiska klientplugin-åtgärder att överväga för generativ orkestrering.
Conversation.Id sträng Den aktuella konversationens unika ID.
Conversation.InTestMode Boolean Boolesk flagga som representerar om konversationen inträffar i testarbetsytan.
Conversation.LokalTidszon sträng 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 sträng Felkoden för det aktuella felet.
Felmeddelandet för det aktuella felet.
Felmeddelande sträng 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 sträng ID för det föregående meddelande användaren skickat.
LastMessage.Text sträng 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 sträng ID för användarmeddelandet som utlöste aktuellt ämne.
Recognizer.TriggeringMessage.Text (ingen översättning krävs; tekniskt gränssnitt). sträng Användarmeddelandet som utlöste aktuellt ämne.
Recognizer.MultipleTopicsMatchedReason sträng 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 sträng Visningsnamnet på den användare som för tillfället pratar med agenten.
Användare.E-post sträng E-postadressen för användaren som för närvarande talar med agenten.
Användare.Förnamn sträng Det första namnet för användaren som för närvarande talar med agenten.
Användar.Id sträng 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 sträng Familjenamnet för den användare som för närvarande pratar med agenten.
User.PrincipalName sträng 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 sträng Åtkomsttoken för användaren som autentiserar med agenten.
User.DisplayName sträng Visningsnamnet på den användare som för tillfället pratar med agenten.
Användar.Id sträng 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 sträng Åtkomsttoken för användaren som autentiserar med agenten.
User.DisplayName sträng Visningsnamnet på den användare som för tillfället pratar med agenten.
Användare.E-post sträng E-postadressen för användaren som för närvarande talar med agenten.
Användare.Förnamn sträng Det första namnet för användaren som för närvarande talar med agenten.
Användar.Id sträng 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 sträng Familjenamnet för den användare som för närvarande pratar med agenten.
User.PrincipalName sträng 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.

Anmärkning

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

Name Type Definition
Aktivitet.InputDTMFKeys sträng 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 sträng 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 Boolean Boolesk flagga som representerar om IVR-systemet ska ställas in på endast DTMF-läge vid körning.
Conversation.SipUuiHeaderValue sträng UUI-rubriksträngen som används för att skicka sammanhang till IVR vid samtalsstart.
  • Last updated on