Overzicht van variabelen

Note

De functies in dit artikel worden aangedreven door de standaard kabelboom, die gebruikmaakt van de factureringsopties zoals beschreven in Licensing voor agenten die door de standaardkabelboom worden aangestuurd. Leer hoe je standaardfuncties kunt openen in Access standaard agents en agentstromen.

Er zijn variabelen op vier niveaus of bereiken:

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

Variabeltypen

Elke variabele heeft een basistype. Het type bepaalt welke waarden de variabele kan hebben en welke operators u kunt gebruiken bij het maken van een logische expressie.

Type Description
Snaar / Touwtje Een reeks tekens die wordt gebruikt om tekst weer te geven
Boolean Een logische waarde die alleen true of false kan zijn
Number Elk reëel getal
Table Een lijst met waarden, maar alle waarden moeten van hetzelfde type zijn
Record Een verzameling naam-waardeparen waarbij waarden van elk type kunnen zijn
Datum/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"; meer te weten komen in Blank in de Power Fx-documentatie

U stelt het type van een variabele in wanneer u er voor het eerst een waarde aan toewijst. Daarna staat het type vast en kunt u geen andere waarden meer toewijzen. Als u bijvoorbeeld de beginwaarde 1 aan een variabele toewijst, stelt u het type in op Getal. Als u vervolgens probeert een Tekenreekswaarde zoals "apples" toe te wijzen, krijgt u een foutmelding.

Wanneer u een agent test, kan er tijdelijk een variabele verschijnen met het type onbekend. Een onbekende variabele heeft nog geen waarde.

De volgorde van variabelen wordt bepaald van boven naar beneden op het auteurscanvas. De agent beschouwt knooppunten bovenaan het auteurscanvas voordat hij knooppunten onderaan heeft.

Wanneer je branches maakt met Condition-nodes, ordent Copilot Studio de branches van links naar rechts. De agent beschouwt knooppunten in de meest linkse tak vóór knooppunten in de meest rechtse tak.

Entities

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 Variabele basistype
Meerkeuzeopties Keuze
Volledige respons van de gebruiker Snaar / Touwtje
Leeftijd Number
Boolean Boolean
City Snaar / Touwtje
Kleur Snaar / Touwtje
Continent Snaar / Touwtje
land, regio Snaar / Touwtje
Datum en tijd Datum/tijd
E-mailadres Snaar / Touwtje
Event Snaar / Touwtje
Integer Integer
Language Snaar / Touwtje
Geld Number
Number Number
Rangtelwoord Number
Organisatie Snaar / Touwtje
Procent Number
Persoonsnaam Snaar / Touwtje
Telefoonnummer Snaar / Touwtje
Nuttige plaats Snaar / Touwtje
Snelheid Number
State Snaar / Touwtje
Straatadres Snaar / Touwtje
Temperatuur Number
URL Snaar / Touwtje
Gewicht Number
Postcode Snaar / Touwtje
Aangepaste entiteit Keuze

Omgevingsvariabelen

Omgevingsvariabelen zijn een Power Platform-concept. Omgevingsvariabelen maken het basisscenario voor levenscyclusbeheer voor toepassingen (ALM) mogelijk waarbij een applicatie tussen Power Platform-omgevingen wordt verplaatst. In dit scenario blijft de applicatie exact hetzelfde, behalve enkele belangrijke externe referenties die verschillen tussen de bronomgeving en de bestemmingsomgeving.

Gebruik omgevingsvariabelen op dezelfde manier als topic-, global- en systeemvariabelen. Een opmerkelijk verschil is dat omgevingsvariabelen alleen-lezen zijn in Copilot Studio. Agentauteurs kunnen omgevingsvariabelen niet wijzigen in Copilot Studio. Beheerders kunnen echter de waarde van omgevingsvariabelen wijzigen in Power Apps. In Copilot Studio kunt u het deelvenster Variabelen gebruiken om informatie over een omgevingsvariabele te bekijken. Het deelvenster Eigenschappen van variabelen bevat ook een koppeling naar Power Apps, de ontwerpervaring voor omgevingsvariabelen.

