Arapça, İngilizce ve İspanyolca konuşan kullanıcılara yönelik bir yapay zekâ özelliği, aslında tek kod tabanını paylaşan üç üründür. Arapça için ekranın yönü çevrilmelidir. Mesajlar tek satırda birden fazla yazı sistemini karıştırır. Sayılar ve tarihler bölgeye göre biçim değiştirir. Model yanlış dilde yanıt verebilir ve her dilin maliyeti farklıdır. Bu sorunların çoğu tek bir tasarım hatasından doğar: “dil”i tek bir ayar olarak görmek.
Bu yazı ürün ve arayüz tarafını ele alıyor. Uygulamanızın kendi metinlerini (yer tutucular, çoğullar, ICU mesajları) çevirmek uygulama metinlerini LLM ile Arapçaya çevirme yazısında; istem yazımı ise Arapça istem mühendisliği yazısında.
Arayüz yerel ayarı neden model dilinden ayrı tutulmalı?
Çünkü farklı sorulara yanıt verirler. Arayüz yerel ayarı (ar-SA, en-US, es-MX) düzenin yönünü, düğmelerinizin dilini ve sayılarla tarihlerin görünümünü belirler. İçerik dili ise belirli bir mesajın, belgenin veya kaydın dilidir ve modelden ne isteyeceğinizi belirler.
İkisi sürekli ayrışır. Arapça arayüz kullanan Suudi bir kullanıcı İngilizce bir sözleşme yapıştırır. İspanyolca konuşan bir kullanıcı Arapça bir fatura fotoğrafı yükler. İki dilli bir müşteri temsilcisi konuşmanın ortasında dil değiştirir (kod değiştirme). Kod, arayüz Arapça olduğu için “Arapça yanıt ver” gönderirse, İngilizce sözleşme kimsenin istemediği Arapça bir özet alır.
Bu yüzden ikisini de kullanıcı başına ve mesaj başına saklayın:
ui_locale: kullanıcı seçer; varsayılanı tarayıcının dilidir.answer_language: kullanıcı açıkça seçtiyse o, aksi hâlde mesajın tespit edilen dili.- Ses için
audio_language: transkripsiyon modeline geçirdiğiniz değer. BroadNet’in API başvurusu, transkripsiyon isteğindelanguagedeğerini her zaman göndermenizi söylüyor; aksi hâlde Arapça Latin harfleriyle dönebilir.
Sağdan sola ve karışık yönlü metin nasıl desteklenir?
W3C yönergelerine göre üç katmanda:
- Sayfa yönü yerel ayardan. Arapça için
htmlöğesinedir="rtl"velang="ar"verin. W3C, temel yönün CSS ile ayarlanmamasını ve kenar boşlukları, iç boşluklar ve hizalama için sol ve sağ yerine mantıksal değerlerin (startveend) kullanılmasını söylüyor. - Mantıksal CSS.
margin-leftyerinemargin-inline-start,leftyerinetext-align: start. MDN mantıksal özellikleri, düzeni “through logical rather than physical direction” (BroadRouter çevirisi: fiziksel değil mantıksal yön üzerinden) kontrol eden özellikler olarak tanımlıyor. Böylece tek bir stil sayfası iki yöne de hizmet eder. - Sizin yazmadığınız metni yalıtın. Kullanıcı mesajlarının, model yanıtlarının, ürün adlarının ve sipariş kodlarının kendi yönleri vardır. W3C’nin kuralı: çalışma anında eklenen metnin yönünü bilmiyorsanız, onu saran öğeye
dir="auto"ekleyin veya birbdiöğesine sarın. Yalıtım olmadan, Arapça bir cümlenin sonundaki İngilizce bir sipariş kodu yanlış tarafa sıçrayabilir ve noktalama işaretleri tuhaf yerlere düşer.
Bir sohbet arayüzünde bu, her mesaj balonuna dir="auto" vermek demektir, çünkü her mesaj yönünü ilk güçlü karakterinden alır; kendi arayüz metinlerinizin içindeki adlar ve kodlar için de bdi kullanılır. İşaretlemenin olmadığı yerlerde (anlık bildirimler, SMS, CSV dışa aktarımları) Unicode Çift Yönlü Algoritması’nın yalıtıcıları aynı işi görür: metinden önce U+2068 FIRST STRONG ISOLATE, sonra U+2069 POP DIRECTIONAL ISOLATE.
Model çıktısı bir durum daha ekler: Markdown. Arapça yanıt veren bir model İngilizce kod, URL veya tablo hücreleri içerebilir. Kod bloklarını açıkça dir="ltr" ile oluşturun, her paragrafa ve tablo hücresine dir="auto" verin.
Sayılar ve tarihler yerel ayara göre nasıl değişmeli?
Biçimlendirmeyi platforma bırakın ve gerçekte ne ürettiğini test edin. Node 24.22.1’de (ICU 78.3, CLDR 48) 1234.5 sayısı ve 15 Kasım 2026 tarihi için Intl.NumberFormat ve Intl.DateTimeFormat çalıştırdık:
| Yerel ayar | Sayı | Tarih (uzun) | Yön |
|---|---|---|---|
| en-US | 1,234.5 | November 15, 2026 | ltr |
| ar-SA | ١٬٢٣٤٫٥ | ١٥ نوفمبر ٢٠٢٦ | rtl |
| ar-SA-u-nu-latn | 1,234.5 | 15 نوفمبر 2026 | rtl |
| ar-AE | 1,234.5 | 15 نوفمبر 2026 | rtl |
| es-ES | 1234,5 | 15 de noviembre de 2026 | ltr |
| es-MX | 1,234.5 | 15 de noviembre de 2026 | ltr |
Dört noktaya dikkat edin. Arapça yerel ayarlar rakamlarda ayrışıyor: Suudi Arabistan varsayılan olarak Arap-Hint, BAE Batı rakamlarını kullanıyor; -u-nu-latn uzantısı (MDN’nin numberingSystem sayfasına bakın) bir yerel ayarı Batı rakamlarına geçiriyor. İspanyolca bölgeye göre değişiyor: İspanya ondalık için virgül kullanıyor ve dört basamaklı bir sayıda binlik ayırıcı koymuyor; Meksika nokta kullanıyor. Ay adları da Arap dünyasında farklılaşıyor: ar-SA Kasım için نوفمبر yazdırırken ar-MA نونبر yazdırdı. Ayrıca tarayıcılar kendi ICU sürümleriyle gelir; aynı kontrolleri hedef tarayıcılarınızda da çalıştırın.
Çoğullar CLDR kurallarını izler: ar için Intl.PluralRules, 0, 1, 2, 3, 11 ve 100 sayılarına altı kategori döndürdü (zero, one, two, few, many, other); İngilizce ve İspanyolca aynı sayılar için yalnızca one ve other döndürdü. Bunun metinler tarafı uygulama metinleri yazısında.
Girdide iki rakam biçimini de kabul edin. Bir kullanıcı miktar alanına ١٢٣٤ yazabilir; ayrıştırmadan önce ve istemleriniz sayıları karşılaştırıyorsa modele göndermeden önce ASCII rakamlarına normalleştirin.
Her mesajın dilini tespit edebilir misiniz?
Kısmen. Arap yazısını Latin yazısından ayırmak kolay ve güvenilirdir: Arapça Unicode bloğundaki karakterleri sayın. İngilizceyi İspanyolcadan ayırmak veya çok kısa mesajları okumak için eğitilmiş bir model gerekir. fastText, 176 dil için iki dil tanıma modeli yayımlıyor (lid.176.bin, 126 MB, ve sıkıştırılmış lid.176.ftz, 917 kB).
Yukarıdaki kararlar için küçük bir yardımcı modül aşağıda. Dedektör, basit yöntemin nerede başarısız olduğunu göstermek için bilerek basit tutuldu.
// UI locale and content language are separate values. Never derive one from the other silently.
const RTL = new Set(['ar', 'he', 'fa', 'ur']);
/** Rough script-based guess: enough to pick a direction and a prompt, not a language-ID model. */
export function guessLanguage(text) {
const arabic = (text.match(/[-ۿݐ-ݿ]/g) || []).length;
const latin = (text.match(/[A-Za-zÀ-ÿ]/g) || []).length;
if (arabic + latin < 3) return 'und';
if (arabic / (arabic + latin) > 0.6) return 'ar';
if (arabic / (arabic + latin) > 0.2) return 'mixed';
return /[ñ¿¡áéíóú]|\b(el|la|los|las|de|que|por|para|está|dónde)\b/i.test(text) ? 'es' : 'en';
}
/** Wrap user or model text for display inside UI text of either direction (W3C: bdi / dir="auto"). */
export const isolate = (s) => `<bdi>${s.replace(/[&<>"]/g, (c) => ({ '&': '&', '<': '<', '>': '>', '"': '"' })[c])}</bdi>`;
/** Plain-text equivalent for places with no markup (notifications, CSV, SMS): FSI ... PDI. */
export const isolateText = (s) => `${s}`;
export function formatters(uiLocale) {
return {
dir: RTL.has(new Intl.Locale(uiLocale).language) ? 'rtl' : 'ltr',
number: new Intl.NumberFormat(uiLocale),
date: new Intl.DateTimeFormat(uiLocale, { dateStyle: 'long', timeZone: 'UTC' }),
plural: new Intl.PluralRules(uiLocale),
};
}
/** Normalise digits a user typed before parsing: Arabic-Indic and Persian to ASCII. */
export const toAsciiDigits = (s) =>
s.replace(/[٠-٩]/g, (d) => d.charCodeAt(0) - 0x0660).replace(/[۰-۹]/g, (d) => d.charCodeAt(0) - 0x06F0);
/** System prompt: the answer language comes from the content, or the user's explicit choice, not the UI. */
export function systemPrompt({ answerLanguage }) {
const name = { ar: 'Arabic', en: 'English', es: 'Spanish' }[answerLanguage] ?? 'the language of the user\'s message';
return `Answer in ${name}. Keep product names, code, URLs and numbers exactly as written.`;
}
Bunu Node 24’te çalıştırdık. وين طلبي؟ metnini ar, “¿Dónde está mi pedido?” metnini es, “Where is my order?” metnini en ve ORD-5521 kodunu içeren Arapça bir cümleyi ar olarak etiketledi. “ok” için und döndü; bu da istemde doğru biçimde “the language of the user’s message” (kullanıcının mesajının dili) seçeneğine düşüyor. Latin harfleriyle Mısır Arapçası (Arabizi) olan “ana 3ayez a3raf el order fen” ise es döndü, çünkü “el” sözcüğü İspanyolca görünüyor. Bir sezgisel yöntemden alınacak dürüst sonuç budur. Kullanıcılarınız Arabizi yazıyorsa, bunu Arabizi’yi ele alma yazısındaki gibi açıkça tespit edip Arapça sayın ve kullanıcıların yanıt dilini tek dokunuşla düzeltmesine izin verin.
Rakam yardımcısı ٢٠٢٦-١١-١٥ değerini 2026-11-15’e çevirdi; isolate() de sarmadan önce HTML’i kaçışladı, böylece Acme <Ltd> gibi bir şirket adı işaretleme enjekte edemez.
Dil değişince başka neler değişir?
- Metin uzunluğu. Çevrilmiş arayüz metni genellikle daha uzundur. W3C, 10 karaktere kadar olan İngilizce metinlerin Avrupa dillerinde uzunluklarının %200–300’üne, 70 karakterden uzun metinlerin yaklaşık %130’una çıkmasını öngören IBM yönergelerini aktarıyor. Düğmeleri ve etiketleri satır kaydırabilecek şekilde tasarlayın ve İspanyolca derlemeyi dar genişliklerde test edin.
- Yazı tipleri. Uyumlu bir Arapça tasarımı olan bir yazı tipi ailesi seçin ve Arapça satır yüksekliğini kontrol edin: harekeler için üstte ve altta yer gerekir.
- Arama ve eşleştirme. Arapça metin, eşleştirmeden önce normalleştirme ister (harekeler, elif biçimleri, tatvil). Arapça metin normalleştirici her kuralı gösteriyor.
- Konuşma. Transkripsiyon modelini arayüze göre değil, sesin diline göre seçin. BroadNet, bir Arapça model ve İngilizce, İspanyolca ve Arapçayı kapsayan 14 dilli bir model listeliyor; çok dilli modelin sayfası Arapça ses için Arapça modelin seçilmesini söylüyor. Çok dilli konuşmadan metne yazısı seçenekleri karşılaştırıyor.
- Lehçe. “Arapça” tek bir hedef değil. Riyad, Kahire ve Kazablanka’daki kullanıcılar farklı yazar; neyi test etmeniz gerektiği Körfez ve Mısır lehçeleri yazısında.
Her dil nasıl değerlendirilir ve bütçelenir?
Ayrı ayrı. Tek bir birleşik puan zayıf bir dili, tek bir birleşik bütçe de pahalı bir dili gizler.
Her dil için gerçek mesajlardan küçük bir değerlendirme seti oluşturun ve beklenen yanıtları anadili konuşanlara etiketletin. Yanıtın istenen dilde olduğunu, adların, sayıların ve kodların değişmeden kaldığını ve hizmet verdiğiniz her lehçede kalitenin korunduğunu kontrol edin. Modeli veya istemi değiştirdiğinizde aynı seti yeniden çalıştırın; yöntem geçişten önce LLM değerlendirme yazısında.
Maliyette token sayıları dile ve tokenizer’a göre değişir. BroadRouter’ın ölçülmüş veri setinde aynı Modern Standart Arapça metin, İngilizce çevirisinin token sayısının 1.31× (Qwen3.8 27B) ile 1.77× (GLM 5.3) katı arasında token gerektiriyor. Dile göre gerçek maliyet bu sayıları İspanyolca dahil model başına paraya çeviriyor; Arapça token sayacı da kendi metninizi ölçüyor. Token’ları her istek için içerik diliyle birlikte kaydedin; böylece maliyeti yalnızca aylık değil, kullanıcı başına ve dil başına görebilirsiniz.
Son olarak, yayına almadan önce anadili konuşan birine inceletin. Makine çevirisi de model çıktısı da dilbilgisi açısından doğru ama hedef kitleniz için yanlış Arapça ve İspanyolca üretebilir. Ürünü kendi dilinde kullanan bir inceleyici, hiçbir testin yakalayamadığını yakalar.
BroadNet Inference nereye oturuyor?
BroadRouter, BroadNet’in kendi sitesidir. BroadNet Inference’ın modelleri Arapça, İngilizce ve İspanyolca bir ürün için makul bir seçenek: BroadNet, Qwen3.8 27B modelini Körfez ve Mısır lehçelerini anlama dahil Arapçada test ettiğini bildiriyor; Gemma 4 VL 26B $5 başlangıç kredisiyle çalışıyor; transkripsiyon ise Arapçayı (BroadNet Transcribe Arabic, dakika başına $0.0042) ve İngilizce ile İspanyolca dahil 14 dili (BroadNet Transcribe, dakika başına $0.002) kapsıyor. Çıkarım içeriği saklanmaz; gerekli hesap, faturalandırma ve güvenlik meta verileri BroadNet’in gizlilik bildiriminde açıklandığı şekilde saklanır. Bu yazıdaki düzen, yön, biçimlendirme ve tespitle ilgili her şey, hangi API’yi kullanırsanız kullanın uygulamanızın işidir.
