Muuttujien yleiskatsaus

Muuttujia voi olla neljällä tasolla tai vaikutusalueella:

• Aihe muuttujia voidaan käyttää vain aiheissa, joissa ne luodaan. Tämä vaikutusalue on luotujen muuttujien oletusarvo.
• Yleisiä muuttujia voi käyttää kaikissa aiheissa. Voit muuttaa aiheen muuttujan vaikutusaluetta ja tehdä siitä yleisen muuttujan.
• Järjestelmämuuttujat luodaan automaattisesti agentin kanssa. Niissä on tilannetietoja keskustelusta tai käyttäjästä. Ne ovat käytettävissä kaikissa aiheissa.
• Ympäristömuuttujat luodaan Power Platformissa ja ne ovat vain luku -muodossa Copilot Studiossa. Ne tallentavat parametrin avaimet ja arvot, jotka tämän jälkeen toimivat muiden sovellusobjektien, kuten Copilot Studion syötteinä. Kun parametrit erotetaan kuluttavista objekteista, voit muuttaa arvoja samassa ympäristössä tai silloin, kun ratkaisuja siirretään muihin ympäristöihin. Vaihtoehto on jättää kiinteät parametriarvot niitä käyttäville osille.

Muuttujan tyypit

Muuttuja liittyy perustyyppiin. Tyyppi määrittää arvot, joita muuttuja voi sisältää, ja operaattorit, joita voit käyttää, kun muodostat loogisen lausekkeen sen avulla.

Type	Description
String	Merkkijono, jota käytetään kuvaamaan tekstiä
Totuusarvo	Looginen arvo, joka voi olla vain true tai false
Number	Mikä tahansa reaaliluku
Table	Arvoluettelo, mutta kaikkien arvojen on oltava samantyyppisiä
Nauhoita	Nimi-arvo-parit, joissa arvot voivat olla minkä tahansa tyyppisiä
DateTime	Päivämäärä, kellonaika, viikonpäivä tai kuukausi suhteessa ajankohtaan
Valinta	Luettelo merkkijonoarvoista sekä liittyvät synonyymit
Tyhjä	Paikkamerkki arvolle "ei arvoa" tai "tuntematon arvo". Lisätietoja on kohdassa Tyhjät Power Fx:ssä

Muuttujan tyyppi määritetään, kun sen arvo määritetään ensimmäisen kerran. Sen jälkeen muuttujan tyyppi on kiinteä eikä sille voi määrittää muun tyyppisiä arvoja. Esimerkiksi muuttujalle, jonka aloitusarvo on 1, määritetään tyyppi Luku. Jos yrität määrittää sen merkkijono-arvoon "apples", tuloksena on virhe.

Kun testaat agenttia, muuttujan tyyppi voi olla tilapäisesti tuntematon. Tuntemattomalle muuttujalle ei ole vielä määritetty arvoa.

Muuttujien järjestys määräytyy sisällön tuotantoalustan yläosasta alareunaan. Muokkausalustan yläosassa olevia solmuja tarkastellaan ennen alareunassa olevia solmuja.

Kun luot haaroja ehto-solmuilla, haarat tilataan vasemmalta oikealle. Vasemmanpuoleisimman haaran solmuja pidetään ennen oikeanpuoleisimman haaran solmuja.

Entiteetit

Verkkosovellus

Copilot Studio käyttää entiteettejä tietynlaisten tietojen tunnistamiseen käyttäjän vastauksista. Tunnistetut tiedot tallennetaan muuttujaan, jonka tyyppi on tietojen mukaan sopiva. Seuraavassa taulukossa on lueteltu valmiiksi rakennettuihin entiteetteihin liittyvä muuttujan perustyyppi.

