Merk
Tilgang til denne siden krever autorisasjon. Du kan prøve å logge på eller endre kataloger.
Tilgang til denne siden krever autorisasjon. Du kan prøve å endre kataloger.
Bemerkning
Funksjonene i denne artikkelen drives av standardledningsnettet, som bruker faktureringsalternativene beskrevet i Lisensiering for agenter drevet av standardledningsnettet. Lær hvordan du får tilgang til standardfunksjoner i Access standardagenter og agentflyter.
Variabler finnes på fire nivåer, eller omfang:
- Emnevariabler du bare kan bruke i emnene der du oppretter dem. Dette omfanget er standardområdet variabler du oppretter.
- Globale variabler du kan bruke i alle emner. Du kan endre omfanget for et emne for å gjøre den til en global variabel.
- Systemvariabler Copilot Studio oppretter automatisk for en agent. De gir mer kontekstavhengig informasjon om samtalen eller brukeren. De er tilgjengelige i alle emner.
- Miljøvariabler du oppretter i Power Platform. De er skrivebeskyttet i Copilot Studio. De lagrer parameternøklene og verdiene, som deretter fungerer som input til diverse andre applikasjonsobjekter, inkludert Copilot Studio. Ved å skille parametrene fra de forbrukende objektene, kan du endre verdiene i samme miljø eller når du migrerer løsninger til andre miljøer. Alternativet er å la hardkodede parameterverdier være igjen i komponentene som bruker dem.
Variabeltyper
Hver variabel har en basistype. Typen bestemmer hvilke verdier variabelen kan holde og operatorene du kan bruke når du bygger et logisk uttrykk med den.
| Type | Beskrivelse |
|---|---|
| Streng | En sekvens med tegn som brukes til å representere tekst |
| boolsk | En logisk verdi som bare kan være true eller false |
| Nummer | Enhver reelt tall |
| Tabell | En liste med verdier, men alle verdier må være av samme type |
| Post | En samling navneverdipar der verdier kan være av hvilken som helst type |
| Dato/klokkeslett | En dato, et klokkeslett, en ukedag eller en måned i forhold til et tidspunkt |
| Valg | En liste over strengverdier med tilknyttede synonymer |
| Tomt | En plassholder for «ingen verdi» eller «ukjent verdi»; lær mer i Blank i Power Fx-dokumentasjonen |
Du angir typen til en variabel første gang du tilordner en verdi til den. Etter det er typen fastsatt, og du kan ikke tilordne verdier av noen annen type. Hvis du for eksempel tildeler startverdien 1 til en variabel, setter du typen til Tall. Hvis du deretter prøver å tilordne en Streng-verdi som "apples", får du en feil.
Når du tester en agent, kan det hende at en variabel midlertidig vises med typen ukjent. En ukjent variabel har ingen verdi ennå.
Rekkefølgen på variablene bestemmes fra toppen til bunnen av forfatterlerretet. Agenten vurderer noder øverst på forfatterlerretet før noder nederst.
Når du lager grener ved å bruke Condition-noder, ordner Copilot Studio grenene fra venstre til høyre. Agenten vurderer noder i den venstre grenen før noder i den høyre grenen.
Enheter
Copilot Studio bruker enheter å identifisere spesifikke typer informasjon fra en brukers svar. Den identifiserte informasjonen lagres i en variabel av typen som er riktig for informasjonen. Tabellen nedenfor viser variabelbasistypen som er knyttet til forhåndsbygde enheter.
| Enhet | Variabel basetype |
|---|---|
| Flervalgsalternativer | Valg |
| Brukerens hele svar | Streng |
| Alder | Nummer |
| boolsk | boolsk |
| City | Streng |
| Farge | Streng |
| Kontinent | Streng |
| Land eller område | Streng |
| Dato og klokkeslett | Dato/klokkeslett |
| E-post | Streng |
| Hendelse | Streng |
| Heltall | Heltall |
| Språk | Streng |
| Penger | Nummer |
| Nummer | Nummer |
| Ordenstall | Nummer |
| Organisasjon | Streng |
| Prosentsats | Nummer |
| Personnavn | Streng |
| Telefonnummer | Streng |
| Interessepunkt | Streng |
| Hastighet | Nummer |
| Tilstand | Streng |
| Gateadresse | Streng |
| Temperatur | Nummer |
| URL | Streng |
| Vekt | Nummer |
| Postnummer | Streng |
| Egendefinert entitet | Valg |
Miljøvariabler
Miljøvariabler er et Power Platform-konsept. Miljøvariabler muliggjør det grunnleggende scenarioet for administrasjon av applivssyklus (ALM) for flytting av en app mellom Power Platform-miljøer. I dette scenariet forblir applikasjonen nøyaktig den samme bortsett fra noen få viktige eksterne referanser som varierer mellom kildemiljøet og destinasjonsmiljøet.
Bruk miljøvariabler på samme måte som tema-, global- og systemvariabler. En bemerkelsesverdig forskjell er at miljøvariabler er skrivebeskyttet i Copilot Studio. Agentforfattere kan ikke endre miljøvariabler i Copilot Studio. Administratorer kan imidlertid endre verdien av miljøvariabler i Power Apps. I Copilot Studio kan du bruke Variabelpanel for å se informasjon om en miljøvariabel. Panelet for variabelegenskaper har også en lenke til Power Apps, redigeringsopplevelsen for miljøvariabler.
Den publiserte versjonen av en agent som bruker miljøvariabler inkluderer verdiene du setter for disse variablene når du publiserer agenten. Når en administrator oppdaterer miljøvariabler, må du republisere alle agenter som bruker disse variablene for at endringene skal tre i kraft under kjøring. Det finnes imidlertid ett unntak: Du trenger ikke publisere agentene på nytt når verdien av en miljøvariabel av typen hemmelighet endres. I motsetning til andre miljøvariabler hentes hemmelige variabler ved kjøretid.
Miljøvariabeltyper i Copilot Studio tilordnes til Power Apps-datatyper som følger:
| Skriv inn i Copilot Studio | Skriv inn i Power Apps |
|---|---|
| Desimaltall | Nummer |
| JSON | Finn typen fra verdien. Hvis ikke JSON => Uspesifisert (valideringsfeil) |
| Tekst | Streng |
| Ja/nei | boolsk |
| Datakilde | Streng |
| Hemmelighet | Streng |
Bemerkning
Du ser miljøvariablefeil i testchatten og når du publiserer. Disse feilene vises imidlertid ikke i Topic-listen fordi miljøvariabler ikke er topicvariabler.
Systemvariabler
Hver agent inkluderer innebygde systemvariabler som gir ekstra informasjon om en samtale.
Copilot Studio viser ikke alle systemvariabler. For å få tilgang til skjulte systemvariabler, bruk en Power Fx-formel.
For å bruke systemvariabler i en Power Fx-formel, legg til System. før variabelnavnet. Hvis du for eksempel vil inkludere systemvariabelen User.DisplayName i en formel, henviser du til den som System.User.DisplayName.
| Navn | Type | Definisjon |
|---|---|---|
| Aktivitet.Vedlegg | tabell | Filvedleggene som brukeren oppgir. |
| Aktivitet.Kanal | valgmulighet | Kanal-ID-en til den gjeldende samtalen. |
| Activity.ChannelData | hvilken som helst | Et objekt som inneholder kanalspesifikt innhold. |
| Activity.ChannelId | streng | Kanal-ID-en til den gjeldende samtalen, som en streng. |
| Aktivitet.Fra.Id | streng | Avsenderens kanalspesifikke unike ID. |
| Activity.From.Name | streng | Det kanalspesifikke, brukervennlige navnet på avsenderen. |
| Activity.Name | streng | Navnet på hendelsen. |
| Activity.Recipient.Id | streng | Type-egenskapen for den innkommende aktiviteten. |
| Activity.Recipient.Name | streng | Representerer visningsnavnet for agenten i kanalen. I telefonikanalkontekst er verdien for denne variabelen telefonnummeret som agenten er knyttet til. |
| Activity.Text | streng | Den nyeste meldingen sendt av brukeren. |
| Aktivitets.Type | valgmulighet | Type av aktivitet. |
| Activity.TypeId | streng | Type aktivitet, som en streng. |
| Activity.Value | hvilken som helst | Verdi med åpen ende. |
| Bot.EnvironmentId | streng | Agentens miljø-ID. |
| Bot.Id | streng | Agentens ID. |
| Bot.Name | streng | Navnet på agenten din. |
| Bot.SchemaName | streng | Skjemanavnet til agenten. |
| Bot.TenantId | streng | Leietaker-ID-en til agenten. |
| ClientPluginActions | valgmulighet | Samling av dynamiske klient-plugin-handlinger å vurdere for generativ orkestrering. |
| Conversation.Id | streng | Den unike ID-en til den gjeldende samtalen. |
| Conversation.InTestMode | boolsk | Boolsk flagg som representerer hvis diskusjonen skjer på testlerretet. |
| Conversation.LocalTimeZone | streng | Navnet på tidssonen som skal brukes av brukeren i databaseformatet for IANA-tidssone. |
| Conversation.LocalTimeZoneOffset | datetime | Tidsforskyvningen fra UTC for gjeldende lokale tidssone. |
| Feilkode | streng | Feilkoden for nåværende feil. Feilmeldingen for den gjeldende feilen. |
| Feilmelding | streng | Feilmeldingen for den gjeldende feilen. Merk: Denne variabelen støttes bare hvis utløseren er On Error. |
| FallbackCount | nummer | Denne variabelen teller antall ganger et emne ikke kunne samsvares med brukerinndata. Merk: Denne variabelen støttes bare hvis utløseren er On Unknown Intent. |
| InactivityTimer.Continue | boolsk | Boolean flagg som representerer om tidtakeren trenger å fortsette. Merk: Denne variabelen støttes bare hvis utløseren er Inactivity. |
| InactivityTimer.Count | nummer | Antall ganger OnInactivity-timeren ble utløst på grunn av brukerinaktivitet etter den konfigurerte tiden. Merk: Denne variabelen støttes bare hvis utløseren er Inactivity. Finn ut mer i inaktivitetsutløseren. |
| LastMessage.Id | streng | ID-en til den forrige meldingen som ble sendt av brukeren. |
| LastMessage.Text | streng | Den forrige meldingen som ble sendt av brukeren. |
| Recognizer.ExtractedEntities | valgmulighet | Representerer de ekstraherte enhetene fra en utløsende melding. Merk: Denne variabelen støttes bare hvis utløseren er On Select Intent. |
| Recognizer.IntentOptions | valgmulighet | Representerer intensjonsalternativene når gjenkjenneren returnerer tvetydige resultater. Merk: Denne variabelen støttes bare hvis utløseren er On Select Intent. |
| Recognizer.SelectedIntent | valgmulighet | Representerer hensikten som er valgt fra gjenkjenneren. Merk: Denne variabelen støttes bare hvis utløseren er On Select Intent. |
| Recognizer.TriggeringMessage.Id | streng | ID-en til brukermeldingen som utløste det gjeldende emnet. |
| Recognizer.TriggeringMessage.Text | streng | Brukermeldingen som utløste det aktuelle emnet. |
| Gjenkjenner.MultipleTopicsMatchedReason | streng | Brukes til å finne ut hvorfor flere emner ble samsvart. Merk: Denne variabelen støttes bare hvis utløseren er On Select Intent. |
| Påloggingsårsak | valgmulighet | Brukes til å finne ut hvilket påloggingsalternativ som er nødvendig ved utløsing av emnet. Merk: Denne variabelen støttes bare hvis utløseren er On Sign In. |
| Bruker.språk | valgmulighet | Denne variabelen brukes til å angi nasjonal innstilling for brukerspråk per diskusjon. |
Variabler for taleaktiverte agenter
Følgende variabler er bare tilgjengelige for taleaktiverte agenter. Lær mer i Bruk stemmevariabler.
| Navn | Type | Definisjon |
|---|---|---|
| Aktivitet.InputDTMFKeys | streng | Den rå DTMF-nøkkelverdien fra telefoni. |
| Aktivitet.Talegjenkjenning.Tillit | nummer | Konfidenspoengsummen for hele resultatet for automatisk talegjenkjenningshypotese, 0 til 1. |
| Activity.SpeechRecognition.MinimallyFormattedText | streng | Lett formatert tekst av hypotesen om automatisk talegjenkjenning. For eksempel «Fem hundre dollar». Ordene er stavet ut, men grunnleggende bruk av store bokstaver og tegnsetting er inkludert. |
| Activity.UserInputType | valgmulighet | Typen av den nyeste inndataen fra agentbrukeren. Verdien kan enten være test, tale eller DTMF. |
| Conversation.OnlyAllowDTMF | boolsk | Boolsk variabel som representerer om IVR skal settes til kun DTMF-modus under avvikling. |
| Conversation.SipUuiHeaderValue | streng | UUI-overskriftsstrengen som brukes til å sende kontekst til IVR ved samtalestart. |
Variabler for integrert godkjenning (standard)
Følgende variabler er tilgjengelige for agenter som er konfigurert til å godkjenne med Microsoft. Denne konfigurasjonen bruker Microsoft Entra ID-autentisering og er standard for nye agenter. Lær mer i autentiseringsvariabler.
| Navn | Type | Definisjon |
|---|---|---|
| Bruker.Visningsnavn | streng | Visningsnavnet til brukeren som for øyeblikket snakker med agent. |
| Bruker.E-post | streng | E-postadressen til brukeren som for øyeblikket snakker med agent. |
| Bruker.Fornavn | streng | Fornavnet til brukeren som for øyeblikket snakker med agent. |
| User.Id | streng | Den unike ID-en til brukeren som for øyeblikket snakker med agent. |
| User.IsLoggedIn | boolsk | Boolsk flagg som representerer om brukeren som for øyeblikket snakker med agenten, er godkjent eller ikke. |
| Bruker.Etternavn | streng | Familienavnet til brukeren som for øyeblikket snakker med agenten. |
| User.PrincipalName | streng | Brukerhovednavnet til brukeren som snakker med agenten. |
Variabler for manuell godkjenning med generisk OAuth 2
Følgende variabler er tilgjengelige for agenter som er konfigurert til å bruke den generiske OAuth 2-tjenesteleverandøren.
| Navn | Type | Definisjon |
|---|---|---|
| User.AccessToken | streng | Tilgangstokenet for brukeren som autentiserer seg via agenten. |
| Bruker.Visningsnavn | streng | Visningsnavnet til brukeren som for øyeblikket snakker med agent. |
| User.Id | streng | Den unike ID-en til brukeren som for øyeblikket snakker med agent. |
| User.IsLoggedIn | boolsk | Boolsk flagg som representerer om brukeren som for øyeblikket snakker med agenten, er godkjent eller ikke. |
Variabler for manuell autentisering med Microsoft Entra ID
Følgende variabler er tilgjengelige for agenter som er konfigurert til å bruke tjenesteleverandørene Microsoft Entra ID (tidligere Azure Active Directory).
| Navn | Type | Definisjon |
|---|---|---|
| User.AccessToken | streng | Tilgangstokenet for brukeren som autentiserer seg via agenten. |
| Bruker.Visningsnavn | streng | Visningsnavnet til brukeren som for øyeblikket snakker med agent. |
| Bruker.E-post | streng | E-postadressen til brukeren som for øyeblikket snakker med agent. |
| Bruker.Fornavn | streng | Fornavnet til brukeren som for øyeblikket snakker med agent. |
| User.Id | streng | Den unike ID-en til brukeren som for øyeblikket snakker med agent. |
| User.IsLoggedIn | boolsk | Boolsk flagg som representerer om brukeren som for øyeblikket snakker med agenten, er godkjent eller ikke. |
| Bruker.Etternavn | streng | Familienavnet til brukeren som for øyeblikket snakker med agenten. |
| User.PrincipalName | streng | Hovednavnet til brukeren som for øyeblikket snakker med agenten. |