De gepubliceerde versie van een agent die omgevingsvariabelen gebruikt, bevat de waarden die je voor deze variabelen instelt wanneer je de agent publiceert. Telkens wanneer een beheerder omgevingsvariabelen bijwerkt, moet je alle agenten die deze variabelen gebruiken opnieuw publiceren om de wijzigingen tijdens runtime in te voeren. 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 gegevenstypen in Power Apps:

Typ in Copilot Studio Typ in Power Apps
Decimaal getal Number
JSON Detecteer het type op basis van de waarde. Als het geen JSON is > Niet gespecificeerd (validatiefout)
Tekst Snaar / Touwtje
Yes/No Boolean
Gegevensbron Snaar / Touwtje
Geheim Snaar / Touwtje

Note

Je ziet fouten in omgevingsvariabelen in de testchat en bij het publiceren. Deze fouten verschijnen echter niet in de Topic-lijst omdat omgevingsvariabelen geen topicvariabelen zijn.

Systeemvariabelen

Elke agent bevat ingebouwde systeemvariabelen die extra informatie over een gesprek leveren.

Screenshot van systeemvariabelen in een onderwerp.

In Copilot Studio worden niet alle systeemvariabelen weergegeven. Gebruik een Power Fx-formule om toegang te krijgen tot verborgen systeemvariabelen.

Als u systeemvariabelen wilt gebruiken in een Power Fx-formule, voegt u System. toe vóór de naam van de variabele. Wilt u bijvoorbeeld de systeemvariabele User.DisplayName opnemen in een formule, verwijs hier dan naar als System.User.DisplayName.

Name Type Definition
Activity.Attachments table De bestandsbijlagen die de gebruiker opgeeft.
Activity.Kanaal choice De kanaal-id van het huidige gesprek.
Activiteit.KanaalData any Een object dat kanaalspecifieke inhoud bevat.
Activity.ChannelId tekenreeks De kanaal-id van het huidige gesprek als een tekenreeks.
Activity.From.Id tekenreeks De kanaalspecifieke unieke id van de afzender.
activiteit.van.naam tekenreeks De kanaalspecifieke gebruikersvriendelijke naam van de afzender.
Activity.Name tekenreeks De naam van de gebeurtenis.
Activity.Recipient.Id tekenreeks De eigenschap Type van de inkomende activiteit.
Activity.Recipient.Name tekenreeks 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.
Activiteit.Tekst tekenreeks Het meest recente bericht dat door de gebruiker is verzonden.
Activiteit.Type choice Het type activiteit.
Activity.TypeId tekenreeks Type activiteit, als tekenreeks.
Activiteit.Waarde any Open-einde waarde.
Bot.EnvironmentId tekenreeks De omgevings-id van de agent.
Bot.Identificatie tekenreeks De id van de agent.
Bot.Name tekenreeks De naam van uw agent.
Bot.SchemaName tekenreeks De schemanaam van de agent.
Bot.TenantId tekenreeks De tenant-id van de agent.
ClientPluginActions choice Verzameling van dynamische client-plug-in-acties die u kunt overwegen voor generatieve orkestratie.
Conversation.Id tekenreeks De unieke ID van het huidige gesprek.
Conversation.InTestMode Boolean Booleaanse vlag die aangeeft of het gesprek plaatsvindt in het testcanvas.
Conversation.LocalTimeZone tekenreeks 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 tekenreeks De foutcode voor de huidige fout.
Het foutbericht voor de huidige fout.
Fout.Bericht tekenreeks Het foutbericht voor de huidige fout.
Opmerking: deze variabele wordt alleen ondersteund als de trigger On Error is.
FallbackCount number 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.
InactiviteitTimer.Vervolg Boolean Booleaanse vlag die aangeeft of de timer moet worden voortgezet.
Opmerking: deze variabele wordt alleen ondersteund als de trigger Inactivity is.
InactivityTimer.Count number Het aantal keren 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. Meer informatie over inactiviteittrigger.
LastMessage.Id tekenreeks De id van het vorige bericht dat door de gebruiker is verzonden.
LastMessage.Text tekenreeks Het vorige bericht dat door de gebruiker is verzonden.
Recognizer.ExtractedEntities choice Geeft de geëxtraheerde entiteiten uit het triggerbericht weer.
Opmerking: deze variabele wordt alleen ondersteund als de trigger On Select Intent is.
Recognizer.IntentOptions choice Vertegenwoordigt de intentieopties wanneer de herkenningsfunctie dubbelzinnige resultaten retourneert.
Opmerking: deze variabele wordt alleen ondersteund als de trigger On Select Intent is.
Recognizer.SelectedIntent choice 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 tekenreeks De id van het gebruikersbericht dat het huidige onderwerp heeft geactiveerd.
Herkenner.Ontsporingsbericht.Tekst tekenreeks Het gebruikersbericht dat het huidige onderwerp heeft geactiveerd.
Recognizer.MultipleTopicsMatchedReason tekenreeks 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.
Aanmeldingsreden choice 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 choice Met deze variabele kan de taallocatie van de gebruiker per gesprek worden ingesteld.

