Muuttujien käyttäminen

Tallenna muuttujien avulla asiakkaiden vastauksia ja käytä niiden sisältöä myöhemmin keskustelussa.

Muuttujia voidaan käytätä myös luomaan loogisia lausekkeita, jotka ohjaavat asiakkaan dynaamisesti eri keskustelupoluille. Jos esimerkiksi tallennat asiakkaan nimen muuttujaan nimeltä UserName asiakaspalvelija voi puhutella asiakasta nimeltä keskustelun jatkuessa.

Muuttujia voidaan siirtää myös muihin aiheisiin ja Power Automate -työnkulkuihin ja palauttaa niistä.

Verkkosovellus

Muuttujia voi olla neljällä tasolla tai vaikutusalueella:

• aihe muuttujia voidaan käyttää vain niissä aiheissa, joissa ne on luotu. Tämä vaikutusalue on luotujen muuttujien oletusarvo.
• Yleisiä muuttujia voidaan käyttää kaikissa aiheissa. Voit muuttaa aiheen muuttujan vaikutusaluetta ja tehdä siitä yleisen muuttujan.
• Järjestelmämuuttujat luodaan automaattisesti asiakaspalvelija-tunnuksella. Niissä on tilannetietoja keskustelusta tai käyttäjästä. Ne ovat käytettävissä kaikissa aiheissa.
• Ympäristömuuttujat luodaan ja Power Platform ne ovat vain luku -tilassa Copilot Studio. 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 merkkijonoarvoon , "apples" tuloksena on virhe.

Kun testaat asiakaspalvelija-merkkiä, muuttuja saattaa näkyä tilapäisesti tuntemattomana tyyppinä . Tuntemattomalle muuttujalle ei ole vielä määritetty arvoa.

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

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

Entiteetit

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 valmiisiin 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

Muuttujan luonti

Mikä tahansa solmu, joka pyytää valitsemaan muuttujan tuloksena, kuten Kysymys-solmu, luo automaattisesti tyypiltään sopivan tulosmuuttujan.

Vihje

Solmut on helppo tunnistaa, jos annat niille uudet nimet. Valitse solmun nimikenttä, jos haluat päivittää nimen suoraan siellä. Vaihtoehtoisesti voit valita solmun Lisää-kuvakkeen (…) ja valita sitten valikosta Nimeä uudelleen -kohdan. Voit nimetä solmut uudelleen myös koodieditorissa.

Käynnistin- ja Siirry vaiheeseen -solmuja ei voi nimetä uudelleen.

Solmujen nimet voivat olla enintään 500 merkkiä pitkä.

Käytettävän entiteetin valinta

Kysymyssolmut luodaan oletusarvoisesti monivalintavaihtoehdoilla. Jos haluat käyttää toista valmista tai mukautettua entiteettiä, valitse Tunnista-ruutu ja valitse tietotyyppi, jota asiakaspalvelija kuuntelee.

Muuttujan uudelleennimeäminen

Muuttujille määritetään automaattisesti nimi, kun ne luodaan. Paras käytäntö on antaa muuttujillesi merkitykselliset nimet, jotta niiden tarkoitus on selvä kaikille muille, joiden on säilytettävä asiakaspalvelija.

1. Valitse Muuttujan ominaisuudet -ruudussa avattava muuttuja.

2. Kirjoita Muuttujan nimi -kohdan alle muuttujan uusi nimi.

Aseta muuttuja

Yleensä kysymyssolmua käytetään käyttäjän syötteen tallentamiseen muuttujaan. Saattaa kuitenkin olla tilanteita, joissa haluat asettaa arvon itse. Käytä tällöin Määritä muuttujan arvo -solmua.

1. Valitse Lisää solmu (+), jos haluat lisätä solmun. Valitse sitten Muuttujien hallinta>Määritä muuttujan arvo.

2. Valitse ruutu kohdasta Määritä muuttuja ja valitse sitten Luo uusi muuttuja.

   

   Uusi muuttuja on luotu. Sen tyyppi on tuntematon, kunnes määrität sille arvon.

   

