BroadRouter

아랍어 프롬프트 엔지니어링: 문체, RTL, 숫자, 혼용 텍스트

BroadNet Inference 팀 · 5분 분량 · 게시 · 업데이트

좋은 아랍어 출력은 명시적인 지시에서 나옵니다. 문체(MSA 또는 특정 방언), 대상 독자, 숫자 표기(서양식 0–9 또는 동아랍 숫자 ٠–٩), 허용할 서식, 영어 용어 처리 방식을 적으세요. 답변은 dir="auto"나 격리 문자로 렌더링해야 아랍어와 영어가 섞인 텍스트가 올바른 순서로 표시됩니다.

LLM에서 좋은 아랍어를 얻으려면, 모델이 짐작으로 정할 선택을 모두 명시하세요. 현대 표준 아랍어인지 특정 방언인지, 대상 독자와 어조, 서양식(123) 숫자인지 동아랍(١٢٣) 숫자인지, 날짜와 통화 형식, 영어 용어 표기 방식, 발음 구별 기호를 붙일지 여부입니다. 그리고 오른쪽에서 왼쪽(RTL) 표시는 프롬프트가 아니라 UI에서 고치세요.

문체와 방언은 어떻게 지정하나요?

아랍어에는 격식 있는 문어 표준인 현대 표준 아랍어(MSA, الفصحى)와 여러 구어 방언이 있습니다. 비즈니스 텍스트는 보통 MSA이고, 채팅, 마케팅, 음성 제품은 방언을 쓰기도 합니다. 모델에 정확히 어느 쪽인지 알려 주세요.

이렇게 쓰는 대신 이렇게 쓰세요
아랍어로 답하세요. 소매 고객에게 맞는 명확하고 쉬운 현대 표준 아랍어로 답하세요.
걸프 방언을 쓰세요. 젊은 브랜드처럼, 격식 없지만 정중한 사우디(나즈드 쪽) 걸프 아랍어로 쓰세요.
친근하게 답하세요. 따뜻하고 정중하게. 이집트 고객에게는 “حضرتك”를 쓰고 속어는 피하세요.

실무 규칙 몇 가지는 다음과 같습니다.

  • “쉬운 MSA”가 가장 안전한 기본값입니다. 어디서나 이해되고 전문적으로 들립니다. 모델도 방언보다 MSA를 더 안정적으로 씁니다.
  • “걸프”나 “레반트”가 아니라 나라를 지정하세요. 사우디, 에미리트, 쿠웨이트 말투가 다르고, 레바논과 요르단 말투도 다릅니다.
  • 호칭 형태. 아랍어의 “당신”에는 성별이 표시됩니다. 기본값을 정하거나(UI 텍스트에서는 남성 단수가 흔한 중립 형태입니다), 가능한 곳에서는 성별 중립 표현을 쓰라고 요청하세요. 예를 들어 명령형 “أدخل/أدخلي”(입력하세요) 대신 명사형 “يرجى إدخال”(입력해 주십시오)를 씁니다.
  • 발음 구별 기호. 일반 텍스트에는 “발음 구별 기호 없이”라고 적으세요. 대부분의 모델은 기본적으로 거의 붙이지 않지만, 일부는 이름이나 시 같은 답변에 붙입니다.

방언 입력은 LLM이 걸프, 이집트, 레반트 아랍어를 처리하는 방식을 참고하세요.

숫자, 날짜, 통화는 어떻게 통제하나요?

아랍어 텍스트에는 서양식 숫자(0–9)와 동아랍 숫자(٠١٢٣٤٥٦٧٨٩), 두 가지 숫자 체계가 쓰입니다. 독자가 기대하는 쪽은 나라와 매체에 따라 다르며, 지시하지 않으면 모델은 섞어 씁니다. 그 시장의 기존 자료가 이미 쓰는 쪽을 기준으로 제품마다 정하세요.

  • 서양식 숫자는 파싱, 검색, 데이터 입력에 가장 쉽습니다.
  • 동아랍 숫자는 더 전통적인 느낌에 맞습니다. 필요하다면 표시할 때 변환하고 데이터에는 서양식 숫자를 두세요.

