Muuttujien yleiskatsaus

Huomautus

Tämän artikkelin ominaisuudet perustuvat standardivaljaisiin, jotka käyttävät Lisensointi-osiossa kuvattuja laskutusvaihtoehtoja agenteille, jotka käyttävät standardivaljasta. Opi, miten pääset käsiksi standardeihin liittyviin ominaisuuksiin Accessin standardiagenteissa ja agenttivirroissa.

Muuttujia on neljällä tasolla tai vaikutusalueella:

  • Aihemuuttujia voi käyttää vain aiheissa, joissa ne on luotu. 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 ovat Copilot Studion agentille automaattisesti luomia muuttujia. Niissä on tilannetietoja keskustelusta tai käyttäjästä. Ne ovat käytettävissä kaikissa aiheissa.
  • Ympäristömuuttujat luodaan Power Platformissa. Ne ovat vain luku -tilassa Copilot Studio -ohjelmassa. Ne tallentavat parametrin avaimet ja arvot, jotka tämän jälkeen toimivat muiden sovellusobjektien, mukaan lukien Copilot Studio, syötteinä. Erottamalla parametrit kulutuskohteista voit muuttaa arvoja samassa ympäristössä tai siirrettäessä ratkaisuja muihin ympäristöihin. Vaihtoehto on jättää kiinteät parametriarvot niitä käyttäville osille.

Muuttujatyypit

Kullakin muuttujalla on perustyyppi. Tyyppi määrittää, mitä arvoja muuttajalla voi olla, ja operaattorit, joita voidaan käyttää, kun sen avulla muodostetaan looginen lauseke.

Tyyppi Kuvaus
merkkijono Merkkijono, jota käytetään kuvaamaan tekstiä
totuusarvo Looginen arvo, joka voi olla vain true tai false
Numero Mikä tahansa reaaliluku
Taulukko Arvoluettelo, mutta kaikkien arvojen on oltava samantyyppisiä
Tallenna 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 "ei arvoa" tai "tuntematon arvo"; lue lisää Blankissa Power FX -dokumentaatiossa

Muuttujan tyyppi määritetään, kun sille määritetään arvo ensimmäisen kerran. Tämän jälkeen tyyppi on pysyvä eikä minkään muun tyypin arvoja voida määrittää. Jos muuttujalle määritetään esimerkiksi aloitusarvo 1, sen tyypiksi määritetään Luku. Jos sitten yritetään määrittää Merkkijono-arvo, kuten "apples", seurauksena on virhe.

Agenttia testattaessa muuttujan tyyppinä voi tilapäisesti näkyä tuntematon. Tuntemattomalla muuttujalla ei vielä ole arvoa.

Muuttujien järjestys määräytyy kirjoittajan kankaan yläosasta alas. Agentti tarkastelee solmuja kirjoittajan kankaan yläosassa ennen solmuja alareunassa.

Kun luot haaroja käyttämällä Condition-solmuja, Copilot Studio järjestää haarat vasemmalta oikealle. Agentti tarkastelee solmuja vasemmanpuoleisimmassa haarassa ennen oikeanpuoleisimman haaran solmuja.

Entiteetit

Copilot Studio käyttää entiteettejä tiettyjen tietotyyppien 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.

Kokonaisuus Muuttujan perustyyppi
Monivalinnan vaihtoehdot Valinta
Käyttäjän koko vastaus merkkijono
Ikä Numero
totuusarvo totuusarvo
City merkkijono
Väri merkkijono
Maanosa merkkijono
Maa tai alue merkkijono
Päivämäärä ja aika DateTime
Email merkkijono
Tapahtuma merkkijono
Kokonaisluku Kokonaisluku
Kieli merkkijono
Raha Numero
Numero Numero
Järjestysluku Numero
Organisaatio merkkijono
Prosenttiosuus Numero
Henkilön nimi merkkijono
Puhelinnumero merkkijono
Kiinnostuksen kohde merkkijono
Nopeus Numero
Osavaltio merkkijono
Katuosoite merkkijono
Lämpötila Numero
osoite merkkijono
Paino Numero
Postinumero merkkijono
Mukautettu entiteetti Valinta

Ympäristömuuttujat

Ympäristömuuttujat ovat Power Platform -käsitteitä. 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 muutamia keskeisiä ulkoisia viittauksia, jotka eroavat lähde- ja kohdeympäristön välillä.

Käytä ympäristömuuttujia samalla tavalla kuin aihe-, globaali- ja järjestelmämuuttujia. Yksi merkittävä ero on se, että ympäristömuuttujat ovat vain luku -muotoisia Copilot Studiossa. Agentin tekijät eivät voi muokata ympäristömuuttujia Copilot Studiossa. Järjestelmänvalvojat voivat kuitenkin muuttaa ympäristömuuttujien arvoa Power Appsissa. Copilot Studion muuttujapaneelissa voi tarkastella ympäristömuuttujaa koskevia tietoja. Muuttujan ominaisuuspaneelissa on myös linkki Power Appsiin, joka on ympäristömuuttujien laatimiskokemus.

