Metin Çevirisi bilişsel becerisi
Metin Çevirisi becerisi metni değerlendirir ve her kayıt için belirtilen hedef dile çevrilen metni döndürür. Bu beceri, Azure AI hizmetlerinde kullanılabilen Translator Metin Çevirisi API'sini v3.0 kullanır.
Bu özellik, belgelerinizin tümünün tek bir dilde olmayabileceğini düşünüyorsanız kullanışlıdır. Bu durumda, çeviri yaparak arama için dizin oluşturmadan önce metni tek bir dile normalleştirebilirsiniz. Aynı metnin kopyalarının birden çok dilde kullanılabilir olmasını isteyebileceğiniz yerelleştirme kullanım örnekleri için de kullanışlıdır.
Translator Metin Çevirisi API'si v3.0 bölgesel olmayan bir Azure yapay zeka hizmetidir. Bu, verilerinizin Azure AI Search veya ekli Azure AI hizmetleri kaynağınızla aynı bölgede kalmasının garanti olmadığı anlamına gelir.
Not
Bu beceri Azure AI hizmetlerine bağlıdır ve günlük dizin oluşturucu başına 20 belgeyi aşan işlemler için faturalanabilir bir kaynak gerektirir. Yerleşik becerilerin yürütülmesi, mevcut Azure AI hizmetlerinin kullandıkça öde fiyatından ücretlendirilir.
Bu beceri kullanılırken, kaynak ve hedef diller aynı olsa bile kaynaktaki tüm belgeler işlenir ve çeviri için faturalandırılır. Bu davranış, aynı belge içindeki çok dilli destek için kullanışlıdır, ancak gereksiz işlemeye neden olabilir. İşlenmesi gerekmeyen belgelerden beklenmeyen faturalama ücretlerini önlemek için, beceriyi çalıştırmadan önce bunları veri kaynağı kapsayıcısından taşıyın.
@odata.type
Microsoft.Skills.Text.TranslationSkill
Veri sınırları
Kaydın boyut üst sınırı, tarafından String.Lengthölçülen 50.000 karakter olmalıdır. Verilerinizi metin çevirisi becerisine göndermeden önce bölmeniz gerekiyorsa Metin Bölme becerisini kullanmayı göz önünde bulundurun. Metin bölme becerisi kullanıyorsanız en iyi performans için sayfa uzunluğunu 5000 olarak ayarlayın.
Beceri parametreleri
Parametreler büyük/küçük harfe duyarlıdır.
| Girişler | Açıklama |
|---|---|
| defaultToLanguageCode | (Gerekli) Açıkça "to" dilini belirtmeyen belgeler için belgelerin çevrildiği dil kodu. Desteklenen dillerin tam listesini görün. |
| defaultFromLanguageCode | (İsteğe bağlı) Açıkça "kimden" dilini belirtmeyen belgeler için belgelerin çevrildiği dil kodu. defaultFromLanguageCode belirtilmezse, Translator Metin Çevirisi API'sinin sağladığı otomatik dil algılaması "kimden" dilini belirlemek için kullanılır. Desteklenen dillerin tam listesini görün. |
| suggestedFrom | (İsteğe bağlı) Belgenin belirtilmemiş veya defaultFromLanguageCode belirtilmemiş olup olmadığının fromLanguageCode çevrildiği dil kodu ve otomatik dil algılama başarısız olur. suggestedFrom dili belirtilmezse, suggestedFrom dili olarak İngilizce (en) kullanılır. Desteklenen dillerin tam listesini görün. |
Beceri girişleri
| Giriş adı | Açıklama |
|---|---|
| text | Çevrilecek metin. |
| toLanguageCode | Metnin çevrilmesi gereken dili gösteren bir dize. Bu giriş belirtilmezse, metni çevirmek için defaultToLanguageCode kullanılır. Desteklenen dillerin tam listesini görün. |
| fromLanguageCode | Metnin geçerli dilini gösteren dize. Bu parametre belirtilmezse, metni çevirmek için defaultFromLanguageCode (veya defaultFromLanguageCode sağlanmadıysa otomatik dil algılama) kullanılır. Desteklenen dillerin tam listesini görün. |
Beceri çıkışları
| Çıkış adı | Açıklama |
|---|---|
| translatedText | translatedFromLanguageCode'dan translatedToLanguageCode'a metin çevirisinin dize sonucu. |
| translatedToLanguageCode | Metnin çevrildiği dil kodunu gösteren bir dize. Birden çok dile çevriliyorsanız ve hangi metnin hangi dilde olduğunu takip edebilmek istiyorsanız kullanışlıdır. |
| translatedFromLanguageCode | Metnin çevrildiği dil kodunu gösteren bir dize. Bu çıkış size bu algılamanın sonucunu vereceğinden otomatik dil algılama seçeneğini seçtiyseniz kullanışlıdır. |
Örnek tanım
{
"@odata.type": "#Microsoft.Skills.Text.TranslationSkill",
"defaultToLanguageCode": "fr",
"suggestedFrom": "en",
"context": "/document",
"inputs": [
{
"name": "text",
"source": "/document/text"
}
],
"outputs": [
{
"name": "translatedText",
"targetName": "translatedText"
},
{
"name": "translatedFromLanguageCode",
"targetName": "translatedFromLanguageCode"
},
{
"name": "translatedToLanguageCode",
"targetName": "translatedToLanguageCode"
}
]
}
Örnek girdi
{
"values": [
{
"recordId": "1",
"data":
{
"text": "We hold these truths to be self-evident, that all men are created equal."
}
},
{
"recordId": "2",
"data":
{
"text": "Estamos muy felices de estar con ustedes."
}
}
]
}
Örnek çıktı
{
"values": [
{
"recordId": "1",
"data":
{
"translatedText": "Nous tenons ces vérités pour évidentes, que tous les hommes sont créés égaux.",
"translatedFromLanguageCode": "en",
"translatedToLanguageCode": "fr"
}
},
{
"recordId": "2",
"data":
{
"translatedText": "Nous sommes très heureux d'être avec vous.",
"translatedFromLanguageCode": "es",
"translatedToLanguageCode": "fr"
}
}
]
}
Hatalar ve uyarılar
"Kime" veya "kaynak" dili için desteklenmeyen bir dil kodu sağlarsanız, bir hata oluşturulur ve metin çevrilemez. Metniniz boşsa bir uyarı oluşturulur. Metniniz 50.000 karakterden büyükse yalnızca ilk 50.000 karakter çevrilir ve bir uyarı verilir.