Entity	Muuttujan perustyyppi
Monivalinnan vaihtoehdot	Valinta
Käyttäjän koko vastaus	String
Ikä	Number
Totuusarvo	Totuusarvo
City	Merkkijono
Väri	String
Maanosa	String
Maa tai alue	String
Päivämäärä ja aika	DateTime
Email	String
Tapahtuma	String
Integer	Integer
Kieli	String
Money	Number
Number	Number
Järjestysluku	Number
Organisaatio	String
Prosenttiosuus	Number
Henkilön nimi	String
Puhelinnumero	Merkkijono
Karttakohde	Merkkijono
Nopeus	Luku
Osavaltio	Merkkijono
Katuosoite	Merkkijono
Lämpötila	Number
URL	String
Paino	Number
Postinumero	String
Mukautettu entiteetti	Valinta

Perinteinen

Copilot Studio käyttää entiteettejä tietynlaisten tietojen tunnistamiseen käyttäjän vastauksista. Tunnistetuille tiedoille lisätään tallennuksen yhteydessä muuttujatyyppi. Muuttujan tyyppi vastaa entiteettiä.

Kukin entiteetti- tai muuttujatyyppi on yhteydessä perustyyppiin seuraavassa taulukossa luetellulla tavalla. Perustyyppi määrittää operaattorit, joita voit käyttää, kun muodostat loogisen lausekkeen vastaavan muuttujan avulla. Se määrittää myös, voitko syöttää muuttujan työnkulkuun tai Bot Framework -taitoon syöteparametrina.

Esimerkiksi perustyyppi totuusarvo liittyy operaattoriin on yhtä suurin kuin, jolloin mahdolliset arvot ovat Tosi ja Epätosi. Luku-perustyyppi taas antaa numeerisia operaattoreita, kuten "on sama kuin", "on suurempi kuin" tai "on suurempi tai yhtä suuri kuin" jne.

Entiteetti	Muuttujan perustyyppi
Monivalinnan vaihtoehdot	Merkkijono
Käyttäjän koko vastaus	Merkkijono
Ikä	Luku
Totuusarvo	Totuusarvo
Paikkakunta	Merkkijono
Väri	Merkkijono
Maanosa	Merkkijono
Maa tai alue	Merkkijono
Päivämäärä ja aika	Merkkijono
Kesto	Merkkijono
Sähköpostiosoite	Merkkijono
Tapahtuma	Merkkijono
Kieli	Merkkijono
Raha	Merkkijono
Luku	Merkkijono
Järjestysluku	Merkkijono
Organisaatio	Merkkijono
Prosenttiosuus	Luku
Henkilön nimi	Merkkijono
Puhelinnumero	Merkkijono
Karttakohde	Merkkijono
Nopeus	Luku
Osavaltio	Merkkijono
Katuosoite	Merkkijono
Lämpötila	Luku
URL	String
Paino	Number
Postinumero	String
Mukautettu entiteetti	String

Ympäristömuuttujat

Ympäristömuuttujat ovat Power Platform -käsite. Ympäristömuuttujat ottavat käyttöön sovelluksen elinkaaren hallinnan (ALM) perusskenaarion sovellusten siirtämiseksi Power Platform -ympäristöjen välillä. Tässä skenaariossa sovellus pysyy täsmälleen samana lukuun ottamatta joitakin tärkeitä ulkoisia viittauksia, jotka ovat erilaisia lähdeympäristön ja kohdeympäristön välillä.

Käytä ympäristö-muuttujia samalla tavalla kuin Aihe-, Yleinen- ja Järjestelmä-muuttujia. Yksi ero on se, että ympäristömuuttujat ovat vain luku -muotoisia Copilot Studiossa. Agenttien tekijät eivät voi muokata Copilot Studio -ympäristön muuttujia. Ylläpitäjät voivat kuitenkin muuttaa Power Appsin ympäristön muuttujien arvoa. Voit käyttää Copilot Studiossa Muuttujat-ruutua nähdäksesi tietoja ympäristömuuttujasta. Muuttujat-ruudussa on myös linkki alkuperäiseen kirjoituskokemukseen.

