Overzicht van variabelen

Variabelen kunnen op vier niveaus, of scopes, voorkomen:

• Onderwerp variabelen kunnen alleen worden gebruikt in de onderwerpen waarin ze worden gemaakt. Dit is het standaardbereik voor variabelen die u maakt.
• Algemene variabelen kunnen in alle onderwerpen worden gebruikt. U kunt het bereik van een onderwerpvariabele wijzigen om er een algemene variabele van te maken.
• Systeemvariabelen worden automatisch aangemaakt met uw agent. Ze bieden meer contextuele informatie over het gesprek of de gebruiker. Ze zijn meestal beschikbaar in alle onderwerpen.
• Omgevingsvariabelen worden gemaakt in Power Platform en zijn alleen-lezen in Copilot Studio. Omgevingsvariabelen slaan de parametersleutels en waarden op, die vervolgens dienen als invoer voor verschillende andere toepassingsobjecten, waaronder Copilot Studio. Door de parameters te scheiden van de verbruikende objecten, kunt u de waarden binnen dezelfde omgeving wijzigen of wanneer u oplossingen naar andere omgevingen migreert. Het alternatief is om hardgecodeerde parameterwaarden te laten in de componenten die ze gebruiken.

Typen variabele

Een variabele is gekoppeld aan een basistype. Het type bepaalt welke waarden de variabele kan bevatten en welke operators u kunt gebruiken wanneer u er een logische expressie mee maakt.

Type	Omschrijving
String	Een reeks tekens die wordt gebruikt om tekst weer te geven
Booleaans	Een logische waarde die alleen true of false kan zijn
Aantal	Elk reëel getal
Table	Een lijst met waarden, maar alle waarden moeten van hetzelfde type zijn
Opnemen	Een verzameling naam-waardeparen waarbij waarden van elk type kunnen zijn
Datum en tijd	Een datum, tijd, dag van de week of maand ten opzichte van een tijdstip
Keuze	Een lijst met tekenreekswaarden met bijbehorende synoniemen
Leeg	Een tijdelijke aanduiding voor "geen waarde" of "onbekende waarde". Zie Lege waarden in Power Fx voor meer informatie

Het type van een variabele wordt ingesteld wanneer er voor het eerst een waarde aan wordt toegewezen. Daarna staat het type voor die variabele vast en kunnen er geen waarden van een ander type aan worden toegewezen. Stel dat aan een variabele met de beginwaarde 1 het type Getal is toegewezen. Als u probeert het toe te wijzen aan een Tekenreeks waarde van "apples" , resulteert dit in een fout.

Wanneer u een agent test, kan een variabele tijdelijk worden weergegeven als het type onbekend. Aan een onbekende variabele is nog geen waarde toegewezen.

De volgorde van variabelen wordt bepaald van boven naar beneden op het ontwerpcanvas. Knooppunten boven aan het ontwerpcanvas krijgen voorrang boven knooppunten onderaan.

Wanneer u branches maakt met Voorwaarde-knooppunten, worden branches van links naar rechts geordend. Knooppunten in de meest linkse branche worden vóór knooppunten in de meest rechtse branche bekeken.

Entiteiten

Webapp

Copilot Studio gebruikt entiteiten om een specifiek type informatie te identificeren uit de reacties van een gebruiker. De geïdentificeerde informatie wordt opgeslagen in een variabele van het type dat geschikt is voor de informatie. In de volgende tabel worden de basistypen van de variabelen weergegeven die aan vooraf gebouwde entiteiten zijn gekoppeld.

Entity	Basistype variabele
Meerkeuzeopties	Keuze
Volledige respons van de gebruiker	String
Leeftijd	Aantal
Booleaans	Booleaans
City	String
Color	String
Continent	String
Land of regio	String
Datum en tijd	Datum en tijd
Email	String
Gebeurtenis	String
Integer	Integer
Taal	String
Money	Aantal
Aantal	Aantal
Rangtelwoord	Aantal
Organisatie	String
Percentage	Aantal
Persoonsnaam	String
Telefoonnummer	String
Nuttige plaats	String
Snelheid	Aantal
Provincie	String
Adres	String
Temperatuur	Aantal
URL	String
Gewicht	Aantal
Postcode	String
Aangepaste entiteit	Keuze

Klassiek

Copilot Studio gebruikt entiteiten om een specifiek type informatie te identificeren uit de reacties van een gebruiker. Een type variabele wordt gekoppeld aan de geïdentificeerde informatie wanneer deze wordt opgeslagen. Het variabeletype is analoog aan de entiteit.

