BroadRouter

Arapça istem mühendisliği: dil düzeyi, RTL, rakamlar, karışık metin

BroadNet Inference ekibi · 5 dk okuma · Yayımlandı · Güncellendi

İyi Arapça çıktı açık talimatlardan gelir: dil düzeyini (MSA ya da belirli bir lehçe), hedef kitleyi, rakam stilini (Batı 0–9 ya da Doğu Arap ٠–٩), izin verilen biçimlendirmeyi ve İngilizce terimlerin nasıl ele alınacağını belirtin. Karışık Arapça ve İngilizcenin doğru sırada görünmesi için yanıtları dir="auto" ya da yalıtım işaretleriyle gösterin.

Bir LLM’den iyi Arapça almak için modelin aksi hâlde tahmin edeceği her seçimi belirtin: Modern Standart Arapça mı yoksa adı konmuş bir lehçe mi, hedef kitle ve üslup, Batı (123) mı Doğu Arap (١٢٣) rakamları mı, tarih ve para birimi biçimi, İngilizce terimlerin nasıl yazılacağı ve hareke eklenip eklenmeyeceği. Ardından sağdan sola gösterimi istemde değil, arayüzünüzde düzeltin.

Dil düzeyi ve lehçe nasıl belirtilir?

Arapçanın resmî bir yazılı standardı, Modern Standart Arapça (MSA, الفصحى), ve birçok konuşma lehçesi vardır. İş metinleri genellikle MSA’dır; sohbet, pazarlama ve ses ürünleri bazen lehçe kullanır. Modele tam olarak hangisini istediğinizi söyleyin:

Bunun yerine Bunu söyleyin
Arapça yanıt ver. Perakende müşterilerine uygun, açık ve sade Modern Standart Arapçayla yanıt ver.
Körfez lehçesi kullan. Genç bir markanın yapacağı gibi, gayriresmî ama saygılı, Suudi (Necid ağzına yakın) Körfez Arapçasıyla yaz.
Samimi ol. Sıcak ve kibar ol. Mısırlı müşteriler için “حضرتك” kullan; argodan kaçın.

Birkaç pratik kural:

  • “Sade MSA” en güvenli varsayılandır. Her yerde anlaşılır ve profesyonel görünür. Modeller onu lehçeden daha güvenilir yazar.
  • “Körfez” ya da “Levant” değil, ülkeyi adlandırın. Suudi, Emirlik ve Kuveyt konuşmaları birbirinden farklıdır; Lübnan ve Ürdün konuşmaları da öyle.
  • Hitap biçimi. Arapça “sen” zamirinde cinsiyet işaretler. Bir varsayılan seçin (arayüz metinlerinde eril tekil yaygın nötr biçimdir) ya da modelden mümkün olduğunda cinsiyetten bağımsız ifadeler kullanmasını isteyin; örneğin emir kipi “أدخل/أدخلي” yerine isim biçimli “يرجى إدخال” (lütfen girin).
  • Harekeler. Normal metin için “hareke yok” deyin. Çoğu model varsayılan olarak az hareke ekler, ama bazıları isimlere ya da şiir tarzı yanıtlara ekler.

Lehçe girdisi için LLM’lerin Körfez, Mısır ve Levant Arapçasını nasıl işlediği yazısına bakın.

Rakamlar, tarihler ve para birimi nasıl kontrol edilir?

Arapça metin iki rakam seti kullanır: Batı rakamları (0–9) ve Doğu Arap rakamları (٠١٢٣٤٥٦٧٨٩). Okuyucuların hangisini beklediği ülkeye ve mecraya göre değişir; söylenmedikçe modeller bunları karıştırır. O pazardaki mevcut materyallerinizin ne kullandığına bakarak ürün başına karar verin:

  • Batı rakamları ayrıştırma, arama ve veri girişi için en kolayıdır.
  • Doğu Arap rakamları daha geleneksel bir görünüme uyar. Bunlara ihtiyacınız varsa gösterim anında dönüştürün ve verinizde Batı rakamlarını tutun.

Ayrıca belirtin:

  • Tarihler: Miladi, Hicri ya da ikisi birden ve biçim (örneğin 2026-11-14 ya da ١٤ نوفمبر ٢٠٢٦). Ay adlarının bölgeye göre değiştiğine dikkat edin: Mısır’da ve Körfez’de نوفمبر, Levant’ta ve Irak’ta تشرين الثاني.
  • Para birimi: Sembol mü kod mu, konumu ne? “ر.س” mi “SAR” mı? Sayıdan önce mi sonra mı? Bir örnek verin.
  • Ondalık ayırıcı: ”.” ya da Arapça ondalık işareti ”٫”.

