Ir para o conteúdo
Tecnologia 7 de novembro de 2026 11 min de leitura

Writing Prompts for an Arabic Voice Agent

How to write instructions for an Arabic AI voice agent: dialect register, gender agreement, spoken numbers and prices, names, code-switching and a test plan.

D
7 de novembro de 2026

Resposta rápida

To write instructions for an Arabic voice agent, name one dialect register per caller base, such as Gulf or Levantine, and say how to address male and female callers. Write numbers, prices and times as they are spoken, confirm names instead of guessing, keep brand names as callers say them, and give exact greeting and closing lines. Keep prices in a catalogue, not in the prompt, and test on real calls with native speakers.

Arabic is not one spoken language. The Arabic a caller uses on the phone in Dubai, Amman or Cairo differs in vocabulary, rhythm and even the word for "now". An agent told only to "speak Arabic" will pick something, and callers will hear that it is the wrong something.

This guide covers the parts of the instructions that matter most for an Arabic voice agent: the dialect register, gender, numbers, names, mixing languages, politeness and the facts that must not change. It closes with a short skeleton and a test plan. Arabic examples are samples to adapt, and a native speaker from your caller base should review every line before it goes live.

Pick a dialect register per caller base

Start with who calls. Then write the register into the instructions as a plain rule, because the model will not infer it reliably.

RegisterTypical callersSample greeting
do GolfoUAE, Saudi Arabia, Kuwait, Qatar, Bahrain, Omanهلا وغلا، معك ليلى
levantinoJordan, Palestine, Lebanon, and many expatriate callers across the Gulfأهلين، معك ليلى
egípcioEgitoأهلاً بحضرتك، معاك ليلى

The DialerBee agente de voz de IA treats Arabic as dialects, not as one flattened language. Your instructions should still say which one to lead with. A line such as "Speak Gulf Arabic. Do not use Modern Standard Arabic except for formal phrases the caller uses first" removes a lot of guessing. Where your callers mix dialects, name the main one and say how to follow the caller: "If the caller speaks Levantine, answer in Levantine." For the recognition side of the same problem, see Arabic speech recognition across dialects, and for Gulf call flows, IVR design for Gulf callers.

Write the instructions in English or in Arabic?

There are two reasonable options, and neither is always better.

  • Instructions in English, spoken lines in Arabic. Rules are easier for most teams to read, review and audit. You quote the exact Arabic you want said. The risk is that a rule written in English is applied in a stiff, translated way.
  • Instructions in Arabic. The register, the politeness and the idioms come through naturally. The risk is that fewer people on your team can review the instructions, and mistakes are harder to spot.

Test both against the same set of recorded questions and compare by ear. Keep the version history: in Agent Studio, every publish is a version, so you can promote the winner and roll back the loser.

Acordo de gênero

Arabic marks gender in verbs, adjectives and pronouns. Two separate agreements matter, and they are easy to mix up.

The agent's own voice is female

The DialerBee agent uses one voice, Layla, the female voice, and every persona uses it. You set the persona's name, tone and pace in Agent Studio; the samples in this guide use the name Layla. Anything the agent says about itself must agree. Say so in the instructions: "You are female. Refer to yourself in the feminine." Compare the two forms of "I am ready":

Usarárabe
Agent about herself (correct)أنا جاهزة
Masculine form (avoid for the agent)أنا جاهز

Addressing male and female callers

Phrases that address the caller change with the caller's gender: "please" or "go ahead" are different for a man and a woman.

SignificadoTo a manTo a woman
Please, go aheadتفضّلتفضّلي
Thank youشكراً لكشكراً لكِ

Tell the agent what to do when it does not know. Do not instruct it to guess from a voice or a name; both mislead. Three safer options: use a neutral phrasing that avoids gendered forms, ask for the caller's name and confirm it, or follow what the caller says about themselves. Pick one and write it down. Then test with male and female callers, because agreement errors only show on a call.

Numbers, prices and times written as they are spoken

The agent will read what you write. Digits in the middle of Arabic text can be read in an odd order or in the wrong form, and a price that is read wrongly is the failure a caller remembers. Write the spoken form into any line that carries a number, and say the unit.

  • Prices. Spell out the amount and the currency in words: خمسة وعشرون ديناراً for 25 dinars. Use the currency word your callers use.
  • Times. Say the hour in words with the part of the day: الساعة الثانية ظهراً for two in the afternoon. Never leave a bare "2:00".
  • Phone numbers and references. Say them digit by digit and in small groups, then ask the caller to confirm.

For why text-to-speech stumbles on dates and numbers and how to test it, read Arabic text-to-speech numbers and dates.

Facts that must never change

The DialerBee agent answers from documents you upload and speaks only prices that exist in your catalogue; the price-truth guard exists so it cannot invent a number a customer will hold you to. Your instructions should support that, not fight it.

  • Keep prices in the catalogue. If the same price also appears in the instructions, it will drift out of date, and the two sources will disagree.
  • Keep opening hours, addresses and policies in an uploaded document, and say in the instructions: "Answer only from the documents. If the answer is not there, say you do not have it and offer to take a message."
  • Tell the agent never to round, estimate or promise a discount.

A short refusal line helps. For example, when a price is not found: ما عندي هذي المعلومة حالياً، بس أقدر أسجّل رقمك وأحد من الفريق يتواصل معك. That is Gulf phrasing, so adjust it for the register you chose.

Names and greetings: confirm, never guess

