Konfigurace a vytvoření vícejazyčných agentů

Pomocí nástroje Copilot Studio můžete vytvořit agenta, který komunikuje se zákazníky v různých jazycích. Můžete nastavit vícejazyčné agenty tak, aby automaticky detekovali požadovaný jazyk na základě nastavení webového prohlížeče uživatele a odpovídali stejným jazykem, což zákazníkům poskytuje personalizovanější a poutavější zážitek.

Při vytváření agenta zadáte jeho primární jazyk.

Po přidání sekundárních jazyků do agenta zodpovídáte za poskytování překladů zpráv v tématech, která vytvoříte. U agentů, kteří používají generativní orchestrace, se generované zprávy automaticky překládají.

Když zákazník spustí relaci s publikovaným agentem, agent vybere jeden z jeho jazyků tak, aby odpovídal jazyku zadanému v klientovi nebo prohlížeči zákazníka. Pokud agent nedokáže rozpoznat jazyk klienta nebo prohlížeče nebo pokud zjištěný jazyk není jedním z jazyků, které jste zadali pro svého agenta, agent ve výchozím nastavení používá svůj primární jazyk.

Agenta můžete navrhnout tak, aby měnil jazyk, který používá během konverzace (viz Přechod agenta do jiného jazyka). Můžete také nastavit agenta, který používá generování orchestrace k dynamickému přepínání jazyků podle jazyka používaného v aktuálním turnu konverzace (viz Nastavení agenta pro dynamické přepínání jazyka).

Seznam podporovaných jazyků viz Podpora jazyků.

Poznámka:

Klasické chatovací roboty podporují pouze jeden jazyk. Další informace o převodu klasického chatovacího robota na agenta najdete v tématu Upgrade na jednotné autorství v Copilot Studio.

Přidání jazyků agentovi

1. Přejděte na stránku Nastavení agenta a vyberte Jazyky.

2. Vyberte Přidat jazyk.

3. Na panelu Přidat jazyky vyberte jazyky, které chcete přidat do agenta, a vyberte Přidat.

4. Zkontrolujte seznam jazyků a zavřete stránku Nastavení .

Správa lokalizace pro vícejazyčného agenta

V Copilot Studiu provedete všechna témata a úpravy obsahu v primárním jazyce agenta. Tato část vysvětluje, jak stáhnout řetězce z vašeho agenta a přeložit je do sekundárních jazyků vašeho agenta. Po nahrání přeložených řetězců můžete jazyk přepnout na testovacím panelu a ověřit, že konverzace v sekundárních jazycích také postupují podle očekávání.

Příprava lokalizovaného obsahu

Při prvním stažení lokalizačního souboru pro sekundární jazyk jsou všechny řetězce v primárním jazyce agenta. Po stažení lokalizačního souboru jej použijte s upřednostňovaným procesem lokalizace.

1. Přejděte na stránku Nastavení vašeho agenta a vyberte Jazyky.

2. Na stránce Jazyky v seznamu sekundárních jazyků vyberte Nahrát jazyk, který chcete aktualizovat.

3. Na panelu Lokalizace aktualizací vyberte formát JSON nebo ResX a stáhněte si aktuální lokalizační soubor pro daný jazyk.

   Poznámka:

   Stažený soubor obsahuje nejnovější lokalizační obsah pro agent. Pokud potřebujete stáhnout předchozí verze lokalizačního souboru, otevřete řešení agenta.

4. Otevřete stažený soubor a nahraďte řetězce primárního jazyka příslušným přeloženým textem.

5. Vraťte se na panel Lokalizace aktualizací , vyberte Procházet a nahrajte přeložený soubor.

6. Zavřete panel Lokalizace aktualizací a stránku Nastavení .

Aktualizace lokalizovaného obsahu

Pokud provedete změny řetězců primárního jazyka, musíte také aktualizovat obsah v sekundárních jazycích. Tento proces zahrnuje jak nový obsah, tak upravený obsah. Přírůstkové změny se automaticky nepřekládají. Musíte si stáhnout soubor JSON nebo ResX sekundárního jazyka a aktualizovat nepřeložené řetězce pomocí upřednostňovaného procesu lokalizace.

Následující scénář je typický pro pracovní postup pro přeložený obsah. Dříve jste přeložili svůj primární jazyk (en-US) do sekundárního jazyka (fr-FR) a přidali jste a upravili obsah v primárním jazyce. Když stáhnete lokalizační soubor pro sekundární jazyk, všechny nové řetězce jsou v primárním jazyce (en-US) a řetězce, které byly dříve přeloženy, zůstávají v sekundárním jazyce (fr-FR). Nicméně dříve přeložené řetězce, jejichž původní text byl upraven od posledního nahrání lokalizačního souboru, se stále objevují tak, jak byly naposledy přeloženy do sekundárního jazyka. Protože ID řetězců se nemění, mohou být řetězce sekundárního a primárního jazyka po změnách v primárním jazyce nesynchronizované. Ujistěte se, že porovnání nového lokalizačního souboru s verzí, kterou jste nahráli naposledy – abyste identifikovali změny řetězců v primárním jazyce – je součástí vašeho lokalizačního procesu.

