Jaa

Muuttujien käyttäminen

  • Artikkeli

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 customerName-nimiseen muuttujaan, niin agentti pystyy kutsumaan asiakasta nimellä, kun keskustelu jatkuu.

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

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.

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

Kysymys-solmut luodaan oletusarvoisesti käyttäen monivalintavaihtoehtoja. Jos haluat käyttää eri esimääritettyä tai mukautettua entiteettiä, valitse Tunnista-ruutu ja valitse, minkä tyyppisiä tietoja asiakaspalvelija kuuntelee.

Näyttökuva kysymyssolmusta, jonka Valitse tunnistettavat tiedot -ruutu on avoinna.

Muuttujan uudelleennimeäminen

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

  1. Valitse Muuttujan ominaisuudet -ruudussa avattava muuttuja.

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

Aseta muuttuja

Yleensä Kysymys-solmua käytetään käyttäjän syötteen tallentamiseksi muuttujaan. Saattaa kuitenkin olla tilanteita, joissa haluat asettaa muuttujan 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.

    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.

Muistiinpano

Jos merkkijonotyyppimuuttujaa määritettäessä ilmenee ristiriita Määritä muuttuja- ja Arvoon-arvojen välillä , näyttöön tulee virhesanoma ja Korjaa tyypin ristiriita -painike. Valitse painike, jos haluat, että Copilot Studio luo automaattisesti ristiriidan korjaavan Power Fx -kaavan automaattisesti.

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.

Näyttökuva toimintosolmusta, jossa on taitotoimintoa varten syöte- ja tulosparametrit.

Literaaliarvojen käyttö muuttujien syötteissä

Solmuissa, joissa voit määrittää arvon syöteparametreille, voit aina syöttää kirjaimellisen arvon sen sijaan, että valitsisit toisen muuttujan arvoksi.

Näyttökuva, jossa näytetään, miten literaaliarvoa käytetään productName-nimisen muuttujan syöteparametrina.

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 (esimerkiksi skenaarioissa, joissa käytetään monimutkaisia tyyppejä), saatat tarvita Power Fx -kaavan määrittämään tietyn tyypin.

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

Ympäristömuuttuja voi viitata avainsäilön salaiseen koodiin. Salaiset ympäristömuuttujat ovat ympäristömuuttujien erityistapaus, jossa on erityisiä huomioon otettavia seikkoja.

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

Jotta voit valtuuttaa Copilot Studion tämän avainsäilön lukemiseen, suorita seuraavat toimet:

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

  2. Jos haluat antaa kaikille ympäristön agenteille oikeudet salaisuuden käyttöön, luo salaisuudelle AllowedEnvironments-tunniste ja lisää sallitut ympäristötunnukset pilkuilla eroteltuna.

  3. Jos haluat antaa oikeudet vain tietyille ympäristön agenteille tämän avainsäilön käyttöä varten, luo AllowedAgents-tunniste ja aseta agentin tunniste muodossa {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 agenttiin voit näyttää tämän salaisuuden arvon kaikille käyttäjille, jotka voivat muokata agenttia ympäristössä, koska nämä käyttäjät voivat muokata agenttia palauttaakseen arvon SendMessage-solmussa.

Muuttujat-ruutu

Muuttujat-ruudussa voit tarkastella kaikkia aiheen käytettävissä olevia muuttujia riippumatta siitä, missä solmuissa ne on määritetty tai niitä on 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.

Näyttökuva Muuttujat-ruudusta 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. Et kuitenkaan voi muuntaa yleistä muuttujaa takaisin aihemuuttujaksi. Voit myös valita, voiko aihemuuttuja vastaanottaa arvoja tai siirtää sen arvon muille aihemuuttujille.

Jos haluat avata Muuttujan ominaisuudet -ruudun muuttujalle, valitse haluamasi muuttuja Muuttujat-ruudussa. Voit myös avata muuttujan ominaisuudet -ruudun valitsemalla muuttujan missä tahansa solmussa.

Muuttujien välittäminen aiheiden välillä

Kun ohjaat yhden aiheen toiseen, voit siirtää muuttujien arvot alkuperäisestä aiheesta kohdeaiheeseen ja palauttaa arvot kohdeaiheesta alkuperäiseen aiheeseen. 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-solmussa), agentti kysyy käyttäjältä kysymyksen muuttujan arvon täyttämistä varten. Jos agentti 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 agentin 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 testiruudussa näkyy, jos tämä ohjeaihe käynnistyy ensin, se kysyy käyttäjältä: "Miksi minun tulisi kutsua sinua?" Se tallentaa arvon merkkijonomuuttujaan nimeltä customerName. CustomerName-muuttuja määritetään myös hakemaan sen arvo muista aiheista. Aihe päättyy tähän sanomaan: "Toivottavasti sinulla on hieno päivä, customerName!"

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

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

