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.
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. Hvis du skiller parameterne fra forbrukerobjektene, kan du endre verdiene i det samme miljøet eller når du overfører 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 | Bekrivelse |
|---|---|
| String | 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 |
| Spill inn | En samling navneverdipar der verdier kan være av hvilken som helst type |
| Date/klokkeslett | En dato, et klokkeslett, en ukedag eller en måned i forhold til et tidspunkt |
| Valg | En liste over strengverdier med tilknyttede synonymer |
| Blank | En plassholder for «ingen verdi» eller «ukjent verdi»; for mer informasjon, se 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 redigeringslerretet. Noder øverst på redigeringslerretet vurderes før noder nederst.
Når du oppretter grener med betingelsesnoder, ordnes grener fra venstre mot høyre. Noder i grenen lengst til venstre vurderes før noder i grenen lengst til høyre.
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 | String |
| Alder | Nummer |
| boolsk | boolsk |
| City | String |
| Farge | String |
| Kontinent | String |
| Land eller område | String |
| Dato og klokkeslett | Date/klokkeslett |
| String | |
| Seminar/konferanse | String |
| Integer | Integer |
| Språk | String |
| Money | Nummer |
| Nummer | Nummer |
| Ordenstall | Nummer |
| Organisasjonen | String |
| Prosentsats | Nummer |
| Personnavn | String |
| Telefonnummer | String |
| Interessepunkt | String |
| Hastighet | Nummer |
| Tilstand | String |
| Gateadresse | String |
| Temperatur | Nummer |
| URL | String |
| Vekt | Nummer |
| Postnummer | String |
| 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 scenarioet forblir programmet nøyaktig det samme bortsett fra noen få viktige eksterne referanser som er forskjellige mellom kildemiljøet og målmiljøet.
Bruk miljøvariabler på samme måte som emnevariabler, globale variabler 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 har verdiene som er angitt for disse variablene når du publiserer agenten. Når en administrator oppdaterer miljøvariabler, må du publisere alle agenter som bruker disse variablene, på nytt for at endringene skal være effektive ved kjøretid. 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) |
| Tekstmelding | String |
| Ja/nei | boolsk |
| Datakilde | String |
| Hemmelighet | String |
Notat
Miljøvariabelfeil vises i testnettpraten og under publisering. Disse feilene vises imidlertid ikke i Emne-listen fordi de ikke er emnevariabler.
Systemvariabler
Hver agent har innebygde systemvariabler som gir ekstra informasjon om en samtale.
Notat
Hvis du vil ha mer informasjon om taleaktiverte agentvariabler, kan du se Bruk talevariabler.
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.
| Name | 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. |
| 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 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.
Hvis du vil ha mer informasjon, kan du se Godkjenningsvariabler.
| Name | Type | Definisjon |
|---|---|---|
| Bruker.DisplayNavn | 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.
| Name | Type | Definisjon |
|---|---|---|
| User.AccessToken | streng | Tilgangstokenet for brukeren som autentiserer seg via agenten. |
| Bruker.DisplayNavn | 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).
| Name | Type | Definisjon |
|---|---|---|
| User.AccessToken | streng | Tilgangstokenet for brukeren som autentiserer seg via agenten. |
| Bruker.DisplayNavn | 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. |
Variabler for taleaktiverte agenter
Følgende variabler er bare tilgjengelige for taleaktiverte agenter.
Notat
Hvis du vil ha mer informasjon om taleaktiverte agentvariabler, kan du se Bruk talevariabler.
| Name | Type | Definisjon |
|---|---|---|
| Aktivitet.InputDTMFKeys | streng | Den rå DTMF-nøkkelverdien fra telefoni. |
| Aktivitet.Talegjenkjenning.Tillit | Nummer | Konfidensresultatet for Azure Site Recovery-hypotesen, fra 0 til 1. |
| Activity.SpeechRecognition.MinimallyFormattedText | streng | Lett formatert tekst i resultatet av Azure Site Recovery-hypotesen. 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. |