Variabelen voor spraakgestuurde agenten

De volgende variabelen zijn alleen beschikbaar voor spraakgestuurde agenten. Lees meer in Gebruik spraakvariabelen.

Name Type Definition
Activiteit.InvoerDTMFToetsen tekenreeks De onbewerkte DTMF-sleutelwaarde van telefonie.
Activity.SpeechRecognition.Vertrouwen number De betrouwbaarheidsscore voor de automatische spraakherkenningshypothese als geheelresultaat, 0 tot 1.
Activiteit.Spraakerkenning.MinimaalOpgemaakteTekst tekenreeks Licht opgemaakte tekst van de automatische spraakherkenningshypothese is resultaat. Bijvoorbeeld: 'Vijfhonderd dollar'. Woorden worden gespeld, maar basishoofdletters en interpunctie zijn inbegrepen.
Activiteit.GebruikersInvoerType choice Het type van de meest recente invoer door de agent-gebruiker. De waarde kan test, spraak of DTMF zijn.
Conversation.OnlyAllowDTMF Boolean Booleaanse vlag die aangeeft of de IVR tijdens runtime op de modus voor alleen DTMF moet worden ingesteld.
Conversation.SipUuiHeaderValue tekenreeks De UUI-headertekenreeks die wordt gebruikt om context door te geven aan IVR bij het starten van de oproep.

Variabelen voor geïntegreerde verificatie (standaard)

De volgende variabelen zijn beschikbaar voor agenten die zijn geconfigureerd voor verificatie met Microsoft. Deze configuratie maakt gebruik van Microsoft Entra ID-verificatie en is de standaardinstelling voor nieuwe agenten. Lees meer in Authenticatievariabelen.

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

Variabelen voor handmatige verificatie met Generic OAuth 2

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

Name Type Definition
User.AccessToken tekenreeks Het toegangstoken voor de gebruiker die zich authenticeert met de agent.
User.DisplayName tekenreeks De weergavenaam van de gebruiker die momenteel met de agent praat.
User.Id tekenreeks De unieke id van de gebruiker die momenteel met de agent praat.
User.IsLoggedIn Boolean 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-serviceproviders (voorheen Azure Active Directory) te gebruiken.

Name Type Definition
User.AccessToken tekenreeks Het toegangstoken voor de gebruiker die zich authenticeert met de agent.
User.DisplayName tekenreeks De weergavenaam van de gebruiker die momenteel met de agent praat.
User.Email tekenreeks Het e-mailadres van de gebruiker die momenteel met de agent praat.
User.FirstName tekenreeks De voornaam van de gebruiker die momenteel met de agent praat.
User.Id tekenreeks De unieke id van de gebruiker die momenteel met de agent praat.
User.IsLoggedIn Boolean Booleaanse vlag die aangeeft of de gebruiker die momenteel met de agent praat al dan niet geverifieerd is.
User.LastName tekenreeks De familienaam van de gebruiker die momenteel met de agent praat.
User.PrincipalName tekenreeks De hoofdnaam van de gebruiker die momenteel met de agent praat.
  • Last updated on