Elke entiteit of variabeletype wordt toegewezen aan een basistype, zoals vermeld in de volgende tabel. Het basistype bepaalt welke operators u kunt gebruiken wanneer u een logische expressie maakt met de bijbehorende variabele. Het bepaalt ook of u een variabele kunt invoeren in een stroom of Bot Framework-vaardigheid als invoerparameter.

Bijvoorbeeld een Booleaans basistype wordt toegewezen aan een operator 'is gelijk aan' met mogelijke waarden True of False. Een basistype getal geeft u numerieke operatoren als 'is gelijk aan', 'is groter dan' of 'is groter dan of gelijk aan', enzovoort.

Entiteit	Basistype variabele
Meerkeuzeopties	String
Volledige respons van de gebruiker	String
Leeftijd	Aantal
Booleaans	Booleaans
City	String
Color	String
Continent	String
Land of regio	String
Datum en tijd	String
Duration	String
Email	String
Gebeurtenis	String
Taal	String
Money	String
Aantal	String
Rangtelwoord	String
Organisatie	String
Percentage	Aantal
Persoonsnaam	String
Telefoonnummer	String
Nuttige plaats	String
Snelheid	Aantal
Provincie	String
Adres	String
Temperatuur	Aantal
URL	String
Gewicht	Aantal
Postcode	String
Aangepaste entiteit	String

Omgevingsvariabelen

Omgevingsvariabelen zijn een Power Platform-concept. Omgevingsvariabelen maken het basisscenario voor Application Lifecycle Management (ALM) mogelijk waarbij een applicatie tussen Power Platform-omgevingen wordt verplaatst. In dit scenario blijft de toepassing precies hetzelfde, afgezien van een paar belangrijke externe verwijzingen die verschillen tussen de bronomgeving en de doelomgeving.

Gebruik Omgevingsvariabelen op dezelfde manier als onderwerp-, algemene en systeemvariabelen. Een opvallend verschil is dat omgevingsvariabelen alleen-lezen zijn in Copilot Studio. Agent auteurs kunnen geen omgevingsvariabelen wijzigen in Copilot Studio. Beheerders kunnen echter de waarde van omgevingsvariabelen wijzigen in Power Apps. In Copilot Studio kunt u het Variabelenpaneel gebruiken om informatie over een omgevingsvariabele te bekijken. Het paneel Variabelen bevat ook een koppeling naar de oorspronkelijke ontwerpervaring.

De gepubliceerde versie van een agent die omgevingsvariabelen gebruikt, heeft de waarden die voor deze variabelen zijn ingesteld toen de agent werd gepubliceerd. Wanneer een beheerder omgevingsvariabelen bijwerkt, moet u alle agenten die deze variabelen gebruiken opnieuw publiceren, zodat de wijzigingen tijdens runtime van kracht worden. Er is echter één uitzondering: u hoeft uw agenten niet opnieuw te publiceren wanneer de waarde van een omgevingsvariabele van het type geheim verandert. In tegenstelling tot andere omgevingsvariabelen worden geheime variabelen tijdens runtime opgehaald.

Typen omgevingsvariabelen worden in Copilot Studio als volgt toegewezen aan Power Apps-gegevenstypen:

Type in Copilot Studio	Type in Power Apps
Decimaal getal	Aantal
JSON	Detecteer het type waarde. Indien niet JSON => Onbepaald (validatiefout)
Sms verzenden	String
Ja/nee	Booleaans
Gegevensbron	String
Geheim	String

Notitie

Fouten in omgevingsvariabelen zijn zichtbaar in het test-chatgesprek en bij publicatie. Deze fouten worden echter niet weergegeven in de lijst Onderwerp omdat het geen onderwerpvariabelen zijn.

Systeemvariabelen

Elke agent wordt geleverd met ingebouwde systeemvariabelen die aanvullende informatie over een gesprek verschaffen.

Notitie

Zie Spraakvariabelen gebruiken voor meer informatie over spraakgestuurde agentvariabelen.

Niet alle systeemvariabelen worden in de lijst weergegeven. U moet toegang krijgen tot deze verborgen systeemvariabelen met een Power Fx-formule.

Als u systeemvariabelen wilt gebruiken in een Power Fx-formule, moet u System. toevoegen vóór de variabelenaam. Wilt u bijvoorbeeld de systeemvariabele User.DisplayName opnemen in een formule, verwijs hier dan naar als System.User.DisplayName.