Kuten testiruudussa näkyy, jos tämä ohjeaihe käynnistyy ensin, se kysyy käyttäjältä: "Mikä sinun nimesi on?" Se tallentaa arvon merkkijonomuuttujaan nimeltä customerName. Aihe lähettää viestin, "Hauska tavata sinut, customerName!" Sen jälkeen se ohjaa aiheeseen Puhu asiakkaalle, joka lähettää viestin: "Toivottavasti sinulla on hieno päivä, customerName!" Huomaa kuitenkin, että Puhu asiakkaalle -aihe ohitti käyttäjän nimen pyytämisen uudelleen. Se käytti sen sijaan tervehdys-aiheesta välitettyä muuttujan arvoa customerName.

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 Esimerkkiskenaariossa käytetään valmiiksi määritettyä 'Tervehdys-aihetta lähdeaiheena ja uutta Puhu asiakkaalle -aihetta kohdeaiheena, mutta samat vaiheet toimivat kaikille aiheille, joissa aiemmassa aiheessa on oltava arvo, jos mahdollista.

Kohdekansion aihe

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

  1. Luo uusi aihe ja anna sen nimeksi "Puhu asiakkaalle".

  2. Lisää herätinlauseita, kuten "puhu minulle", "puhu kanssani", "keskustele kanssani".

  3. Lisää kysymys-solmu ja kirjoita viestiksi "Miten minun pitäisi kutsua sinua?".

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

  5. Valitse muuttujan nimi. Muuttujan ominaisuudet -paneeli avautuu.

  6. Korvaa oletusnimi "customerName"-nimellä ja valitse sitten Vastaanota arvot muista aiheista.

    Näyttökuva Muuttujan ominaisuudet -ruudusta, jossa näkyy customerName-muuttuja ja sen ominaisuudet.

  7. Viesti-solmun lisääminen.

  8. Kirjoita viestiruutuun "Toivottavasti sinulla on ihana päivä, ".

  9. Valitse Syötä muuttuja -kuvake ({x}) ja valitse sitten customerName.

  10. Valitse muuttujan jälkeen välilyönti ja kirjoita "!".

  11. Tallenna aihe.

Valitse lähdeaihe

Lähdeaiheena on uudelleenohjaamista ohjaava aihe, joka antaa arvon ja välittää sen kohdeaiheeseen. Esimerkissä se on Tervehdys.

  1. Siirry Tervehdys-aiheeseen ja poista oletussolmut, paitsi Käynnistä-solmu.

  2. Lisää kysymys-solmu ja kirjoita viestiksi "Mikä sinun nimesi on?".

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

  4. Korvaa oletusnimi nimellä "customerNameFromGreeting".

  5. Viesti-solmun lisääminen.

  6. Kirjoita viestiruutuun "Mukava tavata sinut, ".

  7. Valitse Syötä muuttuja -kuvake ({x}) ja valitse sitten customerNameFromGreeting.

  8. Valitse muuttujan jälkeen välilyönti ja kirjoita "!".

  9. Lisää Uudelleenohjaus-solmu, ja valitse kohdeaihe Keskustele asiakkaan kanssa.

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

    Näyttökuva tervehdysaiheesta, jossa customerName-muuttuja on lisätty syöteenä uudelleenohjaussolmuun.

  11. Valitse >-kuvake ja valitse sitten muuttuja, jonka arvon haluat siirtää, tässä esimerkissä customerNameFromGreeting.

    Uudelleenohjaus-solmun tulisi näyttää tältä:

    Näyttökuva tervehdysaiheen valmiista uudelleenohjaussolmusta.

  12. 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ää yleisten muuttujien tarvetta.

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

