Jaa

Muuttujien käyttäminen

Muuttujien avulla voit tallentaa asiakkaiden vastaukset, jotta voit käyttää heidän sisältöään uudelleen myöhemmin keskustelussa.

Muuttujia voidaan käytätä myös luomaan loogisia lausekkeita, jotka ohjaavat asiakkaan dynaamisesti eri keskustelupoluille. Voit esimerkiksi tallentaa asiakkaan nimen muuttujaan nimeltä customerName, ja agentti voi käsitellä asiakasta nimen mukaan keskustelun jatkuessa.

Voit välittää muuttujia muihin aiheisiin ja Power Automate -työnkulkuihin ja palauttaa ne niistä.

Luo muuttuja

Mikä tahansa solmu, joka palauttaa tuloksen, kuten Kysymyssolmu , luo automaattisesti sopivantyyppisen tulostemuuttujan.

Näyttökuva kysymyssolmusta, jossa muuttujan oletusnimi ja tyyppi on korostettuna.

Vinkki

Solmut on helppo tunnistaa, jos annat niille uudet nimet. Valitse solmun nimikenttä päivittääksesi nimen suoraan, tai valitse solmun kolme pistettä (...) ja valitse valikosta Nimeä uudelleen . 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 käyttävät oletusarvoisesti monivalinta-asetuksia. Jos haluat käyttää eri valmiiksi luotua tai mukautettua entiteettiä, valitse Tunnista-ruutu ja valitse sitten haluamasi tietotyyppi.

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

Muuttujan uudelleennimeäminen

Jotta agenttien ylläpito olisi helpompaa, korvaa kunkin muuttujan oletusnimi mielekkäällä nimellä.

  1. Valitse muuttuja. Näkyviin tulee Muuttujan ominaisuudet -ruutu.

  2. Kirjoita Muuttujan nimi -kohtaan muuttujalle haluamasi nimi.

Aseta muuttuja

Yleensä kysymyssolmua käytetään käyttäjän syötteen tallentamiseen muuttujaan. Voit kuitenkin halutessasi määrittää muuttujan arvon itse. Käytä tällöin Määritä muuttujan arvo -solmua.

  1. Valitse Lisää solmu -kuvake solmun alta, jonka jälkeen haluat lisätä Aseta muuttujan arvo -solmun.

  2. Valitse Muuttujan hallinta>Määritä muuttujan arvo. Piirtoalustalle ilmestyy Aseta muuttujan arvo -solmu.

  3. Valitse Määritä muuttuja -kohdan valintaruutu. Näyttöön avautuu Valitse muuttuja - paneeli.

    • Jos määritettävä muuttuja on jo olemassa, valitse se.

    • Muussa tapauksessa valitse Luo uusi. Tämä toiminto luo uuden muuttujan. 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ä.

  4. Määritä Arvo-kohtaan arvo käyttämällä jotakin seuraavista vaihtoehdoista:

    • Syötä literaaliarvo.

    • Valitse aiemmin luotu samantyyppinen muuttuja.

    • Käytä Power Fx -kaavaa Power Fx -kaavat ovat hyödyllisiä monitasoisemmissa tyypeissä, joissa ei voi käyttää literaaliarvoja, kuten taulukko- ja tietuetyypit.

Muuttujien käyttäminen Toimintosolmuissa

Kun käytät muuttujaa Toiminto-solmussa , jos sen perustyyppi vastaa työnkululle määritettyä parametrityyppiä tai Bot Framework -taitoa, voit syöttää sen kyseiseen parametriin. Toiminto-solmujen tuloste luo uusia muuttujia.

Jos haluat lisäkontekstia, katso esimerkkitilanteet kohdasta Agentin työnkulun kutsuminen ohjeaiheesta ja Käytä syöte- ja tulostemuuttujia tietojen välittämiseen.

Literaaliarvojen käyttö muuttujien syötteissä

Solmussa, jossa määrität syöteparametrien arvon, voit syöttää literaaliarvon 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 sen sijaan tulkita merkkijonoarvoksi, rivitä arvo lainausmerkeissä seuraavasti: "123".

Joissakin tilanteissa, kuten skenaarioissa, jotka käyttävät monimutkaisia tyyppejä, sinun on ehkä käytettävä Power Fx -kaavaa tietyn tyypin määrittämiseen.

Ympäristömuuttujien käyttäminen salaisten Azure Key Vault varten

Ympäristömuuttuja voi viitata salauskoodiin Key Vaultissa. Salaiset ympäristömuuttujat ovat ympäristömuuttujien erityistapaus, jossa on erityisiä huomioon otettavia seikkoja.