Meting	Type	Definitie
Activity.Attachments	tabel	De door de gebruiker verstrekte bestandsbijlagen
Activity.Channel	keuze	De kanaal-id van het huidige gesprek
Activity.ChannelData	willekeurige	Een object dat kanaalspecifieke inhoud bevat
Activity.ChannelId	string	De kanaal-id van het huidige gesprek als een tekenreeks
Activity.From.Id	string	De kanaalspecifieke unieke id van de afzender
Activity.From.Name	string	De kanaalspecifieke beschrijvende naam van de afzender
Activity.Name	string	De naam van de gebeurtenis
Activity.Recipient.Id	string	De eigenschap Type van de inkomende activiteit.
Activity.Recipient.Name	string	Geeft de weergavenaam weer voor de agent binnen het kanaal. In de context van een telefoniekanaal is de waarde van deze variabele het telefoonnummer waaraan de agent is gekoppeld.
Activity.Text	string	Het meest recente bericht dat door de gebruiker is verzonden
Activity.Type	keuze	Type activiteit
Activity.TypeId	string	Type activiteit als een tekenreeks
Activity.Value	willekeurige	Open waarde
Bot.EnvironmentId	string	De omgevings-id van de agent
Bot.Id	string	De id van de agent
Bot.Name	string	De naam van uw agent
Bot.SchemaName	string	De schemanaam van de agent
Bot.TenantId	string	De tenant-id van de agent
ClientPluginActions	keuze	Verzameling van dynamische client-invoegtoepassingsacties die u kunt overwegen voor generatieve indeling
Conversation.Id	string	De unieke id van het huidige gesprek
Conversation.InTestMode	Booleaans	Booleaanse vlag die aangeeft of het gesprek plaatsvindt in het testcanvas
Conversation.LocalTimeZone	string	Naam van de tijdzone die de gebruiker moet gebruiken in de indeling van de IANA-tijdzonedatabase
Conversation.LocalTimeZoneOffset	datetime	De tijdsafwijking ten opzichte van UTC voor de huidige lokale tijdzone
Error.Code	string	De foutcode voor de huidige fout. Het foutbericht voor de huidige fout.
Error.Message	string	Het foutbericht voor de huidige fout. Opmerking: deze variabele wordt alleen ondersteund als de trigger On Error is.
FallbackCount	Nummer	Deze variabele telt het aantal keren dat onderwerp niet aan de gebruikersinvoer kon worden gekoppeld. Opmerking: deze variabele wordt alleen ondersteund als de trigger On Unknown Intent is.
InactivityTimer.Continue	Booleaans	Booleaanse vlag die aangeeft of de timer moet worden voortgezet. Opmerking: deze variabele wordt alleen ondersteund als de trigger Inactivity is.
InactivityTimer.Count	Nummer	Aantal malen dat de OnInactivity-timer is geactiveerd vanwege inactiviteit van de gebruiker na de geconfigureerde tijd. Opmerking: deze variabele wordt alleen ondersteund als de trigger Inactivity is.
LastMessage.Id	string	De id van het vorige bericht dat door de gebruiker is verzonden
LastMessage.Text	string	Het vorige bericht dat door de gebruiker is verzonden
Recognizer.ExtractedEntities	keuze	Geeft de geëxtraheerde entiteiten uit het triggerbericht weer. Opmerking: deze variabele wordt alleen ondersteund als de trigger On Select Intent is.
Recognizer.IntentOptions	keuze	Geeft de intentieopties weer wanneer de herkenningsfunctie dubbelzinnige resultaten retourneert. Opmerking: deze variabele wordt alleen ondersteund als de trigger On Select Intent is.
Recognizer.SelectedIntent	keuze	Geeft de intentie weer die door de herkenningsfunctie is geselecteerd. Opmerking: deze variabele wordt alleen ondersteund als de trigger On Select Intent is.
Recognizer.TriggeringMessage.Id	string	De id van het gebruikersbericht dat het huidige onderwerp heeft geactiveerd
Recognizer.TriggeringMessage.Text	string	Het gebruikersbericht dat het huidige onderwerp heeft geactiveerd
Recognizer.MultipleTopicsMatchedReason	string	Wordt gebruikt om te bepalen waarom meerdere onderwerpen op elkaar zijn afgestemd. Opmerking: deze variabele wordt alleen ondersteund als de trigger On Select Intent is.
SignInReason	keuze	Wordt gebruikt om te bepalen welke aanmeldoptie nodig is bij het activeren van het onderwerp. Opmerking: deze variabele wordt alleen ondersteund als de trigger On Sign In is.
User.Language	keuze	Met deze variabele kan de taalinstelling van de gebruiker per gesprek worden ingesteld.

