Çok dilli aracıları yapılandırma ve oluşturma

Çok dilli aracılar, tüm içeriği tek bir aracıda tutarken farklı dillerde müşterilerle iletişim kurar. Çoğu durumda, aracı kullanıcının web tarayıcısı ayarına göre istenen dili otomatik olarak algılar ve aynı dilde yanıt vererek müşteriler için daha kişiselleştirilmiş ve ilgi çekici bir deneyim sağlar.

Aracı oluşturduğunuzda birincil dilini belirtirsiniz.

Aracıya ikincil diller ekledikten sonra, oluşturduğunuz konulardaki iletiler için çeviri sağlamak sizin sorumluluğundadır. Üretken düzenleme kullanan aracılar için, oluşturulan iletiler otomatik olarak çevrilir.

Müşteri yayımlanmış bir aracıyla oturum başlattığında aracı, müşterinin istemcisinde veya tarayıcısında belirtilen dille eşleşecek şekilde dillerinden birini seçer. Aracı istemci veya tarayıcı dilini algılayamazsa veya algılanan dil aracınız için belirttiğiniz dillerden biri değilse, aracı varsayılan olarak birincil diline sahiptir.

Bir aracıyı, konuşma sırasında kullandığı dili değiştirecek şekilde tasarlayabilirsiniz (bkz. Aracıyı başka bir dile geçiş yapma). Ayrıca, geçerli konuşma dönüşünde kullanılan dili izlemek üzere dilleri dinamik olarak değiştirmek için üretken düzenleme kullanan bir aracı da ayarlayabilirsiniz (bkz. Dinamik dil geçişi için aracı ayarlama).

Desteklenen dillerin listesi için bkz. Dil desteği.

Not

Klasik sohbet botları yalnızca bir dili destekler. Klasik sohbet botunu aracıya dönüştürme hakkında daha fazla bilgi için bkz. Copilot Studio birleştirilmiş yazarlığa yükseltme.

Bir aracıya dil ekleyin

1. Aracının Ayarlar sayfasına gidin ve Diller'i seçin.

2. Dil ekle'yi seçin.

3. Dil ekle panelinde aracıya eklemek istediğiniz dilleri seçin ve Ekle'yi seçin.

4. Dil listesini gözden geçirin ve Ayarlar sayfasını kapatın.

Çok dilli bir aracı için yerelleştirmeyi yönetme

Copilot Studio'da, tüm konu ve içerik düzenleme işlemlerini aracının birincil dilinde gerçekleştirirsiniz. Bu bölümde, aracınızdan dizelerin nasıl indirilip aracınızın ikincil dillerine nasıl çevrildiği açıklanmaktadır. Çevrilmiş dizeleri karşıya yükledikten sonra test panelinde dili değiştirebilir ve ikincil dillerdeki konuşmaların beklendiği gibi aktığını doğrulayabilirsiniz.

Yerelleştirilmiş içeriği hazırlama

İkincil dil için yerelleştirme dosyasını ilk kez indirdiğinizde, tüm dizeler aracının birincil dilinde olur. Bir yerelleştirme dosyasını indirdikten sonra, tercih ettiğiniz yerelleştirme işlemiyle kullanın.

1. Aracınız için Ayarlar sayfasına gidin ve Diller'i seçin.

2. Diller sayfasında, ikincil diller listesinde, güncelleştirmek istediğiniz dil için Karşıya Yükle'yi seçin.

3. Yerelleştirmeleri güncelleştir panelinde JSON veya ResX biçimini seçerek ilgili dil için geçerli yerelleştirme dosyasını indirin.

   Not

   İndirilen dosya, aracı için en son yerelleştirme içeriğini içerir. Yerelleştirme dosyasının önceki sürümlerini indirmeniz gerekiyorsa ajanın çözümünü açın.

4. İndirilen dosyayı açın ve birincil dil dizelerini uygun çevrilmiş metinle değiştirin.

5. Yerelleştirmeleri güncelle paneline dönün, seçin Gözat'ı ve çevrilen dosyayı yükleyin.

6. Yerelleştirmeleri güncelleştir panelini ve Ayarlar sayfasını kapatın.

Yerelleştirilmiş içeriği güncelleştirme

Birincil dil dizelerinde değişiklik yaparsanız, ikincil dillerdeki içeriği de güncelleştirmeniz gerekir. Bu süreç hem yeni içeriği hem de değiştirilmiş içeriği içerir. Artımlı değişiklikler otomatik olarak çevrilmez. İkincil dil JSON veya ResX dosyasını indirmeniz ve tercih ettiğiniz yerelleştirme işlemini kullanarak çevrilmemiş dizeleri güncelleştirmeniz gerekir.

Aşağıdaki senaryo, çevrilmiş içerik için iş akışının tipik bir örneğidir. Daha önce birincil dilinizi (en-US) ikincil bir dile (fr-FR) çevirdiniz ve birincil dilde içerik eklediniz ve değiştirdiniz. İkincil dil için yerelleştirme dosyasını indirdiğinizde, tüm yeni içerik birincil dildedir (en-US). Ancak, değiştirilen içerik ikincil dilde görünmeye devam eder. Değiştirilen içerik aynı kimliği kullandığından, yeni dosyayı daha önce karşıya yüklenen dosyayla karşılaştırmanız gerekir.