3. Määritä Arvoon-kohdassa arvo jollakin seuraavista vaihtoehdoista:

   • Syötä literaaliarvo.
   • Valitse aiemmin luotu samantyyppinen muuttuja. Tämä toiminto määrittää muuttujalle saman arvon kuin valitsemallasi muuttujalla.
   • Käytä Power Fx -kaavaa Power Fx -kaavat ovat hyödyllisiä monitasoisemmissa tyypeissä, joissa ei voi käyttää literaaliarvoja, kuten taulukko- ja tietuetyypit.

Muistiinpano

Kun asetat merkkijonotyyppimuuttujaa ja kohtaat ristiriidan Aseta muuttuja ja Arvoon -arvojen välillä , näyttöön tulee virhesanoma jaKorjaa tyypin ristiriita - painike. Valitse painike, jos haluat, että Copilot Studio Power Fx epäsuhta ratkaisee automaattisesti kaavan .

Literaaliarvojen käyttö

Sen sijaan, että valitsisit muuttujan arvon, voit kirjoittaa literaaliarvon muuttujan mihin tahansa muuttujaan.

Solmu yrittää tulkita literaaliarvon merkkijonoja, lukuna tai totuusarvona. Esimerkiksi 123 tulkitaan numeroksi. Jos haluat, että se tulkitaan sen sijaan merkkijonoarvoksi, voit laittaa arvon lainausmerkkeihin, esimerkiksi näin: "123".

Joissakin skenaarioissa tai monitasoisempia tyyppejä käytettäessä voit määrittää tietyn tyypin käyttämällä Power Fx -kaavaa.

Muuttujat-ruutu

Muuttujat-ruudussa voit tarkastella kaikkia muuttujia, jotka ovat käytettävissä aiheessa riippumatta siitä, missä solmuissa ne on määritetty tai käytetty. Voit valita kullekin muuttujalle, voiko sen saada arvonsa muista aiheista, palauttaa arvon muihin aiheisiin vai molempia. Muuttuja voidaan valita myös siksi, että sen ominaisuuksia muokataan Muuttujan ominaisuudet -ruudussa.

Voit avata muuttujat-ruudun valitsemalla aiheen valikkorivillä Muuttujat.

Muuttujan ominaisuudet -ruutu

Muuttujan ominaisuudet -ruudussa voit nimetä muuttujan uudelleen, nähdä, missä muuttujaa käytetään, tai muuntaa muuttujan yleiseksi muuttujaksi. Sitä ei voi muuntaa yleisessä muuttujassa takaisin aihemuuttujaksi. Voit myös valita, voiko se vastaanottaa arvoja vai siirtää sen arvon muihin aiheisiin.

Muuttujan ominaisuudet -ruutu avataan valitsemalla muuttuja Muuttujat-ruudussa. Voit myös avata muuttujan ominaisuudet -ruudun valitsemalla muuttujan missä tahansa solmussa.

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ömuuttujia voi käyttää ainoastaan vain luku -tilassa . Asiakaspalvelija tekijät eivät voi muokata ympäristömuuttujaa Copilot Studio. Järjestelmänvalvojat voivat kuitenkin muuttaa ympäristömuuttujien arvoja PowerApps -portaalissa.

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