다음도 지정하세요.

  • 날짜: 그레고리력, 히즈라력, 또는 둘 다, 그리고 형식(예: 2026-11-14 또는 ١٤ نوفمبر ٢٠٢٦). 월 이름은 지역마다 다르다는 점에 유의하세요. 이집트와 걸프에서는 نوفمبر, 레반트와 이라크에서는 تشرين الثاني입니다.
  • 통화: 기호인지 코드인지, 그리고 위치. “ر.س”인가요, “SAR”인가요? 숫자 앞인가요, 뒤인가요? 예시를 하나 주세요.
  • 소수점 구분 기호: ”.” 또는 아랍어 소수점 기호 ”٫”.

프롬프트에 완성된 예시 하나를 넣으면 대부분 해결됩니다. “가격은 이렇게 쓰세요: 1,250.00 ر.س”.

오른쪽에서 왼쪽 표시 문제는 어떻게 고치나요?

“아랍어가 깨졌다”는 버그 신고는 대부분 모델 문제가 아니라 표시 문제입니다. 아랍어와 라틴 문자 텍스트나 숫자가 한 줄에 있으면, Unicode 양방향 알고리즘이 문단 방향을 기준으로 시각적 순서를 정합니다. 채팅 말풍선이 왼쪽에서 오른쪽이면 “تم شحن طلبك رقم 4821.”(번역: 주문 번호 4821이 발송되었습니다.) 같은 답변의 마침표가 반대쪽 끝에 표시될 수 있습니다.

UI에서 고치세요.

  • 각 메시지를 표시하는 요소에 dir="auto"(아랍어 전용 화면이면 dir="rtl")를 설정하세요. dir 속성에 관한 MDN 문서와 오른쪽에서 왼쪽 마크업에 관한 W3C 안내를 참고하세요.
  • 아랍어 템플릿에 값(이름, 주문 번호, 영어 제품명)을 넣을 때는 HTML에서는 <bdi>로, 일반 텍스트에서는 Unicode 격리 문자(U+2068 FIRST STRONG ISOLATE … U+2069 POP DIRECTIONAL ISOLATE)로 감싸세요.
  • 프롬프트에서는 표시 화면이 보여 줄 수 있는 서식을 요청하세요. WhatsApp과 SMS는 Markdown 표 없이 일반 텍스트로, 웹 채팅은 렌더러가 RTL 목록을 처리한다면 Markdown도 괜찮습니다. 코드 블록은 왼쪽에서 오른쪽으로 유지해야 합니다.

답변을 스트리밍한다면 텍스트가 튀지 않도록 첫 토큰이 오기 전에 컨테이너 방향을 설정하세요. 스트리밍 가이드를 참고하세요.

모델은 아랍어와 영어를 어떻게 섞어야 하나요?

실제 아랍어 비즈니스 텍스트는 제품명, 기술 용어, 단위, 코드 등으로 언어가 섞입니다. 규칙을 정해서 말해 주세요.

  • “브랜드명과 제품명은 원래의 라틴 문자 표기를 유지하세요.”
  • “기술 용어는 아랍어로 쓰고 처음 나올 때 영어 용어를 괄호에 넣으세요: واجهة برمجة التطبيقات (API).”
  • “영어 단어를 아랍 문자로 음역하지 마세요.” 또는 독자가 “البريد الإلكتروني”보다 “الإيميل”을 선호한다면 그 반대로.
  • “사용자가 영어로 쓰면 영어로 답하세요. 아라비지로 쓰면 아랍 문자로 답하세요.” 자세한 내용은 아라비지 처리를 참고하세요.

시스템 프롬프트는 영어와 아랍어 중 무엇으로 써야 하나요?

둘 다 작동합니다. 아랍어 콘텐츠에 영어 지시를 쓰는 방식은 흔하며, 팀원 모두가 아랍어를 읽지 못한다면 유지 관리하기 쉽습니다. 아랍어 지시는 어조와 어휘를 올바른 방향으로 이끌 수 있습니다. 어느 쪽을 고르든 시스템 프롬프트 하나에는 한 언어만 쓰고, 어느 경우든 원하는 출력의 아랍어 예시를 안에 넣으세요. 아랍어 지시는 같은 규칙을 영어로 쓸 때보다 토큰이 더 들 수 있습니다. 무료 아랍어 토큰 계산기로 둘을 비교해 보세요. 토크나이저 효율 데이터에서 같은 아랍어와 영어 문장이 16개 토크나이저에서 각각 몇 토큰인지 볼 수 있습니다.

