BAYYIN AI — User Manual دليل مستخدم بيّن AI
Your complete guide to citation-backed AI consultations — Saudi labor law, ZATCA tax, medical triage, and restaurant orders. From your first login to a full session with tools, calculators, citations, and live web search.
دليلك الشامل لاستشارات ذكية موثّقة بالمصادر — نظام العمل السعودي، ضرائب ZATCA، الفرز الطبي، وطلبات المطاعم. من أول تسجيل دخول حتى جلسة كاملة مع الأدوات، الحاسبات، الاستشهادات، والبحث الحيّ على الإنترنت.
What BAYYIN AI offersماذا تقدّم بيّن AI
BAYYIN AI is a consultation platform — not a search engine, not a generic chatbot. Each conversation runs against a curated knowledge base and a set of domain-specific tools. Every substantive answer comes with clickable citations: article number, page, and a direct link to the original source PDF or government URL.
بيّن AI منصة استشارات متخصّصة — ليست محرّك بحث ولا روبوت محادثة عام. كل محادثة تعمل على قاعدة معرفة منتقاة بعناية ومجموعة من الأدوات المتخصّصة. كل إجابة جوهرية تأتي مع استشهادات قابلة للنقر: رقم المادة، الصفحة، ورابط مباشر للـ PDF الأصلي أو رابط المصدر الحكومي.
Create an accountإنشاء حساب
Open BAYYIN's home page and click Create Account.
افتح الصفحة الرئيسية لـ بيّن واضغط على إنشاء حساب.
Fill in your full name, email, and a strong password. The password strength meter (Weak / Fair / Good / Strong) gives live feedback.
أدخل اسمك الكامل، بريدك الإلكتروني، وكلمة مرور قوية. مؤشّر قوة كلمة المرور (ضعيفة / متوسطة / جيدة / قوية) يعطيك تغذية راجعة فورية.
Choose an agentاختيار المساعد
Use the country filter pills at the top (All / Saudi / Egypt / Global) to narrow down. Each pill shows the count of agents available.
استخدم شارات تصفية الدول في الأعلى (الكل / السعودية / مصر / عالمي) لتضييق النطاق. كل شارة تعرض عدد المساعدات المتاحة.
Each agent card has:
كل بطاقة مساعد تحتوي:
- Avatar + name + country flag pill (Saudi 🇸🇦, Egypt 🇪🇬, Global 🌍)الصورة الرمزية + الاسم + شارة الدولة (السعودية 🇸🇦، مصر 🇪🇬، عالمي 🌍)
- Type badge — Medical / HR Consultant / Restaurant / ZATCA Tax Consultantشارة النوع — طبي / مستشار موارد بشرية / مطعم / مستشار ضرائب
- Voice and Text Chat buttonsزرّا الصوت ومحادثة نصية
- Context box — optional notes for the session ("What brings you in today?", etc.)صندوق السياق — ملاحظات اختيارية للجلسة ("ما الذي تشكو منه اليوم؟" مثلاً)
- Document drop zone — drag-and-drop PDFs/screenshots before you startمنطقة رفع المستندات — اسحب وأفلت ملفات PDF أو لقطات شاشة قبل البدء
Voice or text — same brain, different interfaceصوت أم نص — نفس العقل، واجهتان
| Modeالوضع | Best forالأفضل لـ |
|---|---|
| Voiceالصوت | Hands-free use on mobile. Fast consultations. Agent speaks back with natural prosody (MSA Arabic or US English).استخدام بدون لمس الجوال. استشارات سريعة. المساعد يردّ بنبرة طبيعية (الفصحى أو الإنجليزية). |
| Text Chatمحادثة نصية | When you want to read citations carefully, copy excerpts, upload documents, or have a long back-and-forth with multiple calculations.عندما تريد قراءة الاستشهادات بدقّة، نسخ المقتطفات، رفع مستندات، أو محادثة طويلة فيها حسابات متعدّدة. |
Voice mode opens a LiveKit room — your browser will ask for microphone permission. Text Chat opens a standard message thread with a citations panel underneath each reply.
وضع الصوت يفتح غرفة LiveKit — سيطلب متصفّحك إذن الميكروفون. وضع النص يفتح خيط رسائل قياسي مع لوحة استشهادات أسفل كل رد.
Language — automatic detection on every messageاللغة — اكتشاف تلقائي مع كل رسالة
You don't pick a language. The agent picks it up from each message you send.
أنت لا تختار لغة. المساعد يلتقطها من كل رسالة ترسلها.
- Write in English → reply in Englishاكتب بالإنجليزية → الرد بالإنجليزية
- Write in Arabic → reply in Arabicاكتب بالعربية → الرد بالعربية
- Mix both in one message → the agent may mix tooاخلط بينهما في رسالة واحدة → يمكن للمساعد أن يخلط أيضاً
- Switch mid-conversation → the agent switches with you on that very turnبدّل اللغة في منتصف المحادثة → المساعد يبدّل معك فوراً
The only exception is the first greeting before you've said anything — that defaults to English on the main BAYYIN tenant. From your first message onwards, the agent always mirrors your language.
الاستثناء الوحيد هو الترحيب الأول قبل أن تكتب شيئاً — يكون افتراضياً بالعربية على نطاق بيّن الرئيسي. ومن أول رسالة تكتبها فصاعداً، يطابق المساعد لغتك.
Example: same agent, Arabic question → Arabic replyمثال: نفس المساعد، سؤال عربي → رد عربي
Same agent, English question → English reply (with calculation)نفس المساعد، سؤال إنجليزي → رد إنجليزي (مع حساب)
The agentsالمساعدات الذكية
⚖️ Saudi HR Consultant — the flagship⚖️ مستشار الموارد البشرية السعودي — المساعد الرئيسي
Covers Saudi Labor Law (Royal Decree M/51) + Executive Bylaws, GOSI, CCHI, Wage Protection (Mudad), Saudization/Nitaqat, plus sectoral regulations (domestic workers, maritime, agriculture, healthcare/teaching/diplomatic/civil-service).
يغطي نظام العمل السعودي (المرسوم الملكي م/51) ولائحته التنفيذية، GOSI، CCHI، حماية الأجور (مدد)، التوطين/نطاقات، واللوائح القطاعية (العمالة المنزلية، البحرية، الزراعة، الوظائف الصحية والتعليمية والدبلوماسية والخدمة المدنية).
Things you can askأسئلة يمكنك طرحها
| Topicالموضوع | Try sayingجرّب أن تقول |
|---|---|
| End-of-serviceمكافأة نهاية الخدمة | Calculate EOSB for 7 years at 8000 SAR, employer terminated.احسب مكافأة نهاية الخدمة لـ 7 سنوات براتب 8000 ريال، أنهى صاحب العمل العقد. |
| Overtimeالأجر الإضافي | Overtime pay for 10 hours at 50 SAR/hour base rate?الأجر الإضافي لـ 10 ساعات بأجر أساسي 50 ريال/ساعة؟ |
| Annual leaveالإجازة السنوية | Annual leave after 6 years of service?كم يوم إجازة سنوية بعد 6 سنوات خدمة؟ |
| GOSIالتأمينات | GOSI contributions for 12,000 SAR salary?اشتراكات GOSI لراتب 12000 ريال؟ |
| Saudizationالتوطين | I have 50 employees, 12 Saudis — what Nitaqat tier?عندي 50 موظف، 12 سعودي — في أي نطاق أنا؟ |
| Maternityإجازة الوضع | Maternity leave duration under Saudi Labor Law?مدة إجازة الوضع بنظام العمل السعودي؟ |
| Specific articleمادة محددة | What does Article 84 say exactly?ماذا تقول المادة 84 بالضبط؟ |
| Draft contractصياغة عقد | Draft an employment contract for a software engineer, 12,000 SAR, 2-year fixed term, Riyadh.اصغ عقد عمل لمهندس برمجيات، 12000 ريال، عقد محدد المدة سنتين، الرياض. |
| Draft terminationصياغة إنهاء | Draft a termination letter for 3 years tenure, redundancy.اصغ خطاب إنهاء عقد لـ 3 سنوات خدمة، سبب الإلغاء. |
| HRSD complaintشكوى HRSD | Draft a wage complaint to HRSD for 4 unpaid months.اصغ شكوى أجور إلى HRSD لمستحقات 4 شهور غير مدفوعة. |
| Official linkرابط رسمي | Where do I file a labor complaint?أين أقدّم شكوى عمالية؟ |
Polite scope refusalالرفض المؤدّب خارج النطاق
The agent refuses out-of-scope questions instead of guessing. Tax → ZATCA. Medical → the medical agent. Family law / criminal / non-KSA jurisdictions → politely declined.
يرفض المساعد الأسئلة خارج النطاق بدل التخمين. الضرائب → ZATCA. الطبية → المساعد الطبي. الأحوال الشخصية / الجنائية / أنظمة دول أخرى → يُحال بأدب.
💰 ZATCA Tax Consultant💰 مستشار ضرائب ZATCA
- VAT — 15% standard, exempt categories, returns, refunds, registrationVAT — 15% قياسية، الفئات المعفاة، الإقرارات، الاسترداد، التسجيل
- E-Invoicing (Fatoora) — Phase 1 & 2, XML schema, QR codes, ZATCA integrationالفوترة الإلكترونية (فاتورة) — الموجة 1 و2، XML schema، QR codes، الربط مع ZATCA
- Excise tax — tobacco, sugary drinks, energy drinksالانتقائية — التبغ، المشروبات الغازية، مشروبات الطاقة
- Customs — tariffs and HS code lookupsالجمارك — التعريفات ورموز HS
- RETT — 5% Real-Estate Transaction TaxRETT — 5% ضريبة التصرفات العقارية
- Zakat — calculation, declaration, GCC exemptionsالزكاة — الحساب، الإقرار، استثناءات دول الخليج
Same scope discipline — labor or medical questions get a polite redirect to the right assistant.
نفس انضباط النطاق — أسئلة العمل أو الطب تُحال بأدب للمساعد الصحيح.
🩺 Medical Doctor🩺 الطبيب الافتراضي
Conducts a structured patient intake: greeting → chief complaint → history → vitals → symptom triage → differential (top-3 ICD-10) → recommendations.
يجري مقابلة منظّمة: تحية ← الشكوى الرئيسية ← التاريخ الطبي ← العلامات الحيوية ← فرز الأعراض ← التشخيص الافتراضي (أعلى 3 ICD-10) ← التوصيات.
Calculators: BMI, GFR, BSA, IBW, CHADS₂-VASc, MELD, pediatric dose. Tools: drug lookup, ICD-10 suggester, SOAP note drafter.
حاسبات: BMI، GFR، BSA، IBW، CHADS₂-VASc، MELD، جرعة الأطفال. أدوات: استعلام الأدوية، مقترح ICD-10، مولّد SOAP.
🍽️ Restaurant Assistant🍽️ مساعد المطعم
Browse restaurants with images, ratings and distance → pick a branch + date/time → order from the menu (item images and prices) → confirm. Uses visual panels heavily — restaurant data is inherently visual.
تصفّح المطاعم بالصور والتقييمات والمسافة ← اختر فرعاً وتاريخاً ووقتاً ← اطلب من القائمة (صور الأصناف وأسعارها) ← أكّد. يستخدم اللوحات البصرية بكثرة — بيانات المطاعم بصرية بطبيعتها.
Citations and live web searchالاستشهادات والبحث على الإنترنت
When the agent gives a substantive answer, you'll see a Sources panel underneath:
عندما يقدّم المساعد إجابة جوهرية، ستظهر لوحة المصادر أسفل الرد:
- 📄 PDF citations — article number, page, source name. Click to open the original PDF at the right page.📄 استشهادات PDF — رقم المادة، الصفحة، اسم المصدر. اضغط لفتح الـ PDF على الصفحة الصحيحة.
- 🌐 Web citations — page title and URL. Click to open in a new tab.🌐 استشهادات ويب — عنوان الصفحة والرابط. اضغط للفتح في نافذة جديدة.
- Each citation has a preview of the exact excerpt the agent based its answer on.كل استشهاد يحتوي معاينة للمقتطف الذي بنى عليه المساعد إجابته.
The fallback chainسلسلة الاحتياط
If the knowledge base has no match and the topic is time-sensitive, the agent automatically calls OpenAI Web Search:
إذا لم تكن قاعدة المعرفة تحتوي إجابة وكان الموضوع زمنياً حسّاساً، يستدعي المساعد OpenAI Web Search تلقائياً:
-
Knowledge base (cited PDFs)قاعدة المعرفة (PDF موثّقة)Try this first. Best signal, highest trust.نحاول هذا أولاً. أفضل إشارة وأعلى ثقة.
-
General knowledge (with disclaimer)المعرفة العامة (مع تنبيه)If the KB is empty, the agent answers from its training with an explicit "not citation-backed" note.إن كانت قاعدة المعرفة فارغة، يجيب من تدريبه مع تنبيه واضح "غير مدعّمة باستشهاد".
-
Live web search (URL citations)البحث الحيّ (روابط استشهاد)For time-sensitive questions (recent ministerial decisions, new fee schedules), the agent calls live web search and returns .gov.sa URLs.للأسئلة الزمنية الحسّاسة (قرارات وزارية حديثة، جداول رسوم جديدة)، يستدعي المساعد بحثاً حيّاً ويعيد روابط .gov.sa.
-
Honest "I couldn't find a source"اعتراف صادق "لم أجد مصدراً"If nothing authoritative is found, the agent says so and suggests contacting HRSD or the relevant authority.إن لم يجد مصدراً موثوقاً، يقول ذلك ويقترح التواصل مع HRSD أو الجهة المختصّة.
Upload documentsرفع المستندات
Before starting a chat, drag-and-drop PDFs, contracts, or screenshots onto the agent card. Up to 3 files per session. The agent extracts text, cross-references against the KB, and refers to your document throughout the conversation.
قبل بدء المحادثة، اسحب وأفلت ملفات PDF أو عقود أو لقطات شاشة على بطاقة المساعد. حتى 3 ملفات لكل جلسة. يستخرج المساعد النص، ويقاطعه مع قاعدة المعرفة، ويشير لمستندك خلال المحادثة.
| Agentالمساعد | Example useمثال على الاستخدام |
|---|---|
| Saudi HRالموارد البشرية | Upload your contract → "is this clause compliant with Article 75?"ارفع عقدك → "هل هذا البند يطابق المادة 75؟" |
| ZATCAZATCA | Upload a VAT return → "validate this for me"ارفع إقرار VAT → "تحقّق منه لي" |
| Medicalالطبي | Upload a lab report → "interpret these values"ارفع تقرير مختبر → "فسّر هذه القيم" |
Supported: PDF, JPG, PNG, WebP. Max 20 MB per file.
المدعوم: PDF، JPG، PNG، WebP. الحد الأقصى 20 ميغا لكل ملف.
Visual panelsاللوحات البصرية
Voice and text chats both render visual panels alongside speech / text:
المحادثات الصوتية والنصية كلاهما يعرض لوحات بصرية بجانب الكلام / النص:
Tapping a panel sends the corresponding value back to the agent — handy on mobile where pronouncing numbers/names is awkward.
الضغط على لوحة يرسل القيمة المقابلة للمساعد — مفيد على الجوال حيث لفظ الأرقام/الأسماء غير ملائم.
Privacy & data handlingالخصوصية والبيانات
- Chat messages are stored in BAYYIN's database, encrypted at rest.رسائل المحادثة محفوظة في قاعدة بيانات بيّن، مشفّرة على القرص.
- IDs and phone numbers are auto-redacted from logs.أرقام الهويات وأرقام الهواتف تُحجب تلقائياً من السجلات.
- Voice audio is processed in-memory and not persisted.الصوت يُعالج في الذاكرة ولا يُحفظ.
- Each tenant's data is isolated; only the platform SuperAdmin has cross-tenant visibility.بيانات كل مؤسسة معزولة؛ صلاحية SuperAdmin هي الوحيدة التي ترى عبر المؤسسات.
- Per-tenant API keys are supported — your administrator can configure their own OpenAI / ElevenLabs accounts.مفاتيح API لكل مؤسسة مدعومة — يمكن للمسؤول لديك إعداد حسابات OpenAI / ElevenLabs الخاصة بها.
Troubleshootingحل المشاكل
| Symptomالمشكلة | What to checkافحص |
|---|---|
| Agent replies in the wrong languageالمساعد يردّ بلغة خاطئة | Refresh the page; if it persists, file a ticket.حدّث الصفحة؛ إن استمرّ أرسل تذكرة دعم. |
| "Could not start session" on Voice"تعذّر بدء الجلسة" في الصوت | Browser mic permission denied; check site settings.إذن الميكروفون مرفوض في المتصفّح؛ افحص إعدادات الموقع. |
| No citations shownلا تظهر استشهادات | The answer is from general knowledge, not the KB. Look for the "not citation-backed" note.الإجابة من المعرفة العامة، ليست من قاعدة المعرفة. ابحث عن ملاحظة "غير مدعّمة باستشهاد". |
| Document upload failsرفع المستند يفشل | Max 20 MB; supported: PDF, JPG, PNG, WebP.الحد الأقصى 20 ميغا؛ المدعوم: PDF، JPG، PNG، WebP. |
| Chat loads blankالمحادثة تُحمَّل فارغة | kb_api may be down; wait 30s and refresh, or contact your admin.قد تكون kb_api معطّلة؛ انتظر 30 ثانية وحدّث، أو اتصل بمسؤولك. |
support@bayyin.ai with the session ID shown in the chat URL.
للمشاكل غير المحلولة، تواصل مع support@bayyin.ai مع رقم الجلسة المعروض في رابط المحادثة.