Uyarlamalı Kartlardan dinamik içeriği yerelleştirme için kullanılabilir hale getirme

Yerelleştirme dosyaları, Uyarlamalı Kartlardan karışık türemiş dizeler içermez. Bir dizenin hem statik metin hem de değişkenleri (dinamik içerik) içerebileceği Uyarlamalı Kartı yerelleştirmeniz gerekiyorsa aşağıdaki geçici çözümü kullanın. Yordamda, statik metin ve değişkenler içeren tam dizeyi bir ara değişkende depolamak için Bir Set metin değişkeni düğümünün nasıl kullanılacağı gösterilir. Ardından Uyarlamalı Kartınızda yalnızca bu ara değişkene başvurursunuz. Aracınız için bir yerelleştirme dosyası indirdiğinizde, statik metin ve değişken başvurularını içeren ara değişkeninizin değeri, bir setVariable eyleminin parçası olarak yerelleştirmeye hazır hale gelir.

Uyarlamalı Kartın dinamik içeriğini yerelleştirilebilir hale getirmek için:

1. Uyarlamalı Kartınızdan önce Bir Set değişken değeri düğümü ekleyin. Bu adım, düğümü Bir Metin değişkeni ayarla düğümüne dönüştürmek için kod düzenleyicisini kullanarak güncelleştirebileceğiniz bir YAML gösterimi oluşturur. Metin değişkeni düğümlerini doğrudan yazma tuvalinden oluşturamazsınız.

2. Değişken değeri ayarla düğümünde yeni bir değişken oluşturun, ancak değeri henüz ayarlamayın.

3. Konunuzun kod düzenleyicisini açın.

4. Kod düzenleyicisinde Değişken değeri ayarla düğümünüzü temsil eden bölümü bulun ve ile kind: SetVariabledeğiştirinkind: SetTextVariable. Bu değişiklik , Değişken değeri ayarla düğümünüzü bir Metin değişkenini ayarla düğümüne dönüştürür.

5. Kod düzenleyicisini kapatın.

6. Metin değişkenini ayarla düğümünün alt alanını seçin ve Uyarlamalı Kartınızda göstermek istediğiniz statik metin ve değişkenleri içeren tam dizeyi girin. Bir değişkeni iletiye eklediğiniz şekilde ekleyin.

7. Uyarlamalı Kartınızı bu yeni değişkene bir başvuruyla güncelleştirin.

8. Konunuzu kaydedin. Artık yerelleştirme dosyasını indirebilir ve Uyarlamalı Kartlarınız için dinamik içeriği içerdiğini doğrulayabilirsiniz.

Çok dilli aracıyı test edin

1. Test panelini açın.

2. Test panelinin üstündeki üç noktayı (...) seçin ve istediğiniz dili seçin. Test paneli bu kez seçilen dili kullanarak kendisini yeniden yükler. Yazma tuvali birincil dilde kalır ve birincil dile geri dönene kadar bir konuda yaptığınız değişiklikleri kaydedemezsiniz.

3. Aracıyı test etmek için seçilen dilde bir iletiyi girin.

Ayrıca tarayıcınızın dilini aracınızın dillerinden birine ayarlayabilir ve önceden oluşturulmuş tanıtım web sitesine gidebilirsiniz. Tanıtım web sitesi belirtilen dilde açılır ve aracı bu dilde sohbet eder.

Bir ajanın başka bir dile geçmesini sağla

Yazarken, aracıyı konuşmanın ortasında başka bir dile geçecek şekilde yapılandırabilirsiniz. Mantık aracıdaki herhangi bir konuda bulunabilir. Ancak, en iyi uygulama, bir Soru düğümünden hemen sonra dili değiştirmektir. Bu da bir sonraki Soru düğümüne kadar sonraki tüm iletilerin aynı dilde olmasını sağlar.

Aracının geçerli dilini değiştirmek için User.Language aracınızın ikincil dillerinden birine ayarlayın. Bu seçim, aracınızın konuştuğu dili hemen değiştirir.

Dinamik dil değiştirme için aracı ayarlama

Not

Bu özellik yalnızca üretken orkestrasyon özelliği etkinleştirilmiş aracılar için kullanılabilir.

Bir aracıyı müşterinin kullandığı dili algılayıp aynı dilde yanıt verecek şekilde yapılandırabilirsiniz. Bu yapılandırmayla aracı, tek bir konuşma boyunca dilleri birden çok kez değiştirebilir. Aşağıdaki senaryoda, Felemenkçe ve İngilizce arasında geçiş yapmak için bir temsilciyi nasıl ayarlayacağınız gösterilmektedir. Aracınızın desteklediği dillerin herhangi bir bileşimi için genişletebilirsiniz.