Variabelen voor geïntegreerde verificatie (standaard)

De volgende variabelen zijn beschikbaar voor agenten die zijn geconfigureerd voor verificatie met Microsoft. Deze configuratie gebruikt Microsoft Entra ID-verificatie en is de standaard voor nieuwe agenten.

Zie Verificatievariabelen voor meer informatie.

Meting	Type	Definitie
User.DisplayName	string	De weergavenaam van de gebruiker die momenteel met de agent praat.
User.Email	string	Het e-mailadres van de gebruiker die momenteel met de agent praat.
User.FirstName	string	De voornaam van de gebruiker die momenteel met de agent praat.
User.Id	string	De unieke id van de gebruiker die momenteel met de agent praat.
User.IsLoggedIn	Booleaans	Booleaanse vlag die aangeeft of de gebruiker die momenteel met de agent praat al dan niet geverifieerd is.
User.LastName	string	De familienaam van de gebruiker die momenteel met de agent praat.
User.PrincipalName	string	De user principal name van de gebruiker die momenteel met de agent praat.

Variabelen voor handmatige verificatie met Generic OAuth 2

De volgende variabelen zijn beschikbaar voor agenten die zijn geconfigureerd om de Generic OAuth 2-gegevensprovider te gebruiken.

Meting	Type	Definitie
User.AccessToken	string	Het toegangstoken voor de gebruiker die zich verifieert met agent.
User.DisplayName	string	De weergavenaam van de gebruiker die momenteel met de agent praat.
User.Id	string	De unieke id van de gebruiker die momenteel met de agent praat.
User.IsLoggedIn	Booleaans	Booleaanse vlag die aangeeft of de gebruiker die momenteel met de agent praat al dan niet geverifieerd is.

Variabelen voor handmatige verificatie met Microsoft Entra ID

De volgende variabelen zijn beschikbaar voor agenten die zijn geconfigureerd om de Microsoft Entra ID (eerder Azure Active Directory) gegevensproviders te gebruiken.

Meting	Type	Definitie
User.AccessToken	string	Het toegangstoken voor de gebruiker die zich verifieert met agent.
User.DisplayName	string	De weergavenaam van de gebruiker die momenteel met de agent praat.
User.Email	string	Het e-mailadres van de gebruiker die momenteel met de agent praat.
User.FirstName	string	De voornaam van de gebruiker die momenteel met de agent praat.
User.Id	string	De unieke id van de gebruiker die momenteel met de agent praat.
User.IsLoggedIn	Booleaans	Booleaanse vlag die aangeeft of de gebruiker die momenteel met de agent praat al dan niet geverifieerd is.
User.LastName	string	De familienaam van de gebruiker die momenteel met de agent praat.
User.PrincipalName	string	De principal-naam van de gebruiker die momenteel met de agent praat.

Variabelen voor spraakgestuurde agenten

De volgende variabelen zijn alleen beschikbaar voor spraakgestuurde agenten.

Notitie

Zie Spraakvariabelen gebruiken voor meer informatie over spraakgestuurde agentvariabelen.

Meting	Type	Definitie
Activity.InputDTMFKeys	string	De onbewerkte DTMF-sleutelwaarde ontvangen van telefonie.
Activity.SpeechRecognition.Confidence	Nummer	De betrouwbaarheidsscore voor het volledige resultaat van de Azure Site Recovery-hypothese, 0 tot 1.
Activity.SpeechRecognition.MinimallyFormattedText	string	Licht opgemaakte tekst van het Azure Site Recovery-hypotheseresultaat. Bijvoorbeeld 'Vijfhonderd dollar'. Woorden worden voluit gespeld, maar basaal hoofdlettergebruik en basale leestekens zijn ook opgenomen.
Activity.UserInputType	keuze	Het invoertype van de meest recente invoer van de gebruiker. De waarde kan tests, spraak of DTMF zijn.
Conversation.OnlyAllowDTMF	Booleaans	Booleaanse vlag die aangeeft of de IVR tijdens runtime op de modus voor alleen DTMF moet worden ingesteld.
Conversation.SipUuiHeaderValue	string	De UUI-headertekenreeks die wordt gebruikt om context door te geven aan IVR bij het starten van de oproep.