İstemdeki tek bir çalışılmış örnek bunların çoğunu çözer: “Fiyatları şöyle yaz: 1,250.00 ر.س”.

Sağdan sola gösterim sorunları nasıl düzeltilir?

“Arapça bozuk” hata raporlarının çoğu model sorunu değil, gösterim sorunudur. Arapça ile Latin metin ya da sayılar aynı satırı paylaştığında, görsel sırayı paragraf yönüne göre Unicode çift yönlü algoritması belirler. Sohbet balonunuz soldan sağa ise, “تم شحن طلبك رقم 4821.” gibi bir yanıtta nokta yanlış uçta görünebilir.

Bunu arayüzde düzeltin:

  • Her mesajı gösteren öğeye dir="auto" (yalnızca Arapça görünümler için dir="rtl") verin. dir özniteliği hakkında MDN sayfasına ve W3C’nin sağdan sola biçimlendirme rehberine bakın.
  • Arapça şablonlara değer eklerken (isimler, sipariş numaraları, İngilizce ürün adları) bunları HTML’de <bdi> içine, düz metinde ise Unicode yalıtımlarının (U+2068 FIRST STRONG ISOLATE … U+2069 POP DIRECTIONAL ISOLATE) arasına alın.
  • İstemde, gösterim yüzeyinizin gösterebileceği biçimlendirmeyi isteyin. WhatsApp ve SMS: düz metin, Markdown tablo yok. Web sohbeti: oluşturucunuz RTL listeleri işliyorsa Markdown olur. Kod blokları soldan sağa kalmalıdır.

Yanıtları akış (streaming) olarak gönderiyorsanız, metin zıplamasın diye yönü ilk token gelmeden önce kapsayıcıya verin; akış rehberine bakın.

Model Arapça ile İngilizceyi nasıl karıştırmalı?

Gerçek Arapça iş metinleri dilleri karıştırır: ürün adları, teknik terimler, birimler, kod. Kurala karar verin ve söyleyin:

  • “Marka ve ürün adlarını özgün Latin yazımıyla tut.”
  • “Teknik terimleri Arapça yaz, ilk geçtiği yerde İngilizce terimi parantez içinde ver: واجهة برمجة التطبيقات (API).”
  • “İngilizce kelimeleri asla Arap harflerine çevirme” ya da kitleniz “البريد الإلكتروني” yerine “الإيميل” tercih ediyorsa tersi.
  • “Kullanıcı İngilizce yazarsa İngilizce yanıt ver. Arabizi yazarsa Arap alfabesiyle yanıt ver.” Bunun ayrıntısı Arabizi’yi işlemek yazısında.

Sistem istemi İngilizce mi olmalı, Arapça mı?

İkisi de çalışır. Arapça içerikle İngilizce talimatlar yaygındır ve ekibinizin tamamı Arapça okumuyorsa sürdürmesi kolaydır. Arapça talimatlar üslubu ve kelime seçimini doğru yöne itebilir. Hangisini seçerseniz seçin, her sistem isteminde tek dil kullanın ve her iki durumda da içine istenen çıktının Arapça bir örneğini koyun. Arapça talimatlar, aynı kuralların İngilizcesinden daha fazla token tutabilir; ikisini ücretsiz Arapça token sayacında karşılaştırın. Tokenizer verimliliği verilerimiz aynı Arapça ve İngilizce cümlelerin 16 tokenizer’da kaç token tuttuğunu gösteriyor.

Eksiksiz bir örnek:

import os
from openai import OpenAI

client = OpenAI(base_url="https://inference.broadnet.ai/v1", api_key=os.environ["BROADNET_API_KEY"])

SYSTEM = """You are the support assistant for an Egyptian electronics store.
Language: reply in simple Modern Standard Arabic. If the customer writes in English, reply in English.
Tone: warm, polite, concise. At most 3 sentences.
Numbers: Western digits. Prices like: 12,499 ج.م
Dates: Gregorian, like: 14 نوفمبر 2026
Names: keep brand and model names in Latin letters (iPhone 17, Galaxy S26).
Formatting: plain text only, no Markdown, no diacritics.
Example reply:
شكراً لتواصلك معنا. سعر Galaxy S26 حالياً 12,499 ج.م، والتوصيل متاح خلال يومين."""