Bu senaryoda, Mesaj alındıkonu tetikleyicisine sahip bir konu kullanılır. Bu konu tetikleyicisi, aracınızın aldığı her iletiyi incelemesine olanak tanır. Bu konu, dili algılamak için özel bir istem ve aracı dili sistem değişkenini ayarlamak için bir koşul kullanır.

1. Konu başlığı oluşturun.

2. Konu için varsayılan tetikleyici türünübir ileti alındı olarak değiştirin.

3. Konunuza bir istem ekleyin:

   1. Add node simgesini Tetikleyici düğümü altından seçin.

   2. Araç ekle>Yeni istem'i seçin.

   3. İstem düzenleyicisinde, isteminiz için "Dili algıla" gibi bir temsili ad girin.

   4. Yönergeler bölmesinde "Bu iletinin hangi dilde yazıldığına karar verin: ".

   5. Yönergeler bölmesinin en altında İçerik ekle'yi ve ardından Metin'i seçin. Sizi bir ad ve örnek ileti girmeye davet eden bir pencere görüntülenir.

   6. Ad alanına "İleti" yazın. Örnek veriler için "Kullanıcıdan gelen ileti" yazın ve Kapat'ı seçin.

   7. Model yanıtı bölmesinde Çıkış biçimini JSON olarak değiştirin.

   8. Test'i seçin. İsteminizde dili İngilizce olarak tanımlayan tek bir özelliğe sahip bir JSON sabiti gösteriliyor.

      

   9. Kaydetseçeneğini seçin. Tuvalde bir İstem düğümü görüntülenir.

4. İstem düğümünü yapılandırın:

   1. Giriş için sistem değişkeniniActivity.Text (gelen iletinin metni) seçin.
   2. Çıkış için adlı DetectedLanguage.

5. Algılanan dile göre mantığınızı dallandırın:

   1. İstem düğümünü altına bir koşul ekleyin.

   2. Koşulunuzu algılanan dilin adını tutan özel değişkenine DetectedLanguage.structuredOutput.languagedayandırın.

   3. Algılamanız gereken her dil için bir koşul dalı ekleyin.

   4. Sistem değişkenini uygun şekilde ayarlamak için her dalın User.Language altına Değişken değeri ayarla düğümü ekleyin. Aşağıdaki görüntüde, Felemenkçe ile İngilizce arasında geçiş yapma koşulu olan bir konu gösterilmektedir.

      

Çok dilli bir ajanın sorunlarını giderme

Bu bölüm, beklenmeyen çok dilli aracı davranışını anlamak için ipuçları sağlar.

Yapılandırılmamış diller için çok dilli aracı davranışı

Kullanıcı tarayıcısını aracı için yapılandırmadığınız bir dil için yapılandırırsa, aracı birincil diline geri döner.

Aracıyı oluştururken bir aracı için birincil dili belirtirsiniz. Oluşturma işleminden sonra birincil dili değiştiremezsiniz, ancak birden fazla bölge varsa aracının birincil dili için bölgeyi değiştirebilirsiniz .

Eksik çeviriler için çok dilli aracı davranışı

Bir aracıya birincil dilinde mesajlar eklerseniz, ancak yeni mesajların çevirilerini karşıya yüklemezseniz, aracı bu çevrilmemiş değişiklikleri birincil dilinde gösterir. Aracıda değişiklik yaptıktan sonra her zaman çevirilerin güncel olduğundan emin olun.

Yerelleştirme dosyaları, Uyarlamalı Kartlardan karışık türemiş dizeler içermez. Bir dizenin hem statik metin hem de değişkenleri (dinamik içerik) içerebileceği Uyarlamalı Kartları yerelleştirmeniz gerekiyorsa, geçici bir çözüm kullanmalısınız. Karışık türdeki bir dizeyi Uyarlamalı Kart'ta kullanmadan önce bir metin değişkeninde depolamayı öğrenin.

Çok dilli bir aracı yayınlarken oluşan hatalar

Çok dilli bir aracı yayınlamaya çalıştığınızda, ham yanıt hata kodu SynonymsNotUnique ile birlikte "Bot için doğrulama başarısız oldu" hata mesajını görüyorsanız, yerelleştirme dosyanız ya yinelenen eş anlamlılar ya da DisplayName değeriyle eşleşen bir eş anlamlı içeriyor demektir. Genellikle bir düğüm aşağıdaki senaryolardan birinin oluştuğu bir Entity.Definition.'closedListItem' durum içerdiğinde bu hatayla karşılaşırsınız:

• Öğelerden Synonyms biri benzersiz değildir .
• Synonyms öğelerinden biri, DisplayName öğesiyle aynı değere sahiptir.

Aynı varlık için tüm Synonyms'ler benzersiz olmalı ve DisplayName öğesinden farklı bir ada sahip olmalıdır.

Hatayı düzeltmek için ikincil dilinizin JSON veya ResX dosyasını gözden geçirin ve bu koşulun mevcut olabileceği örnekleri belirleyin.