Monikielisten agenttien määrittäminen ja luominen

Copilot Studiolla voit luoda agentin, joka viestii asiakkaiden kanssa useilla eri kielillä. Voit määrittää monikieliset agentit tunnistamaan automaattisesti käyttäjän haluaman kielen selaimen asetusten perusteella ja vastaamaan samalla kielellä, mikä tarjoaa asiakkaille henkilökohtaisemman ja kiinnostavamman kokemuksen.

Kun luot agentin, määrität sen ensisijaisen kielen.

Kun lisäät toissijaisia kieliä agenttiin, olet vastuussa käännösten tarjoamisesta luomiesi aiheiden viesteihin. Generatiivista orkestrointia hyödyntävien agenttien generoidut viestit käännetään automaattisesti.

Kun asiakas aloittaa istunnon julkaistulla agentilla, agentti valitsee yhden kielistään vastaamaan asiakkaan asiakasohjelman tai selaimen määrittelemää kieltä. Jos agentti ei tunnista kieltä tai tunnistaa kielen, jota se ei tue, agentti käyttää oletuksena pääkieltään.

Voit suunnitella agentin vaihtamaan kieltä keskustelun aikana (katso Agentin vaihtaminen toiseen kieleen). Voit myös määrittää agentin, joka käyttää generatiivista orkestrointia vaihtaakseen kieltä dynaamisesti seuratakseen nykyisen keskusteluvuoron kieltä (katso Määritä agentti dynaamiselle kielenvaihdolle).

Tuettujen kielten luettelo on kohdassa Kielituki.

Muistiinpano

Perinteiset keskustelubotit tukevat vain yhtä kieltä. Lisätietoja perinteisen keskustelubotin muuntamisesta agentiksi on kohdassa Päivittäminen Copilot Studion yhtenäiseen sisällönluontiin.

Kielten lisääminen agenttiin

1. Siirry agenttisi Asetukset-sivulle ja valitse Kielet.

2. Valitse Lisää kieli.

3. Lisää kieliä -paneelissa valitse ne kielet, jotka haluat lisätä agenttiin, ja valitse Lisää.

4. Tarkista kieliluettelo ja sulje Asetukset-sivu.

Monikielisen agentin lokalisoinnin hallinta

Copilot Studiossa muokkaat kaikki aiheet ja sisällöt agentin ensisijaisella kielellä. Tässä osiossa selitetään, miten voit ladata merkkijonot agentiltasi ja kääntää ne agentin toissijaisille kielille. Kun olet vienyt käännetyt merkkijonot, voit vaihtaa kieltä testipaneelissa ja varmistaa, että keskustelut toissijaisilla kielillä sujuvat odotetusti.

Lokalisoidun sisällön valmistelu

Ensimmäisen kerran ladattaessa lokalisaatiotiedosto toissijaiselle kielelle, kaikki merkkijonot ovat agentin ensisijaisella kielellä. Kun olet ladannut lokalisointitiedoston, käytä sitä haluamassasi lokalisointiprosessissa.

1. Siirry agenttisi Asetukset-sivulle ja valitse Kielet.

2. Valitse Kielet-sivun toissijaisten kielten luettelossa Lataa sen kielen kohdalla, jota haluat päivittää.

3. Valitse Päivitä lokalisoinnit -paneelissa joko JSON- tai ResX-muoto ladataksesi kyseisen kielen kulloisenkin lokalisointitiedoston.

   Muistiinpano

   Ladattu tiedosto sisältää agentin uusimman lokalisointisisällön. Ladataksesi lokalisointitiedoston aiemmat versiot, avaa agentin ratkaisu.

4. Avaa ladattu tiedosto ja korvaa ensisijaiset kielimerkkijonot oikealla käännetyllä tekstillä.

5. Palaa Päivitä lokalisointeja -paneeliin, valitse Selaa ja lataa käännetty tiedosto.

6. Sulje Päivitä lokalisaatiot -paneeli ja Asetukset-sivu.

Lokalisoidun sisällön päivittäminen

Jos muutat ensisijaisen kielen merkkijonoja, sinun täytyy myös päivittää toissijaisten kielten sisällöt. Tämä prosessi sisältää sekä uutta sisältöä että muokattua sisältöä. Lisääviä muutoksia ei käännetä automaattisesti. Sinun on ladattava toissijaisen kielen JSON- tai ResX-tiedosto ja päivitettävä kääntämättömät merkkijonot käyttämällä haluamaasi lokalisointiprosessia.