Ympäristömuuttujia käyttävän agentin julkaistussa versiossa on arvot, jotka on määritetty näille muuttujille agenttia julkaistaessa. Aina kun järjestelmänvalvoja päivittää ympäristömuuttujia, sinun täytyy julkaista uudelleen näitä muuttujia käyttävät agentit, jotta muutokset tulisivat voimaan suorituspalvelussa. On kuitenkin yksi poikkeus: sinun ei tarvitse julkaista uudelleen agenttejasi, kun ympäristömuuttujan tyyppi salainen muuttuu. Toisin kuin muut ympäristömuuttujat, salaiset muuttujat noudetaan suorituspalvelun aikana.

Ympäristömuuttujatyypit Copilot Studiossa yhdistyvät Power Apps -tietotyyppeihin seuraavasti:

Tyyppi Copilot Studiossa	Tyyppi Power Appsssa
Desimaaliluku	Number
JSON	Tunnista tyyppi arvosta. Jos ei JSON => Määrittelemätön (tarkistusvirhe)
Viesti	String
Kyllä/ei	Totuusarvo
Data source	String
Salainen koodi	String

Muistiinpano

Ympäristömuuttujien virheet näkyvät Testi-keskustelussa ja julkaisemisen aikana. Nämä virheet eivät kuitenkaan näy Aihe-luettelossa, koska ne eivät ole aihemuuttujia.

Järjestelmämuuttujat

Jokainen agentti sisältää valmiit järjestelmämuuttujat, jotka sisältävät keskustelua koskevia lisätietoja.

Muistiinpano

Lisätietoja ääniominaisuuksia hyödyntävien agenttien muuttujista on ohjeaiheessa Äänimuuttujien käyttö.

Kaikkia järjestelmän muuttujia ei näytetä luettelossa. Näitä piilotettuja järjestelmämuuttujia on käytettävä Power Fx -kaavalla.

Käyttääksesi järjestelmämuuttujia Power Fx -kaavassa , lisää System. ennen muuttujan nimeä. Jos esimerkiksi haluat sisällyttää järjestelmämuuttujan User.DisplayName kaavaan, viittaa siihen nimellä System.User.DisplayName.