Jotta voit luoda salaisen ympäristömuuttujan Power Appsissa, sinun on määritettävä Key Vault -säilö.

Anna Copilot Studiolle lupa lukea tämä Key Vault -säilö suorittamalla seuraavat toimet:

  1. Määritä Key Vault Secrets -käyttäjärooliMicrosoft Copilot Studio -palvelusovellukselle .

  2. Jotta ympäristön kaikki agentit voivat käyttää salaista koodia, luo salaisuuteen tunniste AllowedEnvironments ja lisää sallitut ympäristötunnukset pilkuilla eroteltuina.

  3. Salli vain tiettyjen ympäristön agenttien käyttää tätä säilöä, luo tunniste AllowedAgents ja anna 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).

Dialogin suorituspalvelu tallentaa salaisen koodin arvon välimuistiin viideksi minuutiksi. Se tallentaa epäonnistuneet lukemisen välimuistiin 30 sekunnin ajan.

Varoitus

Jos lisäät salaisen koodin agenttiin, saatat paljastaa tämän salaisen koodin arvon. Kuka tahansa, joka voi muokata agenttia ympäristössä, voi lisätä Viesti-solmun ja palauttaa salaisen ympäristön muuttujien arvon viestissä.

Muuttujat-paneeli

Muuttujat-paneelissa voit tarkastella kaikkia muuttujia, jotka ovat käytettävissä aiheessa, riippumatta siitä, missä solmuissa ne on määritetty tai käytetty.

Avaa Muuttujat-paneeli valitsemalla Muuttujat aiheen valikkoriviltä.

Näyttökuva Muuttujat-paneelista, jossa Muuttujat-painike on korostettuna.

Voit valita kullekin aiheen muuttujalle, voiko se saada sen arvon muista aiheista, palauttaa sen arvon muihin aiheisiin vai molempiin. Voit myös valita muuttujan ja muokata sen ominaisuuksia Muuttujan ominaisuudet -paneelissa.

Muuttujan ominaisuudet -paneeli

Muuttujan ominaisuudet -paneelissa voit nimetä muuttujan uudelleen, nähdä, missä agenttisi käyttää sitä, tai muuntaa sen yleiseksi muuttujaksi. Yleistä muuttujaa ei voi muuntaa takaisin aiheen muuttujaksi. Voit myös valita, voiko aihemuuttuja vastaanottaa arvoja tai siirtää sen arvon muille aihemuuttujille.

Jos haluat avata Muuttujan ominaisuudet -paneelin muuttujalle, valitse haluamasi muuttuja Muuttujat-paneelissa. Voit myös avata Muuttujan ominaisuudet -paneelin mistä tahansa muuttujia käyttävästä solmusta valitsemalla haluamasi muuttujan.

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 varmasti sitä, että heidän ei tarvitse vastata samoihin kysymyksiin useammin kuin kerran.

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 aiemmassa aiheessa, kysymystä ei tarvitse esittää uudelleen. Tällöin voit määrittää muuttujan arvoksi 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 testipaneelissa näkyy, jos tämä aihe käynnistetään ensin, siinä kysytään käyttäjältä: "Miksi minun pitäisi kutsua sinua?" Se tallentaa arvon merkkijonomuuttujaan nimeltä customerName. Muuttuja customerName määritetään myös noutamaan arvonsa 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 testipaneelista näkyy, jos tämä aihe käynnistetään ensin, siinä kysytään 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. Sen sijaan se käytti customerName välitettyjen muuttujien 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.

Vaiheittainen opas aiheen asetusten määrittämiseen, jotta aihe voi vastaanottaa arvoja muilta aiheilta. Tässä esimerkkiskenaariossa käytetään lähdeaiheena esimääritettyä tervehdystä ja kohdeaiheena on uusi aihe Keskustele asiakkaalle , mutta samat vaiheet toimivat kaikissa aiheissa, joiden pitäisi käyttää arvoa aiemmasta aiheesta, kun se on mahdollista.

Aseta kohdeaihe

Kohdeaihe vastaanottaa arvoja muista aiheista. Tässä esimerkissä se on Keskustele asiakkaan kanssa.

  1. Luo uusi aihe ja anna sille nimeksi "Keskustele asiakkaalle".

  2. Lisää käynnistinlauseita, kuten "puhu minulle", "puhu kanssani" ja "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 customerNamenimellä , ja valitse sitten Vastaanota arvoja muista aiheista.

    Näyttökuva Muuttujan ominaisuudet -ruudusta, jossa näkyvät 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 perässä oleva välilyönti ja kirjoita huutomerkki (!).

  11. Tallenna aihe.