Määritä palautetun muuttujan lähdeaihe

Kun palautat muuttujan aiheeseen, lähdeaiheena on aihe, joka antaa arvon, joka palautuu alkuperäiseen aiheeseen. Tässä esimerkissä lähdeaiheena on Puhu asiakkaalle.

  1. Siirry lähdeaiheeseen.

  2. Lisää kysymys-solmu ja kirjoita viestiksi "Missä kaupungissa asut?".

  3. Valitse Tunnista-kohdassa valmis entiteetti Kaupunki.

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

    Näyttökuva Keskustele asiakkaan kanssa -aiheesta, jossa customerCity-muuttuja ja sen ominaisuudet näkyvät korostettuina.

  5. Viesti-solmun lisääminen.

  6. Valitse Syötä muuttuja -kuvake ({x}) ja valitse sitten customerCity.

  7. Kun muuttuja on viestiruudussa, kirjoita " tähän aikaan vuodesta on varmasti kaunista!".

  8. Tallenna aihe.

Määritä palautetun muuttujan kohdeaihe

Kun palautat muuttujan aiheeseen, kohdeaiheena on aihe, joka vastaanottaa arvoja nykyisestä aiheesta. Tässä esimerkissä kohde aihe on Tervehdys.

  1. Siirry kohdeaiheeseen.

  2. Lähtöaiheessa valitsemasi muuttujan pitäisi näkyä Uudelleenohjaus-solmussa lähtömuuttujana.

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

  3. Tallenna aihe.

Arvon jäsentämissolmu

Arvon jäsentäminen -solmussa voidaan muuntaa tietyntyyppinen arvo toisentyyppiseksi arvoksi. Kun lisäät solmun aiheeseen, valitse Lisää solmu -kuvake, osoita kohtaan Muuttujien hallinta ja valitse Jäsennä arvo.

Näyttökuva valikosta, jossa lisätään solmu, valitaan muuttujan hallinta ja jäsennysarvo.

Tärkeimmät arvon jäsentäminen -solmua 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 alkeellinen muuttuja on palautettava. Arvon jäsentäminen -solmussa koko ohjelmointirajapintatulos voidaan lähettää merkkijonona. Esimerkki: 

{
    "Name": "Parker",
    "Position": "Product manager",
    "Company": "Contoso",
    "FormerPositions": [{
            "Position": "Customer service representative"
        }
    ]
}

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äminen -solmu ja valitse jäsennettävä arvo.

    Näyttökuvassa jäsennettävän muuttujan valinta

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

    Näyttökuvassa tietotyypin valinta arvon jäsentämissolmuun

  3. Valitse Hae rakenne JSON-mallista ja kirjoita haluamasi JSON-esimerkki avaavassa editorissa.

    Näyttökuva rakenteen hakemisesta JSON-näytteestä.

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

    Näyttökuvassa jäsennetyn arvon kohdemuuttujan valinta

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

    Näyttökuvassa jäsennettyjen tietojen kohdemuuttujalla on toivottu tyyppi: tietue.

Jäsennysarvo-solmun keskeinen käyttö on untypedObject-kohtien jäsentäminen suorituksen aikana, sekä JSON-merkkijonojen jäsentäminen. Yleisin käyttötapaus on, kun vastaanotat tapahtuman ja sinun on jäsennettävä tapahtuman arvo. Voit myös jäsentää System.Activity.ChannelData-ominaisuuden, joka muuttuu suorituksen aikana kanavan mukaan.

Jos jäsennät tietoja Teams-tapahtumasta, sinun pitäisi etsiä Teamsin kehittäjän dokumentaatiosta esimerkki siitä, miltä odotettu tapahtuma saattaisi näyttää, ja käyttää tätä esimerkkiä näytetietona tässä osassa kuvatuilla tavalla.

Liittyvä sisältö