Agentin julkaistu versio, joka käyttää ympäristömuuttujia, sisältää ne arvot, jotka asetat näille muuttujille agentin julkaisun yhteydessä. Aina kun ylläpitäjä päivittää ympäristömuuttujia, sinun täytyy julkaista uudelleen kaikki agentit, jotka käyttävät näitä muuttujia, jotta muutokset astuvat voimaan ajonaikaisesti. 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.

Copilot Studioin ympäristömuuttujatyypit yhdistetään Power Appsin tietotyyppeihin seuraavasti:

Kirjoita Copilot Studioon Kirjoita Power Appsiin
Desimaaliluku Numero
JSON Tunnista tyyppi arvosta. Jos ei JSON => Määrittelemätön (tarkistusvirhe)
Teksti merkkijono
Kyllä/ei totuusarvo
Tietolähde merkkijono
Salainen koodi merkkijono

Huomautus

Näet ympäristömuuttujan virheitä testichatissa ja julkaisun aikana. Nämä virheet eivät kuitenkaan näy aihe-listassa, koska ympäristömuuttujat eivät ole aihemuuttujia.

Järjestelmämuuttujat

Jokaisessa agentissa on sisäänrakennettuja järjestelmämuuttujia, jotka tarjoavat lisätietoja keskustelusta.

Kuvakaappaus järjestelmämuuttujista aiheessa.

Copilot Studio ei näytä kaikkia järjestelmämuuttujia. Piilotettuja järjestelmämuuttujia voidaan käyttää Power Fx -kaavalla.

Power Fx -kaavan järjestelmämuuttujia käytetään lisäämällä System. ennen muuttujan nimeä. Jos esimerkiksi haluat sisällyttää järjestelmämuuttujan User.DisplayName kaavaan, viittaa siihen nimellä System.User.DisplayName.

Nimi Tyyppi Määritelmä
Toiminto.Liitteet taulukko Käyttäjän toimittamat tiedostoliitteet.
Aktiviteetti.Kanava valinta Nykyisen keskustelun kanavatunnus.
Activity.Kanavatiedot mikä tahansa Objekti, joka sisältää kanavakohtaista sisältöä.
Activity.ChannelId merkkijono Nykyisen keskustelun kanavatunnus merkkijonona.
Activity.From.Id merkkijono Lähettäjän kanavakohtainen yksilöllinen tunnus.
Activity.From.Name merkkijono Lähettäjän kanavakohtainen käyttäjäystävällinen nimi.
Toiminto.Nimi merkkijono Tapahtuman nimi.
Activity.Recipient.Id merkkijono Saapuvan aktiviteetin tyyppiominaisuus.
Activity.Recipient.Name merkkijono Määrittää agentin näyttönimen kanavassa. Puhelinkanavakontekstissa tämän muuttujan arvo on puhelinnumero, johon asiakaspalvelija on liitetty.
Toiminto.Text merkkijono Käyttäjän viimeksi lähettämä viesti.
Aktiviteetti.Tyyppi valinta Aktiviteetin tyyppi.
Aktiivisuus.TyyppiId merkkijono Aktiviteetin tyyppi merkkijonona.
Activity.Value mikä tahansa Avoimeksi jätetty arvo.
Bot.EnvironmentId merkkijono Agentin ympäristötunnus.
Bot.Id merkkijono Agentin tunnus.
Bot.Name merkkijono Edustajasi nimi.
Bot.SchemaName merkkijono Agentin skeeman nimi.
Bot.TenantId merkkijono Agentin vuokralaisen tunnus.
ClientPluginActions valinta Kokoelma dynaamisia asiakaslaajennustoimintoja, jotka on otettava huomioon generatiivisessa orkestraatiossa.
Conversation.Id merkkijono Mykyisen keskustelun yksilöivä tunniste.
Keskustelu.Testitilassa totuusarvo Totuusarvomerkintä, joka ilmaisee, tapahtuuko keskustelu testikaaviossa.
Conversation.LocalTimeZone merkkijono Käyttäjän IANA-aikavyöhykkeen tietokantamuodossa käyttämän aikavyöhykkeen nimi.
Conversation.LocalTimeZoneOffset päivämäärä/aika Nykyisen paikallisen aikavyöhykkeen aikasiirtymä UTC-ajasta.
Error.Code merkkijono Nykyisen virheen virhekoodi.
Nykyiselle virheelle määritetty virhesanoma.
Virhe.Viesti merkkijono Nykyiselle virheelle määritetty virhesanoma.
Huomautus: tätä muuttujaa tuetaan vain, jos käynnistin on On Error.
FallbackCount numero 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 Boolean-arvomerkki, joka ilmaisee, tarvitseeko ajastimen jatkamista.
Huomautus: tätä muuttujaa tuetaan vain, jos käynnistin on Inactivity.
InactivityTimer.Count numero Kuinka monta kertaa OnInactivity-ajastin käynnistyi käyttäjän käyttämättömyyden vuoksi määritetyn ajan kuluttua.
Huomautus: tätä muuttujaa tuetaan vain, jos käynnistin on Inactivity. Lue lisätietoja Toimettomuus-käynnistimestä.
LastMessage.Id merkkijono Käyttäjän lähettämän edellisen viestin tunnus.
ViimeinenViestiteksti merkkijono Käyttäjän lähettämä 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 aievaihtoehdot, kun tunnistus palauttaa epäselviä 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 merkkijono Sen käyttäjän sanoman tunnus, joka käynnisti nykyisen aiheen.
Recognizer.TriggeringMessage.Text merkkijono Käyttäjän sanoma, joka käynnisti nykyisen aiheen.
Tunnistin.Useita aiheita vastine sekasyy merkkijono Käytetään määrittämään, miksi useita aiheita yhdistettiin.
Huomautus: tätä muuttujaa tuetaan vain, jos käynnistin on On Select Intent.
Kirjautumissyy 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.
Käyttäjä.Kieli valinta Tätä muuttujaa käytetään määrittämään käyttäjän kielialue keskustelukohtaisesti.