Name	Type	Määritelmä
Activity.Attachments	taulukko	Käyttäjän toimittamat tiedostoliitteet
Activity.Channel	valinta	Nykyisen keskustelun kanavatunnus
Activity.ChannelData	mikä tahansa	Objekti, joka sisältää kanavakohtaista sisältöä
Activity.ChannelId	string	Nykyisen keskustelun kanavatunnus merkkijonona
Activity.From.Id	string	Lähettäjän kanavakohtainen yksilöllinen tunnus
Activity.From.Name	string	Lähettäjän kanavakohtainen käyttäjäystävällinen nimi
Activity.Name	string	Tapahtuman nimi
Activity.Recipient.Id	string	Saapuvan aktiviteetin tyyppiominaisuus.
Activity.Recipient.Name	string	Ilmaisee agentin näyttönimen kanavassa. Puhelinkanavakontekstissa tämän muuttujan arvo on puhelinnumero, johon asiakaspalvelija on liitetty.
Activity.Text	string	Käyttäjän viimeksi lähettämä viesti
Activity.Type	valinta	Aktiviteetin tyyppi
Activity.TypeId	string	Aktiviteetin tyyppi merkkijonona
Activity.Value	mikä tahansa	Avoin arvo
Bot.EnvironmentId	string	Agentin ympäristötunnus
Bot.Id	string	Agentin tunnus
Bot.Name	string	Agentin nimi
Bot.SchemaName	string	Agentin rakenteen nimi
Bot.TenantId	string	Agentin vuokraajan tunnus
ClientPluginActions	valinta	Kokoelma dynaamisia asiakaslaajennustoimintoja, jotka on otettava huomioon generatiivisessa orkestraatiossa
Conversation.Id	string	Mykyisen keskustelun yksilöivä tunniste
Conversation.InTestMode	Totuusarvo	Totuusarvomerkintä, joka ilmaisee, tapahtuuko keskustelu testikaaviossa
Conversation.LocalTimeZone	string	Käyttäjän aikavyöhykkeen IANA-tietokantamuodossa käyttämän aikavyöhykkeen nimi
Conversation.LocalTimeZoneOffset	datetime	Nykyisen paikallisen aikavyöhykkeen aikasiirtymä UTC-ajasta
Error.Code	string	Nykyisen virheen virhekoodi. Nykyiselle virheelle määritetty virhesanoma.
Error.Message	string	Nykyiselle virheelle määritetty virhesanoma. Huomautus: Tätä muuttujaa tuetaan vain, jos käynnistin on On Error.
FallbackCount	luku	Tämä muuttuja laskee, kuinka monta kertaa aihetta ei voitu kohdistaa käyttäjän syötteeseen. Huomautus: Tätä muuttujaa tuetaan vain, jos käynnistin on On Unknown Intent.
InactivityTimer.Continue	Totuusarvo	Totuusarvomerkintä, joka ilmaisee, onko ajastinta jatkettava. Huomautus: Tätä muuttujaa tuetaan vain, jos käynnistin on Inactivity.
InactivityTimer.Count	luku	Niiden kertojen määrä, jolloin OnInactivity-ajastin on käynnistynyt käyttäjän passiivisuuden vuoksi määritetyn ajan jälkeen. Huomautus: Tätä muuttujaa tuetaan vain, jos käynnistin on Inactivity.
LastMessage.Id	string	Käyttäjän edellisen viestin tunnus
LastMessage.Text	string	Käyttäjän edellinen viesti
Recognizer.ExtractedEntities	valinta	Ilmaisee käynnistyssanomasta poimitut entiteetit. Huomautus: Tätä muuttujaa tuetaan vain, jos käynnistin on On Select Intent.
Recognizer.IntentOptions	valinta	Ilmaisee tarkoitusvaihtoehdot, kun tunnistus palauttaa moniselitteisiä tuloksia. Huomautus: Tätä muuttujaa tuetaan vain, jos käynnistin on On Select Intent.
Recognizer.SelectedIntent	valinta	Ilmaisee tunnistuksesta valitun tarkoituksen. Huomautus: Tätä muuttujaa tuetaan vain, jos käynnistin on On Select Intent.
Recognizer.TriggeringMessage.Id	string	Sen käyttäjän sanoman tunnus, joka käynnisti nykyisen aiheen
Recognizer.TriggeringMessage.Text	string	Käyttäjän sanoma, joka käynnisti nykyisen aiheen
Recognizer.MultipleTopicsMatchedReason	string	Käytetään määrittämään, miksi useita aiheita yhdistettiin. Huomautus: Tätä muuttujaa tuetaan vain, jos käynnistin on On Select Intent.
SignInReason	valinta	Käytetään määrittämään, mitä kirjautumisvaihtoehtoa tarvitaan aihetta käynnistettäessä. Huomautus: Tätä muuttujaa tuetaan vain, jos käynnistin on On Sign In.
User.Language	valinta	Tätä muuttujaa käytetään määrittämään käyttäjän kielialue keskustelukohtaisesti.

Integroidun todennuksen muuttuvat (oletusarvo)

Seuraavat muuttujat ovat käytettävissä agenteille, jotka on määritetty käyttämään Microsoftin todennusta. Tämä määritys käyttää Microsoft Entra ID-todennusta ja on uusille agenteille oletusarvo.

Lisätietoja: Todennusmuuttujat.