Valitse lähdeaihe

Lähdeaihe on aihe, joka ohjaa toiseen aiheeseen. Se antaa arvon ja välittää sen kohdeaiheisiin. Tässä esimerkissä se on Greeting.

  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 perässä oleva välilyönti ja kirjoita huutomerkki (!).

  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

Agenttina aihe kerää tietyn tiedon. Sitä voidaan kutsua useissa muissa aiheissa ja sen odotetaan palauttavan tiedot muuttujana. Muuttujasta tulee osa alkuperäisestä aiheesta, ja sitä voidaan käyttää kuten mitä tahansa muuta muuttujaa. Tämä lähestymistapa vähentää maailmanlaajuisten muuttujien tarvetta tuomalla agentin hankkimat tiedot saataville eri aiheissa.

Jatketaan edellisen osan esimerkin parissa. Esität uuden kysymyksen Keskustele asiakkaalle - aiheessa ja palautat sitten vastauksen Tervehdys-aiheeseen .

Määritä palautetun muuttujan lähdeaihe

Kun palautat muuttujan aiheeseen, lähdeaihe on aihe, joka antaa arvon, joka välitetään takaisin 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, jotta voit avata sen Muuttujan ominaisuudet -paneelissa. Anna sille customerCitynimi 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, kohdeaihe vastaanottaa arvoja nykyisestä aiheesta. Seuraavassa esimerkissä kohdeaiheena on Greeting.

  1. Siirry kohdeaiheeseen.

  2. Lähdeaiheessa valitsemasi muuttuja näkyy Uudelleenohjauksen solmussa tulostemuuttujana.

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

  3. Tallenna aihe.

Arvojen jäsentäminen

Jäsennä-arvosolmu muuntaa arvon yhdestä tyypistä toiseen. Jäsennä-arvon solmun yleinen käyttötapaus on raaka-JSON:n muuntaminen. Esimerkiksi agentti kutsuu prosessia, joka kutsuu ohjelmointirajapintaa. Ohjelmointirajapinta palauttaa tuloksen. Tarvitset tavan jäsentää tämä tulos ja palauttaa yhden tai useampia primitiivisiä muuttujia. Käyttämällä Jäsennä-arvosolmua voit lähettää koko ohjelmointirajapinnan tuloksen merkkijonona, kuten seuraavassa:

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

Jäsennä-arvosolmu muuntaa merkkijonomuuttujan muuttujaksi, jonka tyyppi on Tietue. Power Fx -editori tarjoaa IntelliSense-koodin valmistumisen ja ehdotuksia tälle tyypille.

JSON-merkkijonojen jäsentämisen lisäksi Jäsennä-arvon solmun avainkäyttö on jäsentää tyypittömiä objekteja suorituksen aikana. Yleisin käyttötapaus on, kun vastaanotat tapahtuman ja sinun täytyy jäsentää tapahtuman arvo. Voit myös halutessasi jäsentää -ominaisuuden System.Activity.ChannelData , joka vaihtelee suorituksen aikana kanavan mukaan.

Jos haluat jäsentää Teamsin kautta tulevan tapahtuman tietoja, katso Teamsin kehittäjädokumentaatiosta esimerkki siitä, miltä odotettu tapahtuma saattaa näyttää. Tämän jälkeen voit noudattaa tämän osion ohjeita ja käyttää esimerkkitapahtumaa mallitietona.

Aiheeseen Jäsennä arvo -solmun lisäämiseksi:

  1. Valitse Lisää solmu -kuvake solmun alta, jonka jälkeen haluat jäsentää arvon. Osoita Muuttujien hallintaa ja valitse Jäsennä arvo.

  2. Lisää arvon jäsentäminen -solmu ja valitse jäsennettävä arvo.

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

  3. Valitse tietotyypiksi Mallitiedot.

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

  4. Valitse Nouda rakenne malli-JSON-mallista, anna haluamasi JSON-esimerkki avautuvassa editorissa ja valitse Vahvista.

    Näyttökuva, jossa näkyy editori, johon lisäät JSON-mallitiedot.

  5. Valitse muuttuja, jos haluat säilyttää jäsenntyneen arvon. Yleensä luot uuden muuttujan.

    Näyttökuva, joka näyttää, miten voit luoda muuttujan, joka säilyttää jäsenntyneen arvon suoraan Jäsennä-arvosolmusta.

    Tulosmuuttujalla on nyt odotettu tyyppi: tietue.

    Näyttökuva, jossa näkyy, että jäsennystietoja sisältävällä muuttujalla on odotettu tyyppi: tietue.

Liittyvä sisältö

  • Last updated on