Käytä muuttujia

Tärkeää

Power Virtual Agents -ominaisuudet ja -toiminnot ovat nyt Microsoft Copilot Studion osa generatiiviseen tekoälyyn tehtyjen panostusten ja parannettujen Microsoft Copilot -integrointien jälkeen.

Joissakin artikkeleissa ja näyttökuvissa voidaan viitata Power Virtual Agentsiin, kun ohjeita ja koulutussisältöä päivitetään.

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. Tallenna esimerkiksi asiakkaan nimi UserName-nimiseen muuttujaan, niin avustaja pystyy kutsumaan asiakasta nimellä, kun keskustelu jatkuu.

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

Muuttujia voi olla kolmessa tasossa tai vaikutusalueessa:

  • 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 avustajan kanssa. Niissä on tilannetietoja keskustelusta tai käyttäjästä. Ne ovat käytettävissä kaikissa aiheissa.

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, jotka on liitetty synonyymeihin
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ää sille Merkkijono-arvon "apples", seurauksena on virhe.

Kun testaat avustajaa, 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. Sisällön tuotantoalustan yläreunassa on solmuja, joita käytetään ennen kuin alareunan solmut. Kun luot haaroja ehto-solmuilla, haarat tilataan vasemmalta oikealle. Vasemmanpuoleisimmassa haarassa solmut katsotaan ennen kuin oikeanpuoleisimman haaran solmut.

Entiteetit

Microsoft 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 esitetty valmiiksi luotuihin 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.

Näyttökuva kysymyssolmusta, jossa on korostettuna oletusmuuttujan nimi ja tyyppi.

Käytettävän entiteetin valinta

Kysymys-solmut luodaan oletusarvoisesti käyttäen monivalintavaihtoehtoja. Voit käyttää toista esimääritettyä tai mukautettua entiteettiä valitsemalla Tunnista-ruutu ja valitsemalla avustajan kuuntelemien tietojen tyyppi.

Näyttökuva kysymyssolmusta, jossa on Valitse tiedot tunnistettaviksi -valikko ja Henkilön nimi -kohde korostettuna.

Muuttujan uudelleennimeäminen

Muuttujille määritetään automaattisesti nimi, kun ne luodaan. Paras käytäntö on antaa muuttujille merkitykselliset nimet, jolloin kaikki avustajaa myöhemmin ylläpitävät tietävät muuttujien tarkoituksen.

  1. Valitse muuttuja, jos haluat avata sen muuttujan ominaisuudet -ruudussa.

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

Aseta muuttuja

Yleensä käyttäjän syöte tallennetaan muuttujaksi Kysymys-solmun avulla. Joissakin tilanteissa haluat kuitenkin määrittää arvon itse. Käytä tällöin Määritä muuttujan arvo -solmua.

  1. Valitse Lisää solmu (+), kun haluat lisätä solmun, ja valitse sitten Aseta muuttujan arvo.

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

    Näyttökuva Luo uusi muuttuja -painikkeesta.

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

    Näyttökuva Määritä muuttuja arvo -solmusta, jossa on uusi muuttuja, jonka tyyppiä ei tiedetä.

  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.

Literaaliarvojen käyttö

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

Näyttökuva, jossa näkyy, miten productName-nimisen muuttujan arvona on literaali.

Näyttökuva, jossa näkyy literaaliarvo syötteenä uudelleenohjaussolmun muuttujassa.

Solmu yrittää tulkita merkkijono-, luku- tai totuusarvotyyppeinä syötettyjä literaaliarvoja. 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. Voit myös valita muuttujan muokataksesi sen ominaisuuksia Muuttujan ominaisuudet -ruudussa.

Voit avata muuttujat-ruudun valitsemalla aiheen valikkorivillä Muuttujat.

Näyttökuva Muuttujat-ruudusta Microsoft Copilot Studio -laatimispohjassa, jossa Muuttujat-painike näkyy korostettuna.

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.

Jos haluat avata muuttujan ominaisuudet -ruudun, valitse muuttuja muuttuja-ruudusta. Voit myös avata muuttujan ominaisuudet -ruudun valitsemalla muuttujan missä tahansa solmussa.

Näyttökuva muuttujan ominaisuusruudusta.

Järjestelmämuuttujat

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