Seuraava skenaario on tyypillinen käännetyn sisällön työnkululle. Olet aiemmin kääntänyt ensisijaisen kielesi (en-US) toissijaiselle kielelle (fr-FR) sekä lisännyt ja muokannut sisältöä ensisijaisella kielellä. Kun lataat toissijaisen kielen lokalisointitiedoston, uudet merkkijonot ovat pääkielellä (en-US) ja aiemmin käännetyt merkkijonot säilyvät toissijaisella kielellä (fr-FR). Kuitenkin aiemmin käännetyt merkkijonot, joiden alkuperäistä tekstiä on muokattu viimeksi lähetyksen jälkeen, näkyvät edelleen sellaisina kuin ne viimeksi käännettiin toissijaiselle kielelle. Koska merkkijonojen tunnisteet eivät muutu, toissijaisen kielen ja ensisijaisen kielen merkkijonot voivat olla ristiriidassa, kun ensisijaisen kielen muutoksia tehdään. Varmista, että vertaat uutta lokalisointitiedostoa viimeksi lähettämääsi versioon, jotta ensisijaisen kielen merkkijonojen muutokset tunnistetaan, ja että tämä on osa lokalisointiprosessiasi.

Tee dynaaminen sisältö Mukautuvista korteista saataville lokalisointia varten

Lokalisointitiedostot eivät sisällä Mukautuvien korttien sekatyyppisiä merkkijonoja. Jos sinun täytyy lokalisoida Mukautuva kortti, jossa merkkijono voi sisältää sekä staattista tekstiä että muuttujia (dynaamista sisältöä), käytä seuraavaa kiertotietä. Ohjeistus osoittaa, miten voit käyttää Aseta tekstimuuttuja -solmua tallentaaksesi koko merkkijonon, jossa on staattista tekstiä ja muuttujia, välimuuttujaan. Tämän jälkeen viittaat vain siihen välimuuttujaan Mukautuvassa kortissa. Kun lataat lokalisointitiedoston agentillesi, välimuuttujan arvo, joka sisältää sekä staattisen tekstin että muuttujaviittaukset, on lokalisoitavissa osana setVariable-toimintoa.

Jotta Mukautuvan kortin dynaaminen sisältö olisi lokalisoitavissa:

1. Lisää Aseta muuttujan arvo -solmu ennen adaptiivista korttiasi. Tämä vaihe luo YAML-esityksen, jota voit päivittää käyttämällä koodieditoria muuntaaksesi solmun Aseta tekstimuuttuja -solmuksi. Et voi luoda Aseta tekstimuuttuja -solmuja suoraan tekijäkaaviossa.

2. Aseta muuttujan arvo -solmussa luo uusi muuttuja, mutta älä aseta arvoa vielä.

3. Avaa koodieditori aiheellesi.

4. Koodieditorissa etsi osa, joka edustaa Aseta muuttujan arvo -solmuasi, ja korvaa kind: SetVariable se kohteella kind: SetTextVariable. Tämä muutos muuntaa Aseta muuttujan arvo -solmusi Aseta tekstimuuttuja -solmuksi.

5. Sulje koodieditori.

6. Valitse Aseta tekstimuuttuja -solmun alin kenttä ja syötä koko merkkijono, jossa on staattinen teksti ja muuttujat, jotka haluat näyttää Mukautuvalla kortillasi. Lisää muuttuja samalla tavalla kuin lisäät muuttujan viestiin.

7. Päivitä mukautuva kortti lisäämällä viittaus tähän uuteen muuttujaan.

8. Tallenna aihe. Voit nyt ladata lokalisointitiedoston ja varmistaa, että se sisältää dynaamisen sisällön Mukautuvien korttiesi osalta.

Lue lisää kohdasta Lokalisoi mukautuvan kortin sisältö.

Monikielisen agentin testaaminen

1. Avaa testipaneeli.

2. Valitse testipaneelin yläosasta kolme pistettä (…) ja valitse haluamasi kieli. Testipaneeli latautuu uudelleen, tällä kertaa valitulla kielellä. Kaavio pysyy pääkielessä, etkä voi tallentaa tekemiäsi muutoksia aiheeseen ennen kuin palaat pääkieleen.