Zpřístupnění dynamického obsahu z Adaptive Cards pro lokalizaci

Lokalizační soubory nezahrnují řetězce smíšeného typu z Adaptive Cards. Pokud potřebujete lokalizovat adaptivní kartu, kde řetězec může obsahovat statický text i proměnné (dynamický obsah), použijte následující alternativní řešení. Tento postup ukazuje, jak pomocí uzlu Nastavit textovou proměnnou uložit celý řetězec se statickým textem a proměnnými v zprostředkující proměnné. Pak odkazujete pouze na tuto zprostředkující proměnnou ve své Adaptivní kartě. Při stahování lokalizačního souboru pro vašeho agenta je hodnota vaší zprostředkující proměnné, která obsahuje statický text a odkazy na proměnné, k dispozici pro lokalizaci jako součást akce setVariable.

Nastavení dynamického obsahu adaptivní karty jako lokalizovatelného:

1. Přidejte uzel Nastavit hodnotu proměnné před adaptivní kartu. Tento krok vytvoří reprezentaci YAML, kterou můžete aktualizovat pomocí editoru kódu a převést uzel na uzel Nastavit textovou proměnnou . Z plátna pro vytváření nemůžete vytvářet uzly nastavit textové proměnné .

2. V uzlu Nastavit hodnotu proměnné vytvořte novou proměnnou, ale hodnotu ještě nenastavujte.

3. Otevřete editor kódu pro vaše téma.

4. V editoru kódu vyhledejte část, která představuje váš Set variable value uzel, a nahraďte kind: SetVariable za kind: SetTextVariable. Tato změna převede uzel Nastavit hodnotu proměnné na uzel Nastavit textovou proměnnou .

5. Zavřete editor kódu.

6. Vyberte dolní pole uzlu Nastavit textovou proměnnou a zadejte celý řetězec se statickým textem a proměnnými, které chcete zobrazit na adaptivní kartě. Vložte proměnnou stejným způsobem, jakým vložíte proměnnou do zprávy.

7. Aktualizujte adaptivní kartu odkazem na tuto novou proměnnou.

8. Uložte téma. Teď si můžete stáhnout lokalizační soubor a ověřit, že obsahuje dynamický obsah Adaptive Cards.

Další informace najdete v tématu Lokalizace obsahu adaptivní karty.

Testování vícejazyčného agenta

1. Otevřete testovací panel.

2. Vyberte tři tečky (...) v horní části testovacího panelu a vyberte jazyk, který chcete. Testovací panel se znovu načte, tentokrát pomocí vybraného jazyka. Plátno pro vytváření obsahu zůstane v primárním jazyce a změny, které uděláte v tématu, nemůžete uložit, dokud nepřepnete zpět do primárního jazyka.

3. Pokud chcete agenta otestovat, zadejte zprávu ve vybraném jazyce.

Jazyk prohlížeče můžete také nastavit na jeden z jazyků agenta a přejít na předem připravený ukázkový web. Ukázkový web se otevře v zadaném jazyce a agent chatuje v tomto jazyce.

Přepnutí agenta do jiného jazyka

Při vytváření obsahu můžete agenta nakonfigurovat tak, aby se přepnul do jiného jazyka uprostřed konverzace. Logika se může nacházet v libovolném tématu agenta. Osvědčeným postupem je však přepnout jazyk přímo za uzel Otázka, což zajistí, že všechny následující zprávy až do dalšího uzlu Otázka budou ve stejném jazyce.

Pokud chcete změnit aktuální jazyk agenta, nastavte User.Languagesystémovou proměnnou na jeden ze sekundárních jazyků agenta. Tento výběr okamžitě změní jazyk, kterým mluví váš agent.

Nastavení agenta pro přepínání dynamických jazyků

Poznámka:

Tato funkce je dostupná jenom pro agenty s povolenou generativní orchestrací .

Agenta můžete nakonfigurovat tak, aby rozpoznal jazyk, který zákazník používá, a reagoval ve stejném jazyce. Díky této konfiguraci může agent během jedné konverzace přepínat jazyky vícekrát. Následující scénář ukazuje, jak nastavit agenta pro přepínání mezi holandštinou a angličtinou. Můžete ho rozšířit pro libovolnou kombinaci jazyků, které agent podporuje.