Tyyppi Copilot Studiossa	Tyyppi PowerAppsissa
Desimaaliluku	Number
JSON	Tunnista tyyppi arvosta. Jos ei Json => Ei määritetty (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.

Ympäristömuuttujia ei voi muokata Copilot Studiossa. Ympäristömuuttujia on muutettava tai määritettävä PowerApps -portaalissa. Copilot Studiosta voit tarkastella tietoja ympäristömuuttujasta Muuttujat-ruudun avulla. Muuttujat-ruudussa on myös linkki alkuperäiseen laatimiskokemukseen.

Ympäristömuuttujien käyttäminen Azure Key Vault -salasanoissa

Ympäristömuuttuja voi viitata avainsäilön salaiseen koodiin. Tämä on erityinen ympäristömuuttuja, johon liittyy yksilöllisiä näkökohtia.

Jos haluat luoda PowerApps -portaalissa salaisen koodin ympäristömuuttujan, määritä sen avainsäilö.

Edellä mainitun määrityksen lisäksi sinun täytyy suorittaa seuraavat toiminnot, jotta voit antaa Copilot Studiolle oikeudet lukea tästä avainsäilöstä:

1. Määritä Microsoft Virtual Agents Service-sovellukselle Key Vault Secrets User-rooli.

2. Jos haluat valtuuttaa kaikki ympäristön asiakaspalvelijat käyttämään salaisuutta, luo salaisuuteen tunniste AllowedEnvironments ja lisää sallitut ympäristötunnukset pilkuilla erotettuina.

3. Jos haluat valtuuttaa vain tietyt ympäristön agentit käyttämään tätä Key Vaultia, luo tunniste AllowedAgents ja aseta asiakaspalvelija-tunniste muotoon {envId}/{schemaName}. Jos arvoja on useita, erota arvot pilkuilla.

Jos saavutat merkkien enimmäismäärän, mutta sinun on silti lisättävä agentteja, lisää toinen tunniste, jolla on kuvaava mutta yksilöllinen nimi (esimerkiksi: AllowedAgents2).

Salaisuuden arvo tallennetaan välimuistiin valintaikkunan suorituspalveluun viiden minuutin ajaksi. Epäonnistuneet luennat tallennetaan välimuistiin 30 sekunniksi.

Varoitus

Lisäämällä salaisuuden asiakaspalvelija saatat paljastaa tämän salaisuuden arvon kaikille käyttäjille, jotka voivat muokata asiakaspalvelija ympäristössä, koska tällaiset käyttäjät voivat muokata asiakaspalvelija palauttaakseen arvon solmussa SendMessage .

Järjestelmämuuttujat

Jokaisessa asiakaspalvelija:ssa on sisäänrakennetut järjestelmämuuttujat, jotka antavat lisätietoja keskustelusta.

Muistiinpano

Lisätietoja ääntä käyttävistä asiakaspalvelija-muuttujista on ohjeaiheessa Äänimuuttujien käyttäminen.

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	Edustaa asiakaspalvelija:n näyttönimi 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	Asiakaspalvelija ympäristötunnus
Bot.Id	string	Asiakaspalvelija tunnus
Bot.Name	string	Asiakaspalvelija nimi
Bot.SchemaName	string	Asiakaspalvelija rakenteen nimi
Bot.TenantId	string	Asiakaspalvelija vuokraajan tunnus
ClientPluginActions	valinta	Kokoelma dynaamisia asiakaslaajennustoimintoja, jotka on otettava huomioon generatiivisessa orkestraatiossa
Conversation.Id	string	Mykyisen keskustelun yksilöivä tunniste
Conversation.InTestMode	boolean	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. Huomautus: Tätä muuttujaa tuetaan vain, jos käynnistin on On Error.
Error.Message	string	Nykyisen virheen 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	boolean	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.
User.Language	valinta	Tätä muuttujaa käytetään määrittämään käyttäjän kielialue keskustelukohtaisesti.
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.

Integroidun todennuksen muuttuvat (oletusarvo)

Seuraavat muuttujat ovat käytettävissä, kun olet määrittänyt asiakaspalvelija todentamaan Microsoft. Tämä käyttää Entra ID -todennusta sekä sallii vain Teams- ja PowerApps -kanavat. Tämä on oletusarvo uusille asiakaspalvelijoille.

Lisätietoja on kohdassa Todennusmuuttujat.

Name	Type	Määritelmä
User.DisplayName	string	Käyttäjän näyttönimi, joka puhuu parhaillaan asiakaspalvelija.
User.Email	string	Sen käyttäjän sähköpostiosoite, joka parhaillaan keskustelee asiakaspalvelija:n kanssa.
User.FirstName	string	Käyttäjän etunimi, joka puhuu parhaillaan asiakaspalvelija.
User.Id	string	asiakaspalvelija:n kanssa parhaillaan keskustelevan käyttäjän yksilöllinen tunnus.
User.IsLoggedIn	boolean	Totuusarvo merkintä, joka ilmaisee, onko asiakaspalvelija-merkin kanssa parhaillaan puhuva käyttäjä todennettu vai ei.
User.LastName	string	Käyttäjän sukunimi, joka puhuu parhaillaan asiakaspalvelija.
User.PrincipalName	string	Sen käyttäjän täydellinen nimi, joka parhaillaan keskustelee asiakaspalvelija:n kanssa.

Manuaalisen todennuksen muuttujat Generic OAuth 2:lla

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

Name	Type	Määritelmä
User.AccessToken	string	Käyttöoikeustietue käyttäjälle, joka todentaa asiakaspalvelija.
User.DisplayName	string	Käyttäjän näyttönimi, joka puhuu parhaillaan asiakaspalvelija.
User.Id	string	asiakaspalvelija:n kanssa parhaillaan keskustelevan käyttäjän yksilöllinen tunnus.
User.IsLoggedIn	boolean	Totuusarvo merkintä, joka ilmaisee, onko asiakaspalvelija-merkin kanssa parhaillaan puhuva käyttäjä todennettu vai ei.

Manuaaliset Microsoft Entra ID -todennuksen muuttujat

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

Name	Type	Määritelmä
User.AccessToken	string	Käyttöoikeustietue käyttäjälle, joka todentaa asiakaspalvelija.
User.DisplayName	string	Käyttäjän näyttönimi, joka puhuu parhaillaan asiakaspalvelija.
User.Email	string	Sen käyttäjän sähköpostiosoite, joka parhaillaan keskustelee asiakaspalvelija:n kanssa.
User.FirstName	string	Käyttäjän etunimi, joka puhuu parhaillaan asiakaspalvelija.
User.Id	string	asiakaspalvelija:n kanssa parhaillaan keskustelevan käyttäjän yksilöllinen tunnus.
User.IsLoggedIn	boolean	Totuusarvo merkintä, joka ilmaisee, onko asiakaspalvelija-merkin kanssa parhaillaan puhuva käyttäjä todennettu vai ei.
User.LastName	string	Käyttäjän sukunimi, joka puhuu parhaillaan asiakaspalvelija.
User.PrincipalName	string	Sen käyttäjän täydellinen nimi, joka parhaillaan keskustelee asiakaspalvelija:n kanssa.

Ääntä käyttävien asiakaspalvelijoiden muuttujat

Seuraavat muuttujat ovat käytettävissä vain ääntä käyttävissä agenteissa.

Muistiinpano

Lisätietoja ääntä käyttävistä asiakaspalvelija-muuttujista on ohjeaiheessa Äänimuuttujien käyttäminen.

Name	Type	Määritelmä
Activity.InputDTMFKeys	string	Puhelimen kautta vastaanotettu DTMF-avaimen raaka-arvo.
Activity.SpeechRecognition.Confidence	luku	ASR-hypoteesin koko tuloksen luotettavuuspisteet, 0–1.
Activity.SpeechRecognition.MinimallyFormattedText	string	ASR-hypoteesin tuloksen hieman 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ötetyyppi. Arvo voi olla joko, testi, puhe tai DTMF.
Conversation.OnlyAllowDTMF	boolean	Totuusarvomerkintä, joka ilmaisee, onko äänipalvelu määritettävä vain DTMF-muotoon suorituspalvelussa.
Conversation.SipUuiHeaderValue	string	UUI-otsikkomerkkijono kontekstin siirtämiseen äänipalvelun puhelun alkaessa.

Muuttujien välittäminen aiheiden välillä

Kun uudelleenohjaat aiheen toiseen, voit siirtää muuttujien arvot alkuperäisen aiheen ja kohdeaiheen välillä. Muuttujien välittäminen aiheiden välillä on erityisen hyödyllistä, kun aiempi aihe on jo kerännyt tietoja, joita myöhempi aihe tarvitsee. Käyttäjät arvostavat sitä, ettei heidän tarvitse vastata samoihin kysymyksiin uudelleen.

Vastaanota arvoja muista aiheista

Kun aihe määrittää muuttujan (esimerkiksi kysymyssolmussa), asiakaspalvelija kysyy käyttäjältä kysymyksen muuttujan arvon täyttämiseksi. Jos asiakaspalvelija on jo saanut arvon aiemmassa aihe, ei ole mitään syytä kysyä kysymystä uudelleen. Tällöin voit asettaa muuttujan muotoon Vastaanota arvoja muista aiheista. Kun toinen aihe uudelleenohjaa tähän aiheeseen, se voi välittää joko muuttujan arvoa (tai literaaliarvoa) tähän muuttujaan ja ohittaa kysymyksen. Käyttäjän kokemus puhua asiakaspalvelija on saumaton.

Tässä esimerkissä käytetään kahta aihetta: Tervehdys ja Puhu asiakkaalle. Molemmat aiheet pyytävät asiakkaan nimeä. Jos Tervehdys-aihe suoritetaan ensin, Puhu asiakkaalle -aihe ohittaa sen kysymyksen. Se käyttää sen sijaan Tervehdys-aiheesta välitettyä muuttujan arvoa.

Tässä on Puhu asiakkaalle -aiheen työnkulku:

Kuten Test asiakaspalvelija -ruudussa näkyy, jos tämä aihe käynnistyy ensin, se kysyy käyttäjältä: "Miksi minun pitäisi soittaa sinulle?" Se tallentaa arvon merkkijonomuuttujaan kutsua userName. userName-muuttuja määritetään myös hakemaan sen arvo muista aiheista. Lopuksi aihe päättyy seuraavaan sanomaan: "Toivottavasti sinulla on hieno päivä, {userName}!"

Tässä on Tervehdys-aiheen työnkulku:

Kuten Test asiakaspalvelija -ruudussa näkyy, jos tämä aihe käynnistyy ensin, se kysyy käyttäjältä: "Mikä on nimesi?" Se tallentaa arvon merkkijonomuuttujaan kutsua UserName. Aihe lähettää viestin: "Mukava tavata, {UserName}!" Tämän jälkeen se ohjaa keskustelun asiakasaiheeseen, joka lähettää viestin: "Toivottavasti sinulla on upea päivä, {userName}!" Huomaa kuitenkin, että Puhu asiakkaalle -aihe ei kysynyt käyttäjän nimeä uudelleen. Se käytti sen sijaan Tervehdys-aiheesta välitettyä UserName-muuttujan arvoa.

Lopuksi tässä toinen keskustelu uudelleen, tällä kertaa Puhu asiakkaalle -aiheen perspektiivistä:

Käydään läpi vaiheet aiheen määrittämiseksi vastaanottamaan arvoja muista aiheista Käytetään nykyistä esimerkkiä, mutta samat vaiheet toimivat aina, kun aiheeseen tarvitaan arvo aiemmasta aiheesta.

Kohdekansion aihe

Kohdeaihe aihe on aihe, johon ohjataan ja joka vastaanottaa arvoja muista aiheista. Tässä esimerkissä kyse on Puhu asiakkaalle -keskustelusta.

1. Luo kohdeaihe tai siirry aiheeseen.

2. Lisää kysymyssolmu ja kirjoita viestiin What should I call you?.

3. Valitse Tunnista-kohdassa valmis entiteetti Henkilön nimi.

4. Valitse muuttuja, jos haluat avata sen muuttujan ominaisuudet -ruudussa. Anna sen nimeksi userName ja valitse sitten Vastaanota arvot muista aiheista.

   

5. Lisää Viesti-solmu.

6. Kirjoita viestiruutuun I hope you're having a wonderful day,.

7. Valitse Lisää muuttuja-kuvake ({x}) ja valitse sitten userName.

8. Valitse muuttujan jälkeinen tila ja kirjoita !.

9. Tallenna aihe.

Valitse lähdeaihe

Lähdeaihe on aihe, joka hoitaa uudelleenohjaamisen, se, joka antaa arvon, joka annetaan kohdeaiheelle. Esimerkissä se on Tervehdys.

1. Siirry lähdeaiheeseen.

2. Lisää Uudelleenohjaus-solmu ja valitse kohde-aihe.

3. Valitse +Lisää syöte ja valitse sitten kohdeaiheesta muuttuja, johon haluat siirtää arvon.

   

4. Valitse >-kuvake ja valitse sitten muuttuja, jonka arvon haluat siirtää.

   

   Uudelleenohjaussolmun tulisi näyttää tältä:

   

5. Tallenna aihe.

Palauta arvot alkuperäisiin aiheisiin

Kun aihe uudelleenohjataan ja saa muuttujan kysymällä kysymyksen tai jollain muulla tavalla, muuttuja voidaan palauttaa alkuperäiseen aiheeseen. Muuttujasta tulee osa alkuperäistä aihetta, ja sitä voi käyttää kuin mitä tahansa muuta muuttujaa. Asiakaspalvelija saama tieto on siten saatavilla eri aiheista, mikä vähentää globaalien muuttujien tarvetta.

Jatketaan edellisen osan esimerkin parissa. Kysymme uuden kysymyksen Puhu asiakkaalle -aiheessa ja palautamme vastauksen sitten Tervehdys-aiheeseen.

Määritä palautetun muuttujan lähdeaihe

Kun palautat muuttujan aiheeseen, lähdeaihe on aihe, johon aihe uudelleenohjataan, se, joka antaa arvon, joka välitetään takaisin alkuperäiseen aiheeseen. Tässä esimerkissä kyse on Puhu asiakkaalle -keskustelusta.

1. Siirry lähdeaiheeseen.

2. Lisää kysymyssolmu ja kirjoita viestiin What city do you live in?.

3. Valitse Tunnista-kohdassa valmis entiteetti Kaupunki.

4. Valitse muuttuja, jos haluat avata sen muuttujan ominaisuudet -ruudussa. Anna sen nimeksi userCity ja valitse sitten Palauta arvot alkuperäisiin aiheisiin.

   

5. Tallenna aihe.

Määritä palautetun muuttujan kohdeaihe

Kun palautat muuttujan aiheeseen, kohdeaihe on aihe, joka suorittaa uudelleenohjauksen, se, joka saa arvoja muista aiheista. Esimerkissä se on Tervehdys.

1. Siirry kohdeaiheeseen.

2. Lähdeaiheessa valitsemasi muuttujan tulisi ilmestyä uudelleenohjaussolmussa tulosmuuttujana.

   

3. Tallenna aihe.

Perinteinen

Entiteetin ja muuttujan tyyppi

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	Merkkijono
Paino	Luku
Postinumero	Merkkijono
Mukautettu entiteetti	Merkkijono

Muuttujan luonti

Lisää kysymyssolmu botinlaatimispohjaan. Muuttuja luodaan automaattisesti solmuun.

1. Siirry botti Aiheet-sivulle ja avaa aihe, johon haluat lisätä muuttujan.

2. Valitse Lisää solmu (+) ja valitse sitten Esitä kysymys.

   

   Järjestelmä luo automaattisesti muuttujan, joka sisältää käyttäjän vastauksen.

   

Käytettävän entiteetin valinta

Oletusarvoisesti kysymyssolmu luodaan käyttäen monivalintavaihtoehtoja. Jos haluat käyttää toista esimääritettyä tai mukautettua entiteettiä, valitse solmusta tunnistettava kohde.

Muuttujan uudelleennimeäminen

Automaattisesti luoduilla muuttujilla on oletusnimi. Jos haluat muuttaa muuttujan nimeä, valitse se, syötä uusi nimi ja valitse Valmis.

Muuttujien käyttö toimintosolmuissa

Kun käytät muuttujaa toimintosolmussa, voit syöttää sen parametriin, jos sen perustyyppi vastaa työnkululle tai Bot Framework -taidolle määritettyä parametrityyppiä. Toimintosolmujen tuloste luo uusia muuttujia.

Literaaliarvojen käyttö toimintosolmuissa

Voit kirjoittaa literaaliarvon muuttujan syöttökenttään toimintosolmussa sen sijaan, että valitsisit muuttujan valikosta.

Arvon jäsentämissolmu

Arvon jäsentämissolmussa voidaan muuntaa tietyntyyppinen arvo toisentyyppiseksi arvoksi. Kun solmu lisätään aiheeseen, ensin valitaan Lisää solmu (+), sitten Muuttujan hallinta ja lopuksi Jäsennä arvo.

Tärkeimmät arvon jäsentämissolmua käyttävät skenaariot keskittyvät JSON- tai kirjoittamattomien raakamuuttujien (joiden arvoa tai rakennetta ei tunneta ennen suorituspalvelua: esimerkiksi ChannelData) muuntamiseen konkreettisiksi tyypeiksi.

Prosessi alkaa, kun työnkulku kutsutaan, ja työnkulku puolestaan kutsuu ohjelmointirajapinnan. Ohjelmointirajapintaa palauttaa sitten tuloksen. Yleensä tämä vastaus on jäsennettävä ja vähintään yksi primitiivimuuttuja palautettava Copilot Studioiin. Arvon jäsennyssolmussa koko ohjelmointirajapintatulos voidaan lähettää merkkijonona.

{
    "Name": "Gary",
    "Position": "PM",
    "Company": "Microsoft",
    "FormerPositions": [{
            "Position": "Engineer"
        }
    ]
}

Näin saatu merkkijonomuuttuja voidaan muuntaa tämän uuden solmun avulla tietuemuuttujaksi, jolla on täydellinen Intellisense-tuki Power Fx:ssä. Näytetietoja hyödyntävä esimerkki auttaa selventämään tätä prosessia.

Arvon jäsentämissolmun käyttöesimerkki

1. Lisää arvon jäsentämissolmu ja valitse jäsennettävä arvo.

   

2. Valitse tietotyyppi. Valitse tässä tapauksessa Näytetiedoista.

   

3. JSON voidaan nyt antaa valitsemalla Nouda rakenne JSON-näytteestä. Tämän kohdan napsauttaminen avaa editorin, jossa voi liittää esimerkin.

   

4. Määritä lopuksi muuttuja, johon jäsennetty arvo sijoitetaan. Yleensä sitä varten luodaan uusi muuttuja.

   

   Huomaa, että tulosmuuttujalla on nyt oikea tyyppi – tietue.

   

Uutta muuttujaa voidaan nyt käyttää. Power Fx -editorissa nähdään, että Intellisense on kokonaisuudessaan käytettävissä eri ominaisuuksissa.

JSON-merkkijonojen jäsentämisen ohella toinen arvon jäsentämissolmun tärkeä käyttötapa on UntypedObjects-jäsennys suorituksen aikana. Yleisin näistä on tapahtuman vastaanottaminen ja tapahtuman arvon jäsentäminen. Tai sitten on jäsennettävä System.Activity.ChannelData-ominaisuus, joka vaihtelee suorituksen aikana kanavakohtaisesti.

Seuraavassa esimerkissä, jos tapahtuma tulee Teamsista, on käytettävä Teamsin kehittäjien ohjeita ja etsittävä esimerkki saapuvan tapahtuman ulkoasusta. Tämän jälkeen käytetään esimerkkitietoja tämän osan ohjeiden mukaisesti.

Muuttujien välittäminen aiheiden välillä

Kun käytät uudelleenohjausta muihin aiheisiin, voit väittää arvoja kohdeaiheen muuttujiin tai noutaa sieltä muuttujia. Muuttujien välittäminen aiheiden välillä on erityisen hyödyllistä, kun sinulla on jo tietoja, joita aihe tarvitsee. Käyttäjät arvostavat sitä, ettei heidän tarvitse vastata kysymykseen uudelleen. Siitä on hyötyä myös silloin, refaktoroit aiheitasi ja erittelet niitä uudelleenkäytettäviksi komponenteiksi ja haluat välittää muuttujia aiheiden välillä.

Huomautus

Tyyppien Custom Entity, Date and Time, Duration ja Multiple-choice muuttujia ei voi välittää aiheiden välillä.

Vastaanota arvoja muista aiheista

Kun aihe määrittää muuttujan (esimerkiksi kysymyssolmun avulla), botti kysyy käyttäjältä kysymyksen muuttujan arvon täyttämistä varten. Jos botti on jo saanut arvon, kysymystä ei tarvitse esittää uudelleen. Tällöin voit määrittää muuttujan muotoon Vastaanota arvoja muista aiheista. Kun toinen aihe uudelleenohjaa tähän aiheeseen, se voi välittää muuttujan (tai literaaliarvoja) tähän muuttujaan ja ohittaa kysymyksen. Kokemus on saumaton botin kanssa keskustelevalle käyttäjälle.

Jos haluat vastaanottaa arvoja muista aiheista, määritä muuttujan ominaisuus:

1. Valitse Kysymys-solmussa se muuttuja, johon haluat vastaanottaa arvoja muista aiheista.

2. Valitse Muuttujan ominaisuudet -ruudun kohdassa Aihe (rajoitettu vaikutusalue) Vastaanota arvoja muista aiheista.

   

3. Tallenna aihe.

4. Siirry aiheeseen, johon haluat uudelleenohjata. Noudata Ohjaa uudelleen toiseen aiheeseen -kohdan suorittaaksesi uudelleenohjauksen oikeaan aiheeseen.

5. Valitse + Lisää syöte kohdeaihetta varten.

   

6. Valitse uudelleenohjatusta aiheesta muuttuja, johon haluat välittää muuttujan.

   

7. Valitse Syötä tai valitse arvo -kohdassa se nykyisen aiheen muuttuja, jonka haluat välittää uudelleenohjattuun aiheeseen.

   

   Muuttuja näkyy uudelleenohjatussa solmussa.

   

Palauta arvot alkuperäisiin aiheisiin

Kun aihe esittää kysymyksen tai hankkii muuttujan toiminnosta muulla tavalla, muuttujan voi palauttaa alkuperäiseen aiheeseen, josta siihen uudelleenohjattiin.

Tällöin muuttujasta tulee myös osa alkuperäistä aihetta, ja sitä voi käyttää kuin mitä tahansa muuta muuttujaa. Tämä auttaa sinua rakentamaan aiheen siten, että botin hankkimat tiedot ovat käytettävissä kaikissa aiheissa, mikä vähentää yleisten muuttujien tarvetta.

Jos haluat palauttaa muuttujan alkuperäiseen aiheeseen, määritä muuttujan ominaisuus:

1. Valitse Kysymys-solmussa se muuttuja, johon haluat vastaanottaa arvoja muista aiheista.

2. Valitse Muuttujan ominaisuudet -ruudun kohdassa Aihe (rajoitettu vaikutusalue) Palauta arvoja alkuperäisiin aiheisiin.

   

3. Tallenna aihe.

4. Siirry aiheeseen, johon haluat uudelleenohjata. Noudata Ohjaa uudelleen toiseen aiheeseen -kohdan suorittaaksesi uudelleenohjauksen oikeaan aiheeseen.

   Aiheeseen palautettava muuttuja näytetään uudelleenohjatussa aiheessa. Käytä palautettua muuttujaa aiheessasi.

   

Muuttujat-ruudun käyttö

Voit valita useiden muuttujien vastaanotto- tai palautustilan samanaikaisesti käyttämällä Muuttujat-ruutua.

1. Valitse aiheen valikkopalkista Muuttujat.

   

2. Valitse kunkin aiheen muuttujan osalta, haluatko, että arvoja välitetään tai vastaanotetaan aiheiden välillä tai molempia.

   

Literaaliarvojen käyttö muuttujien syötteissä

Voit välittää aiheeseen sekä literaaliarvoja että muuttujia. Jos haluat välittää literaaliarvon, kirjoita haluamasi arvo syötteeksi sen sijaan, että valitsisit muuttujan.

Liittyvä sisältö

• Muuttujien käyttäminen siirrettäessä sisältöä aiheiden välillä
• Mukauta asiakaspalvelija:n ulkoasua ja tuntumaa