r = client.chat.completions.create(
    model="broadnet/qwen3.8-27b",
    max_tokens=2000,  # reasoning comes first
    messages=[{"role": "system", "content": SYSTEM},
              {"role": "user", "content": "عايز أعرف سعر الايفون ١٧ وهل في تقسيط؟"}],
)
print(r.choices[0].message.content)

Müşteri Doğu Arap rakamlarıyla Mısır Arapçası yazıyor (“iPhone 17’nin fiyatını öğrenmek istiyorum, taksit var mı?”). İstem, yanıtı Batı rakamlarıyla MSA yapıyor. İstemdeki örnek yanıt şöyle: “Bizimle iletişime geçtiğiniz için teşekkürler. Galaxy S26’nın şu anki fiyatı 12,499 EGP ve teslimat iki gün içinde mümkün.”

Arapça yapılandırılmış çıktı nasıl alınır?

JSON gerektiğinde anahtarları İngilizce, değerleri Arapça tutun. Sayıların sayı mı dize mi olacağını ve dizelerin içinde hangi rakam setinin kullanılacağını söyleyin. Tahmin yerine null isteyin. Bkz. JSON şemasıyla yapılandırılmış çıktı.

Arapça istemler nasıl test edilir?

Pazar başına 30 ila 50 gerçek istemden bir set kurun, bunları her aday modelde çalıştırın ve o pazarın anadili konuşuruna dil düzeyini, doğruluğu ve doğallığı puanlatın. BroadNet, testlerinde Qwen3.8 27B modelinin akıcı Arapça yazdığını ve Körfez ile Mısır lehçelerini anladığını bildiriyor; DeepSeek V4.1 Flash ve GLM 5.3 aynı API’de, yani geçiş tek satırlık bir değişiklik. Fiyatlarını fiyatlar sayfasında ya da DeepSeek V4.1 Flash ve Qwen3.8 27B karşılaştırmasında karşılaştırın ve Arapça çoğu zaman İngilizceden kelime başına daha fazla token tuttuğu için token’ları gerçek Arapça metinde ölçün. Daha geniş model seçimi kontrol listesi için Arapça için LLM API seçimi yazısına bakın.

Arapça istem kontrol listesi

  • Dil düzeyi ve ülke adlandırıldı.
  • Hitap biçimine (cinsiyet) karar verildi.
  • Rakamlar, tarihler, para birimi ve ondalık ayırıcı bir örnekle belirtildi.
  • Biçimlendirme gösterim yüzeyine uyduruldu.
  • İngilizce terimler ve marka adları kuralı belirtildi.
  • Arayüzde dir="auto" ve yalıtım.
  • Sabit bir test setinde anadili konuşuru incelemesi.

Sık sorulan sorular

Sistem istemini Arapça mı yazmalıyım, İngilizce mi?

İkisi de güncel modellerde çalışır. İngilizce talimatları çoğu ekip daha kolay sürdürür; Arapça talimatlar bazen daha doğal bir üslup verir. Her sistem istemini tek dilde tutun ve ikisini de kendi test setinizde karşılaştırın.

Arapça metnimde noktalama neden yanlış yerde görünüyor?

Bu bir gösterim sorunudur, genellikle soldan sağa yönlü bir kapsayıcıdan kaynaklanır. Yanıtı gösteren öğeye dir="rtl" ya da dir="auto" verin.

Modelin hareke eklemesini nasıl engellerim?

İsteme "Hareke (teşkil) ekleme" yazın. Hareke yalnızca yardımcı olduğu yerlerde isteyin; örneğin öğrenme materyallerinde ya da belirsiz isimlerde.

Bir LLM'in Doğu Arap rakamlarını kullanmasını nasıl sağlarım?

Bunu sistem isteminde söyleyin ve "Fiyatları şöyle yaz: ١٬٢٥٠ ر.س" gibi bir örnek gösterin. Kural olmadığında modeller rakam setlerini karıştırır. Çıktıyı ayrıştırıyorsanız JSON alanlarında Batı rakamları isteyin ve gösterim için dönüştürün.

En iyi Arapçayı hangi model yazıyor?

Kendi istemlerinizde test edin. BroadNet, testlerinde Qwen3.8 27B'nin akıcı Arapça yazdığını ve Körfez ile Mısır lehçelerini anladığını bildiriyor.

Markdown olarak okuChatGPT asistanına sorClaude asistanına sorPerplexity asistanına sor