Lue englanniksi

Jaa


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ä.

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.

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

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

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

    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.

Huomautus

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.

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

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

Näyttökuva muuttujan ominaisuusruudusta.

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.

Näyttökuva Aiheet-sivun ympäristömuuttujan arvon asettamisesta.

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

Huomautus

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.

Kuvakaappaus asiakaspalvelija aihe järjestelmämuuttujista.

Huomautus

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.

Huomautus

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:

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

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:

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

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ä:

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

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

    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.