Näyttökuva avustajan aiheen järjestelmämuuttujista.

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ä. Esimerkiksi järjestelmämuuttujan User.DisplayName sisällyttämiseksi kaavaan, sen viittauksen tulee olla System.User.DisplayName.

Name Type Piilotettu Määritelmä
Activity.Channel valinta näkyvä Nykyisen keskustelun kanavatunnus
Activity.ChannelData mikä tahansa piilotettu Objekti, joka sisältää kanavakohtaista sisältöä
Activity.ChannelId string piilotettu Nykyisen keskustelun kanavatunnus merkkijonona
Activity.From.Id string piilotettu Lähettäjän kanavakohtainen yksilöllinen tunnus
Activity.From.Name string piilotettu Lähettäjän kanavakohtainen käyttäjäystävällinen nimi
Activity.Name string näkyvä Tapahtuman nimi
Activity.Text string näkyvä Käyttäjän viimeksi lähettämä viesti
Activity.Type valinta näkyvä Aktiviteetin tyyppi
Activity.TypeId string piilotettu Aktiviteetin tyyppi merkkijonona
Activity.Value mikä tahansa piilotettu Avoin arvo
Bot.Name string näkyvä Avustajan nimi
Channel.DisplayName string piilotettu Kanavan näyttönimi
Conversation.Id string näkyvä Mykyisen keskustelun yksilöivä tunniste
LastActivity.Id string näkyvä Aiemmin lähetetyn aktiviteetin tunnus
LastMessage.Id string näkyvä Käyttäjän edellisen viestin tunnus
LastMessage.Text string näkyvä Käyttäjän edellinen viesti
Recognizer.TriggerMessage.Id string näkyvä Sen käyttäjän sanoman tunnus, joka käynnisti nykyisen aiheen
Recognizer.TriggerMessage.Text string näkyvä Käyttäjän sanoma, joka käynnisti nykyisen aiheen
User.DisplayName string näkyvä Kirjautuneen käyttäjän näyttönimi

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 Kysymys-solmun avulla), avustaja esittää käyttäjälle kysymyksen muuttujan arvon täyttämistä varten. Jos avustaja on jo saanut arvon aiemmin aiheessa, kysymystä ei tarvitse esittää 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. Kokemus on saumaton avustajan kanssa keskustelevalle käyttäjälle.

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:

Näyttökuva Puhu asiakkaalle -aiheen keskustelun työnkulusta.

Kuten Testaa avustaja -ruudussa nähtiin, jos tämä aihe käynnistyy ensimmäiseksi, se esittää käyttäjälle Millä nimellä voin kutsua sinua? -kysymyksen. Arvo tallennetaan merkkijonomuuttujaan nimeltä 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:

Näyttökuva Tervehdys-aiheen keskustelun työnkulusta.

Kuten Testaa avustaja -ruudussa nähtiin, jos tämä aihe käynnistyy ensimmäiseksi, se esittää käyttäjälle Mikä on nimesi? -kysymyksen. Arvo tallennetaan merkkijonomuuttujaan nimeltä 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ä:

Näyttökuva Puhu asiakkaalle -aiheen keskustelun työnkulusta, kun Tervehdys-aihe käynnistyy ensin.

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.

    Näyttökuva Keskustelu asiakkaan kanssa -aiheesta, jossa on userName-muuttuja ja sen ominaisuudet korostettuina.

  5. Viestisolmun lisääminen.

  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ää uudelleenohjaussolmu ja valitse kohdeaihe.

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

    Näyttökuva Tervehdys-aiheesta, jossa userName-muuttuja on lisätty syötteenä uudelleenohjaussolmuun.

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

    Näyttökuva Tervehdys-aihesta, jossa UserName-muuttujan arvo on valittu.

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

    Näyttökuva Tervehdys-aiheesta, jossa uudelleenohjaussolmu on valmis.

  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. Avustajan saamat tiedot ovat aiheiden käytettävissä, joten yleisten muuttujien tarve vähenee.

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.

    Näyttökuva Keskustelu asiakkaan kanssa -aiheesta, jossa on userCity-muuttuja ja sen ominaisuudet korostettuina.

  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.

    Näyttökuva Tervehdys-aiheen keskustelun työnkulusta, jossa on palautettu muuttuja uudelleenohjaussolmussa.

  3. Tallenna aihe.