Ääniohjattujen agenttien muuttujat

Seuraavat muuttujat ovat käytettävissä vain äänitoimintoja käyttävissä asiakaspalvelijoissa. Lue lisää aiheesta Käytä äänimuuttujia.

Nimi Tyyppi Määritelmä
Activity.InputDTMFKeys merkkijono Puhelimen DTMF-avaimen raaka-arvo.
Activity.Puheentunnistus.Luotettavuus numero Automaattisen puheentunnistuksen hypoteesin luottamuspisteet koko tulos, 0–1.
Activity.SpeechRecognition.MinimallyFormattedText merkkijono Hieman muotoiltu teksti automaattisen puheentunnistushypoteesin tuloksesta. Esimerkiksi Viisisataa dollaria. Sanat on kirjoitettu, mutta peruskirjainkoko ja välimerkit ovat mukana.
Toiminto.KäyttäjänSyöttöTyyppi valinta Agentin käyttäjän viimeisimmän syötteen tyyppi. Arvo voi olla joko testi, puhe tai DTMF.
Keskustelu.SalliVainDTMF totuusarvo Boolean-lippu, joka ilmaisee, onko puheentunnistusjärjestelmä määritettävä DTMF-tilaan ajonaikaisesti.
Conversation.SipUuiHeaderValue merkkijono UUI-otsikkomerkkijono kontekstin siirtämiseen äänipalvelun puhelun alkaessa.

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 uusien agenttien oletusarvo. Lue lisää autentikointimuuttujista.

Nimi Tyyppi Määritelmä
Käyttäjä.Näyttönimi merkkijono Agentin kanssa keskustelevan käyttäjän näyttönimi.
Käyttäjä.Sähköposti merkkijono Agentin kanssa keskustelevan käyttäjän sähköpostiosoite.
Kayttaja.Etunimi merkkijono Agentin kanssa keskustelevan käyttäjän etunimi.
User.Id merkkijono 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.
Käyttäjä.Sukunimi merkkijono Sen käyttäjän sukunimi, joka parhaillaan keskustelee agentin kanssa.
User.PrincipalName merkkijono Sen käyttäjän pääasiallinen käyttäjänimi, joka parhaillaan keskustelee asiakaspalvelijan kanssa.

Manuaaliset yleisen OAuth 2 -todennuksen muuttujat

Seuraavat muuttujat ovat niiden agenttien käytettävissä, jotka on määritetty käyttämään yleistä OAuth 2 -palveluntarjoajaa.

Nimi Tyyppi Määritelmä
User.AccessToken merkkijono Agenttia todennukseen käyttävän käyttäjän käyttöoikeustietue.
Käyttäjä.Näyttönimi merkkijono Agentin kanssa keskustelevan käyttäjän näyttönimi.
User.Id merkkijono 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.

Manuaalisen todennuksen muuttujat Microsoft Entra ID:n avulla

Seuraavat muuttujat ovat niiden agenttien käytettävissä, jotka on määritetty käyttämään Microsoft Entra ID (aiemmin Azure Active Directory) -palveluntarjoajia.

Nimi Tyyppi Määritelmä
User.AccessToken merkkijono Agenttia todennukseen käyttävän käyttäjän käyttöoikeustietue.
Käyttäjä.Näyttönimi merkkijono Agentin kanssa keskustelevan käyttäjän näyttönimi.
Käyttäjä.Sähköposti merkkijono Agentin kanssa keskustelevan käyttäjän sähköpostiosoite.
Kayttaja.Etunimi merkkijono Agentin kanssa keskustelevan käyttäjän etunimi.
User.Id merkkijono 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.
Käyttäjä.Sukunimi merkkijono Sen käyttäjän sukunimi, joka parhaillaan keskustelee agentin kanssa.
User.PrincipalName merkkijono Sen käyttäjän pääasiallinen nimi, joka parhaillaan keskustelee agentin kanssa.
  • Last updated on