완전한 예시입니다.

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)

고객은 동아랍 숫자를 써서 이집트 방언으로 “아이폰 17 가격이 궁금한데, 할부도 되나요?”라고 묻습니다. 프롬프트 덕분에 답변은 서양식 숫자를 쓴 MSA가 됩니다. 프롬프트 안의 예시 답변은 “문의해 주셔서 감사합니다. Galaxy S26의 현재 가격은 12,499이집트 파운드이며, 이틀 안에 배송 가능합니다.”라는 뜻입니다.

아랍어로 구조화된 출력은 어떻게 받나요?

JSON이 필요하면 키는 영어로, 값은 아랍어로 두세요. 숫자를 숫자로 받을지 문자열로 받을지, 문자열 안에서는 어느 숫자 체계를 쓸지 적으세요. 추측 대신 null을 요청하세요. JSON 스키마를 쓰는 구조화된 출력을 참고하세요.

아랍어 프롬프트는 어떻게 테스트하나요?

시장마다 실제 프롬프트 30~50개로 세트를 만들어 후보 모델마다 돌리고, 그 시장의 원어민에게 문체, 정확성, 자연스러움을 평가받으세요. BroadNet은 자체 테스트에서 Qwen3.8 27B가 자연스러운 아랍어를 쓰고 걸프와 이집트 방언을 이해했다고 보고합니다. DeepSeek V4.1 Flash와 GLM 5.3도 같은 API에 있으므로 전환은 한 줄만 바꾸면 됩니다. 가격은 가격 페이지나 DeepSeek V4.1 Flash와 Qwen3.8 27B 비교에서 비교하고, 아랍어는 영어보다 단어당 토큰이 많은 경우가 많으므로 실제 아랍어 텍스트로 토큰을 측정하세요. 더 넓은 모델 선택 체크리스트는 아랍어용 LLM API 선택을 참고하세요.

아랍어 프롬프트 체크리스트

  • 문체와 나라를 명시했는가.
  • 호칭 형태(성별)를 정했는가.
  • 숫자, 날짜, 통화, 소수점 구분 기호를 예시와 함께 지정했는가.
  • 서식을 표시 화면에 맞췄는가.
  • 영어 용어와 브랜드명 규칙을 적었는가.
  • UI에 dir="auto"와 격리 처리를 했는가.
  • 고정된 테스트 세트로 원어민 검토를 받았는가.

자주 묻는 질문

시스템 프롬프트는 아랍어와 영어 중 무엇으로 써야 하나요?

최신 모델에서는 둘 다 작동합니다. 영어 지시는 대부분의 팀이 유지 관리하기 쉽고, 아랍어 지시는 어조가 더 자연스러워지기도 합니다. 시스템 프롬프트마다 한 언어로 쓰고, 내 테스트 세트로 둘을 비교하세요.

아랍어 텍스트에서 구두점이 엉뚱한 위치에 나오는 이유는 무엇인가요?

표시 문제이며, 보통 컨테이너 방향이 왼쪽에서 오른쪽으로 되어 있기 때문입니다. 답변을 표시하는 요소에 dir="rtl" 또는 dir="auto"를 설정하세요.

모델이 발음 구별 기호를 붙이지 않게 하려면 어떻게 하나요?

프롬프트에 "발음 구별 기호(타슈킬)를 붙이지 마세요"라고 적으세요. 학습 자료나 모호한 이름처럼 도움이 되는 곳에서만 요청하세요.

LLM이 동아랍 숫자를 쓰게 하려면 어떻게 하나요?

시스템 프롬프트에 적고 "가격은 이렇게 쓰세요: ١٬٢٥٠ ر.س" 같은 예시를 하나 보여 주세요. 규칙이 없으면 모델은 숫자 체계를 섞어 씁니다. 출력을 파싱한다면 JSON 필드에는 서양식 숫자를 요청하고 표시할 때 변환하세요.

아랍어를 가장 잘 쓰는 모델은 무엇인가요?

내 프롬프트로 테스트하세요. BroadNet은 자체 테스트에서 Qwen3.8 27B가 자연스러운 아랍어를 쓰고 걸프와 이집트 방언을 이해했다고 보고합니다.

Markdown으로 읽기ChatGPT에 질문하기Claude에 질문하기Perplexity에 질문하기