Tento scénář používá téma se spouštěčem tématuPřijato zprávu. Trigger tohoto tématu umožňuje agentu prozkoumat všechny zprávy, které obdrží. Toto téma používá vlastní výzvu k rozpoznání jazyka a podmínky k nastavení systémové proměnné jazyka agenta.

1. Ověřte, že váš agent je nakonfigurován tak, aby podporoval všechny jazyky, které chcete.

2. Vytvořte téma.

3. Nahraďte výchozí typ spouštění pro téma Je přijata zpráva.

4. Přidejte do tématu výzvu:

   1. Vyberte ikonu Přidat uzel pod uzlem Aktivátor.

   2. Vyberte Přidat nástroj>Nový podnět.

   3. V editoru výzev zadejte reprezentativní název výzvy, například "Zjistit jazyk".

   4. V podokně Pokyny zadejte "Určit jazyk, ve kterém je tato zpráva napsána: ".

   5. V dolní části podokna Pokyny vyberte Přidat obsah a vyberte Text. Zobrazí se okno s výzvou k zadání jména a ukázkové zprávy.

   6. Jako název zadejte "Zpráva". V části Ukázková data zadejte "Zpráva od uživatele" a vyberte Zavřít.

   7. V podokně odpovědi modelu přepněte výstupní formát na JSON.

   8. Vyberte Test. Výzva zobrazí literál JSON s jedinou vlastností identifikující jazyk jako angličtinu.

      

   9. Vyberte Uložit. Na plátně se zobrazí uzel Prompt.

5. Nakonfigurujte uzel Prompt:

   1. Jako vstup vyberte systémovou proměnnouActivity.Text (text příchozí zprávy).
   2. Pro Výstupvytvořte novou proměnnou s názvem DetectedLanguage.

6. Rozvětvení logiky na základě zjištěného jazyka:

   1. Pod uzel Výzvy přidejte podmínku.

   2. Založte podmínku na vlastní proměnné DetectedLanguage.structuredOutput.language, která obsahuje název zjištěného jazyka.

   3. Přidejte větev podmínky pro každý jazyk, který potřebujete zjistit.

   4. Pod každou větev přidejte uzel Nastavit hodnotu proměnné , aby se systémová proměnná nastavil User.Language odpovídajícím způsobem. Následující obrázek ukazuje téma s podmínkou pro přepínání mezi holandštinou a angličtinou.

      

Řešení potíží s vícejazyčným agentem

Tato sekce poskytuje tipy, které vám pomohou pochopit nečekané chování vícejazyčných agentů.

Vícejazyčné chování agent pro jazyky, které nejsou nakonfigurované

Pokud uživatel nakonfiguruje prohlížeč pro jazyk, který jste pro agenta nenakonfigurovali, agent se vrátí do svého primárního jazyka.

Při vytváření agenta zadáte primární jazyk agenta. Po vytvoření nemůžete změnit primární jazyk, ale oblast primárního jazyka agenta můžete změnit , pokud je k dispozici více než jedna oblast.

Vícejazyčné chování agent pro chybějící překlady

Pokud přidáte zprávy agentovi v jeho primárním jazyce, ale nenahrajete překlady nových zpráv, agent ukáže nepřeložené změny ve svém primárním jazyce. Vždy se ujistěte, že jsou překlady aktuální, po provedení změn u agenta.

Lokalizační soubory nezahrnují řetězce se smíšenými typy z Adaptive Cards. Pokud potřebujete lokalizovat Adaptive Cards, kde řetězec může obsahovat statický text i proměnné (dynamický obsah), musíte použít alternativní řešení. Zjistěte, jak před použitím v adaptivní kartě uložit řetězec se smíšeným typem do textové proměnné .

Chyby při publikování vícejazyčného agenta

Když se pokusíte publikovat vícejazyčného agenta a zobrazí se chybová zpráva "Ověření robota selhalo" s kódem chyby nezpracované odpovědi, SynonymsNotUnique, váš lokalizační soubor obsahuje buď duplicitní synonyma, nebo synonymum, které odpovídá hodnotě DisplayName. K této chybě obvykle dochází v případě, že uzel obsahuje některou Entity.Definition.'closedListItem' z následujících situací:

• Jeden z prvků Synonyms není jedinečný.
• Jeden z Synonyms prvků má stejnou hodnotu jako DisplayName prvek.

Všechny Synonyms pro stejnou entitu musí být jedinečné a mít jiný název než prvek DisplayName .

Pokud chcete chybu opravit, zkontrolujte soubor JSON nebo ResX pro váš sekundární jazyk a identifikujte všechny instance, ve kterých může být tato podmínka přítomna.