3. Testaa agenttia kirjoittamalla viesti valitulla kielellä.

Voit myös asettaa selaimesi kielen joksikin agenttisi tuetuista kielistä ja avata valmiin demosivuston. Demosivusto avautuu määritetyllä kielellä, ja agentti keskustelee sillä kielellä.

Vaihda agentin kieli

Kun suunnittelet agenttia, voit konfiguroida agentin vaihtamaan kieltä kesken keskustelun. Logiikka voi sijaita missä tahansa agentin aiheessa. Paras käytäntö on kuitenkin vaihtaa kieltä heti Kysymys-solmun jälkeen. Näin varmistetaan, että kaikki seuraavat kysymykset aina seuraavaan Kysymys-solmuun asti annetaan samalla kielellä.

Voit vaihtaa agentin nykyisen kielen asettamalla User.Languagejärjestelmämuuttujan arvoksi jonkin agentin toissijaisista kielistä. Tämä valinta vaihtaa agentin puhuman kielen välittömästi.

Konfiguroi agentti dynaamiseen kielenvaihtoon

Muistiinpano

Tämä ominaisuus on käytettävissä vain agenteille, joilla on generatiivinen orkestrointi käytössä.

Voit määrittää agentin tunnistamaan asiakkaan käyttämän kielen ja vastaamaan samalla kielellä. Tällä määrityksellä agentti voi vaihtaa kieltä useita kertoja saman keskustelun aikana. Seuraava skenaario näyttää, miten agentti voidaan asettaa vaihtamaan hollannin ja englannin välillä. Voit laajentaa tämän mihin tahansa agenttisi tukemien kielten yhdistelmään.

Varoitus

Tämä dynaaminen kielenvaihtotoiminto ei ole yhteensopiva selainpohjaisen kielen tunnistuksen kanssa. Kun aihe, joka dynaamisesti tunnistaa käyttäjän kielen, asettaa User.Language-muuttujan, selainpohjainen kielitunnistus lakkaa toimimasta kyseisellä käyttäjällä, vaikka aihe myöhemmin poistettaisiin käytöstä tai poistettaisiin. Jos haluat kokeilla tai validoida molempia lähestymistapoja, käytä erillistä testiagenttia. Kun olet testannut dynaamisen kielenvaihdon, sinun täytyy tyhjentää pysyvä käyttäjäkielen tila ennen kuin yrität testata selainpohjaista kielen tunnistusta.

Tässä skenaariossa käytetään aihetta, jossa on Viesti vastaanotettuaiheen käynnistin. Tämä aihelaukaisu antaa agentillesi mahdollisuuden tarkastella jokaista saamaansa viestiä. Tämä aihe käyttää mukautettua kehotetta kielen tunnistamiseen ja ehtoa agentin kielen järjestelmämuuttujan asettamiseen.

1. Varmista, että agenttisi on konfiguroitu tukemaan kaikkia haluamiasi kieliä.

2. Aiheen luominen.

3. Korvaa aiheen oletus käynnistintyyppi arvolla Viesti vastaanotettu.

4. Kehotteen lisääminen aiheeseen:

   1. Valitse Lisää solmu -kuvake Käynnistin-solmun alapuolelta.

   2. Valitse Lisää työkalu>Uusi kehote.

   3. Kirjoita kehotteen editoriin kuvaava nimi kehotteellesi, esimerkiksi "Tunnista kieli."

   4. Kirjoita Ohjepaneeli-osioon: "Määritä, millä kielellä tämä viesti on kirjoitettu: "

   5. Ohje-paneelin alareunasta valitse Lisää sisältöä ja valitse Teksti. Näytölle avautuu ikkuna, jossa pyydetään syöttämään nimi ja esimerkkiviesti.

   6. Kirjoita Nimi-kohdassa "Viesti". Esimerkkidataa varten kirjoita "Viesti käyttäjältä" ja valitse Sulje.

   7. Mallin vastaus -paneelissa vaihda Tulos-muoto JSON-muotoon.

   8. Valitse Testaa. Kehotteessasi näkyy JSON-literaali, jossa on yksi ominaisuus, joka osoittaa, että kieli on englanti.

      

   9. Valitse Tallenna. Kaavioon tulee näkyviin kehote-solmu.

5. Määritä kehote-solmu:

   1. Valitse Syötteen kohdalla järjestelmämuuttujaActivity.Text (saapuvan viestin teksti).
   2. TulokselleLuo uusi muuttuja nimeltä DetectedLanguage.