Names are the most error-prone item on an Arabic call. Speech recognition can turn one name into another that sounds close, and a name written in Latin letters in your CRM has several Arabic spellings. Write these rules:

  • Do not address the caller by name unless they said it on this call or it was confirmed.
  • If a name comes from stored history, confirm it once: "Am I speaking with ...?" in the caller's dialect. Do not ask again after it is confirmed.
  • Read a name back before booking anything under it.
  • Do not guess the caller's gender from the name.

A simple confirmation line is معي الأستاذ أحمد؟ for a man or معي الأستاذة سارة؟ for a woman, but only once the gender is known from the caller.

Code-switching: keep brand names as the caller says them

Many Gulf and Levantine callers mix English words into Arabic, especially for brand names, products and technical words. An agent that translates these into formal Arabic sounds odd and may not be understood. Tell it to keep a brand or a loanword in the form the caller used. For the full picture, see Arabic and English code-switching in voice AI. The site presents mid-sentence switching as something to test on a demo, not to assume, so build that test into your plan.

Write a short list of the brand names and loanwords your callers use, and put it in the knowledge base. A list the agent can look up is more reliable than a general rule.

Politeness formulas and closings

Arabic callers expect the ritual phrases. Skipping them reads as cold; overdoing them reads as slow. Give the agent a short set, in the right dialect, and say when to use each.

MomentSample line
Welcomeأهلاً وسهلاً
Offer to helpكيف أقدر أساعدك؟
Thanksشكراً لاتصالك
Closingمع السلامة

Limit them. One greeting and one closing per call is usually enough, and the agent should not repeat a formula on every turn.

A short instruction skeleton

Adapt this, then have a native speaker review it. Keep each Arabic line in its own element so a translation tool treats it correctly.

ROLE
You are Layla, a female voice agent for [business].
Refer to yourself in the feminine.

DIALECT
Speak Gulf Arabic. Follow the caller if they use another dialect.
Do not use Modern Standard Arabic except for formal phrases.

GREETING (say once)

هلا وغلا، معك ليلى من الصالون. كيف أقدر أساعدك؟

RULES
- Answer only from the uploaded documents.
- Say only prices that are in the catalogue.
- Write and say numbers, prices and times in words, with the unit.
- Confirm the caller's name once. Never guess gender.
- Read back any name, date or phone number before booking.
- Keep brand names as the caller says them.
- If the caller asks for a person, hand over without argument.

IF YOU DO NOT KNOW (say)

ما عندي هذي المعلومة حالياً، بس أقدر أسجّل رقمك وأحد من الفريق يتواصل معك.

CLOSING (say once)

شكراً لاتصالك، مع السلامة.

Test on real calls with Gulf and Levantine speakers

Reading Arabic output on a screen proves little. Place test calls and listen, with native speakers of each dialect you serve. A good test list covers:

  1. A male caller and a female caller, in each dialect, to check agreement.
  2. A price that is in the catalogue, and one that is not.
  3. A time and a date, spoken by the agent and by the caller.
  4. A name read back, including a name with a hard-to-spell sound.
  5. A sentence with an English brand name inside it.
  6. An interruption, to confirm the agent stops. Barge-in is a behaviour of the agent, so test it.
  7. A request for a person.

O Arabic voice agent testing checklist goes into each of these, and the Agente de voz com IA em árabe page lists what the agent does today. When a call fails, change one thing, test again, then promote the new version. The loop is described in how to QA AI voice agent calls. For the interface side of Arabic support, see Suporte para árabe e RTL.

The AI voice agent has run on live calls in Arabic and English. For any other language, test on a demo first.

Perguntas frequentes

Should I write the instructions in Arabic or English?

Try both and compare recorded calls. English instructions are easier for most teams to maintain and review. Arabic instructions can carry the dialect, the politeness forms and the exact wording you want spoken. A common middle path is English rules with the Arabic phrases you want said quoted exactly. Decide by listening, not by preference.

How do I choose a dialect for the agent?

Pick the dialect of the majority of your callers and state it in the instructions as a register: Gulf, Levantine or Egyptian. DialerBee describes Arabic on the voice agent as handled as dialects. Test each dialect you expect, and do not assume one Arabic suits every caller.

What voice does the DialerBee agent use?

One voice, Layla, the female voice. Every persona uses it, and you set the persona's name, tone and pace. That means the agent refers to itself in the feminine, and the instructions should say so, so that first-person phrases agree with the voice the caller hears.

How should the agent say prices and times?

Write them the way they are spoken, in words, and give the unit. Only prices in your catalogue can be spoken by the DialerBee agent, so keep the catalogue as the single source and do not repeat prices in the instructions where they can drift out of date.

What if the agent does not know the caller's gender?

Say what to do in that case. Options are to use a neutral phrasing, to ask the caller's name and confirm it, or to follow what the caller says about themselves. Do not tell the agent to guess from the voice or name.

Does the agent handle other languages?

The AI voice agent has run on live calls in Arabic and English. For any other language, test on a demo first before you rely on it.

Leituras relacionadas

Leitura relacionada: Saudação e Aviso de IA do Agente de Voz em Árabe

Pronto para ver DialerBee em ação?

Solicite uma demo ao vivo de 15 minutos ou comece um teste grátis de 14 dias — sem slides, sem compromisso. As ligações começam assim que o seu próprio SIP trunk ou PBX estiver conectado e aprovado.

Teste grátis de 14 dias · crédito de IA gratuito · sem cartão · 11 idiomas · BYOC · controles de apoio à conformidade

Ver o site completo em inglês →