Name	Type	Määritelmä
User.DisplayName	string	Agentin kanssa keskustelevan käyttäjän näyttönimi.
User.Email	string	Agentin kanssa keskustelevan käyttäjän sähköpostiosoite.
User.FirstName	string	Agentin kanssa keskustelevan käyttäjän etunimi.
User.Id	string	Agentin kanssa keskustelevan käyttäjän yksilöivä tunnus.
User.IsLoggedIn	Totuusarvo	Totuusarvomerkintä, joka ilmaisee, onko agentin kanssa keskusteleva käyttäjä todennettu vai ei.
User.LastName	string	Sen käyttäjän sukunimi, joka parhaillaan keskustelee agentin kanssa.
User.PrincipalName	string	Sen käyttäjän täydellinen käyttäjätunnus, joka parhaillaan keskustelee asiakaspalvelija:n kanssa.

Manuaalisen todennuksen muuttujat Generic OAuth 2:n avulla

Seuraavat muuttujat ovat käytettävissä, kun olet määrittänyt agentin käyttämään Generic OAuth 2 -palveluntarjoajaa.

Name	Type	Määritelmä
User.AccessToken	string	Agenttia todennukseen käyttävän käyttäjän käyttöoikeustietue.
User.DisplayName	string	Agentin kanssa keskustelevan käyttäjän näyttönimi.
User.Id	string	Agentin kanssa keskustelevan käyttäjän yksilöivä tunnus.
User.IsLoggedIn	Totuusarvo	Totuusarvomerkintä, joka ilmaisee, onko agentin kanssa keskusteleva käyttäjä todennettu vai ei.

Manuaaliset Microsoft Entra ID -todennuksen muuttujat

Seuraavat muuttujat ovat käytettävissä, kun olet määrittänyt agentin käyttämään Microsoft Entra ID:n palveluntarjoajia (aiemmin Azure Active Directory).

Name	Type	Määritelmä
User.AccessToken	string	Agenttia todennukseen käyttävän käyttäjän käyttöoikeustietue.
User.DisplayName	string	Agentin kanssa keskustelevan käyttäjän näyttönimi.
User.Email	string	Agentin kanssa keskustelevan käyttäjän sähköpostiosoite.
User.FirstName	string	Agentin kanssa keskustelevan käyttäjän etunimi.
User.Id	string	Agentin kanssa keskustelevan käyttäjän yksilöivä tunnus.
User.IsLoggedIn	Totuusarvo	Totuusarvomerkintä, joka ilmaisee, onko agentin kanssa keskusteleva käyttäjä todennettu vai ei.
User.LastName	string	Sen käyttäjän sukunimi, joka parhaillaan keskustelee agentin kanssa.
User.PrincipalName	string	Sen käyttäjän objektin nimi, joka parhaillaan keskustelee agentin kanssa.

Ääniohjattujen agenttien muuttujat

Seuraavat muuttujat ovat käytettävissä vain äänitoimintoja käyttävissä asiakaspalvelijoissa.

Muistiinpano

Lisätietoja ääniominaisuuksia hyödyntävien agenttien muuttujista on ohjeaiheessa Äänimuuttujien käyttö.

Name	Type	Määritelmä
Activity.InputDTMFKeys	string	Puhelimen kautta vastaanotettu DTMF-avaimen raaka-arvo.
Activity.SpeechRecognition.Confidence	luku	Azure Site Recovery -hypoteesin kokonaistuloksen luotettavuuspisteet, 0–1.
Activity.SpeechRecognition.MinimallyFormattedText	string	Azure Site Recovery -hypoteesin tuloksen kevyesti muotoiltu teksti. Esimerkki: Viisisataa dollaria. Sanat kirjoitetaan mutta perustason isot alkukirjaimet ja välimerkit sisällytetään.
Activity.UserInputType	valinta	Käyttäjän viimeisimmän syötteen syöttötyyppi. Arvo voi olla joko, testi, puhe tai DTMF.
Conversation.OnlyAllowDTMF	Totuusarvo	Totuusarvomerkintä, joka ilmaisee, onko äänipalvelu määritettävä vain DTMF-muotoon suorituspalvelussa.
Conversation.SipUuiHeaderValue	string	UUI-otsikkomerkkijono kontekstin siirtämiseen äänipalvelun puhelun alkaessa.