6. Haarauta logiikkasi havaitun kielen perusteella:

   1. Lisää ehtokehote-solmun alle.

   2. Perusta ehtosi mukautettuun muuttujaan DetectedLanguage.structuredOutput.language, joka sisältää havaitun kielen nimen.

   3. Lisää ehtohaara jokaiselle kielelle, jonka sinun täytyy havaita.

   4. Kunkin haaran alle lisää Aseta muuttujan arvo -solmu, jolla asetat User.Language-järjestelmämuuttujan sen mukaisesti. Seuraava kuva näyttää aiheen, jossa on ehto kielen vaihtoon hollannin ja englannin välillä.

      

Ota uudelleen käyttöön selainpohjainen kielitunnistus

Kun agentti, joka on määritetty dynaamista kielen vaihtoa varten, asettaa järjestelmämuuttujan User.Language, valittu kieli säilyy käyttäjälle tallennettuna ohituksena. Käyttäjän suosima kieli määritellään seuraavassa prioriteettijärjestyksessä:

1. Kieliasetus, jonka käyttäjä on itse määrittänyt ja joka säilytetään ohituksena tälle käyttäjälle (korkein prioriteetti).
2. Käyttäjältä saapuva viesti kielellä, joka vastaa yhtä agentin tuetuista kielistä (Activity.Locale).
3. Agentin ensisijainen kieli (varakieli).

Poista pysyvä kieliasetus dynaamisen kielenvaihdon testaamisen jälkeen:

• Lähetä /debug clearstate agenttiin. Tämä komento poistaa kielen ohituksen käyttäjätilasta.

Monikielisen agentin vianmääritys

Tässä osiossa annetaan vinkkejä, jotka auttavat ymmärtämään odottamatonta monikielisen agentin käyttäytymistä.

Monikielisen agentin toiminta kielille, joita ei ole määritetty

Jos käyttäjä määrittää selaimensa kielelle, jota et ole määrittänyt agentille, agentti palautuu käyttämään ensisijaista kieltään.

Agentin ensisijainen kieli määritetään, kun agentti luodaan. Et voi vaihtaa ensisijaista kieltä luomisen jälkeen, mutta agentin ensisijaisen kielen aluetta voi vaihtaa, jos käytettävissä on useita alueita.

Monikielisen agentin toiminta puuttuvien käännösten suhteen

Jos lisäät viestejä asiakaspalvelijalle sen ensisijaisella kielellä, mutta et lataa uusien viestien käännöksiä, asiakaspalvelija näyttää kääntämättömät muutokset ensisijaisella kielellään. Varmista aina, että käännökset ovat ajan tasalla agenttiin tehtyjen muutosten jälkeen.

Lokalisointitiedostot eivät sisällä Mukautuvien korttien sekatyyppisiä merkkijonoja. Jos sinun täytyy lokalisoida Mukautuvat kortit, joissa merkkijono sisältää sekä staattista tekstiä että muuttujia (dynaamista sisältöä), sinun täytyy käyttää kiertotietä. Lue, miten tallennat sekatyyppisen merkkijonon tekstimuuttujaan ennen kuin käytät sitä Mukautuvissa korteissa.

Virheitä monikielisen agentin julkaisemisessa

Kun yrität julkaista monikielisen agentin, saatat nähdä virheilmoituksen "Botin vahvistus epäonnistui" raakavastauksen virhekoodilla, SynonymsNotUnique. Tämä virhe tarkoittaa, että lokalisaatiotiedostossasi on joko päällekkäisiä synonyymejä tai synonyymi, joka vastaa arvoa DisplayName. Tämä virhe ilmenee yleensä, kun solmu sisältää kohteen Entity.Definition.'closedListItem', jossa jokin seuraavista tilanteista esiintyy:

• Yksi Synonyms-elementeistä ei ole yksilöllinen.
• Yhdellä elementeistä Synonyms on sama arvo kuin elementillä DisplayName.

Kaikkien saman entiteetin Synonyms-elementtien on oltava yksilöllisiä, ja niillä on oltava eri nimi kuin DisplayName-elementillä.

Korjataksesi virheen tarkista toissijaisen kielen JSON- tai ResX-tiedosto ja tunnista mahdolliset tapaukset, joissa tämä ehto saattaa esiintyä.