Översikt över variabler

Note

Funktionerna i denna artikel drivs av standardkabeln, som använder faktureringsalternativen som beskrivs i Licensiering för agenter som drivs av standardkabeln. Lär dig hur du får tillgång till standardfunktioner i Access standardagenter och agentflöden.

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 konsumerande objekten kan du ändra värdena inom 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
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
Siffra 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 och 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"; läs mer i 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å variabler bestäms från toppen till botten av författarduken. Agenten betraktar noder högst upp på författarduken innan noder längst ner.

När du skapar grenar med hjälp av Condition-noder, ordnar Copilot Studio grenarna från vänster till höger. Agenten betraktar noder i den vänstra grenen före noder i den högra grenen.

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 Siffra
Boolean Boolean
Ort String
Färg String
Continent String
Land eller region String
Datum och tid Datum och tid
E-postmeddelande String
Event String
Heltal Heltal
Language String
Pengar Siffra
Siffra Siffra
Ordinal Siffra
Organisation String
Procentsats Siffra
Personnamn String
Telefonnummer String
Intressepunkt String
Hastighet Siffra
State String
Gatuadress String
Temperatur Siffra
URL String
Vikt Siffra
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 detta scenario förblir applikationen exakt densamma förutom några få viktiga externa referenser som skiljer sig mellan källmiljön och destinationsmiljön.

Använd miljövariabler på samma sätt som ämnes-, global- 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 inkluderar de värden du sätter för dessa variabler när du publicerar agenten. När en administratör uppdaterar miljövariabler måste du återpublicera alla agenter som använder dessa variabler för att ändringarna ska träda i kraft vid körning. 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 Siffra
JSON Identifiera typen från värdet. Om inte JSON => Ospecificerad (valideringsfel)
Text String
Yes/No Boolean
Datakälla String
Hemlighet String

Note

Du ser fel i miljövariabler i testchatten och vid publicering. Dessa fel visas dock inte i ämneslistan eftersom miljövariabler inte är ämnesvariabler.

Systemvariabler

Varje agent inkluderar inbyggda systemvariabler som ger extra information om en konversation.

Skärmdump av systemvariabler i ett ämne.

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 choice Kanal-ID för aktuell konversation.
Activity.ChannelData någon Ett objekt som innehåller kanalspecifikt innehåll.
Activity.ChannelId snöre Kanal-ID för aktuell konversation, som en sträng.
Aktivitet.Från.Id snöre Kanalspecifikt, unikt ID för avsändaren.
Aktivitet.Från.Namn snöre Kanalspecifikt användarnamn för avsändaren.
Activity.Name snöre Namnet på händelsen.
Activity.Recipient.Id snöre Typ-egenskapen för den inkommande aktiviteten.
Aktivitet.Mottagare.Namn snöre Representerar visningsnamnet för agenten inom kanalen. I telefonkanalskontext är värdet för variabeln det telefonnummer som agenten är bifogad till.
Aktivitet.Text snöre Det senaste meddelande användaren skickat.
Aktivitet.Typ choice Aktivitetstyp.
Activity.TypeId snöre Typ av aktivitet, som en sträng.
Aktivitet.Värde någon Ospecificerat värde
Bot.MiljöId snöre Agentens miljö-ID.
Bot.Id snöre ID på agenten.
Bot.Name snöre Namnet på din agent.
Bot.SchemaName snöre Schemanamnet för agenten.
Bot.TenantId snöre Klient-ID för agenten.
ClientPluginActions choice Samling av dynamiska klientplugin-åtgärder att överväga för generativ orkestrering.
Conversation.Id snöre Den aktuella konversationens unika ID.
Conversation.InTestMode Boolean Boolesk flagga som representerar om konversationen inträffar i testarbetsytan.
Conversation.LokalTidszon snöre 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 snöre Felkoden för det aktuella felet.
Felmeddelandet för det aktuella felet.
Felmeddelande snöre Felmeddelandet för det aktuella felet.
Obs! Den här variabeln stöds bara om utlösaren är On Error.
FallbackCount number 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 number 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 inaktivitetsutlösare.
LastMessage.Id snöre ID för det föregående meddelande användaren skickat.
LastMessage.Text snöre Det föregående meddelande som användaren skickat.
Recognizer.ExtractedEntities choice 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 choice 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 choice 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 snöre ID för användarmeddelandet som utlöste aktuellt ämne.
Recognizer.TriggeringMessage.Text (ingen översättning krävs; tekniskt gränssnitt). snöre Användarmeddelandet som utlöste aktuellt ämne.
Recognizer.MultipleTopicsMatchedReason snöre 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 choice 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 choice Den här variabeln används för att ange användarens språklokal per konversation.

Variabler för röstaktiverade agenter

Följande variabler är endast tillgängliga för röstaktiverade agenter. Läs mer i Använd röstvariabler.

Name Type Definition
Aktivitet.InputDTMFKeys snöre Det råa DTMF-nyckelvärdet från telefoni.
Activity.SpeechRecognition.Tillförlitlighet number Förtroendepoängen för den automatiska taligenkänningshypotesen är hela resultatet, 0 till 1.
Activity.SpeechRecognition.MinimallyFormattedText snöre Något formaterad text av den automatiska taligenkänningshypotesen. Till exempel "Femhundra dollar". Orden skrivs ut, men grundläggande versaler och skiljetecken ingår.
Activity.UserInputType choice 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 snöre UUI-rubriksträngen som används för att skicka sammanhang till IVR vid samtalsstart.

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. Läs mer i Autentiseringsvariabler.

Name Type Definition
User.DisplayName snöre Visningsnamnet på den användare som för tillfället pratar med agenten.
Användare.E-post snöre E-postadressen för användaren som för närvarande talar med agenten.
Användare.Förnamn snöre Det första namnet för användaren som för närvarande talar med agenten.
Användar.Id snöre 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 snöre Familjenamnet för den användare som för närvarande pratar med agenten.
User.PrincipalName snöre 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 snöre Åtkomsttoken för användaren som autentiserar med agenten.
User.DisplayName snöre Visningsnamnet på den användare som för tillfället pratar med agenten.
Användar.Id snöre 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 snöre Åtkomsttoken för användaren som autentiserar med agenten.
User.DisplayName snöre Visningsnamnet på den användare som för tillfället pratar med agenten.
Användare.E-post snöre E-postadressen för användaren som för närvarande talar med agenten.
Användare.Förnamn snöre Det första namnet för användaren som för närvarande talar med agenten.
Användar.Id snöre 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 snöre Familjenamnet för den användare som för närvarande pratar med agenten.
User.PrincipalName snöre Huvudnamnet för den användare som för närvarande pratar med agenten.
  • Last updated on