# Mr. AI Documentation — Full Published Corpus

> Generated from published revisions only. Drafts are never included.

---

## أول خطواتك مع Mr. AI

- Language: ar
- Section: ابدأ من هنا
- Canonical: https://mrailabs.com/docs/ar/getting-started/first-steps/
- Markdown: https://mrailabs.com/docs/ar/getting-started/first-steps.md
- Published: 2026-07-14T20:11:38.480940

خريطة سريعة من إنشاء الحساب إلى أول محادثة حقيقية ناجحة.

Mr. AI يساعدك تدير محادثات العملاء بموظف ذكي يعتمد على معلومات نشاطك، ويرد تلقائيًا، ويترك لك التدخل البشري وقت الحاجة. أفضل نتيجة لا تبدأ بربط القنوات مباشرة، بل بتجهيز المعلومات ثم الاختبار ثم التشغيل.

*من لوحة النظرة العامة تتابع الرصيد وحالة النظام والتنبيهات وأهم مؤشرات العملاء.*

## المسار المقترح لأول تشغيل

1. أكمل مهمات الإعداد وعرّف النظام بنشاطك وخدماتك ومواعيدك.
2. أضف التفاصيل المهمة داخل قاعدة المعرفة، خصوصًا الأسعار والسياسات والأسئلة المتكررة.
3. راجع أسلوب الرد وقواعد التحويل للفريق البشري.
4. اختبر الموظف الذكي بأسئلة تشبه أسئلة عملائك الحقيقية.
5. اربط قناة واحدة، أرسل رسالة تجريبية، ثم تابع أول المحادثات من لوحة التحكم.

> **ابدأ بأمان**
> لا تبدأ التشغيل على العملاء قبل تجربة أسئلة الأسعار، المواعيد، الحجز، الاعتراضات، والحالات التي تحتاج موظفًا بشريًا.

## بعد أول تشغيل

- راجع المحادثات التي احتاجت تدخلًا بشريًا.
- أكمل أي معلومة اكتشفت أن الموظف الذكي لا يعرفها.
- تابع النقاط المستخدمة وإجراءات العملاء وتقارير الأداء.

[فتح لوحة النظرة العامة](/client/overview)

---

## كيفية استخدام مهمات الإعداد

- Language: ar
- Section: ابدأ من هنا
- Canonical: https://mrailabs.com/docs/ar/getting-started/setup-missions/
- Markdown: https://mrailabs.com/docs/ar/getting-started/setup-missions.md
- Published: 2026-07-30T18:10:02.394496

افهم ترتيب المهمات وكيف تعرف أن حسابك جاهز للتشغيل.

![شكل صحفة رحلة الاعداد](https://mrailabs.com/api/docs/media/1fe66d45-6883-4539-92a5-aff99b6589ab)

*كيفية استخدام مهمات الإعداد*

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

## مجموعات المهمات

- علّم مساعدك: بيانات الشركة، ملف المعلومات الأولي، المعرفة التفصيلية، رحلة المحادثة، وإعدادات الردود.
- اختبر وحسّن: تجربة محادثة واقعية ومراجعة النتيجة.
- ابدأ التشغيل: ربط قناة حقيقية ثم تأكيد الجاهزية.

## كيف تكمل مهمة؟

1. اضغط فتح المهمة وانتقل للصفحة المرتبطة بها.
2. أكمل البيانات واحفظ التغييرات.
3. ارجع إلى مهمات الإعداد واضغط تحقق من الاكتمال عند الحاجة.
4. تابع نسبة التقدم والمهمة المقترحة التالية.

> **شرط التشغيل**
> التشغيل الآمن يحتاج اختبارًا ناجحًا للموظف الذكي وقناة واحدة متصلة على الأقل.

[فتح مهمات الإعداد](/client/onboarding)

---

## تجهيز بيانات موظفك الذكي

- Language: ar
- Section: ابدأ من هنا
- Canonical: https://mrailabs.com/docs/ar/getting-started/ai-employee-setup/
- Markdown: https://mrailabs.com/docs/ar/getting-started/ai-employee-setup.md
- Published: 2026-07-12T22:37:22.223480

اكتب بيانات نشاطك بطريقة تساعد الموظف الذكي يقدم إجابات دقيقة.

معالج إعداد الموظف الذكي يحفظ المعلومات مباشرة في الأقسام التي سيعتمد عليها النظام لاحقًا. يمكنك حفظ مسودة والعودة لها، أو إنهاء الإعداد بعد استكمال الحقول المطلوبة.

## المعلومات التي تحتاج تجهيزها

- اسم النشاط، نوع المجال، وصف واضح للنشاط، والموقع الإلكتروني إن وجد.
- الخدمات والأسعار والعروض الحالية.
- أيام وساعات العمل، مدة الحجز أو الجلسة، والبيانات المطلوبة من العميل.
- أرقام التواصل والفروع أو أماكن تقديم الخدمة.
- اللغة واللهجة ونبرة الرد والكلمات المفضلة.
- الأسئلة الشائعة والسياسات والحالات التي يجب تحويلها للفريق البشري.

## كيف تكتب بيانات أفضل؟

1. اكتب اسم كل خدمة وسعرها وشروطها بدل وصف عام مثل لدينا خدمات كثيرة.
2. فرّق بوضوح بين المعلومة الثابتة والعرض المؤقت.
3. اذكر الاستثناءات؛ مثل الأيام غير المتاحة أو الحالات التي لا يتم فيها تأكيد الحجز.
4. اكتب البيانات المطلوبة من العميل بالترتيب الذي تريد جمعها به.

> **حماية البيانات**
> لا تضع كلمات مرور أو مفاتيح API أو بيانات شخصية حساسة لعملائك داخل معلومات الموظف الذكي.

[فتح إعداد الموظف الذكي](/client/ai-employee-setup)

---

## اختبار موظفك من داخل Mr. AI

- Language: ar
- Section: ابدأ من هنا
- Canonical: https://mrailabs.com/docs/ar/getting-started/test-assistant-before-live/
- Markdown: https://mrailabs.com/docs/ar/getting-started/test-assistant-before-live.md
- Published: 2026-09-29T19:19:11.235236

استخدم Test Assistant كمساحة آمنة داخل حسابك لتجربة الردود والسياق والصور والصوت قبل الاعتماد على التغيير مع العملاء.

## أختبر موظف AI منين؟

استخدم Test Assistant داخل حسابك. محادثات الاختبار منفصلة عن محادثات العملاء، الرسائل لا تُرسل لعميل حقيقي، ورسائل Testing لا تخصم Customer Points. تقدر تعمل Chat مختلفة لكل سيناريو وتجرب Text وImage وAudio من واجهة Dashboard الحالية.

- اعمل Chat منفصلة لكل سيناريو مهم.
- اكتب كأنك عميل حقيقي.
- ابدأ Chat جديدة بعد أي تعديل كبير.

*اختبر المساعد في محادثة جديدة وراجع الرد قبل تشغيله مع العملاء.*

## ابدأ اختبار واضح

1. افتح Test Assistant واعمل Testing Chat جديدة.
2. اختار سيناريو واحد واضح: سؤال سعر، ترشيح منتج، اعتراض، مرحلة محادثة، أو Action.
3. اكتب السؤال بطريقة طبيعية من غير ما تقول للموظف الإجابة المتوقعة.
4. كمّل أكتر من رسالة لو السيناريو بيعتمد على السياق.
5. راجع الرد، والمرحلة، وأي Action حاول الموظف يوصل له.
6. لو عدلت الإعدادات، ابدأ Chat جديدة وأعد نفس السيناريو.

## إيه اللي تقدر تختبره هنا؟

- المحتوى الفعلي للرد وطريقة الكلام واللغة وهوية النشاط.
- الأسئلة المتتابعة والحفاظ على السياق.
- Catalog وDeep Knowledge بصياغات مختلفة.
- Conversation Stages وانتقال المحادثة بين المراحل.
- قرار AI بخصوص Action من غير تنفيذ الـBusiness Action الحقيقي.
- Text وImage وAudio من واجهة Dashboard Testing الحالية.

## وإيه اللي Test Assistant مش بيثبته؟

- مش بينفذ Business Action حقيقي في Production.
- مش دليل إن Booking أو Order أو Payment أو Refund أو Update حصل فعلًا.
- مش بيبعت رسالة لقناة عميل حقيقية.
- مش بيجدول Follow-up حقيقية.
- وجود Stage صحيحة داخل Test Chat مش دليل إن Stage Follow-up Task حقيقية اتنفذت.

## اختبار التغيير قبل نشره

لو فتحت Testing من Change Proposal مدعومة، تقدر تختبر النسخة المقترحة قبل تطبيقها على Production. ده بيساعدك تشوف تأثير التغيير قبل ما يعتمد على محادثات العملاء.

> **اختبر قبل النشر**
> Testing خطوة QA موصى بها، لكنها مش Publish Gate إجباري حاليًا. يعني الأفضل تختبر قبل النشر، لكن النظام مش لازم يمنع Publish لو ما اختبرتش.

## Dashboard Testing وحدود AI-assisted Testing

محادثات Dashboard Testing لها إدارة منفصلة. حدود Sessions والرسائل الموجودة في دليل الاختبار باستخدام ChatGPT تخص خدمة AI-assisted Testing، ومش معناها إنها حدود Test Assistant داخل الـDashboard.

[فتح Test Assistant](/client/settings/test-assistant)

[راجع Testing Playbook](/docs/ar/learn/test-ai-employee-before-real-customers/)

[اختبر باستخدام ChatGPT أو مساعد AI متصل](/docs/ar/settings-and-usage/test-ai-employee-with-connected-assistant/)

[افهم دورة تحسين جودة موظف AI](/docs/ar/knowledge-and-behavior/continuous-ai-employee-quality-loop/)

---

## فهم لوحة التحكم والتنبيهات المهمة

- Language: ar
- Section: ابدأ من هنا
- Canonical: https://mrailabs.com/docs/ar/getting-started/dashboard-overview-and-insights/
- Markdown: https://mrailabs.com/docs/ar/getting-started/dashboard-overview-and-insights.md
- Published: 2026-07-13T18:51:40.226212

اقرأ حالة النظام والعملاء والنقاط وأداء الردود وحدد الخطوة التالية.

## ماذا تعرض لوحة التحكم في Mr. AI؟

تعرض لوحة التحكم ملخصًا لحالة النظام والعملاء والقنوات والنقاط، وتنبيهات تحتاج تدخلًا، ومؤشرات نشاط وردود تساعدك تختار الخطوة التالية بدل مراجعة كل صفحة يدويًا.

- راجع حالة النظام والقنوات أولًا.
- افتح Customer Operations عندما توجد محادثات تحتاج ردًا.
- قارن مؤشرات الرد مع حجم المحادثات وليس كرقم منفصل.

## خطوات الاستخدام

1. راجع عدد العملاء المسموحين والمعلقين والمحظورين.
2. تأكد أن رصيد النقاط أعلى من الحد الأدنى وأن AI غير متوقف.
3. راجع المنصات المتصلة وتنبيهات العمل اليدوي.
4. اقرأ متوسط أول رد للذكاء والبشر وساعات الذروة.
5. استخدم الإجراءات السريعة للانتقال إلى المحادثات أو المعرفة أو الاختبار.

## أسئلة شائعة

### لماذا يظهر متوسط الرد غير متاح؟

يظهر ذلك عندما لا توجد بيانات كافية وصالحة في الفترة المحددة.

### هل لوحة التحكم بديل عن تقارير الأداء؟

لا؛ هي ملخص تشغيلي سريع، بينما تقارير الأداء تقدم تحليلًا أعمق للمحادثات والإجراءات.

[فتح الصفحة في Mr. AI](/client/overview)

---

## فهم أقسام قاعدة المعرفة

- Language: ar
- Section: المعرفة وسلوك الموظف الذكي
- Canonical: https://mrailabs.com/docs/ar/knowledge-and-behavior/knowledge-base-overview/
- Markdown: https://mrailabs.com/docs/ar/knowledge-and-behavior/knowledge-base-overview.md
- Published: 2026-09-03T20:38:56.667478

اعرف أين تضيف كل نوع من المعلومات حتى تتحسن الردود بسرعة.

## كيف أختار المكان الصحيح لكل معلومة في قاعدة المعرفة؟

ضع كل حقيقة في المصدر الذي يمثلها: المنتجات والخدمات في الكتالوج، العروض في Offers، التفاصيل الطويلة في Deep Knowledge، وتعليمات الأسلوب والسلوك في أقسام التعليمات. التنظيم الصحيح يقلل التعارض ويجعل إصلاح الردود أسرع.

*تجمع قاعدة المعرفة الكتالوج والعروض والمستندات وتعليمات الرد في مكان واحد.*

قاعدة المعرفة مقسمة حتى لا تختلط الحقائق بأسلوب الرد. كل قسم له وظيفة مختلفة، واختيار القسم الصحيح يجعل التعديل أسهل والنتيجة أوضح.

## أين تضيف المعلومة؟

- المنتجات والخدمات: الأسماء، الوصف، الأسعار، والاختيارات المتاحة.
- العروض: الخصومات الحالية وشروطها ومدة صلاحيتها.
- المعرفة التفصيلية: السياسات، الفروع، خطوات الخدمة، والأسئلة الطويلة.
- تعليمات الذكاء: النبرة، طول الرد، الممنوعات، وقواعد التحويل للفريق.
- منشئ المحادثة: ترتيب المراحل التي يمر بها العميل حتى يصل للنتيجة المطلوبة.

> **قاعدة مهمة**
> حدّث المعلومة في مصدرها الأساسي بدل تكرارها في أكثر من مكان؛ التكرار المختلف قد يؤدي لردود متعارضة.

## دورة التحسين

1. راجع محادثة بها مشكلة.
2. حدد المعلومة أو القاعدة الناقصة.
3. حدّث القسم الصحيح.
4. اختبر نفس الحالة مرة أخرى.

[فتح قاعدة المعرفة](/client/knowledge-base)

[افهم كيف تعتمد الردود على معرفة شركتك](/docs/ar/knowledge-and-behavior/grounded-ai-replies-from-business-knowledge/)

---

## Catalog 2.0: خلي Mr. AI يفهم منتجاتك ويلاقي الصح

- Language: ar
- Section: المعرفة وسلوك الموظف الذكي
- Canonical: https://mrailabs.com/docs/ar/knowledge-and-behavior/products-and-services/
- Markdown: https://mrailabs.com/docs/ar/knowledge-and-behavior/products-and-services.md
- Published: 2026-09-29T19:19:11.235236

رتّب المنتجات والخدمات في مكان واحد، وساعد Mr. AI يفهم معنى كل عنصر ويجاوب بدقة سواء العميل بيسأل بشكل طبيعي أو بيدور على معلومة محددة.

## الكتالوج بيفيدني في إيه؟

الكتالوج هو المكان الأساسي للمنتجات والخدمات اللي موظفك محتاج يعرفها. بدل ما توزع السعر والتفاصيل والصور ومعلومات البحث في أماكن مختلفة، بتحط كل عنصر في مكانه الصحيح، وMr. AI يستخدم البيانات دي علشان يرشّح العنصر المناسب ويجاوب على أسئلة العميل بدقة.

- لو بتبني Catalog من الصفر، ابدأ بإعطاء AI بيانات العناصر وطبيعة البيزنس قبل ما تنشئ العناصر داخل الكتالوج.
- خلّي AI يقترح Folders وSemantic Tree / Semantic Classification وSemantic Tags وAI Search Attributes وSearch Names المناسبة بناءً على الصورة الكاملة للعناصر.
- راجع الهيكل المقترح، وبعدها استخدم Build & Manage with AI لإضافة العناصر وتوزيعها عليه. ده هو المسار اللي بنرشحه حاليًا لأنه أسهل في الحفاظ على تنظيم متسق ومراجعة الشغل على دفعات.

*افتح تبويب الكتالوج ثم استخدم زر إضافة عنصر لإنشاء أول منتج أو خدمة.*

## الترتيب اللي بنرشحه لو بتبني Catalog من الصفر

1. جهّز المصدر اللي فيه المنتجات أو الخدمات: ملف، قائمة، أو بيانات واضحة عن العناصر وطبيعة البيزنس.
2. استخدم Build & Manage with AI واطلب منه يحلل العناصر ويقترح Folders مناسبة للتنظيم الداخلي.
3. خلّيه يقترح Semantic Tree / Semantic Classification وSemantic Tags بناءً على المعاني والأنماط المشتركة بين العناصر.
4. خلّيه يقترح AI Search Attributes والـValues والـAliases وSearch Names اللي هتساعد في الأسئلة الدقيقة، مع الاعتماد على الحقائق الموجودة في المصدر.
5. راجع الاقتراحات وعدّل أي حاجة لا تمثل طريقة شغلك أو بياناتك الحقيقية.
6. بعد اعتماد الهيكل، خلّي AI يضيف العناصر ويربط كل عنصر بالـFolder والتصنيف والـTags والـSearch Attributes المناسبة.
7. بعد الإضافة والفهرسة، اختبر أسئلة discovery وأسئلة exact lookup من Test Assistant.

## Mr. AI بيدور إزاي؟

- لو العميل قال: «عايز كورس يساعدني أتعلم البيع» فده سؤال اكتشاف، والبحث الدلالي يساعد في الوصول للعناصر الأقرب لاحتياجه.
- لو قال: «هات كل كورسات المدرس حسن فليح» أو «كام كورس في فرع القاهرة؟» فدي أسئلة أدق، وAI Search Attributes تساعد في الوصول للنتيجة المنظمة.
- لو فيه حقيقة دقيقة منظمة في الكتالوج، زي السعر أو المدرس أو الفرع، النظام يعتمد على المعلومة المنظمة بدل ما يخمّن من التشابه.

> **خلّي AI يقترح الهيكل أولًا**
> الميزة في بدء الرحلة بالـAI إنه يشوف مجموعة العناصر ككل، فيقدر يقترح تنظيمًا موحدًا بدل ما تبني الهيكل عنصرًا وراء عنصر. لكن راجع الاقتراح قبل النشر: AI يساعد في التصميم والتنظيم، ومصدر بياناتك يفضل المرجع للحقائق.

## مثال سريع

1. ارفع أو شارك مع AI قائمة الكورسات وما تعرفه عن النشاط.
2. اطلب منه يقترح Folders والـSemantic Tree والـTags المناسبة للمجموعة كلها.
3. اطلب منه يحدد Attributes مهمة مثل Instructor وLevel، ويقترح Aliases وSearch Name للقيم عند الحاجة.
4. راجع الهيكل المقترح، وبعدها اطلب منه إنشاء الكورسات وتوزيعها على الهيكل بدل إضافة كل عنصر يدويًا.
5. راجع النتائج، ثم اختبر سؤالًا طبيعيًا وسؤالًا دقيقًا من Test Assistant.

> **مش لازم تعيد بناء الكتالوج كله**
> العناصر القديمة أو العناصر اللي من غير Semantic Classification أو AI Search Attributes تفضل صالحة. المزايا الجديدة بتحسّن التنظيم والبحث، لكنها مش شرط علشان العنصر يشتغل.

## اختار الدليل حسب الخطوة اللي أنت فيها

- ابدأ بـ«إدارة كتالوج كبير بالـAI» لو عندك مصدر أو مجموعة عناصر وعايز AI يقترح الهيكل ثم يضيف العناصر.
- استخدم «تنظيم الكتالوج: Folders والتصنيف الدلالي والـTags» علشان تفهم وتراجع الهيكل اللي AI اقترحه.
- استخدم «البحث الدقيق: AI Search Attributes وSearch Name» علشان تفهم وتراجع حقائق البحث الدقيقة.
- استخدم «إضافة وتعديل منتج أو خدمة بشكل صحيح» كمرجع لو محتاج تفهم حقول عنصر واحد أو تعدله يدويًا.

[فتح كتالوج المنتجات والخدمات](/client/knowledge-base/products)

---

## إدارة العروض الحالية

- Language: ar
- Section: المعرفة وسلوك الموظف الذكي
- Canonical: https://mrailabs.com/docs/ar/knowledge-and-behavior/current-offers/
- Markdown: https://mrailabs.com/docs/ar/knowledge-and-behavior/current-offers.md
- Published: 2026-07-14T20:11:38.480940

أضف الخصومات والشروط بوضوح وامنع استمرار عرض منتهي.

قسم العروض مخصص للمعلومات المؤقتة. افصل العرض عن السعر الأساسي حتى يعرف الموظف الذكي الفرق بين السعر الدائم والخصم الحالي.

*من تبويب العروض يمكنك إضافة عرض وتحديد تفاصيله وتواريخه وشروطه.*

## اكتب في كل عرض

- اسم العرض والخدمة أو المنتجات التي يشملها.
- السعر قبل الخصم وبعده أو نسبة الخصم.
- تاريخ البداية والنهاية إن وجد.
- الفروع أو الفئات أو المواعيد التي ينطبق عليها.
- أي شرط مثل الدفع المسبق أو عدد محدود من الأماكن.

> **بعد انتهاء العرض**
> راجع هذا القسم عند انتهاء أي حملة. عرض قديم داخل قاعدة المعرفة قد يجعل الموظف الذكي يعد العميل بخصم غير متاح.

[فتح العروض الحالية](/client/knowledge-base/offers)

---

## إضافة المعرفة التفصيلية والملفات

- Language: ar
- Section: المعرفة وسلوك الموظف الذكي
- Canonical: https://mrailabs.com/docs/ar/knowledge-and-behavior/deep-knowledge-files/
- Markdown: https://mrailabs.com/docs/ar/knowledge-and-behavior/deep-knowledge-files.md
- Published: 2026-07-12T22:37:22.223480

استخدم المستندات للمعلومات الطويلة والسياسات والتفاصيل التي لا تناسب الكتالوج.

المعرفة التفصيلية مناسبة للمعلومات الطويلة مثل سياسة الاسترجاع، خطوات الخدمة، تعليمات الحجز، تفاصيل الفروع، والأسئلة المتخصصة.

## قبل إضافة ملف

1. احذف المعلومات القديمة أو المتعارضة من الملف.
2. استخدم عناوين واضحة وقسم المحتوى إلى أجزاء قصيرة.
3. اكتب السؤال أو الموضوع ثم الإجابة أو القاعدة المرتبطة به.
4. تأكد أن الملف لا يحتوي على بيانات عملاء أو كلمات مرور أو أسرار داخلية.

## متى تستخدم ملفًا منفصلًا؟

- عندما تكون لديك سياسة طويلة لها عدة حالات.
- عندما تختلف التفاصيل بين فروع أو خدمات كثيرة.
- عندما تحتاج شرح خطوات كاملة للفريق أو العميل.

> **لأفضل نتيجة**
> جودة التنظيم أهم من حجم الملف. ملف قصير ومحدد أفضل من مستند كبير يحتوي على معلومات مكررة وغير محدثة.

[فتح المعرفة التفصيلية](/client/knowledge-base/deep)

---

## كتابة تعليمات ردود واضحة

- Language: ar
- Section: المعرفة وسلوك الموظف الذكي
- Canonical: https://mrailabs.com/docs/ar/knowledge-and-behavior/ai-reply-instructions/
- Markdown: https://mrailabs.com/docs/ar/knowledge-and-behavior/ai-reply-instructions.md
- Published: 2026-09-03T20:38:56.667478

حدد نبرة الرد وقواعد التعامل والتحويل البشري بدون إرباك الموظف الذكي.

## ما الذي يجب أن تكتبه في تعليمات رد موظف AI؟

استخدم التعليمات لتحديد أسلوب الكلام وقواعد التعامل ومتى يحتاج العميل موظفًا بشريًا، وليس لتكرار كل أسعار وخدمات الشركة. اجعل القواعد قصيرة وواضحة واختبر أثرها على أكثر من سيناريو.

*استخدم أقسام التعليمات لضبط الهوية والأسلوب ووصف الشركة وخدماتها.*

تعليمات الذكاء تتحكم في طريقة استخدام المعلومات، وليس في المعلومات نفسها. استخدمها لتحديد السلوك والنبرة والحدود.

## تعليمات جيدة تشمل

- اللغة واللهجة ونبرة الكلام المناسبة للبراند.
- طول الرد وهل تفضل رسائل قصيرة أو شرحًا مفصلًا.
- المعلومات التي يجب جمعها قبل الحجز أو تسجيل الطلب.
- متى يسأل سؤالًا إضافيًا ومتى يقدم ترشيحًا.
- الحالات التي يجب فيها التوقف والتحويل للفريق البشري.
- الأشياء التي لا يجب تخمينها أو الوعد بها.

## اكتب قاعدة قابلة للتنفيذ

> **مثال**
> بدل: كن محترفًا. اكتب: استخدم لهجة مصرية بسيطة، اجعل كل رسالة أقل من 4 سطور، ولا تؤكد موعدًا قبل جمع الاسم ورقم الهاتف والخدمة واليوم المناسب.

> **افصل السلوك عن الحقائق**
> لا تضع أسعار المنتجات داخل تعليمات السلوك؛ ضعها في الكتالوج حتى يسهل تحديثها.

[فتح تعليمات الردود](/client/knowledge-base/instructions)

[افهم كيف تعتمد الردود على معرفة شركتك](/docs/ar/knowledge-and-behavior/grounded-ai-replies-from-business-knowledge/)

---

## تصميم رحلة المحادثة

- Language: ar
- Section: المعرفة وسلوك الموظف الذكي
- Canonical: https://mrailabs.com/docs/ar/knowledge-and-behavior/conversation-builder/
- Markdown: https://mrailabs.com/docs/ar/knowledge-and-behavior/conversation-builder.md
- Published: 2026-07-14T20:11:38.480940

رتب مراحل الحوار من الترحيب حتى الإجراء المطلوب بدل الاعتماد على ردود منفصلة.

منشئ المحادثة يساعدك تحدد كيف يقود الموظف الذكي العميل من أول رسالة إلى نتيجة واضحة، مثل الحجز أو تسجيل طلب أو التحويل للفريق.

*راجع المراحل الجاهزة وعدّل كل مرحلة ثم انشر النسخة عندما تصبح الرحلة جاهزة.*

## المراحل الأساسية

- الترحيب وتحديد سبب التواصل.
- اكتشاف احتياج العميل والأسئلة الضرورية.
- ترشيح الخدمة أو الحل المناسب.
- التعامل مع الاعتراضات والأسئلة المتكررة.
- الإغلاق والدعوة للخطوة التالية.
- جمع بيانات الإجراء المطلوب مثل الحجز أو المتابعة.

## قبل نشر الرحلة

1. راجع ترتيب المراحل والأسئلة المطلوبة في كل مرحلة.
2. تأكد أن العميل يمكنه الخروج لسؤال جانبي ثم العودة للرحلة.
3. اختبر حالة عميل جاهز وحالة عميل متردد وحالة تحتاج تحويلًا بشريًا.
4. انشر النسخة الجاهزة؛ المسودات تستخدم للاختبار ولا تغيّر المحادثات الحية حتى النشر.

> **ميزة تجريبية**
> قد لا تظهر هذه الميزة في كل الحسابات. استخدمها فقط عندما تجدها داخل قسم سلوك الموظف الذكي.

[فتح منشئ المحادثة](/client/knowledge-base/conversation-builder)

---

## إنشاء مستند في قاعدة المعرفة بالصوت

- Language: ar
- Section: المعرفة وسلوك الموظف الذكي
- Canonical: https://mrailabs.com/docs/ar/knowledge-and-behavior/create-knowledge-document-with-voice/
- Markdown: https://mrailabs.com/docs/ar/knowledge-and-behavior/create-knowledge-document-with-voice.md
- Published: 2026-07-14T20:11:38.480940

سجل إجابة صوتية وحولها إلى مستند قابل للمراجعة قبل إضافته للمعرفة.

## كيف أنشئ مستندًا في قاعدة المعرفة باستخدام صوتي؟

اختر موضوعًا إرشاديًا، سجل إجابتك بشكل طبيعي، ثم راجع النص الذي ينشئه النظام وعدله قبل إضافته إلى Documents. لا يصبح التسجيل معرفة معتمدة قبل مرحلة المراجعة والإضافة.

- اسمح للمتصفح باستخدام الميكروفون.
- اذكر الحقائق والاستثناءات بوضوح.
- صحح النص قبل إضافته إلى المستندات.

*اختر موضوعًا وسجّل الإجابات ثم راجع المستند الناتج قبل اعتماده.*

## خطوات الاستخدام

1. اختر موضوعًا جاهزًا أو أنشئ موضوعًا خاصًا.
2. ابدأ التسجيل وتحدث بطبيعتك مع ذكر التفاصيل المهمة.
3. أوقف التسجيل وانتظر إنشاء المسودة؛ يمكنك مغادرة الصفحة أثناء المعالجة.
4. راجع المستند الناتج وصحح أي خطأ أو معلومة ناقصة.
5. اضغط إضافة إلى المستندات ثم تابع حالته داخل المعرفة التفصيلية.

> **مهم**
> راجع الأسماء والأسعار والسياسات بعد التحويل؛ جودة التسجيل لا تلغي ضرورة المراجعة البشرية.

## أسئلة شائعة

### هل يمكنني إعادة التسجيل؟

نعم، يمكنك تسجيل إجابة جديدة قبل إضافة المستند النهائي.

### ماذا أفعل إذا رفض المتصفح الميكروفون؟

فعّل إذن الميكروفون للموقع من إعدادات المتصفح ثم أعد المحاولة.

[فتح الصفحة في Mr. AI](/client/knowledge-base/file-generator)

---

## كتابة تعليمات مستقلة لكل قسم

- Language: ar
- Section: المعرفة وسلوك الموظف الذكي
- Canonical: https://mrailabs.com/docs/ar/knowledge-and-behavior/knowledge-base-section-instructions/
- Markdown: https://mrailabs.com/docs/ar/knowledge-and-behavior/knowledge-base-section-instructions.md
- Published: 2026-07-13T18:51:40.226212

حدد قواعد منفصلة لمصادر المعرفة وسلوك الرد بدل جمع كل شيء في ملاحظة واحدة.

## ما فائدة تعليمات كل قسم في قاعدة المعرفة؟

تسمح لك تعليمات الأقسام بوضع قواعد محددة للهوية، والأسلوب، والسياسات، والمنتجات، والعروض، والمستندات، ومسار المحادثة، والتحويل والإجراءات. القسم الفارغ لا يرسل كتعليمات فعالة.

- اكتب القاعدة في القسم المرتبط بها.
- لا تكرر الحقيقة في أكثر من مصدر.
- كل قسم يدعم حتى 1200 حرف.

## خطوات الاستخدام

1. افتح قاعدة المعرفة ثم تعليمات كل قسم.
2. اختر القسم الذي يطابق القاعدة المطلوبة.
3. اكتب تعليمات قابلة للتنفيذ مع مثال واضح.
4. اترك الأقسام غير المطلوبة فارغة بدل إضافة كلام عام.
5. احفظ ثم اختبر نفس السيناريو داخل اختبار المساعد.

## أسئلة شائعة

### ما الأقسام المتاحة؟

الهوية والشركة، الصوت والأسلوب، سياسات العمل، المنتجات، العروض، المعرفة العميقة، مسار المحادثة، والتحويل والإجراءات.

### هل تستبدل هذه التعليمات معلومات المنتجات؟

لا؛ المعلومات والحقائق تبقى في مصادرها، بينما التعليمات تحدد طريقة استخدامها.

[فتح الصفحة في Mr. AI](/client/knowledge-base/section-instructions)

---

## كيف يعتمد رد موظف AI على معرفة شركتك؟

- Language: ar
- Section: المعرفة وسلوك الموظف الذكي
- Canonical: https://mrailabs.com/docs/ar/knowledge-and-behavior/grounded-ai-replies-from-business-knowledge/
- Markdown: https://mrailabs.com/docs/ar/knowledge-and-behavior/grounded-ai-replies-from-business-knowledge.md
- Published: 2026-09-03T20:38:55.983279

افهم كيف ترتبط قاعدة المعرفة وتعليمات السلوك والاختبار بالردود الدقيقة، وماذا يحدث عندما لا توجد معلومة موثوقة.

## ماذا يعني أن يكون رد موظف AI مبنيًا على معرفة شركتك؟

يعني أن المعلومات التشغيلية مثل الخدمات والأسعار والمواعيد والسياسات تأتي من المعرفة التي جهزتها داخل Mr. AI، بينما تحدد تعليمات السلوك كيف يستخدم الموظف هذه المعلومات. عندما تكون المعلومة ناقصة أو الحالة تحتاج إنسانًا، الحل الآمن هو إصلاح المصدر أو تحويل الحالة بدل اختراع إجابة.

- المعرفة تجيب: ما الحقيقة التي نعتمد عليها؟
- التعليمات تجيب: كيف نستخدم هذه الحقيقة في الرد؟
- الاختبار يكشف الفجوات قبل وصولها لعملاء حقيقيين.

## متى تحتاج هذا المفهوم؟

- عندما يكون الرد سريعًا لكنه غير دقيق أو عام.
- عندما تختلف إجابة الموظف عن الأسعار أو السياسات الحالية.
- عندما تريد فهم هل المشكلة في المعرفة أم في أسلوب وتعليمات الرد.

## مسار تحسين الرد

1. حدد الحقيقة التي يجب أن يعرفها الموظف.
2. ضعها في المصدر المناسب داخل قاعدة المعرفة بدل تكرارها في رسائل مؤقتة.
3. اضبط تعليمات السلوك إذا كانت المشكلة في طريقة استخدام المعلومة.
4. اختبر نفس النية بصيغ مختلفة، بما فيها سؤال لا توجد له معلومة.
5. انشر أو وسّع الاستخدام فقط بعد أن يصبح السلوك المتوقع واضحًا.

> **حدود مهمة**
> لا توجد قاعدة معرفة تجعل كل سؤال قابلًا للإجابة. بعض الحالات تحتاج اعترافًا بعدم توفر المعلومة أو تدخلًا بشريًا.

## أسئلة سريعة

### هل أكرر نفس المعلومة في التعليمات وقاعدة المعرفة؟

يفضل وضع الحقيقة في مصدر المعرفة المناسب واستخدام التعليمات لتحديد السلوك، حتى لا تنشئ نسخًا متعارضة.

### ماذا أفعل إذا كانت الإجابة خاطئة؟

حدد أولًا هل المصدر ناقص أو قديم أم أن التعليمات جعلت الموظف يستخدم المعلومة بطريقة غير مناسبة، ثم أصلح المصدر وأعد الاختبار.

[راجع نظرة عامة على قاعدة المعرفة](/docs/ar/knowledge-and-behavior/knowledge-base-overview/)

[راجع تعليمات الرد](/docs/ar/knowledge-and-behavior/ai-reply-instructions/)

[اختبر الموظف الذكي](/docs/ar/getting-started/test-assistant-before-live/)

[أصلح الردود الضعيفة](/docs/ar/troubleshooting/improve-ai-answer-quality/)

---

## إضافة وتعديل منتج أو خدمة بشكل صحيح

- Language: ar
- Section: المعرفة وسلوك الموظف الذكي
- Canonical: https://mrailabs.com/docs/ar/knowledge-and-behavior/build-and-edit-catalog-items/
- Markdown: https://mrailabs.com/docs/ar/knowledge-and-behavior/build-and-edit-catalog-items.md
- Published: 2026-09-29T19:19:11.235236

ابدأ بالمعلومات اللي العميل فعلًا محتاجها، وبعدها أضف الصور والاختيارات ومعلومات التنظيم والبحث من غير ما تخلط بينهم.

## إيه أهم حاجة أكتبها داخل عنصر الكتالوج؟

لو الهيكل جاهز بالفعل، اكتب الحقائق اللي العميل هيعتمد عليها: اسم واضح، ملخص قصير، التفاصيل المطلوبة، والسعر والعملة لو معروفين. بعدها أضف الاختيارات والصور والملاحظات واربط العنصر بالتنظيم ومعلومات البحث المناسبة.

- خلي Brief Summary سريع وسهل القراءة.
- حط التفاصيل الأطول في Content بدل ما تحشرها في الاسم أو الملخص.
- راجع السعر والعملة والـOptions / Variants لأن دي معلومات مباشرة في رد العميل.

## قبل ما تضيف عناصر كتير

> **جهّز الهيكل الأول**
> لو بتبني Catalog جديد، بنرشح تبدأ من Build & Manage with AI: ادّيه بيانات العناصر وطبيعة البيزنس، خليه يقترح Folders وSemantic Tree / Classification وAI Search Attributes، راجع الهيكل، وبعدها خليه يضيف العناصر عليه. الإضافة اليدوية تفضل مفيدة للتعديل أو الحالات الصغيرة، لكنها مش المسار الموصى به لبناء كتالوج كامل.

## البيانات الأساسية

- Name: الاسم اللي العميل والفريق يقدروا يميزوا بيه العنصر بسهولة.
- Price / Money: السعر والعملة عندما يكونوا معروفين.
- Options / Variants: المقاسات أو الأنواع أو الباقات أو الاختيارات المتاحة عندما تنطبق.
- Brief Summary: جملة أو سطرين يشرحوا العنصر بسرعة.
- Content: التفاصيل الإضافية اللي يحتاجها العميل قبل اتخاذ قرار.
- AI Usage Guidance / Internal Notes: تعليمات داخلية تساعد AI يستخدم العنصر بشكل صحيح، ومش معلومة تُعرض للعميل كحقيقة.
- Customer Delivery Note: ملاحظة مساعدة عند تقديم العنصر للعميل.

## الصور

أضف الصور اللي تساعد العميل يفهم المنتج أو الخدمة فعلًا. النظام يدعم أكثر من صورة حسب سيناريو الإنشاء، فراجع النتيجة بعد الحفظ وتأكد إن الصور مرتبطة بالعنصر المقصود.

## بعد ما بيانات العنصر تكون صحيحة

- استخدم Folder لو هدفك ترتّب العناصر للفريق داخل لوحة التحكم.
- استخدم التصنيف الدلالي وSemantic Tags لو عايز توضّح معنى العنصر للبحث الطبيعي.
- استخدم AI Search Attributes لما يكون عندك حقائق دقيقة ومتكررة زي Instructor أو Brand أو Branch أو Level.
- استخدم Search Name داخل معلومات البحث عندما تحتاج شكلًا ثابتًا يساعد النظام يتعرف على نفس الاسم عبر اختلاف اللغة أو الكتابة.

## استخدام AI Improve

AI Improve يساعدك تقترح تحسينات للعنصر، لكنه مش بديل عن المصدر الحقيقي للبيانات. راجع أي تغيير في السعر أو الاسم أو التصنيف أو معلومات البحث قبل اعتماده.

> **الدقة أهم من ملء كل خانة**
> لو معلومة مش معروفة، سيبها ناقصة بدل ما تخلي AI يخمّنها. كتالوج أصغر وصحيح أفضل من كتالوج مليان تفاصيل غير موثوقة.

[فتح الكتالوج](/client/knowledge-base/products)

---

## كيف تحسّن موظف AI باستمرار بعد الإطلاق؟

- Language: ar
- Section: المعرفة وسلوك الموظف الذكي
- Canonical: https://mrailabs.com/docs/ar/knowledge-and-behavior/continuous-ai-employee-quality-loop/
- Markdown: https://mrailabs.com/docs/ar/knowledge-and-behavior/continuous-ai-employee-quality-loop.md
- Published: 2026-09-03T20:38:55.983279

استخدم دورة واضحة تربط المعرفة والتعليمات والاختبار والمحادثات الحقيقية والتحسين بدل تعديل الردود بشكل عشوائي.

## كيف تحسّن موظف AI بعد أن يبدأ العمل مع العملاء؟

تعامل مع الجودة كدورة مستمرة: راقب حالة أو ردًا ضعيفًا، حدّد السبب في المعرفة أو التعليمات أو رحلة المحادثة أو الحاجة لإنسان، أصلح المصدر الصحيح، اختبر السيناريو مرة أخرى، ثم راقب النتيجة بعد التطبيق. لا تجعل كل مشكلة تؤدي إلى patch منفصل داخل نص الرد.

- ابدأ من حالة حقيقية ومحددة.
- أصلح المصدر وليس العرض فقط.
- المراجعة والاختبار يسبقان تطبيق التغيير.

## دورة الجودة العملية

1. اجمع مثالًا واضحًا لرد ضعيف أو خطوة تعطلت.
2. صنّف السبب: معرفة، تعليمات، رحلة محادثة، Action، أو تدخل بشري.
3. عدّل أقل جزء يزيل السبب بدون توسيع غير ضروري.
4. اختبر النجاح والفشل والحالات القريبة من السيناريو.
5. طبّق التغيير وراجع محادثات لاحقة للتأكد أن المشكلة لم تنتقل إلى مكان آخر.

## أين تدخل أدوات Mr. AI؟

- قاعدة المعرفة وتعليمات السلوك لإصلاح المصدر.
- Test Assistant للتحقق قبل التشغيل.
- Customer Operations وClient Actions لمراجعة الحالات التي تحتاج عملًا بشريًا.
- Build & Manage with AI كمسار اختياري لتحضير تغييرات مدعومة مع بقاء المراجعة والاختبار داخل Mr. AI.

> **لا تختبر مثالًا واحدًا فقط**
> لا تعتبر تحسن مثال واحد دليلًا على أن كل الحالات أصبحت صحيحة. اختبر أكثر من صياغة وحافظ على تدخل الإنسان للحالات التي تحتاجه.

[اختبر الموظف الذكي](/docs/ar/getting-started/test-assistant-before-live/)

[راجع نظرة عامة على قاعدة المعرفة](/docs/ar/knowledge-and-behavior/knowledge-base-overview/)

[أصلح الردود الضعيفة](/docs/ar/troubleshooting/improve-ai-answer-quality/)

---

## تنظيم الكتالوج: Folders والتصنيف الدلالي والـTags

- Language: ar
- Section: المعرفة وسلوك الموظف الذكي
- Canonical: https://mrailabs.com/docs/ar/knowledge-and-behavior/organize-catalog-and-bulk-actions/
- Markdown: https://mrailabs.com/docs/ar/knowledge-and-behavior/organize-catalog-and-bulk-actions.md
- Published: 2026-09-29T19:19:11.235236

فرّق بين ترتيب العناصر للفريق وبين المعنى اللي محتاج AI يفهمه، واستخدم الفلاتر والـBulk Actions لإدارة كتالوج كبير بأمان.

## إيه الفرق بين Folder والتصنيف الدلالي والـTags؟

الـFolder بيساعدك ترتب الكتالوج داخل لوحة التحكم. التصنيف الدلالي بيوضح مكان العنصر داخل شجرة معنى يفهمها AI. والـSemantic Tags بتضيف معاني مرنة ممكن تتكرر على عناصر موجودة في أماكن مختلفة. لو بتبني Catalog من الصفر، بنرشح إن AI يحلل مجموعة العناصر ويقترح الثلاثة الأول، وبعدها تراجع الهيكل قبل إنشاء العناصر.

- Folder للفريق والتنظيم البصري.
- Semantic Classification للمعنى الهرمي الذي يساعد AI.
- Semantic Tags لمعاني مرنة مشتركة بين عناصر مختلفة.

## التصنيف الدلالي أو Semantic Tree

تقدر تبني مسار دلالي حتى 3 مستويات. مثال: تعليم > كورسات > مهارات مهنية. مش لازم كل عنصر يستخدم الثلاث مستويات؛ استخدم العمق اللي يوضح المعنى من غير تعقيد.

## إمتى أستخدم Semantic Tags؟

- لما معنى مهم ينطبق على عناصر من تصنيفات مختلفة، مثل «مناسب للمبتدئين» أو «أونلاين» إذا كان ده معنى تستخدمه في الاكتشاف.
- لما تحتاج تضيف معنى مرن من غير ما تغيّر مكان العنصر في الـSemantic Tree.
- ما تستخدمش Tag بدل حقيقة دقيقة المفروض تكون AI Search Attribute.

## مثال يوضح الفرق

- Folder: عروض سبتمبر — علشان الفريق يلاقي عناصر الحملة بسرعة.
- Semantic Classification: تعليم > كورسات > مبيعات — علشان AI يفهم نوع العنصر وسياقه.
- Semantic Tag: للمبتدئين — معنى مرن ممكن يظهر على كورسات من أقسام مختلفة.
- AI Search Attribute: Instructor = حسن فليح — حقيقة دقيقة ينفع العميل يسأل عنها مباشرة.

## إدارة عدد كبير من العناصر

1. استخدم Search والفلاتر وFolder والتصنيف الدلالي علشان تحدد المجموعة المطلوبة.
2. راجع عدد النتائج قبل اختيار الكل.
3. استخدم الاختيار الجماعي للنتائج المطابقة حتى لو موزعة على أكثر من صفحة عندما الواجهة تتيح ذلك.
4. طبّق التغيير على المجموعة المطلوبة فقط، وبعدها تابع إعادة الفهرسة لو التغيير أثّر على معنى العناصر.

> **لو عندك كتالوج كبير**
> الحد الآمن الحالي لعملية Semantic Classification الجماعية التفاعلية هو 500 عنصر. لو عندك نتائج أكتر، ضيّق الفلاتر وقسّم الشغل بدل تنفيذ تغيير ضخم مرة واحدة.

## لو بدأت Re-index

- التحديثات الكبيرة ممكن تكمل في الخلفية.
- تابع حالة العملية من الكتالوج بدل ما تفترض إن Refresh للصفحة أوقفها.
- لو ظهرت عناصر فاشلة واختبار Retry متاح، أعد المحاولة للعناصر المتأثرة فقط.

[فتح الكتالوج وتنظيم العناصر](/client/knowledge-base/products)

---

## إدارة كتالوج كبير بالـAI

- Language: ar
- Section: المعرفة وسلوك الموظف الذكي
- Canonical: https://mrailabs.com/docs/ar/knowledge-and-behavior/manage-catalog-with-ai/
- Markdown: https://mrailabs.com/docs/ar/knowledge-and-behavior/manage-catalog-with-ai.md
- Published: 2026-09-29T19:19:11.235236

خلّي Build & Manage with AI يساعدك في إنشاء وتنظيم وتحديث الكتالوج على دفعات تقدر تراجعها بدل تعديل مئات العناصر يدويًا.

## إزاي أستخدم AI مع كتالوج كبير من غير ما أفقد السيطرة؟

في الوقت الحالي بنرشح تبدأ من Build & Manage with AI قبل إنشاء العناصر: ادّيه قائمة المنتجات أو الخدمات وسياق البيزنس، خليه يقترح Folders وSemantic Tree / Classification وTags وAI Search Attributes وSearch Names، راجع الهيكل، وبعدها خليه ينشئ العناصر ويوزعها عليه على دفعات.

- خلّي AI يحلل المجموعة ككل قبل إنشاء العناصر.
- راجع الهيكل والحقائق، وبعدها نفّذ على Proposals محدودة.
- بعد Publish والفهرسة، اختبر النتيجة بأسئلة عملاء حقيقية.

## أفضل ترتيب لو بتبدأ من ملف أو قائمة كبيرة

1. أعطِ AI المصدر اللي فيه المنتجات أو الخدمات وسياق البيزنس ووضح هدف الكتالوج.
2. اطلب منه تحليل المجموعة واقتراح Folders والـSemantic Tree والـTags قبل إنشاء العناصر.
3. اطلب منه اقتراح AI Search Attributes والقيم وAliases وSearch Names اللي تدعم الأسئلة الدقيقة، من غير اختراع حقائق غير موجودة في المصدر.
4. راجع الهيكل والحقائق المقترحة وعدّلها لو محتاجة تدخل بشري.
5. بعد الموافقة، اطلب من AI إنشاء العناصر وتوزيعها على الهيكل والقيم المناسبة في دفعات مراجعة؛ عقد Catalog AI الحالي يدعم بحد أقصى 100 عنصر في الـlogical proposal الواحد.
6. راجع → انشر → انتظر الفهرسة المطلوبة → اختبر من Test Assistant.

## مثال: عندك 1000 عنصر

وجود 1000 عنصر مش معناه إنك تبعت 1000 تعديل مباشر مرة واحدة. قسمهم على دفعات واضحة علشان لو ظهر خطأ تعرف توقفه وتراجعه وتعيد المحاولة من غير ما تعرّض الكتالوج كله لتغيير واحد.

> **AI يساعدك، لكنه مش مصدر الحقيقة**
> راجع بالذات السعر والعملة واسم العنصر والقيم الدقيقة. AI ممكن يساعد في التنظيم، لكن مصدر البيانات عندك هو المرجع للحقائق.

## بعد كل دفعة

- راجع إن العناصر اتضافت أو اتعدلت زي ما كنت متوقع.
- تابع أي Re-index مطلوب.
- اختبر سؤال discovery طبيعي.
- اختبر سؤال exact lookup أو count لو أضفت AI Search Attributes.
- ابدأ Test جديد بعد أي تعديل مهم علشان ما تعتمدش على سياق قديم.

## أسئلة شائعة

### هل لازم أعمل 1000 عنصر يدويًا؟

لا. AI يقدر يساعدك في التنظيم والتغييرات، لكن التنفيذ الكبير يفضل مقسّم إلى دفعات مراجعة بدل one-shot غير قابل للمراجعة.

### هل AI يقدر يخترع Search Name أو قيمة ناقصة؟

ممكن يقترح صياغة تساعد البحث، لكن لازم تراجعها وتأكد إنها تمثل نفس الحقيقة. أي قيمة أعمال ناقصة لازم تفضل ناقصة لحد ما يكون عندك مصدر موثوق.

[فتح الكتالوج](/client/knowledge-base/products)

---

## البحث الدقيق: AI Search Attributes وSearch Name

- Language: ar
- Section: المعرفة وسلوك الموظف الذكي
- Canonical: https://mrailabs.com/docs/ar/knowledge-and-behavior/catalog-ai-search-attributes/
- Markdown: https://mrailabs.com/docs/ar/knowledge-and-behavior/catalog-ai-search-attributes.md
- Published: 2026-09-29T19:19:11.235236

استخدم حقائق منظمة وأسماء بحث ثابتة علشان Mr. AI يقدر يجاوب على أسئلة دقيقة مثل «كل منتجات البراند ده» أو «كام كورس للمدرس ده؟».

## إمتى أحتاج AI Search Attributes؟

استخدمها لما يكون عندك حقيقة دقيقة ومتكررة والعميل ممكن يسأل عنها مباشرة، زي المدرس أو البراند أو الفرع أو المستوى أو المدة. بدل ما يعتمد Mr. AI على تشابه الكلام فقط، بتديله معلومة منظمة يقدر يبحث ويعدّ ويصفّي بيها.

- Attribute = نوع الحقيقة، مثل Instructor.
- Value = القيمة على العنصر، مثل حسن فليح.
- Aliases وSearch Name بيساعدوا النظام يتعرف على نفس القيمة لما تتكتب بأشكال مختلفة.

> **خلّي AI يقترح معلومات البحث**
> لو عندك مجموعة عناصر جديدة، خَلّي AI يحللها ويقترح الـAttributes والـValues والـAliases وSearch Names اللي تظهر من بيانات البيزنس قبل إنشاء العناصر. بعدها راجع الاقتراحات، لأن AI ممتاز في اكتشاف الأنماط لكن ما ينفعش يخترع حقيقة مش موجودة في المصدر.

## الأنواع المتاحة

- Text: حقيقة نصية مثل اسم مدرس أو فرع.
- Enum: قيمة من مجموعة معروفة ومتكررة مثل Level أو Category.
- Number: رقم مثل Duration أو Capacity عندما تحتاج المقارنات المدعومة.
- Boolean: نعم/لا لحقيقة واضحة مثل Online.

## إيه الفرق بين Value وAlias وSearch Name؟

- Value هي القيمة الأساسية اللي تمثل الحقيقة داخل الكتالوج.
- Alias هو طريقة أخرى لكتابة نفس القيمة، وليس قيمة مختلفة. مثال: «حسن فليح» وHassan Faleeh لو الاتنين نفس الشخص.
- Search Name هو اسم ثابت وصديق للبحث يساعد النظام يربط بين القيمة وصيغ مختلفة عبر اللغة أو الكتابة.
- Search Name لا يغيّر الاسم اللي العميل يشوفه؛ هو بيساعد محرك البحث يفهم المقصود.

## شكل Search Name

- يكون بالإنجليزية بحروف lowercase.
- يستخدم مسافة واحدة بين الكلمات.
- لا يستخدم أرقامًا أو underscores أو hyphens أو punctuation.
- مثال: «أمنية علي عامر» يمكن أن يكون Search Name لها omnia ali amer.
- مثال: «العربية» يمكن أن يكون Search Name لها arabic عندما تكون دي القيمة المقصودة.

## Mr. AI بيستخدمه إزاي؟

النظام يحاول أولًا يفهم القيمة اللي العميل كتبها فعلًا. لو القيمة ما اتحلتش بشكل واضح، Search Name يساعد في الوصول لنفس الكيان بصيغة ثابتة. لو النتيجة ما زالت ملتبسة، النظام ما يجبرش فلتر دقيق ممكن يطلع منتج غلط؛ يقدر يرجع لمسار البحث الدلالي الأكثر أمانًا.

## Attribute ولا Semantic Tag؟

- استخدم Attribute لحقيقة دقيقة ينفع تسأل عنها أو تعمل عليها Filter أو Count.
- استخدم Semantic Tag لمعنى مرن يساعد الاكتشاف، لكنه مش حقل أعمال دقيق.
- ما تحوّلش توقعات أو استنتاجات AI إلى Attribute من غير مصدر واضح.

> **استخدم البيانات المنظمة للأسئلة الدقيقة**
> مثال عملي: لو عندك 40 كورس وبتحتاج تجاوب على «كل كورسات أ. أمنية»، Instructor كـAttribute مع Value صحيحة وSearch Name مضبوط أقوى بكتير من الاعتماد على وجود اسم المدرس داخل وصف كل كورس.

## لو عندك عناصر قديمة

العناصر اللي من غير AI Search Attributes تفضل قابلة للبحث والاستخدام. أضف Attributes تدريجيًا للحالات اللي محتاجة دقة أعلى بدل ما تحاول تحويل كل الكتالوج مرة واحدة.

## تعديل أو إيقاف Attribute

تقدر تعدل التعريفات أو توقف استخدامها. لو Attribute عليه قيم مرتبطة بعناصر بالفعل، استخدم مسار Disable الآمن عندما النظام يطلبه بدل حذف العلاقة بشكل مفاجئ.

[فتح معلومات البحث في الكتالوج](/client/knowledge-base/products)

---

## اختيار القناة وخطوات ما قبل التشغيل

- Language: ar
- Section: ربط القنوات والتشغيل
- Canonical: https://mrailabs.com/docs/ar/channels-and-launch/connect-channels/
- Markdown: https://mrailabs.com/docs/ar/channels-and-launch/connect-channels.md
- Published: 2026-07-14T20:11:38.480940

راجع قائمة الجاهزية ثم اربط القناة التي يستخدمها عملاؤك.

اربط قناة واحدة أولًا واختبرها بالكامل قبل إضافة قنوات أخرى. هذا يجعل اكتشاف أي مشكلة أسهل ويمنع وصول رد غير جاهز لعدد كبير من العملاء.

*تعرض صفحة ربط القنوات حالة كل قناة والمدخل المناسب لإعدادها أو إدارتها.*

## قائمة الجاهزية

- بيانات الشركة والخدمات والأسعار محدثة.
- تعليمات الرد وقواعد التحويل البشري واضحة.
- اختبار المساعد نجح في السيناريوهات الأساسية.
- إعدادات الرد التلقائي والمتابعة والتحكم اليدوي مناسبة لفريقك.
- لديك شخص مسؤول عن متابعة المحادثات والإجراءات في الأيام الأولى.

## بعد الربط

1. أرسل رسالة من حساب أو رقم مختلف عن الحساب المتصل.
2. تأكد أن الرسالة ظهرت في الدردشات والتحكم.
3. راجع رد الموظف الذكي وحالة القناة.
4. جرب الرد اليدوي ثم إعادة تشغيل الذكاء للمحادثة.

[فتح صفحة ربط القنوات](/client/settings/connect)

---

## ربط واتساب باستخدام QR

- Language: ar
- Section: ربط القنوات والتشغيل
- Canonical: https://mrailabs.com/docs/ar/channels-and-launch/connect-whatsapp-qr/
- Markdown: https://mrailabs.com/docs/ar/channels-and-launch/connect-whatsapp-qr.md
- Published: 2026-07-27T17:29:45.555261

امسح QR من الأجهزة المرتبطة ثم أكد الاتصال برسالة تجريبية.

يتم ربط واتساب كجهاز مرتبط. جهّز الهاتف الذي عليه رقم النشاط، وافتح صفحة ربط واتساب من جهاز الكمبيوتر حتى تستطيع مسح QR بسهولة.

*من تبويب واتساب يمكنك تشغيل أو إيقاف رد AI وبدء ربط جهاز واتساب جديد.*

## خطوات الربط

1. افتح واتساب على الهاتف.
2. افتح القائمة ثم اختر الأجهزة المرتبطة.
3. اضغط ربط جهاز واسمح باستخدام الكاميرا.
4. امسح QR الظاهر في لوحة Mr. AI.
5. انتظر حتى تظهر حالة تم الاتصال.
6. أرسل رسالة واتساب تجريبية من رقم آخر لتأكيد وصول الرسائل والردود.

> **لو QR لم يعمل**
> صلاحية QR قصيرة ويتم تحديثه تلقائيًا. لو ظهر خطأ أو انتهت الصلاحية اضغط اطلب QR جديد ثم امسحه مرة أخرى.

## للحفاظ على الاتصال

- لا تحذف الجهاز المرتبط من واتساب دون قصد.
- راجع حالة الاتصال إذا توقفت الرسائل فجأة.
- بعد تغيير الهاتف أو إعادة تثبيت واتساب قد تحتاج إعادة الربط.

[فتح ربط واتساب](/client/settings/connect/whatsapp)

---

## ربط Facebook Messenger

- Language: ar
- Section: ربط القنوات والتشغيل
- Canonical: https://mrailabs.com/docs/ar/channels-and-launch/connect-facebook-messenger/
- Markdown: https://mrailabs.com/docs/ar/channels-and-launch/connect-facebook-messenger.md
- Published: 2026-07-27T17:29:45.554611

جهز تطبيق Meta وبيانات الصفحة ثم فعّل واختبر اتصال Messenger.

ربط Messenger الحالي يعتمد على تطبيق Meta خاص بنشاطك. ستحتاج صلاحية على صفحة Facebook والوصول إلى Meta for Developers.

*من تبويب فيسبوك ماسنجر يمكنك مراجعة حالة الاتصال واختباره والتحكم في رد AI.*

## المعلومات المطلوبة

- Facebook Page ID للصفحة المطلوبة.
- Page Access Token صالح.
- Callback URL وVerify Token اللذان تعرضهما صفحة الربط داخل Mr. AI.

## خطوات الربط

1. أنشئ Business App داخل Meta for Developers وأضف منتج Messenger.
2. اختر صفحة Facebook وأنشئ Page Access Token ثم انسخ Page ID والـToken إلى Mr. AI واحفظ.
3. داخل إعدادات Webhooks في Messenger، الصق Callback URL وVerify Token الظاهرين في Mr. AI.
4. فعّل الاشتراك في messages وmessaging_postbacks وmessaging_optins.
5. ارجع إلى Mr. AI واضغط تفعيل الاتصال ثم اختبار الاتصال.
6. قبل استقبال رسائل عملاء حقيقيين، اجعل تطبيق Meta في وضع Live وأكمل المتطلبات التي تظهر لك من Meta.

> **حماية بيانات Meta**
> Page Access Token معلومة سرية. لا ترسله في محادثة أو ملف عام ولا تشاركه مع شخص لا يحتاجه.

> **عند تغيير كود التحقق**
> لو أنشأت Verify Token جديدًا، يجب تحديثه أيضًا داخل Meta ثم إعادة التحقق.

[فتح ربط Facebook Messenger](/client/settings/connect/facebook)

---

## إضافة دردشة Mr. AI إلى موقعك

- Language: ar
- Section: ربط القنوات والتشغيل
- Canonical: https://mrailabs.com/docs/ar/channels-and-launch/website-chat-widget/
- Markdown: https://mrailabs.com/docs/ar/channels-and-launch/website-chat-widget.md
- Published: 2026-07-14T20:11:38.480940

خصص شكل الدردشة، اسمح لنطاق موقعك، ثم انسخ كود التثبيت.

دردشة الموقع تتيح للزائر التحدث مع الموظف الذكي من داخل موقعك. يمكنك تخصيص الهوية والمظهر ورسائل الترحيب وطريقة جمع بيانات الزائر.

*عاين دردشة الموقع واضبط الهوية والترحيب وزر الفتح قبل حفظ التغييرات.*

## خطوات التثبيت

1. فعّل دردشة الموقع.
2. أضف نطاق موقعك بصيغة كاملة مثل https://example.com إلى النطاقات المسموحة.
3. خصص اسم المساعد والألوان والموضع ورسائل الترحيب والردود السريعة.
4. اختر طريقة جمع بيانات الزائر وحد النقاط اليومي إن احتجت.
5. احفظ الإعدادات ثم انسخ كود التثبيت وضعه في موقعك.
6. افتح الموقع من نافذة خاصة وجرب المحادثة.

> **النطاقات المسموحة**
> القائمة الفارغة للنطاقات المسموحة تمنع الودجت من العمل على كل المواقع. أضف نطاق موقعك قبل الاختبار.

## إعدادات مفيدة

- يمكن اختيار الوضع الفاتح أو الداكن أو التلقائي.
- يمكن التحكم في فتح الدردشة تلقائيًا بعد وقت أو نسبة تمرير.
- يمكن إبقاء الزائر مجهولًا أو طلب الاسم والهاتف أولًا أو بشكل تدريجي.
- يمكن وضع حد أقصى للنقاط المستخدمة من الموقع يوميًا.

[فتح إعدادات دردشة الموقع](/client/settings/connect/website)

---

## إضافة وإدارة أكثر من رقم واتساب

- Language: ar
- Section: ربط القنوات والتشغيل
- Canonical: https://mrailabs.com/docs/ar/channels-and-launch/manage-multiple-whatsapp-numbers/
- Markdown: https://mrailabs.com/docs/ar/channels-and-launch/manage-multiple-whatsapp-numbers.md
- Published: 2026-07-13T18:51:40.226212

سمّ كل اتصال واربطه بـQR وأعد المسح أو الإدارة بدون التأثير على رقم آخر.

## هل يمكن ربط أكثر من رقم واتساب بحساب Mr. AI؟

تدعم صفحة ربط واتساب إدارة أكثر من اتصال. عند إضافة رقم جديد تختار اسمًا للاتصال، ثم تمسح رمز QR الخاص به. إعادة مسح اتصال موجود تستخدم معرفه حتى لا يتم توجيه QR إلى رقم مختلف.

- استخدم اسمًا واضحًا لكل رقم.
- امسح QR من الهاتف الصحيح.
- اختبر كل اتصال برسالة من رقم خارجي.

## خطوات الاستخدام

1. افتح Settings ثم Connect ثم WhatsApp.
2. اضغط إضافة جهاز أو رقم واكتب اسمًا يوضح الفرع أو الاستخدام.
3. امسح QR من الأجهزة المرتبطة على هاتف الرقم المطلوب.
4. انتظر ظهور حالة الاتصال واختبر استقبال رسالة.
5. استخدم إعادة المسح للاتصال المحدد عند تغيير الهاتف أو انتهاء الجلسة.

## أسئلة شائعة

### هل إضافة رقم جديد تفصل الرقم الأساسي؟

لا، كل اتصال يُدار بشكل مستقل ما لم يتم حذفه أو فصله.

### لماذا يجب تسمية الاتصال؟

الاسم يساعد الفريق يميز الأرقام والفروع ويقلل مسح QR للاتصال الخطأ.

[فتح الصفحة في Mr. AI](/client/settings/connect/whatsapp)

---

## ربط تطبيقك باستخدام System API

- Language: ar
- Section: ربط القنوات والتشغيل
- Canonical: https://mrailabs.com/docs/ar/channels-and-launch/system-api-chat-integration/
- Markdown: https://mrailabs.com/docs/ar/channels-and-launch/system-api-chat-integration.md
- Published: 2026-07-13T18:51:40.226212

أنشئ مفتاح محادثة مستقل واستدعِ واجهة chat من تطبيقك ثم ألغ المفتاح عند الحاجة.

## كيف أستخدم System API لإضافة موظف Mr. AI إلى تطبيقي؟

أنشئ مفتاحًا باسم واضح من صفحة System API، وانسخه عند ظهوره أول مرة، ثم أرسل طلب POST إلى /api/v1/chat باستخدام Bearer token ومعرف ثابت للمستخدم والرسالة. المفاتيح مخصصة للمحادثة ولا تكشف مفتاح النظام الداخلي.

- المفتاح السري يظهر مرة واحدة فقط.
- استخدم user_id ثابتًا لكل عميل للحفاظ على سياق صحيح.
- ألغ المفتاح فور الاشتباه في تسريبه.

## خطوات الاستخدام

1. افتح Settings ثم Connect ثم API.
2. اكتب اسم المفتاح وأنشئه ثم انسخ القيمة السرية فورًا.
3. احفظ المفتاح في Secret Manager أو متغير بيئة على السيرفر.
4. أرسل POST إلى /api/v1/chat مع Authorization: Bearer والمحتوى JSON.
5. راجع آخر استخدام وألغ أي مفتاح لم يعد مستخدمًا.

> **مهم**
> لا تنشر المفتاح في GitHub أو JavaScript عام أو Screenshots. إلغاء المفتاح يوقف التطبيقات التي تستخدمه فورًا.

## أسئلة شائعة

### هل أضع المفتاح داخل تطبيق المتصفح أو الموبايل؟

لا يُفضّل؛ مرّر الطلب عبر Backend تملكه حتى لا يتعرض المفتاح للمستخدم.

### هل يمكن رؤية المفتاح مرة أخرى؟

لا، تظهر القيمة الكاملة عند الإنشاء فقط؛ أنشئ مفتاحًا جديدًا إذا فقدتها.

[فتح الصفحة في Mr. AI](/client/settings/connect/api)

---

## استخدام صفحة الدردشات والتحكم

- Language: ar
- Section: المحادثات والعملاء
- Canonical: https://mrailabs.com/docs/ar/conversations-and-customers/chats-and-control/
- Markdown: https://mrailabs.com/docs/ar/conversations-and-customers/chats-and-control.md
- Published: 2026-07-14T20:11:38.480940

ابحث عن العملاء، افتح سجل المحادثة، وتحكم في السماح والذكاء والرد اليدوي.

صفحة الدردشات والتحكم هي المكان الرئيسي لمتابعة العملاء ورسائلهم. يمكنك البحث والتصفية حسب الحالة والمنصة ثم فتح أي محادثة لمراجعتها أو التدخل.

*استخدم البحث وفلاتر الحالة والمنصة للوصول إلى المحادثة المطلوبة بسرعة.*

## الحالات الأساسية

- مسموح: يمكن للنظام التعامل مع العميل حسب إعدادات القناة.
- قيد الانتظار: يحتاج القرار حسب وضع المستخدمين الجدد في إعدادات النظام.
- محظور: يتم منع التعامل التلقائي مع المستخدم.
- الذكاء يعمل: الموظف الذكي يمكنه الرد على المحادثة.
- رد يدوي أو متوقف مؤقتًا: الفريق يتولى المحادثة والذكاء لا يرسل ردًا حتى يعود للعمل.

## عند فتح المحادثة

- راجع سجل الرسائل والملفات المرسلة.
- اعرف الردود الصادرة من الذكاء والردود البشرية.
- شغّل أو أوقف الذكاء للمحادثة.
- أرسل ردًا يدويًا عند الحاجة.
- استخدم ملخص المحادثة عندما يكون السجل طويلًا.

> **العمل الجماعي**
> قبل الرد اليدوي، تأكد أن المحادثة ليست مفتوحة لدى زميل آخر. النظام يستخدم قفلًا لتقليل الردود البشرية المتعارضة.

[فتح الدردشات والتحكم](/client/clients/chats)

---

## استخدام مركز الرد اليدوي

- Language: ar
- Section: المحادثات والعملاء
- Canonical: https://mrailabs.com/docs/ar/conversations-and-customers/manual-reply-hub/
- Markdown: https://mrailabs.com/docs/ar/conversations-and-customers/manual-reply-hub.md
- Published: 2026-07-12T22:37:22.223480

ركز على المحادثات التي تحتاج متابعة بشرية بدل مراجعة كل المحادثات.

مركز الرد اليدوي يجمع المحادثات في مجموعات تساعد الفريق يركز على الحالات المهمة؛ مثل المحادثات التي يعمل فيها الذكاء، المحادثات التي انتقلت للوضع اليدوي، والمحادثات التي تدخل فيها الفريق مؤخرًا.

## طريقة العمل المقترحة

1. اختر المجموعة التي تريد مراجعتها.
2. استخدم البحث وفلاتر المنصة والفترة والحالة للوصول للحالات المهمة.
3. افتح المحادثة وراجع آخر الرسائل والإجراء المطلوب.
4. أرسل الرد اليدوي أو أعد تشغيل الذكاء حسب الحالة.
5. انتقل للمحادثة التالية مع متابعة عداد الرسائل غير المقروءة.

> **قفل الرد**
> قد يمنعك النظام من الرد إذا كانت المحادثة محجوزة لزميل آخر. انتظر انتهاء القفل أو افتح محادثة أخرى بدل إرسال رد مكرر.

[فتح مركز الرد اليدوي](/client/clients/manual-hub)

---

## تنظيم ملفات العملاء

- Language: ar
- Section: المحادثات والعملاء
- Canonical: https://mrailabs.com/docs/ar/conversations-and-customers/customer-profiles/
- Markdown: https://mrailabs.com/docs/ar/conversations-and-customers/customer-profiles.md
- Published: 2026-07-14T20:11:38.480940

حافظ على بيانات التواصل والتفضيلات والملاحظات في ملف واحد.

ملف العميل يجمع بيانات التواصل والمعلومات التي تساعد فريقك يتعامل معه بصورة متسقة. يمكنك تعديل ملف موجود أو إنشاء ملف جديد يدويًا.

*حدد المنصة وأدخل معرف العميل وبيانات الاتصال المتاحة ثم احفظ الملف.*

## البيانات التي يمكن تنظيمها

- الاسم ورقم الهاتف الأساسي وأرقام إضافية.
- البريد الإلكتروني وروابط حسابات التواصل.
- طريقة التواصل المفضلة.
- أسلوب الكلام المناسب للعميل.
- نوع النشاط أو التصنيف.
- ملاحظات داخلية تساعد الفريق.

> **تجنب التكرار**
> تأكد من ربط الرقم بالمنصة الصحيحة. إنشاء ملف مكرر لنفس الرقم قد يوزع تاريخ العميل على أكثر من ملف.

## الحذف والأرشفة

عند حذف العميل من القائمة يحتفظ النظام بسجل المحادثات. استخدم إظهار المحذوفين عندما تحتاج مراجعة أو استعادة ملف سابق.

[فتح ملفات العملاء](/client/clients/profiles)

---

## متابعة إجراءات العملاء

- Language: ar
- Section: المحادثات والعملاء
- Canonical: https://mrailabs.com/docs/ar/conversations-and-customers/client-actions/
- Markdown: https://mrailabs.com/docs/ar/conversations-and-customers/client-actions.md
- Published: 2026-09-03T20:38:56.667478

تابع الحجوزات والشكاوى وطلبات التواصل والمهام الناتجة من المحادثات.

إجراءات العملاء تحول الطلبات المهمة داخل المحادثات إلى قائمة عمل واضحة. بدل الرجوع لكل محادثة، يمكنك متابعة ما هو معلق وما تم تنفيذه من صفحة واحدة.

## ما الذي يمكنك عمله؟

- التصفية حسب الحالة والنوع والفئة والفترة الزمنية.
- فتح تفاصيل الإجراء والعميل والمطلوب تنفيذه.
- إضافة أو تحديث ملاحظات الشركة.
- فتح المحادثة الأصلية للحصول على السياق الكامل.
- تعليم الإجراء كمكتمل أو إعادة فتحه عند الحاجة.
- تصدير القائمة بصيغة CSV للمراجعة الخارجية.

> **حافظ على دقة التقارير**
> تعليم الإجراء كمكتمل يعني أن الفريق نفّذه فعليًا. لا تستخدمه فقط لتنظيف القائمة؛ لأن التقارير تعتمد على حالة الإجراءات.

[فتح إجراءات العملاء](/client/actions)

[اعرف كيف تكتشف المحادثات التي تحتاج متابعة](/docs/ar/learn/identify-customers-who-need-follow-up/)

---

## فهم تقارير الأداء

- Language: ar
- Section: المحادثات والعملاء
- Canonical: https://mrailabs.com/docs/ar/conversations-and-customers/performance-reports/
- Markdown: https://mrailabs.com/docs/ar/conversations-and-customers/performance-reports.md
- Published: 2026-09-03T20:38:56.667478

اقرأ تغطية الذكاء والاستقلالية والتحويل والتدخل البشري بشكل صحيح.

تقارير الأداء تجمع بيانات المحادثات والإجراءات لتوضح أين يعمل الموظف الذكي جيدًا وأين يحتاج الفريق أو قاعدة المعرفة إلى تحسين.

*يعرض التقرير مؤشرات التحويل وأداء المحادثات خلال الفترة والمنصة المحددتين.*

## أهم المؤشرات

- محادثات العملاء: المحادثات التي أرسل فيها العملاء رسائل.
- محادثات رد فيها الذكاء: المحادثات التي ظهر فيها رد AI.
- محادثات أكملها الذكاء وحده: لم تحتج تدخلًا أو قفلًا يدويًا.
- تدخل الفريق أو القفل: المحادثات التي انتقلت للبشر أو أوقف فيها الذكاء.
- بدون رد AI: محادثات وصل فيها كلام من العميل ولم يظهر رد للذكاء.
- الإجراءات والحجوزات: النتائج التي تم تسجيلها من المحادثات.

## كيف تستفيد من التقرير؟

1. راجع فرص تحتاج مراجعة والمحادثات بدون رد AI.
2. صنف سبب التدخل البشري: معلومة ناقصة، طلب غير مدعوم، رد يدوي، أو إيقاف الذكاء.
3. حدّث قاعدة المعرفة أو رحلة المحادثة.
4. قارن نفس المؤشرات بعد فترة مشابهة.

> **اقرأ المؤشرات معًا**
> لا تقرأ نسبة واحدة وحدها. زيادة التحويل مع زيادة التدخل البشري قد تعني أن الفريق ينجح لكن الموظف الذكي ما زال يحتاج تحسينًا.

[فتح تقارير الأداء](/client/actions/performance-report)

> **حوّل التقرير لقرار تشغيل**
> استخدم التقارير مع Customer Operations وClient Actions لفهم أين تتوقف المحادثات وما الذي يحتاج متابعة أو تدخلًا من الفريق.

[راجع دليل اكتشاف العملاء الذين يحتاجون متابعة](/docs/ar/learn/identify-customers-who-need-follow-up/)

[افهم استخدام بيانات المحادثات](/docs/ar/conversations-and-customers/conversation-intelligence-for-customer-operations/)

---

## استخدام مساحة عمليات العملاء

- Language: ar
- Section: المحادثات والعملاء
- Canonical: https://mrailabs.com/docs/ar/conversations-and-customers/customer-operations-inbox/
- Markdown: https://mrailabs.com/docs/ar/conversations-and-customers/customer-operations-inbox.md
- Published: 2026-09-03T20:38:56.667478

راجع المحادثات التي تحتاج تدخلًا بشريًا ونظم عمل الفريق بدون ردود مكررة.

## ما هي مساحة عمليات العملاء في Mr. AI؟

مساحة عمليات العملاء هي صندوق العمل اليومي للفريق البشري. تجمع المحادثات التي تحتاج مراجعة أو ردًا يدويًا، وتوضح حالة الذكاء والعمل غير المقروء حتى لا يضيع طلب مهم داخل قائمة كل المحادثات.

- ابدأ بالحالات التي تحتاج ردًا.
- راجع السياق قبل التدخل.
- أعد الذكاء للمحادثة فقط عندما تصبح جاهزة.

## خطوات الاستخدام

1. افتح مساحة عمليات العملاء من القائمة الجانبية.
2. راجع العدادات والطابور الحالي واستخدم البحث والفلاتر.
3. افتح المحادثة واقرأ آخر رسائل العميل والردود السابقة.
4. أرسل ردًا يدويًا أو غيّر حالة الذكاء حسب الحاجة.
5. أنه العمل المطلوب وانتقل للحالة التالية.

## أسئلة شائعة

### لماذا لا أستطيع الرد على محادثة؟

قد تكون المحادثة محجوزة لعضو فريق آخر لتقليل الردود المتعارضة.

### ما الفرق بينها وبين Chats & Control؟

Chats & Control يعرض قاعدة العملاء والمحادثات كاملة؛ Customer Operations يركز على طابور العمل البشري الحالي.

[فتح الصفحة في Mr. AI](/client/operations/inbox)

[اعرف كيف تكتشف المحادثات التي تحتاج متابعة](/docs/ar/learn/identify-customers-who-need-follow-up/)

[افهم الفرق بين Operations وActions](/docs/ar/conversations-and-customers/customer-operations-vs-client-actions/)

[افهم تسليم المحادثة وعودة AI](/docs/ar/conversations-and-customers/human-ai-handoff-and-resume/)

---

## إدارة بيانات وملفات العملاء

- Language: ar
- Section: المحادثات والعملاء
- Canonical: https://mrailabs.com/docs/ar/conversations-and-customers/manage-customer-profiles-and-contact-data/
- Markdown: https://mrailabs.com/docs/ar/conversations-and-customers/manage-customer-profiles-and-contact-data.md
- Published: 2026-07-14T20:11:38.480940

أضف بيانات التواصل والتفضيلات والملاحظات، وتعامل مع الملفات المكررة أو المؤرشفة بدون فقد سجل الدردشة.

## ما الذي يمكن حفظه داخل Customer Profile في Mr. AI؟

يمكنك حفظ رقم الهاتف الأساسي والأرقام الإضافية والبريد وروابط التواصل والطريقة المفضلة للاتصال وأسلوب الكلام ونوع النشاط والملاحظات الداخلية. أرشفة الملف لا تحذف سجل الدردشة المرتبط به.

- استخدم ملفًا واحدًا لكل عميل قدر الإمكان.
- راجع تحذير التكرار قبل إضافة رقم موجود.
- ضع الحقائق التشغيلية في الحقول المخصصة والملاحظات الداخلية في Notes.

*يعرض دليل العملاء الملفات الموجودة ويوفر البحث وإضافة ملف جديد.*

## إنشاء أو تحديث ملف عميل

1. افتح Clients ثم Customer Profiles واستخدم البحث قبل إنشاء ملف جديد.
2. أضف رقم الهاتف الأساسي، ثم الأرقام الإضافية والبريد وروابط التواصل عند توفرها.
3. حدد طريقة التواصل المفضلة وأسلوب الكلام ونوع النشاط إذا كانت مفيدة للفريق.
4. اكتب ملاحظات داخلية واضحة لا تظهر للعميل.
5. احفظ وراجع المحادثة المرتبطة للتأكد أن الملف الصحيح مستخدم.

## ما الذي يحتاج مراجعة دورية؟

- الأرقام أو الروابط القديمة وغير المستخدمة.
- الملفات المكررة لنفس العميل عبر أكثر من قناة.
- الملاحظات التي تحولت إلى معلومة قديمة أو غير دقيقة.
- الملفات المؤرشفة التي يحتاج الفريق عرضها مرة أخرى.

## أسئلة شائعة

### هل الأرشفة تحذف المحادثات؟

لا، يمكن إخفاء الملف من القائمة النشطة مع الاحتفاظ بسجل الدردشة المرتبط به.

### لماذا يظهر تحذير أن رقم الهاتف مستخدم؟

النظام يحاول منع إنشاء ملف مكرر؛ ابحث عن الملف الموجود وحدّثه بدل إنشاء نسخة ثانية.

### هل يستطيع العميل رؤية الملاحظات الداخلية؟

الملاحظات داخل Customer Profiles مخصصة لتنظيم عمل الفريق وليست رسالة يتم إرسالها للعميل.

[فتح ملفات العملاء](/client/clients/profiles)

---

## إدارة ومتابعة Client Actions

- Language: ar
- Section: المحادثات والعملاء
- Canonical: https://mrailabs.com/docs/ar/conversations-and-customers/manage-client-actions-workflow/
- Markdown: https://mrailabs.com/docs/ar/conversations-and-customers/manage-client-actions-workflow.md
- Published: 2026-09-03T20:38:56.667478

راجع الإجراءات المطلوبة، افتح المحادثة المصدر، أضف ملاحظات الفريق، ثم أنهِ الإجراء أو أعد فتحه.

## كيف أستخدم Client Actions لمتابعة طلبات العملاء؟

تجمع Client Actions الحالات التي تحتاج خطوة من الفريق مثل متابعة عميل أو رد معلق أو طلب أو حجز أو إلغاء. يمكنك فلترة الإجراءات، مراجعة التفاصيل والمحادثة المصدر، إضافة ملاحظات، ثم تعليم الإجراء كمكتمل أو إعادة فتحه.

- ابدأ بالإجراءات Pending والأعلى أولوية.
- راجع المحادثة المصدر قبل اتخاذ القرار.
- استخدم Done فقط بعد تنفيذ الخطوة المطلوبة فعلًا.

*تابع الإجراءات المعلقة والمكتملة واستخدم الفلاتر للوصول إلى الإجراء المطلوب.*

## مسار العمل المقترح

1. افتح Client Actions واختر Pending.
2. استخدم فلاتر النوع والفئة والتاريخ للوصول للحالات المهمة.
3. افتح تفاصيل الإجراء واقرأ الوصف والبيانات والملاحظات الحالية.
4. افتح المحادثة المصدر عند الحاجة لفهم السياق أو التواصل مع العميل.
5. أضف ملاحظة الشركة ثم علّم الإجراء Done، أو أعد فتحه إذا عاد للعمل.

> **حالة دقيقة**
> إكمال الإجراء يعني أن الخطوة التشغيلية انتهت، وليس فقط أن أحد أعضاء الفريق فتح البطاقة.

## أسئلة شائعة

### هل يمكن إعادة إجراء مكتمل؟

نعم، استخدم Reopen عندما يحتاج الإجراء متابعة جديدة.

### متى أستخدم التصدير CSV؟

عند الحاجة لمراجعة مجموعة إجراءات خارج النظام أو مشاركتها مع فريق إداري، مع حماية بيانات العملاء.

### ما الفرق بين Client Actions وCustomer Operations؟

Client Actions يتتبع مهمة أو نتيجة مطلوبة؛ Customer Operations ينظم المحادثات التي تحتاج تدخلًا وردًا بشريًا الآن.

[فتح إجراءات العملاء](/client/actions)

[اعرف كيف تكتشف المحادثات التي تحتاج متابعة](/docs/ar/learn/identify-customers-who-need-follow-up/)

[افهم الفرق بين Operations وActions](/docs/ar/conversations-and-customers/customer-operations-vs-client-actions/)

---

## متى تستخدم المتابعة التلقائية ومتى يتابع الفريق يدويًا؟

- Language: ar
- Section: المحادثات والعملاء
- Canonical: https://mrailabs.com/docs/ar/conversations-and-customers/automatic-vs-manual-customer-follow-up/
- Markdown: https://mrailabs.com/docs/ar/conversations-and-customers/automatic-vs-manual-customer-follow-up.md
- Published: 2026-09-03T20:38:55.983279

اختَر بين المتابعة التلقائية والرد اليدوي وClient Action حسب الخطوة المفتوحة وسياق العميل بدل استخدام Follow-up واحد لكل الحالات.

## متى أستخدم Follow-up تلقائي ومتى يحتاج العميل متابعة بشرية؟

استخدم المتابعة التلقائية عندما توجد محادثة واضحة وخطوة يمكن تذكير العميل بها بأمان. استخدم ردًا بشريًا عندما تحتاج الحالة حكمًا أو استثناءً أو تفاوضًا. وإذا كانت الخطوة المطلوبة داخلية على الفريق، سجّلها كـClient Action بدل إرسال رسالة للعميل قبل تنفيذ العمل.

- Automatic Follow-up يعيد فتح محادثة لها سياق.
- Customer Operations ينظم العمل البشري الذي يحتاج ردًا الآن.
- Client Actions يتتبع خطوة تشغيلية يجب تنفيذها.

## ثلاثة قرارات مختلفة

- ذكّر العميل: Follow-up عندما توجد خطوة عميل مفتوحة ورسالة مناسبة.
- تدخل مع العميل: Customer Operations عندما يحتاج إنسان للرد أو المراجعة.
- نفّذ عملًا داخليًا: Client Action عندما يجب على الفريق إكمال مهمة أو نتيجة.

## اسأل قبل المتابعة

1. هل توجد خطوة مفتوحة فعلًا؟
2. هل الرسالة التالية تحتاج حكمًا بشريًا؟
3. هل هناك عمل داخلي يجب تنفيذه أولًا؟
4. هل تغيّرت حالة العميل أو طلب إيقاف التواصل؟
5. بعد الإجابة اختر المسار الأقل إزعاجًا والأوضح للفريق.

> **السياق أهم من عمر آخر رسالة**
> الصمت وحده لا يجعل المحادثة Lead مؤهلة ولا يبرر سلسلة رسائل آلية.

[اضبط المتابعة التلقائية](/docs/ar/settings-and-usage/automatic-customer-follow-up-settings/)

[افتح Customer Operations](/docs/ar/conversations-and-customers/customer-operations-inbox/)

[راجع Client Actions](/docs/ar/conversations-and-customers/manage-client-actions-workflow/)

---

## أتمتة المتابعة حسب المرحلة

- Language: ar
- Section: المحادثات والعملاء
- Canonical: https://mrailabs.com/docs/ar/conversations-and-customers/stage-follow-up-automation/
- Markdown: https://mrailabs.com/docs/ar/conversations-and-customers/stage-follow-up-automation.md
- Published: 2026-09-19T23:45:18.097139

شغّل متابعة تلقائية عندما يبقى العميل في مرحلة منشورة بدون رد لمدة تحددها.

## ما هي أتمتة المتابعة حسب المرحلة في Mr. AI؟

تراقب هذه الميزة مرحلة العميل المنشورة في Conversation Builder. إذا بقي العميل في المرحلة المحددة بدون رد لمدة تختارها، ينفذ النظام نتيجة محددة: إنشاء مهمة للفريق، أو جدولة Follow-up بالذكاء، أو محاولة Follow-up بالذكاء ثم إنشاء مهمة بشرية عند الحاجة. الإصدار الحالي يعتمد على عدم نشاط العميل داخل المرحلة، وليس محرك قواعد عام لكل أنواع الشروط.

- الشرط الحالي هو عدم نشاط العميل داخل Stage منشورة.
- القواعد الجديدة لا تنشئ مهام من أحداث مراحل تاريخية سبقت نشر القاعدة.
- فتح الصفحة لا يشغّل AI ولا ينشئ مهمة؛ التنفيذ يحدث في الخلفية من Stage Events محفوظة على السيرفر.

## خطوات الاستخدام

1. افتح Customer Operations ثم أتمتة المتابعة حسب المرحلة.
2. اختر Stage فعالة من النسخة المنشورة في Conversation Builder وحدد مدة عدم نشاط العميل.
3. اختر النتيجة: مهمة للفريق، Follow-up بالذكاء، أو Follow-up بالذكاء ثم مهمة بشرية.
4. إذا اخترت مهمة، حدد نوعها وأولويتها وطريقة التعيين ووقت الاستحقاق أو التصعيد أو الانتهاء حسب الحاجة.
5. احفظ Draft ثم انشر القاعدة، وراقب المهام الناتجة داخل Operations Inbox.

> **مهم**
> إذا اخترت نتيجة تعتمد على AI Follow-up، يجب أن تكون أتمتة المتابعة بالذكاء مفعلة وصالحة للحساب.

## أسئلة شائعة

### ما الفرق بينها وبين أتمتة المتابعة العادية؟

أتمتة المتابعة العادية تضبط رسائل Follow-up العامة للمحادثة؛ أتمتة المتابعة حسب المرحلة تربط التشغيل بمرحلة محددة منشورة في Conversation Builder ويمكنها إنشاء عمل بشري أو استخدام Follow-up AI.

### ماذا يحدث إذا تغير Conversation Builder؟

القاعدة مرتبطة بنسخة Builder المنشورة. إذا تغيرت النسخة فقد تظهر القاعدة كنسخة تحتاج مراجعة وإعادة نشر قبل الاعتماد عليها.

### هل Testing Chat ينشئ مهام حقيقية؟

لا. أحداث Testing Chat مستبعدة من تشغيل القواعد الحية.

[فتح أتمتة المتابعة حسب المرحلة](/client/operations/rules)

---

## كيف يتعاون الموظف البشري وموظف AI في نفس المحادثة؟

- Language: ar
- Section: المحادثات والعملاء
- Canonical: https://mrailabs.com/docs/ar/conversations-and-customers/human-ai-handoff-and-resume/
- Markdown: https://mrailabs.com/docs/ar/conversations-and-customers/human-ai-handoff-and-resume.md
- Published: 2026-09-03T20:38:55.983279

افهم متى يتدخل الإنسان، كيف يتوقف AI عن التعارض مع الرد اليدوي، ومتى يمكن إعادته للمحادثة بأمان.

## كيف تمنع تعارض الموظف البشري وموظف AI في نفس المحادثة؟

اجعل التدخل البشري حالة تشغيل واضحة: عندما يحتاج العميل إنسانًا أو يرد الفريق يدويًا، يجب أن يرى الفريق حالة AI ويتعامل مع المحادثة من مسار العمل المخصص. بعد انتهاء الاستثناء أو الرد الحساس يمكن إعادة AI وفق إعدادات الـTakeover، وليس بمجرد افتراض أن المحادثة أصبحت جاهزة.

- التدخل البشري ليس فشلًا؛ هو جزء من تصميم الخدمة.
- حالة المحادثة يجب أن تكون واضحة للفريق قبل إرسال رد.
- عودة AI تحتاج أن يصبح السياق مناسبًا للرد الآلي مرة أخرى.

## متى يحتاج الإنسان أن يتدخل؟

- طلب صريح للتحدث مع موظف.
- استثناء أو شكوى أو قرار يحتاج صلاحية بشرية.
- معلومة غير متوفرة ويجب التحقق منها.
- حالة يمكن أن يسبب فيها رد تلقائي إضافي تعارضًا أو سوء فهم.

## مسار Handoff آمن

1. افتح الحالة من Customer Operations واقرأ السياق.
2. تأكد من حالة AI قبل الرد اليدوي.
3. نفّذ الرد أو الإجراء البشري المطلوب.
4. أبقِ AI متوقفًا طالما الحالة ما زالت تحتاج متابعة بشرية.
5. أعد AI عندما تنتهي الحالة الاستثنائية ويصبح السياق مناسبًا.

> **العودة تعتمد على الإعداد**
> إعداد مدة التوقف أو الوضع اليدوي الدائم يحدد سلوك العودة؛ لا تفترض رقمًا واحدًا أو توقيتًا مناسبًا لكل شركة.

[راجع إعدادات Human Takeover](/docs/ar/settings-and-usage/human-takeover-pause-settings/)

[افتح Customer Operations](/docs/ar/conversations-and-customers/customer-operations-inbox/)

---

## ما الفرق بين Customer Operations وClient Actions؟

- Language: ar
- Section: المحادثات والعملاء
- Canonical: https://mrailabs.com/docs/ar/conversations-and-customers/customer-operations-vs-client-actions/
- Markdown: https://mrailabs.com/docs/ar/conversations-and-customers/customer-operations-vs-client-actions.md
- Published: 2026-09-03T20:38:55.983279

استخدم Customer Operations لتنظيم المحادثات التي تحتاج تدخلًا بشريًا، وClient Actions لتتبع المهمة أو النتيجة المطلوبة من الفريق.

## ما الفرق بين Customer Operations وClient Actions في Mr. AI؟

Customer Operations يجيب: أي محادثة تحتاج انتباهًا أو ردًا بشريًا الآن؟ أما Client Actions فيجيب: ما المهمة أو النتيجة التي يجب على الفريق تنفيذها ومتابعة حالتها؟ قد تبدأ الحالة في Customer Operations ثم ينتج عنها Client Action، لكنهما لا يؤديان نفس الوظيفة.

- Operations = طابور محادثات وعمل بشري حالي.
- Actions = مهمة أو نتيجة قابلة للتتبع حتى الإكمال.
- لا تجعل فتح المحادثة بديلًا عن إكمال الإجراء.

## اختر الأداة حسب السؤال

- من يحتاج ردًا الآن؟ ابدأ من Customer Operations.
- ما الذي وعدنا العميل بتنفيذه؟ راجع Client Actions.
- هل تم تنفيذ الخطوة أم فقط قراءة الرسالة؟ حالة Action هي المرجع للعمل المطلوب.

## مثال تشغيلي

1. عميل يطلب تغييرًا أو حجزًا ويحتاج موظفًا.
2. تظهر المحادثة في مسار العمل البشري لمراجعة السياق والرد.
3. إذا نتجت مهمة يجب تنفيذها، تابعها كـClient Action.
4. بعد تنفيذ المهمة، حدّث حالتها ثم أكمل التواصل المناسب مع العميل.

## أسئلة سريعة

### هل كل محادثة في Operations تحتاج Action؟

لا. بعض الحالات تحتاج ردًا بشريًا فقط بدون مهمة منفصلة.

### هل كل Action يحتاج Follow-up للعميل؟

لا. بعض الإجراءات داخلية، والمتابعة ترسل فقط عندما يوجد سبب فعلي للتواصل مع العميل.

[افتح Customer Operations](/docs/ar/conversations-and-customers/customer-operations-inbox/)

[راجع Client Actions](/docs/ar/conversations-and-customers/manage-client-actions-workflow/)

---

## كيف تستخدم بيانات المحادثات لفهم العملاء وتحسين المتابعة؟

- Language: ar
- Section: المحادثات والعملاء
- Canonical: https://mrailabs.com/docs/ar/conversations-and-customers/conversation-intelligence-for-customer-operations/
- Markdown: https://mrailabs.com/docs/ar/conversations-and-customers/conversation-intelligence-for-customer-operations.md
- Published: 2026-09-03T20:38:55.983279

اربط سياق المحادثة بملف العميل والإجراءات والتقارير لفهم ما يحتاج متابعة وما يتكرر، بدون اعتبار التحليل بديلًا عن المصدر التشغيلي.

## ماذا تعني Conversation Intelligence داخل تشغيل Mr. AI؟

هي استخدام المعلومات المتاحة من المحادثة وملف العميل والإجراءات والتقارير لفهم السياق والخطوة المفتوحة وأنماط الأداء. المحادثات والإجراءات الفعلية تظل المصدر التشغيلي؛ أي ملخص أو تحليل يساعد الفريق على الفهم لكنه لا يستبدل مراجعة الحقيقة الأصلية عند اتخاذ قرار مهم.

- Customer Profile يجمع سياقًا منظمًا عن العميل.
- Client Actions يحول المطلوب إلى عمل قابل للتتبع.
- التقارير تساعدك ترى الأنماط بعد التنفيذ.

## أسئلة يمكن للنظام أن يساعدك في تنظيمها

- ما الذي طلبه العميل وما الخطوة المفتوحة؟
- هل توجد مهمة على الفريق أم يحتاج العميل رسالة متابعة؟
- هل تتكرر أنواع معينة من الحالات أو نقاط التعطل؟
- ما المعلومات التي يجب تصحيحها أو إضافتها لتحسين التشغيل؟

## استخدم البيانات بدون مبالغة

1. ابدأ من المحادثة أو الإجراء الفعلي.
2. راجع ملف العميل للمعلومات المنظمة ذات الصلة.
3. استخدم التقارير لفهم النمط لا للحكم على حالة فردية بدون سياق.
4. حوّل النتيجة إلى تعديل تشغيلي واضح: معرفة، Action، Follow-up، أو تدخل بشري.

> **حدود التحليل**
> لا تفترض أن كل محادثة Lead أو أن كل ملخص تحليل لحظي. استخدم الحالات والبيانات التي يعرضها المنتج فعلًا.

[راجع ملفات العملاء](/docs/ar/conversations-and-customers/manage-customer-profiles-and-contact-data/)

[راجع Client Actions](/docs/ar/conversations-and-customers/manage-client-actions-workflow/)

[راجع تقارير الأداء](/docs/ar/conversations-and-customers/performance-reports/)

---

## شرح إعدادات النظام والردود

- Language: ar
- Section: الإعدادات والاستهلاك
- Canonical: https://mrailabs.com/docs/ar/settings-and-usage/system-settings/
- Markdown: https://mrailabs.com/docs/ar/settings-and-usage/system-settings.md
- Published: 2026-07-12T22:37:22.223480

اضبط السماح للمستخدمين وتجميع الرسائل والتحكم اليدوي والمتابعة التلقائية.

إعدادات النظام تؤثر مباشرة على طريقة استقبال المستخدمين وتوقيت رد الذكاء وانتقال المحادثة للفريق. غيّر إعدادًا واحدًا في كل مرة ثم اختبر تأثيره.

## إعدادات مهمة

- تشغيل النظام بالكامل أو إيقافه.
- وضع المستخدم الجديد: سماح تلقائي، انتظار موافقة، أو حظر تلقائي.
- تشغيل أو إيقاف الرد التلقائي لكل قناة.
- تجميع الرسائل السريعة قبل الرد: ينتظر النظام من ثانيتين إلى 30 ثانية ليجمع عدة رسائل في رد واحد.
- التحكم اليدوي: إيقاف مؤقت لعدد ساعات أو استمرار الوضع اليدوي حتى إعادة التشغيل.
- المتابعة التلقائية: عدد المحاولات والفترة قبل كل محاولة وتوجيه نبرة رسالة المتابعة.

> **المتابعة التلقائية**
> فترة كل محاولة متابعة يجب أن تكون 30 دقيقة على الأقل، وعدد المحاولات محدود حتى لا يشعر العميل بالإزعاج.

> **تجميع رسائل العميل**
> زيادة وقت تجميع الرسائل قد تقلل الردود المتقطعة، لكنها تجعل العميل ينتظر أكثر. ابدأ بالقيمة الافتراضية واختبرها.

[فتح إعدادات النظام](/client/settings/system)

---

## البناء والإدارة بالذكاء الاصطناعي: ابدأ من هنا

- Language: ar
- Section: الإعدادات والاستهلاك
- Canonical: https://mrailabs.com/docs/ar/settings-and-usage/build-and-manage-with-ai/
- Markdown: https://mrailabs.com/docs/ar/settings-and-usage/build-and-manage-with-ai.md
- Published: 2026-09-01T23:19:45.921976

افهم مساري التحسين المدعومين، ومن أين تبدأ، وما الصلاحيات التي تظل دائمًا داخل Mr.AI.

## ما هي ميزة البناء والإدارة بالذكاء الاصطناعي؟

هي مساحة Mr.AI لتحسين موظفك الذكي بمساعدة AI. يمكنك ربط مساعد متوافق لاستخدام المسار المتصل، أو استخدام المسار اليدوي الدائم بدون ربط أي مساعد.

- المسار المتصل هو المسار المفضل عندما يكون متاحًا ومناسبًا.
- مسار التصدير والرفع اليدوي يظل مسارًا مدعومًا ودائمًا.
- المراجعة وصلاحية تغييرات الإنتاج تظلان داخل Mr.AI.

## اختر نقطة البداية المناسبة

- في صفحات المعرفة والسلوك والكتالوج وأي صفحات تعديل مدعومة، استخدم تحسين باستخدام AI للعمل على سياق الصفحة الحالية بدون مغادرتها.
- استخدم البناء والإدارة بالذكاء الاصطناعي عندما تحتاج الـHub الكامل أو حالة الاتصال أو الاقتراحات أو مهمة تحسين أوسع.
- استخدم إعدادات AI عندما تريد ربط مساعد أو إعادة ربطه أو مراجعة تفاصيل الاتصال أو تحديث حالته أو قطع الاتصال.

## مساران مدعومان

- المساعد المتصل: فوّض مساعدًا متوافقًا، واستخدم فقط الإمكانيات التي يتيحها Mr.AI، ثم راجع التغييرات المقترحة قبل أن تصبح حية.
- مسار AI اليدوي: صدّر حزمة تعديل مدعومة، واعمل عليها مع مساعدك المفضل، وارفع النتيجة، ثم راجع وطبّق من خلال نفس رحلة Mr.AI المحمية.

> **صلاحيات مساحة العمل**
> المساعد المتصل لا يصبح مالكًا لمساحة العمل ولا يحصل على صلاحية كتابة عامة. Mr.AI هو من يحدد المجالات والأدوات والصلاحيات المتاحة.

## ماذا تقرأ بعد ذلك؟

- ربط مساعد AI: إعداد ChatGPT أو Claude وحالة الاتصال المؤكدة من الخادم وحدود الصلاحيات.
- استخدام AI بدون ربط: المسار اليدوي الدائم من التصدير إلى الرفع والمراجعة.
- المراجعة وTesting والتطبيق والتراجع: كيف تنتقل الاقتراحات بأمان نحو الإنتاج.
- إدارة الاتصال وحل المشكلات: إعادة الربط وقطع الاتصال والأخطاء الشائعة وحماية بيانات الاعتماد.

## قواعد أمان الإنتاج

- ربط المساعد اختياري؛ المسار اليدوي مسار دائم ومدعوم.
- الاقتراح لا يصبح حيًا تلقائيًا. الاختبار معزول عن الإنتاج. اختر تطبيق صراحةً بعد المراجعة.
- لا يمنحه صلاحية كتابة غير محدودة.
- يبقى مسار AI اليدوي متاحًا أثناء قطع الاتصال أو إلغاء التفويض أو انتهائه أو إعادة الربط.
- لا تشارك كلمات المرور أو Authorization headers أو OAuth codes أو access tokens أو refresh tokens.

## ('هل يمكنني الاستمرار يدويًا؟', 'نعم. ربط المساعد اختياري، والمسار اليدوي مسار دائم ومدعوم.')

### هل ينشر المساعد التغييرات وحده؟

لا. يجب أن يراجع العميل الاقتراح ويختار تطبيق صراحةً داخل Mr.AI.

[فتح البناء والإدارة بالذكاء الاصطناعي](/client/manage-with-ai)

---

## إضافة الرسائل التلقائية الثابتة

- Language: ar
- Section: الإعدادات والاستهلاك
- Canonical: https://mrailabs.com/docs/ar/settings-and-usage/fixed-automatic-messages/
- Markdown: https://mrailabs.com/docs/ar/settings-and-usage/fixed-automatic-messages.md
- Published: 2026-07-14T20:11:38.480940

امنع الذكاء من الرد على رسائل آلية معروفة مع الاحتفاظ بها في السجل.

بعض القنوات أو الأنظمة ترسل رسائل تلقائية لا تحتاج ردًا من الموظف الذكي. يمكنك إضافة النص المطابق حتى يتم تسجيل الرسالة بدون إنشاء رد AI عليها.

*اختر المنصة وأدخل نص الرسالة ثم فعّلها وأضفها إلى قائمة الرسائل الثابتة.*

## طريقة الإضافة

1. انسخ نص الرسالة التلقائية كما يصل بالضبط.
2. اختر القناة أو طبّق القاعدة على كل القنوات.
3. احفظ الرسالة وتأكد أنها مفعلة.
4. راقب عدد مرات المطابقة وآخر مرة ظهرت فيها.

> **مطابقة دقيقة**
> المطابقة تعتمد على النص. لو تغيرت كلمة أو رمز داخل الرسالة الجديدة، قد تحتاج تحديث القاعدة أو إضافة نسخة أخرى.

[فتح الرسائل الثابتة](/client/settings/fixed-messages)

---

## تحديث بيانات الحساب وكلمة المرور

- Language: ar
- Section: الإعدادات والاستهلاك
- Canonical: https://mrailabs.com/docs/ar/settings-and-usage/profile-settings/
- Markdown: https://mrailabs.com/docs/ar/settings-and-usage/profile-settings.md
- Published: 2026-07-12T22:37:22.223480

حدّث البريد وكلمة المرور وافهم خطوات حذف الحساب قبل تأكيدها.

من إعدادات الملف يمكنك مراجعة بيانات الحساب وتحديث البريد أو كلمة المرور. عند تغيير كلمة المرور اكتبها مرتين وتأكد من حفظها في مكان آمن.

## قبل حذف الحساب

- حذف الحساب إجراء مختلف عن إيقاف الردود أو فصل قناة.
- يتطلب تأكيد كلمة المرور وكتابة سبب المغادرة.
- بعد التأكيد يتم تعطيل الحساب وتسجيل الخروج، ثم تنفيذ الحذف النهائي بعد 30 يومًا.
- قد يظهر خيار للاحتفاظ بنصوص دردشة منزوعة البيانات التعريفية لتحسين النظام؛ القرار اختياري.

> **قبل القرار النهائي**
> لو هدفك إيقاف التشغيل مؤقتًا، استخدم إعدادات النظام أو افصل القناة بدل طلب حذف الحساب.

[فتح إعدادات الملف](/client/settings/profile)

---

## فهم الباقة والتجديد والنقاط

- Language: ar
- Section: الإعدادات والاستهلاك
- Canonical: https://mrailabs.com/docs/ar/settings-and-usage/subscription-and-renewal/
- Markdown: https://mrailabs.com/docs/ar/settings-and-usage/subscription-and-renewal.md
- Published: 2026-07-14T20:11:38.480940

راجع الباقة الحالية وتاريخ التجديد والمستحق والنقاط المتبقية.

صفحة تفاصيل التجديد والباقة تعرض حالة اشتراكك والأرقام التي تحتاجها قبل موعد التجديد.

*راجع حالة الاشتراك والباقة الحالية والنقاط ثم قارن الباقات المتاحة.*

## البيانات الأساسية

- اسم الباقة الحالية.
- تاريخ التجديد وعدد الأيام المتبقية.
- إجمالي المستحق إن كان مسجلًا.
- النقاط الأساسية والنقاط المُرحّلة.
- النقاط المستخدمة والمتبقية وما تشمل الباقة.

> **تابع الرصيد مبكرًا**
> انتهاء النقاط أو الاشتراك قد يؤثر على الخدمات التي تعتمد على الاستهلاك. راجع الرصيد قبل الحملات أو فترات الضغط.

[فتح تفاصيل الباقة والتجديد](/client/subscription/overview)

---

## متابعة استخدام النقاط

- Language: ar
- Section: الإعدادات والاستهلاك
- Canonical: https://mrailabs.com/docs/ar/settings-and-usage/points-usage-reports/
- Markdown: https://mrailabs.com/docs/ar/settings-and-usage/points-usage-reports.md
- Published: 2026-07-14T20:11:38.480940

اعرف متى وأين تم استهلاك النقاط حسب اليوم والمستخدم والمنصة.

تقارير الاستهلاك تساعدك تفرق بين الرصيد المتبقي ومصدر الاستخدام. استخدم الصفحات اليومية وحسب المستخدم لتفسير أي زيادة.

*اختر الشهر ثم راجع استخدام النقاط ورسائل الذكاء والتقارير وسجل الرصيد.*

## طرق العرض

- مركز الاشتراك: ملخص شهري وحركة الرصيد وحالة التجديد.
- الاستخدام اليومي: عدد النقاط المستخدمة في كل يوم، مع إمكانية فتح تفاصيل مستخدمي اليوم.
- حسب المستخدم: استهلاك كل عميل وآخر نشاط والمنصة.

## عند مراجعة زيادة في الاستخدام

1. حدد الفترة المناسبة مثل آخر 7 أو 30 أو 90 يومًا.
2. راجع الأيام التي ظهر فيها ارتفاع.
3. افتح تفاصيل المستخدمين في اليوم أو استخدم صفحة حسب المستخدم.
4. فلتر حسب المنصة لمعرفة مصدر النشاط.
5. قارن الزيادة بعدد المحادثات والنتائج وليس بالنقاط وحدها.

[فتح مركز الاستهلاك](/client/subscription/usage-reports)

---

## ضبط وقت تجميع رسائل العميل قبل رد الذكاء

- Language: ar
- Section: الإعدادات والاستهلاك
- Canonical: https://mrailabs.com/docs/ar/settings-and-usage/incoming-message-debounce-delay/
- Markdown: https://mrailabs.com/docs/ar/settings-and-usage/incoming-message-debounce-delay.md
- Published: 2026-07-27T17:29:45.554611

اختر مدة الانتظار التي تجمع الرسائل السريعة في طلب واحد بدون تأخير غير ضروري.

## ما هو Incoming Message Debounce Delay في Mr. AI؟

هو عدد الثواني التي ينتظرها النظام بعد الرسالة الواردة قبل إنشاء رد AI. إذا أرسل العميل عدة رسائل بسرعة، يتم تجميعها في طلب واحد. القيمة الافتراضية 3 ثوانٍ، والنطاق المسموح من ثانيتين إلى 30 ثانية.

- القيمة الأقل تعطي ردًا أسرع.
- القيمة الأعلى تجمع رسائل أكثر.
- ابدأ بـ3 ثوانٍ وعدل بعد مراجعة محادثات حقيقية.

## خطوات الاستخدام

1. افتح قاعدة المعرفة ثم طريقة الرد واختر توقيت الرد وتسليم المحادثة.
2. ابحث عن تجميع رسائل العميل السريعة.
3. اختر قيمة صحيحة بين 2 و30 ثانية.
4. احفظ عناصر التحكم في الرد.
5. اختبر بإرسال رسالتين أو ثلاث رسائل متتابعة من رقم خارجي.

> **مهم**
> زيادة المدة تقلل الردود المتقطعة لكنها تزيد زمن الانتظار؛ لا تستخدم 30 ثانية تلقائيًا دون اختبار.

## أسئلة شائعة

### هل القيمة صفر متاحة؟

لا، الواجهة والـBackend يفرضان حدًا أدنى ثانيتين.

### متى أزيد المدة؟

عندما يكتب العملاء فكرتهم في عدة رسائل قصيرة ويبدأ AI بالرد قبل اكتمالها.

[فتح الصفحة في Mr. AI](/client/knowledge-base/response-controls)

---

## طلب دعم فوري بأمان

- Language: ar
- Section: الإعدادات والاستهلاك
- Canonical: https://mrailabs.com/docs/ar/settings-and-usage/request-secure-immediate-support/
- Markdown: https://mrailabs.com/docs/ar/settings-and-usage/request-secure-immediate-support.md
- Published: 2026-07-27T17:29:45.554611

امنح فريق دعم Mr. AI وصولًا مؤقتًا ومحدد الصلاحيات دون مشاركة كلمة مرور حسابك.

## كيف أمنح فريق دعم Mr. AI وصولًا آمنًا إلى حسابي؟

أنشئ تصريح دعم مؤقتًا من صفحة طلب دعم فوري، وحدد مدة الوصول ومستوى الصلاحيات والسبب. لا تحتاج إلى مشاركة كلمة المرور، ويمكنك متابعة التصاريح السابقة أو إلغاء التصريح النشط عند انتهاء الحاجة.

- لا تشارك كلمة مرورك مع أي شخص.
- اختر أقل مستوى صلاحيات ينجز المهمة.
- ألغ التصريح فور انتهاء الدعم.

## خطوات الاستخدام

1. افتح Settings ثم طلب دعم فوري.
2. اختر مدة وصول مناسبة للمشكلة الحالية.
3. حدد مستوى الصلاحيات المطلوب فقط.
4. اكتب سببًا واضحًا يشرح ما يحتاج فريق الدعم إلى مراجعته.
5. أرسل الطلب وراجع حالة التصريح، ثم ألغِ الوصول عندما تنتهي المهمة.

> **مهم**
> لا تمنح صلاحيات أوسع أو مدة أطول من المطلوب، ولا تضع أسرارًا أو كلمات مرور داخل سبب الطلب.

## أسئلة شائعة

### هل يحصل موظف الدعم على كلمة مروري؟

لا. التصريح يمنح وصولًا مؤقتًا ومحدودًا دون كشف كلمة المرور.

### ماذا يحدث عند انتهاء المدة؟

ينتهي الوصول تلقائيًا، كما يمكنك إلغاؤه يدويًا قبل ذلك.

### أين أراجع الطلبات السابقة؟

تظهر التصاريح السابقة وحالتها في نفس صفحة طلب الدعم الفوري.

[فتح الصفحة في Mr. AI](/client/settings/support-access)

---

## تفعيل وضبط المتابعة التلقائية للعملاء

- Language: ar
- Section: الإعدادات والاستهلاك
- Canonical: https://mrailabs.com/docs/ar/settings-and-usage/automatic-customer-follow-up-settings/
- Markdown: https://mrailabs.com/docs/ar/settings-and-usage/automatic-customer-follow-up-settings.md
- Published: 2026-09-03T20:38:56.667478

حدد عدد محاولات المتابعة وتوقيت كل محاولة وتوجيه النبرة بطريقة آمنة.

## كيف تعمل المتابعة التلقائية في Mr. AI؟

عند توقف العميل عن الرد، يستطيع AI إرسال رسالة متابعة بعد المدة المحددة. يمكنك تفعيل الميزة، واختيار من محاولة إلى 3 محاولات، وتحديد مدة كل محاولة بحد أدنى 30 دقيقة، وإضافة توجيه اختياري لنبرة الرسالة.

- الحد الأقصى 3 محاولات.
- كل فترة انتظار 30 دقيقة على الأقل.
- اكتب توجيهًا للنبرة لا معلومات تجارية جديدة.

*حدد عدد محاولات المتابعة وفترة انتظار كل محاولة ثم احفظ إعدادات المتابعة.*

## خطوات الاستخدام

1. افتح عمليات العملاء ثم أتمتة المتابعة.
2. فعّل المتابعة وحدد عدد المحاولات.
3. ضع مدة منفصلة لكل محاولة؛ يجب ألا تقل عن 30 دقيقة.
4. أضف توجيهًا قصيرًا مثل كن ودودًا ولا تضغط على العميل.
5. احفظ أتمتة المتابعة وراقب النتائج والتدخلات البشرية.

> **مهم**
> لا تستخدم فترات قصيرة أو رسائل ضاغطة. راجع القواعد المحلية وسياسة قناتك قبل متابعة العملاء تسويقيًا.

## أسئلة شائعة

### لماذا يرفض الحفظ عند التفعيل؟

يجب اختيار محاولة واحدة على الأقل وإضافة فترة انتظار صالحة.

### هل تستخدم المتابعة بعد انتهاء الإجراء؟

حالات مثل إتمام Client Action أو عدم الحاجة للمتابعة تمنع الرسائل غير الضرورية وفق حالة المحادثة.

[فتح الصفحة في Mr. AI](/client/operations/followups)

> **المتابعة تبدأ من السياق**
> لا تعتمد على رقم عام ثابت لكل نشاط. اربط المتابعة بسبب واضح في المحادثة، وراجع ما يحدث بعدها من Customer Operations.

[افهم متى تكون المتابعة مفيدة](/docs/ar/learn/automatic-follow-up-when-customers-stop-replying/)

[قارن المتابعة التلقائية والعمل البشري](/docs/ar/conversations-and-customers/automatic-vs-manual-customer-follow-up/)

---

## ضبط إيقاف الذكاء عند الرد اليدوي

- Language: ar
- Section: الإعدادات والاستهلاك
- Canonical: https://mrailabs.com/docs/ar/settings-and-usage/human-takeover-pause-settings/
- Markdown: https://mrailabs.com/docs/ar/settings-and-usage/human-takeover-pause-settings.md
- Published: 2026-09-03T20:38:56.667478

اختر هل يتوقف AI مؤقتًا بعد رد الفريق أم يظل يدويًا حتى إعادة تشغيله.

## ماذا يحدث للذكاء عندما يرد الفريق يدويًا؟

عند تفعيل Human Takeover يوقف النظام ردود AI للمحادثة بعد تدخل الفريق. الوضع المؤقت يعيد السماح بعد مدة من 1 إلى 168 ساعة، بينما الوضع الدائم يبقي المحادثة يدوية حتى يعيد أحد أعضاء الفريق تشغيل AI.

- استخدم المؤقت للحالات اليومية.
- استخدم الدائم للحالات الحساسة أو المعقدة.
- يمكن إعادة تشغيل AI يدويًا من المحادثة.

*اضبط تجميع الرسائل والتسليم البشري وطريقة عودة الموظف الذكي إلى المحادثة.*

## خطوات الاستخدام

1. افتح قاعدة المعرفة ثم طريقة الرد واختر توقيت الرد وتسليم المحادثة.
2. فعّل تسليم المحادثة للموظف البشري.
3. اختر العودة تلقائيًا بعد مدة أو العودة فقط عند تشغيل أحد أعضاء الفريق للذكاء.
4. في الوضع المؤقت حدد مدة بين ساعة و168 ساعة.
5. احفظ عناصر التحكم في الرد، ثم اختبر تدخلًا بشريًا وراجع حالة المحادثة.

## أسئلة شائعة

### هل إيقاف Human Takeover يمنع الرد اليدوي؟

لا، لكنه يمنع الإيقاف التلقائي للذكاء بعد الرد البشري وقد يزيد احتمال تداخل الردود.

### كيف أعيد AI قبل انتهاء المدة؟

افتح المحادثة واستخدم أمر إعادة تشغيل الذكاء عندما تصبح جاهزة.

[فتح الصفحة في Mr. AI](/client/knowledge-base/response-controls)

> **التدخل البشري جزء من التشغيل**
> استخدم التسليم البشري للحالات التي لا ينبغي للـAI تخمينها أو إكمالها وحده، ثم راجع كيف تعود المحادثة للمسار المناسب.

[افهم كيف تمنع تأخر الرد من تحويل المحادثة لفرصة ضائعة](/docs/ar/learn/prevent-losing-customers-slow-replies/)

[افهم تسليم المحادثة وعودة AI](/docs/ar/conversations-and-customers/human-ai-handoff-and-resume/)

---

## التحكم في تشغيل النظام ورد AI لكل قناة

- Language: ar
- Section: الإعدادات والاستهلاك
- Canonical: https://mrailabs.com/docs/ar/settings-and-usage/system-channel-ai-and-new-user-controls/
- Markdown: https://mrailabs.com/docs/ar/settings-and-usage/system-channel-ai-and-new-user-controls.md
- Published: 2026-07-27T17:29:45.554611

افهم الفرق بين مفتاح النظام وحالة AI لكل قناة ووضع المستخدم الجديد.

## ما الفرق بين تشغيل النظام وتشغيل AI لكل قناة؟

مفتاح النظام يوقف أو يسمح بالتشغيل المباشر على مستوى الحساب، بينما مفتاح WhatsApp أو Messenger يتحكم في الرد التلقائي لتلك القناة. وضع المستخدم الجديد يحدد هل العميل الجديد يُسمح له تلقائيًا أو ينتظر الموافقة أو يُحظر.

- راجع رصيد النقاط قبل إعادة تشغيل النظام.
- أوقف قناة واحدة عند صيانة ربطها بدل إيقاف الحساب كله.
- اختر Pending عندما تريد مراجعة العملاء الجدد يدويًا.

*راجع حالة النظام العامة واختر طريقة التعامل مع المستخدمين الجدد ثم احفظ الإعدادات.*

## خطوات الاستخدام

1. افتح System Settings وراجع حالة النظام العامة.
2. اختر Auto Allow أو Pending أو Block للمستخدمين الجدد ثم احفظ الإعدادات.
3. افتح Connect ثم WhatsApp أو Facebook للتحكم في رد AI للقناة المطلوبة.
4. احفظ أو راجع حالة القناة بعد التغيير.
5. اختبر من حساب جديد على كل قناة متصلة.

## أسئلة شائعة

### لماذا لا أستطيع إعادة تشغيل النظام؟

قد يكون رصيد النقاط وصل إلى الحد الأدنى المسموح؛ أضف نقاطًا أولًا.

### هل إيقاف AI لقناة يفصل القناة؟

لا، الاتصال يبقى موجودًا لكن الردود التلقائية لتلك القناة تتوقف.

[فتح الصفحة في Mr. AI](/client/settings/system)

---

## متابعة سجل الإصدارات والميزات الجديدة

- Language: ar
- Section: الإعدادات والاستهلاك
- Canonical: https://mrailabs.com/docs/ar/settings-and-usage/version-history-and-release-notes/
- Markdown: https://mrailabs.com/docs/ar/settings-and-usage/version-history-and-release-notes.md
- Published: 2026-07-13T18:51:40.226212

اعرف ما تغير في Mr. AI ومتى نُشر التحديث ثم انتقل لدليل الاستخدام التفصيلي.

## ما الفرق بين سجل الإصدارات ومركز المساعدة؟

سجل الإصدارات يوضح ما أُضيف أو تغير في كل نسخة مع التاريخ والميزات والفيديو إن وجد. مركز المساعدة يشرح طريقة استخدام الميزة وحدودها وخطوات حل المشكلات.

- الأحدث يظهر أولًا وبشارة Latest.
- ظهور ميزة لا يعني دائمًا أنها مفعلة لكل حساب.
- ارجع إلى Help Center قبل تطبيق تغيير على العمل المباشر.

## خطوات الاستخدام

1. افتح Version History من أسفل القائمة الجانبية.
2. اقرأ وصف أحدث إصدار وقائمة الميزات.
3. شاهد الفيديو إن كان متاحًا.
4. ابحث عن اسم الميزة في مركز المساعدة.
5. اختبر التغيير ببيانات تجريبية قبل الاعتماد عليه.

## أسئلة شائعة

### هل كل ميزة في السجل متاحة لحسابي؟

ليس دائمًا؛ بعض الميزات تجريبية أو تحتاج تفعيلًا للحساب.

### أين أجد خطوات الإعداد؟

استخدم البحث في مركز المساعدة باسم الميزة أو المشكلة للوصول للدليل التفصيلي.

[فتح الصفحة في Mr. AI](/client/versions)

---

## طلب حذف حساب Mr. AI وبياناته

- Language: ar
- Section: الإعدادات والاستهلاك
- Canonical: https://mrailabs.com/docs/ar/settings-and-usage/request-account-and-data-removal/
- Markdown: https://mrailabs.com/docs/ar/settings-and-usage/request-account-and-data-removal.md
- Published: 2026-07-13T18:51:40.226212

اعرف خطوات تأكيد كلمة المرور وسبب الحذف وفترة السماح قبل تنفيذ حذف الحساب.

## ماذا يحدث عند طلب حذف حساب Mr. AI؟

بعد تأكيد كلمة المرور وكتابة سبب واضح، يتم تعطيل الحساب وتسجيل الخروج وجدولة الحذف النهائي بعد 30 يومًا. خيار الاحتفاظ بنصوص دردشة منزوعة الهوية لا يعمل إلا عند الموافقة عليه صراحة.

- الطلب يحتاج كلمة المرور الحالية.
- سبب الحذف يجب أن يكون 10 أحرف على الأقل في الواجهة.
- الحساب يُعطل فور تأكيد الطلب.

## قبل التأكيد

1. صدّر أو احتفظ بأي بيانات تحتاجها وفق سياسة شركتك.
2. افتح Settings ثم Profile وانتقل إلى منطقة حذف الحساب.
3. أدخل كلمة المرور الحالية ثم اكتب سبب الحذف.
4. راجع خيار الاحتفاظ بنصوص منزوعة الهوية واتركه غير محدد إذا لم توافق.
5. راجع التأكيد النهائي ثم أرسل الطلب؛ سيتم تسجيل خروجك مباشرة.

> **تنبيه**
> هذه عملية حساسة تؤثر على الوصول والبيانات. لا تبدأها كتجربة، وراجع احتياجات فريقك قبل التأكيد.

## أسئلة شائعة

### هل يتم الحذف النهائي في نفس اللحظة؟

يتم تعطيل الحساب فورًا، بينما الحذف النهائي مجدول بعد فترة سماح 30 يومًا.

### هل الاحتفاظ بنصوص الدردشة إلزامي؟

لا، هو اختيار منفصل يحتاج موافقة صريحة، ويقتصر على نصوص منزوعة البيانات التعريفية.

[فتح إعدادات الحساب](/client/settings/profile)

---

## اختبار موظفك باستخدام ChatGPT أو مساعد AI متصل

- Language: ar
- Section: الإعدادات والاستهلاك
- Canonical: https://mrailabs.com/docs/ar/settings-and-usage/test-ai-employee-with-connected-assistant/
- Markdown: https://mrailabs.com/docs/ar/settings-and-usage/test-ai-employee-with-connected-assistant.md
- Published: 2026-09-29T19:19:10.681386

خلّي مساعد AI متصل يبني السيناريوهات ويتصرف كعميل ويراجع ردود Mr. AI Testing بدل ما تنفذ كل Test يدويًا.

## هل ChatGPT يقدر يختبر موظف Mr. AI بدل ما أجرّب كل سيناريو بنفسي؟

نعم، لو حساب Mr. AI مربوط بمساعد متوافق مع أدوات Testing. المساعد يقدر يبني Scenarios، يبدأ Test Session، يتصرف كعميل، يرسل الرسائل إلى Mr. AI Testing، يكمل المحادثة، وبعدها يراجع الردود ويلخص المشاكل. المهم إن الرد اللي بنقيّمه لازم يكون راجع من Mr. AI Testing نفسه، مش إجابة كتبها ChatGPT من عنده.

- المساعد ينظم الاختبار؛ Mr. AI Testing هو اللي يولّد الرد تحت الاختبار.
- استخدم Scenario مستقلة لكل رحلة مهمة.
- بعد تعديل مهم، ابدأ Scenario جديدة.

## مثال طلب عملي

> **Prompt جاهز**
> اختبر موظف الـAI عندي في سيناريوهات السعر، ترشيح المنتج، الاعتراض، وطلب موظف بشري. استخدم Mr. AI Testing في كل Turn، وبعدها لخص المشاكل اللي ظهرت.

## المساعد المتصل يقدر يعمل إيه؟

- يبني سيناريوهات مناسبة للتغيير اللي عملته.
- يبدأ Test Session منفصلة.
- يتصرف كعميل ويرسل الرسائل الفعلية إلى Mr. AI Testing.
- يكمل Multi-turn داخل نفس الـSession.
- يراجع ردود AI Employee اللي رجعت من Testing Chat.
- يجرب أكتر من Scenario ويلخص الـgaps المتكررة.
- يختبر Proposed Configuration مدعومة قبل نشرها.

> **أهم قاعدة**
> لو ChatGPT كتب لك إجابة من عنده من غير ما يشغّل Mr. AI Testing، فده مش Test لموظفك. اطلب منه صراحة يستخدم Testing ويراجع الرد اللي رجع من Mr. AI.

## الحدود الحالية لخدمة AI Testing

- 15 رسالة Testing ناجحة كحد حالي لكل Session.
- 6 Testing Sessions جديدة كحد حالي لكل Workspace في اليوم.
- 90 Testing Messages كحد حالي لكل Workspace في اليوم.
- عمر Session الحالية: 4 ساعات.
- الحد اليومي يُحسب وفق Africa/Cairo.
- رسائل MCP Testing لا تخصم Customer Points.
- MCP Testing V1 يدعم Text فقط؛ Image وAudio متاحين من Dashboard Testing.

> **الحدود قابلة للتغيير**
> دي حدود الخدمة الحالية، وممكن تتغير من إعدادات السيرفر. اعتبرها Current service limits، مش وعد ثابت في الباقة.

## بعد أي تعديل مهم

ابدأ Scenario جديدة، حتى لو القديمة لسه شغالة. كده الردود الجديدة ما تتأثرش بسياق اتكوّن قبل التعديل. ولو بتختبر Proposal مدعومة، تقدر تختبر النسخة المقترحة قبل Publish.

> **اختبر قبل Publish**
> الاختبار قبل النشر هو المسار الموصى به للجودة، لكنه مش Publish Gate إجباري حاليًا.

## إيه اللي يفضل داخل بيئة الاختبار؟

- لا Customer Points على رسائل Testing.
- لا إرسال لقناة عميل حقيقية.
- لا Business Action writes حقيقية.
- لا Follow-up scheduling ولا Stage Follow-up Task حقيقية.

[فتح Build & Manage with AI](/client/manage-with-ai)

[راجع Testing Playbook](/docs/ar/learn/test-ai-employee-before-real-customers/)

[اختبر يدويًا من Test Assistant](/docs/ar/getting-started/test-assistant-before-live/)

[راجع Build & Manage with AI](/docs/ar/settings-and-usage/build-and-manage-with-ai/)

[افهم دورة تحسين جودة موظف AI](/docs/ar/knowledge-and-behavior/continuous-ai-employee-quality-loop/)

---

## إعداد وإدارة فريق المبيعات

- Language: ar
- Section: فريق المبيعات
- Canonical: https://mrailabs.com/docs/ar/sales-team/manage-sales-team/
- Markdown: https://mrailabs.com/docs/ar/sales-team/manage-sales-team.md
- Published: 2026-07-12T22:37:22.223480

أنشئ أعضاء الفريق واختر طريقة توزيع العملاء وفعّل أو أوقف الحسابات.

صفحة فريق المبيعات تظهر فقط للحسابات التي تم تفعيل الميزة لها. منها يستطيع صاحب الحساب إنشاء بيانات دخول مستقلة لأعضاء المبيعات واختيار طريقة توزيع العملاء.

## إضافة عضو جديد

1. اكتب اسم العضو.
2. اكتب بريدًا أو رقم هاتف ليستخدمه في تسجيل الدخول.
3. أنشئ كلمة مرور مؤقتة لا تقل عن 6 حروف أو أرقام.
4. أضف العضو ثم أرسل له بيانات الدخول بطريقة آمنة.

## طرق التوزيع

- بالتساوي Round Robin: يوزع العملاء بالتتابع بين الأعضاء النشطين.
- عضو محدد: يرسل العملاء الجدد إلى عضو نشط تختاره.
- يدوي: يترك العملاء بدون إسناد حتى يوزعهم المسؤول.

> **قبل تعطيل الحساب**
> عند إيقاف عضو، راجع العملاء المسندين له وأعد توزيع الحالات التي ما زالت تحتاج متابعة.

[فتح إدارة فريق المبيعات](/client/sales-team)

---

## استخدام مساحة عمل عضو المبيعات

- Language: ar
- Section: فريق المبيعات
- Canonical: https://mrailabs.com/docs/ar/sales-team/sales-user-workspace/
- Markdown: https://mrailabs.com/docs/ar/sales-team/sales-user-workspace.md
- Published: 2026-07-12T22:37:22.223480

افتح العملاء المسندين لك وراجع المحادثة والإجراءات والتعليقات في مكان واحد.

عند تسجيل الدخول كعضو مبيعات تظهر لك قائمة العملاء المسندين إلى حسابك فقط. لا يمكنك فتح عميل غير مسند لك.

## داخل مساحة العميل

- اسم العميل أو معرفه على المنصة.
- المنصة وحالة الـLead الحالية.
- الإجراءات المرتبطة بالعميل وحالتها.
- سجل المحادثة الكامل بين العميل والنظام أو الفريق.
- التعليقات الداخلية المسجلة على العميل.

## ترتيب المراجعة اليومي

1. ابدأ بالعملاء الذين لديهم إجراء مفتوح أو متابعة قريبة.
2. اقرأ آخر رسائل العميل قبل التواصل معه.
3. راجع التعليقات الداخلية حتى لا تكرر سؤالًا أو وعدًا سابقًا.
4. ارجع لمسؤول الحساب لو ظهر عميل غير موجود في قائمتك أو تحتاج إعادة إسناد.

> **حسابك الشخصي**
> بيانات الدخول خاصة بك. لا تستخدم حساب عضو آخر؛ لأن توزيع العملاء وسجل النشاط مرتبطان بالحساب المسجل.

[فتح مساحة المبيعات](/sales)

---

## لماذا لا يرد الموظف الذكي؟

- Language: ar
- Section: حل المشاكل الشائعة
- Canonical: https://mrailabs.com/docs/ar/troubleshooting/ai-not-replying/
- Markdown: https://mrailabs.com/docs/ar/troubleshooting/ai-not-replying.md
- Published: 2026-09-03T20:38:56.667478

راجع حالة النظام والعميل والمحادثة والقناة والنقاط بالترتيب.

## لماذا قد يتوقف موظف AI عن الرد وما أول فحص؟

ابدأ من حالة النظام والعميل والمحادثة والقناة والرصيد بالترتيب. إذا كانت الخدمة والقناة سليمتين، راجع هل المحادثة في وضع يدوي أو تحتاج تدخلًا بشريًا قبل تغيير المعرفة أو السلوك.

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

## قائمة الفحص

1. تأكد أن نظام الردود مفعل وأن الرد التلقائي للقناة المطلوبة يعمل.
2. تأكد أن المستخدم حالته مسموح وليست قيد الانتظار أو محظورًا.
3. افتح المحادثة وتأكد أن الذكاء ليس متوقفًا أو في وضع رد يدوي.
4. راجع هل الرسالة تطابق رسالة تلقائية ثابتة تم إعداد النظام لتجاهلها.
5. راجع اتصال القناة وأرسل رسالة تجريبية جديدة.
6. راجع النقاط المتبقية وحالة الاشتراك.
7. راجع تقارير الأداء أو المحادثة لمعرفة هل وصل كلام العميل أصلًا.

> **اختبر بهدوء**
> لا تعِد إرسال نفس رسالة العميل عدة مرات أثناء الفحص؛ قد تصل الردود لاحقًا وتسبب تكرارًا. اختبر برسالة جديدة واضحة بعد تعديل الإعداد.

[فتح الدردشات والتحكم](/client/clients/chats)

[افهم كيف تعتمد الردود على معرفة شركتك](/docs/ar/knowledge-and-behavior/grounded-ai-replies-from-business-knowledge/)

---

## تحسين رد غير دقيق أو غير مناسب

- Language: ar
- Section: حل المشاكل الشائعة
- Canonical: https://mrailabs.com/docs/ar/troubleshooting/improve-ai-answer-quality/
- Markdown: https://mrailabs.com/docs/ar/troubleshooting/improve-ai-answer-quality.md
- Published: 2026-09-03T20:38:56.667478

حدد هل المشكلة في المعلومة أو السلوك أو رحلة المحادثة ثم عدّل المصدر الصحيح.

## ما أول شيء أراجعه عندما يكون رد موظف AI ضعيفًا؟

حدد هل المشكلة معلومة ناقصة أو قديمة، تعليمات سلوك غير واضحة، رحلة محادثة غير مناسبة، أم حالة تحتاج إنسانًا. أصلح المصدر الصحيح ثم أعد نفس السيناريو في Test Assistant بدل تعديل الرد الظاهر فقط.

أسرع طريقة للتحسين هي تحديد نوع المشكلة قبل التعديل. إضافة تعليمات كثيرة في مكان واحد قد تخفي المشكلة بدل حلها.

## حدد نوع المشكلة

- حقيقة خاطئة أو ناقصة: حدّث المنتج أو العرض أو ملف المعرفة.
- أسلوب غير مناسب أو رد طويل: عدّل تعليمات الذكاء.
- لم يجمع البيانات المطلوبة: عدّل التعليمات أو مرحلة جمع الإجراء.
- المحادثة لا تصل للنتيجة: راجع منشئ رحلة المحادثة.
- كان يجب التحويل للبشر: أضف قاعدة تحويل واضحة مع أمثلة.

## اختبار التعديل

1. انسخ سؤال العميل الذي ظهرت فيه المشكلة.
2. حدّث مصدرًا واحدًا فقط.
3. اختبر السؤال وصياغتين مختلفتين له.
4. راجع أن التعديل لم يفسد سيناريوهات أخرى.

> **لا تخمّن الحقائق**
> لا تطلب من الموظف الذكي تخمين سعر أو موعد أو سياسة عند عدم وجود المعلومة. الأفضل أن يوضح أنه يحتاج مساعدة الفريق.

[فتح قاعدة المعرفة](/client/knowledge-base)

[افهم كيف تعتمد الردود على معرفة شركتك](/docs/ar/knowledge-and-behavior/grounded-ai-replies-from-business-knowledge/)

[استخدم دورة تحسين مستمرة لموظف AI](/docs/ar/knowledge-and-behavior/continuous-ai-employee-quality-loop/)

---

## حل مشكلة توقف قناة عن استقبال الرسائل

- Language: ar
- Section: حل المشاكل الشائعة
- Canonical: https://mrailabs.com/docs/ar/troubleshooting/channel-not-receiving-messages/
- Markdown: https://mrailabs.com/docs/ar/troubleshooting/channel-not-receiving-messages.md
- Published: 2026-07-12T22:37:22.223480

اختبر الاتصال حسب نوع القناة وحدد هل المشكلة في الربط أم الإعداد أم الموقع.

ابدأ بتحديد هل الرسالة لا تصل إلى Mr. AI أصلًا أم تصل ولا ينتج عنها رد. لو لا تظهر في الدردشات فركز على اتصال القناة. لو تظهر بدون رد فراجع إعدادات الذكاء.

## واتساب

- راجع حالة الاتصال والأجهزة المرتبطة داخل واتساب.
- اطلب QR جديد وأعد الربط إذا كانت الجلسة منتهية.
- أرسل رسالة من رقم آخر بعد ظهور حالة الاتصال.

## Facebook Messenger

- استخدم زر اختبار الاتصال.
- راجع Page ID والـPage Access Token.
- تأكد أن Webhook تم التحقق منه وأن الاشتراكات المطلوبة مفعلة.
- تأكد أن تطبيق Meta في الوضع المناسب لاستقبال رسائل العملاء الحقيقيين.

## دردشة الموقع

- تأكد أن الودجت مفعل وتم حفظ الإعدادات.
- تأكد أن نطاق الموقع موجود في النطاقات المسموحة.
- راجع أن كود التثبيت الحالي موجود في الموقع ولم تستخدم معرّفًا قديمًا بعد إعادة إنشائه.
- جرب من نافذة خاصة وأوقف إضافات الحجب مؤقتًا أثناء الاختبار.

[فتح ربط القنوات](/client/settings/connect)

---

## ربط مساعد ذكاء اصطناعي

- Language: ar
- Section: البناء والإدارة بالذكاء الاصطناعي
- Canonical: https://mrailabs.com/docs/ar/build-manage-ai/connect-ai-assistant/
- Markdown: https://mrailabs.com/docs/ar/build-manage-ai/connect-ai-assistant.md
- Published: 2026-08-30T12:41:09.172773

اربط ChatGPT أو Claude من خلال Mr.AI وتأكد من حالة الاتصال المؤكدة من الخادم وافهم حدود الصلاحيات.

إعدادات الاتصال تستخدم نفس حالة الاتصال الموجودة على خادم Mr.AI والتي يعتمد عليها Build & Manage with AI. لا توجد حالة اتصال منفصلة خاصة بصفحة Settings.

## قبل الربط

- الربط اختياري؛ استخدم المسار اليدوي إذا كنت لا تريد تفويض مساعد خارجي.
- قد تعتمد الإتاحة على مساحة العمل ومرحلة طرح الميزة والإمكانيات الحالية في المنصة المستضيفة للمساعد.
- المساعد المتصل يستطيع استخدام المجالات التي يتيحها Mr.AI لمساحة عملك فقط.

## ربط ChatGPT

1. افتح إعدادات AI أو البناء والإدارة بالذكاء الاصطناعي واختر ربط مساعد AI.
2. استخدم مسار custom MCP app / Developer Mode الحالي في ChatGPT إذا كان متاحًا لحسابك أو مساحة عملك.
3. أدخل https://access.mrailabs.com/mcp بالضبط كـMCP endpoint الخاص بـMr.AI.
4. اختر OAuth عند طلبه، وأكمل تفويض Mr.AI، ثم شغّل أو أكمل Scan Tools.
5. ارجع إلى Mr.AI وتأكد أن الخادم يعرض حالة متصل قبل الاعتماد على الربط.

## ربط Claude

1. افتح إعدادات Connectors الحالية في Claude وأضف custom remote connector.
2. أدخل https://access.mrailabs.com/mcp بالضبط كرابط الموصل.
3. أكمل OAuth الخاص بـMr.AI وفعّل فقط الأدوات التي تحتاجها للمهمة الحالية.
4. راجع طلبات موافقة Claude على الأدوات بعناية.
5. ارجع إلى Mr.AI وتأكد من حالة الاتصال المؤكدة من الخادم.

> **اعتمد على حالة Mr.AI**
> نجاح اختبار MCP عام أو وجود connector قديم أو ظهور نجاح داخل المنصة المستضيفة لا يكفي. اعتبر الاتصال نشطًا فقط عندما يؤكد Mr.AI حالته من الخادم.

## الصلاحيات وحدود الإمكانيات

- Mr.AI هو من يحدد الأدوات والمجالات المتاحة لمساحة العمل.
- اسم المنصة المستضيفة لا يوسّع الصلاحيات.
- محدودية الإمكانيات لا تعني فشل النظام؛ استخدم المسار اليدوي للمجال غير المتاح للمساعد المتصل.

[فتح إعدادات AI](/client/settings/ai)

---

## استخدام AI بدون ربط مساعد

- Language: ar
- Section: البناء والإدارة بالذكاء الاصطناعي
- Canonical: https://mrailabs.com/docs/ar/build-manage-ai/manual-ai-workflow/
- Markdown: https://mrailabs.com/docs/ar/build-manage-ai/manual-ai-workflow.md
- Published: 2026-08-30T12:41:09.172773

استخدم مسار التصدير والعمل مع AI والرفع والمراجعة والتطبيق بدون تفويض اتصال لمساعد خارجي.

## هل أستطيع استخدام AI بدون ربط ChatGPT أو Claude؟

نعم. مسار AI اليدوي مسار دائم ومدعوم. استخدمه إذا كنت لا تريد تفويض اتصال، أو كان الربط غير متاح، أو كان المساعد المتصل لا يدعم المجال الذي تريد تحسينه.

- لا تحتاج إلى ربط أي مساعد.
- النتيجة تعود إلى Mr.AI للمراجعة قبل أي تغيير على الإنتاج.

## من داخل صفحة مدعومة

1. اختر تحسين باستخدام AI من الصفحة التي تعمل عليها.
2. استخدم المسار السياقي حتى يظل نطاق الصفحة والهدف الحاليان مرتبطين بالمهمة.
3. صدّر حزمة التعديل المدعومة.
4. اعمل على الحزمة مع مساعد AI الذي تفضله.
5. ارفع النتيجة مرة أخرى داخل نفس مسار Mr.AI.
6. راجع النتيجة المقترحة قبل التطبيق.

## من الـHub الكامل

1. افتح البناء والإدارة بالذكاء الاصطناعي.
2. اختر المسار اليدوي والمجال الذي تريد تحسينه.
3. صدّر الحزمة وأكمل العمل مع AI خارجيًا.
4. ارفع النتيجة وراجع الفروق والتنبيهات ثم أكمل مسار المراجعة والتطبيق المدعوم.

> **حافظ على حاجز المراجعة**
> لا تنسخ التغيير المقترح يدويًا إلى الإنتاج لتجاوز المراجعة. قيمة المسار أن النتيجة تعود إلى تحقق Mr.AI وتطبيق يتحكم فيه العميل.

[فتح AI Hub](/client/manage-with-ai)

---

## مراجعة واختبار وتطبيق والتراجع عن تغييرات AI

- Language: ar
- Section: البناء والإدارة بالذكاء الاصطناعي
- Canonical: https://mrailabs.com/docs/ar/build-manage-ai/review-test-apply-rollback-ai-changes/
- Markdown: https://mrailabs.com/docs/ar/build-manage-ai/review-test-apply-rollback-ai-changes.md
- Published: 2026-08-30T12:41:09.172773

افهم دورة الاقتراح المحمية قبل تغيير الإنتاج وبعده.

## هل يطبّق مساعد AI التغييرات تلقائيًا؟

لا. المساعد المتصل المدعوم يجهز اقتراحًا فقط. لا يصبح الاقتراح حيًا حتى يراجعه العميل ويختار التطبيق صراحةً من خلال Mr.AI.

- الاقتراح ليس إنتاجًا.
- Testing لا ينشر الاقتراح.
- التطبيق يحتاج إجراء صريحًا من العميل.

## دورة الاقتراح الآمنة

1. افتح مراجعة الاقتراح وتأكد من المجال المتأثر والحالة الحالية والفروق والتنبيهات.
2. تحقق من الاقتراح مقابل إعدادات مساحة العمل الحالية.
3. إذا تغيرت الإعدادات أو أصبح الاقتراح قديمًا أو متعارضًا، أنشئ اقتراحًا جديدًا بدل إجبار القديم على التطبيق.
4. استخدم Testing عندما يدعم نوع الاقتراح ذلك. الاختبار منفصل عن الإنتاج.
5. اختر التطبيق صراحةً فقط عندما يصبح الاقتراح جاهزًا وتفهم أثره.
6. بعد التطبيق استخدم التراجع فقط عندما يوفر Mr.AI snapshot تراجع موثوقًا لهذا النوع من التغيير ويعرض الإجراء.

## كيف تفسر حالات الفشل؟

- فشل التحقق: الاقتراح غير جاهز للتطبيق؛ راجع الرسالة وحدّث الاقتراح عند الحاجة.
- فشل Testing: فشل الاختبار لا يغير الإنتاج.
- فشل التطبيق: لا تفترض أن الاقتراح أصبح حيًا؛ اعتمد على الحالة التي يعرضها Mr.AI.
- فشل التراجع: لا تفترض أن الحالة السابقة عادت حتى يؤكد Mr.AI نجاح Rollback.

> **فضّل الاقتراح الجديد**
> عند الشك توقف عند المراجعة وأنشئ اقتراحًا جديدًا من الإعدادات الحالية بدل محاولة إنقاذ اقتراح قديم.

[فتح البناء والإدارة بالذكاء الاصطناعي](/client/manage-with-ai)

---

## إدارة الاتصال وحل المشكلات الشائعة

- Language: ar
- Section: البناء والإدارة بالذكاء الاصطناعي
- Canonical: https://mrailabs.com/docs/ar/build-manage-ai/ai-connection-management-troubleshooting/
- Markdown: https://mrailabs.com/docs/ar/build-manage-ai/ai-connection-management-troubleshooting.md
- Published: 2026-08-30T12:41:09.172773

أعد الربط أو حدّث الحالة أو راجع التفاصيل أو اقطع الاتصال بأمان، وحل مشاكل ChatGPT وClaude والتفويض والاقتراحات الشائعة.

## إدارة الاتصال

- استخدم تحديث الحالة لطلب آخر حالة اتصال من الخادم.
- افتح تفاصيل الاتصال لمراجعة الاتصال النشط الذي يعترف به Mr.AI.
- أعد الربط عندما ينتهي التفويض أو يلغى أو لا يكتمل أو يعرض Mr.AI أن إعادة الربط مطلوبة.
- اقطع الاتصال عندما لا تريد استمرار ربط هذا المساعد. قطع الاتصال لا يغير إعدادات الموظف الذكي الحية.
- يبقى مسار AI اليدوي متاحًا أثناء قطع الاتصال أو إعادة الربط أو إلغاء التفويض أو انتهائه أو عدم إتاحة الربط.

## الحالات والمشكلات الشائعة

## حل المشكلات

### غير متصل

اربط مساعدًا فقط إذا أردت المسار المتصل. يمكنك استخدام مسار AI اليدوي فورًا.

### إعادة الربط مطلوبة

أعد الربط من داخل المساعد، وأكمل التفويض مرة أخرى، ثم حدّث Mr.AI حتى يؤكد الخادم الاتصال.

### إمكانيات محدودة

استخدم المجالات التي يتيحها Mr.AI حاليًا واستخدم المسار اليدوي للمجالات غير المدعومة.

### فشل Scan Tools في ChatGPT

تأكد أن العنوان هو https://access.mrailabs.com/mcp بالضبط، وأكمل OAuth مرة أخرى ثم أعد محاولة مسار ChatGPT الحالي.

### موصل Claude غير مصرح

أعد ربط custom connector وأكمل OAuth الخاص بـMr.AI مرة أخرى. وجود موصل قديم لا يثبت استمرار التفويض.

### الربط غير متاح أو فشل

حدّث حالة الاتصال وأعد محاولة المسار المدعوم. فشل محاولة الربط لا يغير إعدادات الموظف الذكي الحية.

### فشل التحقق من الاقتراح

راجع رسالة المراجعة. إذا تغيرت الإعدادات أو أصبح الاقتراح قديمًا، أنشئ اقتراحًا جديدًا وراجعه.

### فشل Testing

عد إلى مراجعة الاقتراح وابدأ Testing مرة أخرى. فشل الاختبار لا ينشر الاقتراح.

### فشل التطبيق

راجع الحالة التي أعادها النظام قبل المحاولة مرة أخرى. لا تعتبر الاقتراح مطبقًا إلا إذا أكد Mr.AI النجاح.

### فشل التراجع

راجع الحالة قبل إعادة المحاولة. لا تعتبر Rollback مكتملًا إلا إذا أكد Mr.AI النجاح.

## حماية بيانات الاعتماد

> **حافظ على سرية بيانات الاعتماد**
> لا تشارك كلمات المرور أو مفاتيح API أو Authorization headers أو OAuth codes أو access tokens أو refresh tokens أو بيانات اعتماد المساعد داخل prompts أو الحزم المصدرة أو لقطات الشاشة أو ملاحظات الدعم.

[فتح إعدادات AI](/client/settings/ai)

---

## كيف تمنع ضياع العملاء بسبب تأخر الرد؟

- Language: ar
- Section: تعلّم
- Canonical: https://mrailabs.com/docs/ar/learn/prevent-losing-customers-slow-replies/
- Markdown: https://mrailabs.com/docs/ar/learn/prevent-losing-customers-slow-replies.md
- Published: 2026-09-03T20:38:55.983279

قلل أثر تأخر الرد بجمع سرعة الاستجابة، معلومات الشركة، وضوح المحادثة، التدخل البشري، والمتابعة المناسبة في مسار واحد.

## كيف تمنع ضياع العملاء بسبب تأخر الرد؟

لا يكفي إرسال رد آلي سريع. المطلوب أن يحصل العميل على رد أول سريع ومبني على معلومات شركتك، مع بقاء المحادثة واضحة للفريق، وإمكانية تدخل موظف عندما تحتاج الحالة ذلك، ثم متابعة العميل عندما يكون هناك سبب حقيقي للمتابعة.

- السرعة مهمة، لكن الدقة والسياق أهم من رد عام.
- يجب أن يعرف الفريق متى يحتاج العميل تدخلًا بشريًا.
- المتابعة تكمل المحادثة عندما تتوقف، ولا تستبدلها.

## لماذا يتحول تأخر الرد إلى فرصة ضائعة؟

العميل الذي يسأل عن سعر أو موعد أو حجز غالبًا ينتظر خطوة تساعده يكمل قراره. عندما يطول الانتظار، قد يغيّر القناة، يذهب لمنافس، أو ينسى الطلب. المشكلة هنا تشغيلية: الرسالة وصلت، لكن لم تدخل مسارًا واضحًا للرد والمراجعة والمتابعة.

## ما الذي يفشل عادة؟

- رد ترحيبي عام يصل بسرعة لكنه لا يجيب السؤال الحقيقي.
- معلومة قديمة أو غير موجودة تجعل الرد السريع غير مفيد.
- عدم وجود مكان واضح للفريق يرى منه المحادثات التي تحتاج تدخلًا.
- استمرار AI في حالة تحتاج موظفًا بشريًا.
- غياب متابعة مناسبة بعد أن يتوقف العميل عن الرد.

## ما الذي يحتاجه تشغيل أفضل؟

1. جهّز الأسعار والخدمات والمواعيد والسياسات داخل قاعدة المعرفة.
2. اختبر الأسئلة التي يرسلها العملاء فعلًا، وليس الأسئلة السهلة فقط.
3. اربط قناة واحدة وراقب أول المحادثات قبل التوسع.
4. استخدم Customer Operations لمراجعة الحالات التي تحتاج تدخلًا بشريًا.
5. فعّل المتابعة فقط للحالات التي تحتاجها، مع سياق وتحكم بشري.

## أين يساعد Mr. AI؟

Mr. AI يجمع الردود المبنية على معرفة نشاطك مع القنوات المتصلة، اختبار الموظف الذكي، Customer Operations، والتحكم البشري. القنوات المؤكدة حاليًا هي WhatsApp وFacebook Messenger ودردشة الموقع. الهدف ليس إخفاء الفريق البشري، بل تقليل الوقت الذي تضيع فيه الرسائل بين الوصول والتصرف المناسب.

## ابدأ من هذه الأدلة

[جهّز المعلومات التي يعتمد عليها الرد](/docs/ar/knowledge-and-behavior/knowledge-base-overview/)

[اختبر الموظف الذكي قبل التشغيل](/docs/ar/getting-started/test-assistant-before-live/)

[اربط قناة واحدة واختبرها](/docs/ar/channels-and-launch/connect-channels/)

[راجع المحادثات التي تحتاج تدخلًا](/docs/ar/conversations-and-customers/customer-operations-inbox/)

## الخطوة التالية

ابدأ بعينة من أكثر أسئلة العملاء تكرارًا، أصلح المعرفة والسلوك حتى تصبح الردود مفيدة، ثم شغّل قناة واحدة وراقب أين يحتاج الفريق إلى تدخل أو متابعة.

[افهم كيف تعتمد الردود على معرفة شركتك](/docs/ar/knowledge-and-behavior/grounded-ai-replies-from-business-knowledge/)

---

## كيف تتابع العملاء تلقائيًا عندما يتوقفون عن الرد؟

- Language: ar
- Section: تعلّم
- Canonical: https://mrailabs.com/docs/ar/learn/automatic-follow-up-when-customers-stop-replying/
- Markdown: https://mrailabs.com/docs/ar/learn/automatic-follow-up-when-customers-stop-replying.md
- Published: 2026-09-03T20:38:55.983279

استخدم المتابعة التلقائية لاستكمال محادثة لها سياق وهدف، مع تجنب الرسائل المتكررة أو غير المناسبة وإبقاء الفريق قادرًا على التدخل.

## كيف تتابع العملاء تلقائيًا عندما يتوقفون عن الرد؟

ابدأ من محادثة لها سياق واضح وسبب منطقي للمتابعة، واضبط رسالة المتابعة لتكمل ما كان العميل يفعله بدل أن تبدأ محادثة عامة جديدة. راقب النتائج واترك للفريق القدرة على التدخل أو إيقاف المتابعة عندما تتغير الحالة.

- المتابعة الجيدة مرتبطة بما حدث قبلها.
- التكرار دون سياق قد يزعج العميل بدل أن يعيده للمحادثة.
- الرد وحده لا يكفي إذا توقفت المحادثة قبل الخطوة التالية.

## لماذا يتوقف العميل عن الرد؟

قد يكون مشغولًا، ما زال يقارن، ينتظر معلومة، يحتاج موافقة من شخص آخر، أو ببساطة نسي المحادثة. لذلك عدم الرد لا يعني دائمًا الرفض، لكنه أيضًا لا يعني أن كل محادثة تستحق سلسلة رسائل آلية.

## متى تكون المتابعة مفيدة؟

- عندما كان هناك طلب واضح مثل سعر، حجز، عرض، أو خطوة ينتظر العميل إكمالها.
- عندما تحتوي المحادثة على سياق كافٍ لكتابة رسالة مرتبطة بما سبق.
- عندما يستطيع الفريق رؤية ما تم وإيقاف المتابعة أو التدخل عند الحاجة.

## ما شكل المتابعة السيئة؟

- رسالة عامة لا علاقة لها بآخر سؤال أو خطوة.
- الاستمرار في إرسال رسائل بعد أن تغيّرت حالة العميل أو طلب التواصل مع موظف.
- تكرار نفس النص دون إضافة قيمة أو خطوة واضحة.
- اعتبار كل شخص لم يرد فرصة بيعية مؤكدة.

## كيف يتعامل Mr. AI مع المسار؟

يوفر Mr. AI إعدادات للمتابعة التلقائية مع إمكانية إدارة المحادثات من Customer Operations وربط العمل اللاحق بـClient Actions والتقارير. لا يعتمد هذا الدليل على رقم ثابت لمحاولات أو توقيت المتابعة؛ اختَر الإعداد المناسب لطبيعة نشاطك واختبر أثره بدل استخدام رقم عام غير موثّق لكل الحالات.

## نفّذ المسار في Mr. AI

[اضبط المتابعة التلقائية](/docs/ar/settings-and-usage/automatic-customer-follow-up-settings/)

[راجع العمل البشري في Customer Operations](/docs/ar/conversations-and-customers/customer-operations-inbox/)

[نظّم إجراءات العملاء](/docs/ar/conversations-and-customers/manage-client-actions-workflow/)

## الخطوة التالية

اختر نوعًا واحدًا من المحادثات التي تتوقف قبل خطوة مهمة، راجع رسائلها وسياقها، ثم اختبر متابعة مناسبة مع الفريق قبل توسيع استخدامها.

[قارن المتابعة التلقائية والعمل البشري](/docs/ar/conversations-and-customers/automatic-vs-manual-customer-follow-up/)

---

## كيف تعرف العملاء الذين يحتاجون متابعة من محادثاتك؟

- Language: ar
- Section: تعلّم
- Canonical: https://mrailabs.com/docs/ar/learn/identify-customers-who-need-follow-up/
- Markdown: https://mrailabs.com/docs/ar/learn/identify-customers-who-need-follow-up.md
- Published: 2026-09-03T20:38:55.983279

افصل بين السؤال العادي والفرصة النشطة والعمل المعلّق والحالة التي تحتاج موظفًا، ثم استخدم Customer Operations وClient Actions والتقارير لترتيب ما يحتاج متابعة.

## كيف تعرف العملاء الذين يحتاجون متابعة من محادثاتك؟

لا تبحث فقط عن آخر رسالة بلا رد. صنّف معنى المحادثة: هل هي سؤال معلومات وانتهى، فرصة نشطة، خطوة ينتظرها العميل، حالة تحتاج موظفًا، أم إجراء يجب على الفريق تنفيذه؟ العملاء الذين لديهم خطوة مفتوحة أو قرار معلّق هم المرشحون الحقيقيون للمتابعة.

- معنى المحادثة أهم من مجرد كون آخر رسالة قديمة.
- بعض الحالات تحتاج إجراءً داخليًا قبل إرسال أي Follow-up.
- التدخل البشري والمتابعة ليسا الشيء نفسه.

## خمسة أنواع يجب التفريق بينها

- محادثة عادية: سؤال تم الرد عليه ولا توجد خطوة مفتوحة.
- طلب معلومات: العميل يجمع تفاصيل وقد لا يكون مستعدًا لخطوة بيعية بعد.
- فرصة نشطة: توجد نية واضحة مثل حجز أو سعر أو طلب عرض أو خطوة شراء.
- إجراء معلّق: هناك شيء يجب على العميل أو الفريق إكماله.
- حالة تحتاج انتباهًا بشريًا: اعتراض، استثناء، طلب موظف، أو سياق لا ينبغي أن يستمر فيه AI وحده.

## أين تظهر الإشارات في Mr. AI؟

Customer Operations يركز على طابور العمل البشري والمحادثات التي تحتاج مراجعة أو ردًا. Client Actions يحول ما يجب فعله إلى إجراء يمكن متابعته بدل بقائه داخل نص المحادثة. التقارير تساعد الفريق على رؤية نمط النشاط والأداء بعد التنفيذ. هذه الأدوات لا تجعل كل محادثة Lead تلقائيًا؛ قرار المتابعة يجب أن يبقى مرتبطًا بالسياق الفعلي.

## مسار عملي للفريق

1. ابدأ من Customer Operations للحالات التي تحتاج انتباهًا الآن.
2. اقرأ آخر الرسائل وحدد هل هناك خطوة مفتوحة فعلًا.
3. أنشئ أو راجع Client Action عندما يحتاج الأمر إجراءً من الفريق.
4. استخدم المتابعة عندما يكون المطلوب إعادة العميل للمحادثة، وليس بدل تنفيذ العمل الداخلي.
5. راجع التقارير دوريًا لمعرفة أين تتكرر الحالات أو تتعطل.

[افتح دليل Customer Operations](/docs/ar/conversations-and-customers/customer-operations-inbox/)

[افتح دليل Client Actions](/docs/ar/conversations-and-customers/manage-client-actions-workflow/)

## الخطوة التالية

اتفق داخل الفريق على تعريف واضح لما تعتبرونه خطوة مفتوحة أو فرصة تحتاج متابعة، ثم طبّق التعريف على المحادثات بدل الاعتماد على الانطباع أو عمر آخر رسالة فقط.

[افهم الفرق بين Operations وActions](/docs/ar/conversations-and-customers/customer-operations-vs-client-actions/)

[افهم استخدام بيانات المحادثات](/docs/ar/conversations-and-customers/conversation-intelligence-for-customer-operations/)

---

## كيف تضيف AI لخدمة العملاء بدون تغيير نظام شركتك بالكامل؟

- Language: ar
- Section: تعلّم
- Canonical: https://mrailabs.com/docs/ar/learn/add-ai-customer-service-without-replacing-system/
- Markdown: https://mrailabs.com/docs/ar/learn/add-ai-customer-service-without-replacing-system.md
- Published: 2026-09-03T20:38:55.983279

ابدأ تدريجيًا: جهّز المعرفة والسلوك، اختبر، اربط قناة حالية واحدة، أبقِ التدخل البشري، راقب النتائج، ثم وسّع الاستخدام عندما يصبح التشغيل مستقرًا.

## كيف تضيف AI لخدمة العملاء بدون تغيير نظام شركتك بالكامل؟

أضف AI كطبقة تشغيل تدريجية فوق قناة تستخدمها بالفعل: جهّز معرفة النشاط، حدد سلوك الرد، اختبر السيناريوهات، اربط قناة واحدة، واحتفظ بمسار واضح للتدخل البشري. بعد أن ترى أين ينجح وأين يحتاج تعديلًا، وسّع الاستخدام خطوة بخطوة.

- ابدأ بنطاق صغير يمكن مراجعته.
- لا تربط القنوات قبل تجهيز المعرفة والاختبار.
- التشغيل الناجح قد يحتاج تعديلات في العملية، لكنه لا يتطلب استبدال كل أدوات الشركة دفعة واحدة.

## لماذا التدرج أفضل؟

المشكلة في إطلاق AI مرة واحدة على كل شيء أن أي نقص في الأسعار أو السياسات أو قواعد التحويل يتكرر على نطاق أكبر. البدء بقناة وحالات معروفة يجعل الفريق يرى الفجوات مبكرًا ويصلحها قبل التوسع.

## مسار تطبيق عملي

1. جهّز معلومات النشاط والخدمات والأسعار والمواعيد والسياسات.
2. حدد نبرة الرد والحالات التي يجب أن تنتقل لموظف بشري.
3. اختبر معلومات أساسية واعتراضات وحجوزات وأسئلة غير مدعومة.
4. اربط قناة واحدة من القنوات الحالية: WhatsApp أو Facebook Messenger أو Website/Webchat.
5. راقب المحادثات وتدخل يدويًا عندما تستدعي الحالة ذلك.
6. حسّن المعرفة والسلوك، ثم قرر إن كان الوقت مناسبًا لإضافة قناة أو استخدام آخر.

## كيف يطبق Mr. AI ذلك؟

Mr. AI يجمع قاعدة المعرفة، سلوك الموظف الذكي، اختبار المساعد، ربط القنوات، التحكم البشري، ومتابعة المحادثات في منتج واحد. هذا يقلل الحاجة لبناء كل طبقة من الصفر، لكنه لا يلغي مسؤولية فريقك عن جودة المعلومات والاختبار ومراجعة الحالات المهمة.

[ابدأ من أول خطوات Mr. AI](/docs/ar/getting-started/first-steps/)

[راجع قاعدة المعرفة](/docs/ar/knowledge-and-behavior/knowledge-base-overview/)

[اختبر قبل التشغيل](/docs/ar/getting-started/test-assistant-before-live/)

[اربط قناة واحدة](/docs/ar/channels-and-launch/connect-channels/)

[تعرف على Build & Manage with AI](/docs/ar/settings-and-usage/build-and-manage-with-ai/)

[استخدم دورة تحسين مستمرة لموظف AI](/docs/ar/knowledge-and-behavior/continuous-ai-employee-quality-loop/)

---

## كيف تبني وتطوّر موظف AI باستخدام ChatGPT أو Claude؟

- Language: ar
- Section: تعلّم
- Canonical: https://mrailabs.com/docs/ar/learn/build-ai-employee-with-chatgpt-or-claude/
- Markdown: https://mrailabs.com/docs/ar/learn/build-ai-employee-with-chatgpt-or-claude.md
- Published: 2026-09-03T20:38:55.983279

استخدم مساعد AI متوافق تعمل معه بالفعل لمساعدتك في بناء وتحسين موظفك الذكي، مع مراجعة التغييرات واختبارها داخل Mr. AI قبل تطبيقها.

## كيف تبني وتطوّر موظف AI باستخدام ChatGPT أو Claude؟

يمكنك استخدام مساعد AI متوافق مثل ChatGPT أو Claude ليساعدك في إعداد وتحسين أجزاء من موظفك الذكي، ثم تراجع المقترحات وتختبرها وتطبقها داخل Mr. AI. ويمكنك أيضًا إدارة نفس الموظف مباشرة من Mr. AI أو استخدام الطريقتين معًا.

- Mr. AI يظل مكان تشغيل وإدارة الموظف الذكي.
- التوافق مطلوب؛ ليس كل مساعد AI مدعومًا تلقائيًا.
- راجع واختبر التغيير قبل تطبيقه على العملاء.

## ثلاث طرق للعمل

- مباشرة داخل Mr. AI: عدّل المعرفة والسلوك والإعدادات من صفحات المنتج.
- باستخدام مساعد AI متوافق: اطلب منه المساعدة في بناء أو تحسين الأجزاء التي يسمح الاتصال بإدارتها.
- الطريقتان معًا: استخدم المساعد للتفكير والصياغة، وMr. AI للمراجعة والاختبار والتشغيل.

## ما القيمة العملية؟

بدل نسخ معلومات كثيرة يدويًا بين محادثتك مع المساعد وصفحات المنتج، يمكن للاتصال المتوافق أن يجعل المساعد يعمل ضمن قدرات محددة تسمح بها Mr. AI. حالة كل قدرة قد تكون متاحة أو محدودة أو غير متاحة، لذلك يجب التعامل مع ما يظهر فعليًا في الاتصال لا مع افتراض أن كل شيء قابل للتعديل.

## أين يدخل MCP؟

MCP هو جزء تقني من طريقة الاتصال في التجارب المتوافقة، وليس هو المنتج الذي تحتاج أن تبدأ منه. ابدأ بالسؤال: ما الجزء الذي تريد بناءه أو تحسينه؟ ثم استخدم AI Assistant Connection إذا كان مساعدك والقدرة المطلوبة متوافقين.

## مسار آمن للتغيير

1. حدد المشكلة أو الجزء الذي تريد تحسينه.
2. اطلب من المساعد المتوافق اقتراح تغيير أو إعداد مناسب.
3. راجع المقترح ولا تعتبره منشورًا لمجرد أن المساعد أنشأه.
4. اختبر النتيجة على سيناريوهات حقيقية داخل Mr. AI.
5. طبّق التغيير بعد المراجعة، ثم راقب أثره على المحادثات.

[افتح Build & Manage with AI](/docs/ar/settings-and-usage/build-and-manage-with-ai/)

[اختبر الموظف الذكي قبل التطبيق](/docs/ar/getting-started/test-assistant-before-live/)

[استخدم دورة تحسين مستمرة لموظف AI](/docs/ar/knowledge-and-behavior/continuous-ai-employee-quality-loop/)

---

## كيف تختبر موظف AI بطريقة صحيحة؟

- Language: ar
- Section: تعلّم
- Canonical: https://mrailabs.com/docs/ar/learn/test-ai-employee-before-real-customers/
- Markdown: https://mrailabs.com/docs/ar/learn/test-ai-employee-before-real-customers.md
- Published: 2026-09-29T19:19:11.235236

بعد أي تعديل مهم: اختبر أهم السيناريوهات، شوف المشكلة جاية منين، أصلح المصدر الصحيح، وجرّب من جديد قبل ما تعتمد التغيير مع العملاء.

## أنا عدلت حاجة في موظف AI؛ أعمل إيه قبل ما أعتمدها؟

اعمل Test قصير على أهم أسئلة العملاء، وبعدها ركّز على الجزء اللي عدلته. لو ظهر رد غلط أو ضعيف، ارجع للمصدر المسؤول عنه، أصلحه، وابدأ Test جديد. الفكرة ببساطة: عدّل → اختبر → أصلح السبب → أعد الاختبار → وبعدها اعتمد التغيير.

- اختبر بعد أي تعديل مهم، حتى لو الحفظ تم بنجاح.
- اكتب أسئلة زي العميل الحقيقي بدل ما تلقّن الموظف الإجابة.
- قيّم الرد اللي رجع فعلًا من Mr. AI Testing.

## اختبار سريع بعد أي تعديل مهم

- اسأل عن Product أو Service أساسي، وبعدها عن سعر أو عرض أو موعد أو Policy مهمة.
- اسأل نفس المعنى بصياغة مختلفة، وبعدها حط افتراض غلط وشوف هل الموظف هيصححه.
- كمّل محادثة من أكتر من رسالة وتأكد إنه فاكر السياق من غير ما يخترع بيانات ناقصة.
- جرّب اعتراض حقيقي وشوف هل المحادثة تكمل بشكل طبيعي.
- اسأل عن معلومة مش موجودة وتأكد إنه ما يهبدش.
- اطلب موظف بشري، وراجع طريقة الكلام واللغة واسم وهوية النشاط.
- لو بتستخدم Conversation Stages، جرّب رحلة كاملة وتأكد إن المرحلة ما بتتغيرش بدري.
- لو عندك Action، اختبر إمتى الموظف يحاول يشغله وإمتى ما يحاولش.

> **ابدأ بالصورة الكبيرة**
> ده اختبار سريع لاكتشاف المشاكل الكبيرة. بعده اختبر الجزء اللي عدلته بتفاصيل أكتر بدل ما تعمل Checklist ضخمة كل مرة.

## لو عدلت الهوية أو طريقة الكلام

- اسم النشاط ودور الموظف.
- Tone واللغة وطريقة الرد.
- الحاجات اللي ممنوع يقولها أو يعملها.
- التعامل مع سؤال إجابته مش موجودة.
- إمتى يقترح أو يطلب تدخل موظف بشري.

## لو عدلت Catalog

- اسأل عن منتج أو خدمة بالاسم وتأكد من السعر والعملة والـOptions / Variants.
- اسأل سؤال discovery طبيعي من غير ما تكرر اسم العنصر حرفيًا.
- اختبر Semantic Classification وSemantic Tags بأسئلة تمثل المعنى اللي بنيت عليه الهيكل.
- اختبر AI Search Attributes بسؤال دقيق عن Instructor أو Branch أو Level أو قيمة مشابهة.
- لو بتستخدم Aliases أو Search Name، جرّب نفس القيمة بصياغة أو لغة مختلفة وتأكد إن Mr. AI لسه بيوصل لنفس العنصر الصحيح.
- جرّب عنصرين شبه بعض علشان تتأكد إن التشابه لوحده ما يرجعش المنتج الغلط.

## لو عدلت Deep Knowledge

- اسأل عن معلومة مباشرة.
- اسأل نفس المعنى بصياغة مختلفة.
- لو المعلومة موزعة على أكتر من جزء، جرّب سؤال يحتاج الربط بينهم.
- اسأل عن حاجة غير موجودة وتأكد إنه ما يخترعش إجابة.
- بعد تحديث الملف أو الـResource، ابدأ Test جديد واسأل من جديد.

## لو عدلت Conversation Stages

- ابدأ الرحلة من أولها وكمّل أكتر من Turn.
- راجع إن الانتقال للمرحلة التالية حصل في الوقت الصح، مش بدري.
- جرّب سؤال جانبي وبعدها ارجع للرحلة الأساسية.
- تأكد إن المحادثة وصلت للحالة النهائية الصحيحة.

## لو عدلت Actions

- جرّب الحالة اللي المفروض تشغّل الـAction.
- جرّب نفس السيناريو قبل اكتمال البيانات وتأكد إنه ما يتشغلش بدري.
- جرّب بيانات ناقصة أو غير صالحة.
- راجع إيه اللي الموظف كان هيحاول يعمله لو المحادثة Live.

> **اختبار الـAction مش تنفيذ حقيقي**
> Test Assistant بيختبر قرار وسلوك الـAI، لكنه مش دليل إن Booking أو Order أو Payment أو Refund أو أي Business Action اتنفذ فعلًا في النظام الحقيقي.

## لو عدلت Follow-up أو Stage Follow-up

اختبر هل المحادثة وصلت للمرحلة والسياق الصح للمتابعة. لكن Test Chat نفسها مش دليل إن Follow-up أو Task حقيقية اتعمل لها Schedule أو اتنفذت في Production.

## لما تلاقي مشكلة: أصلح المصدر الصح

1. احتفظ بسؤال العميل والرد اللي كشف المشكلة.
2. حدد المصدر المسؤول: Catalog، Deep Knowledge، الهوية وطريقة الكلام، Conversation Stages، أو Action.
3. عدّل أقل جزء لازم بدل ما تضيف تعليمات عامة تحاول تصلح كل حاجة.
4. ابدأ Testing Chat أو Scenario جديدة بعد التعديل المهم.
5. أعد نفس السؤال، وبعدها جرّب صياغة قريبة علشان تتأكد إن الإصلاح مش محفوظ على جملة واحدة.
6. بعد ما الاختبارات الأساسية تنجح، راقب أول المحادثات الحقيقية للتأكد من الجودة.

> **ابدأ Fresh Test بعد التعديل**
> بعد أي تعديل مهم ابدأ Test جديد. كده بتختبر النسخة الجديدة بوضوح من غير ما سياق محادثة قديمة يأثر على النتيجة.

[فتح Test Assistant](/client/settings/test-assistant)

[اختبر يدويًا من Test Assistant](/docs/ar/getting-started/test-assistant-before-live/)

[اختبر باستخدام ChatGPT أو مساعد AI متصل](/docs/ar/settings-and-usage/test-ai-employee-with-connected-assistant/)

[افهم دورة تحسين جودة موظف AI](/docs/ar/knowledge-and-behavior/continuous-ai-employee-quality-loop/)

[افهم كيف تمنع الإجابات غير المسندة](/docs/ar/knowledge-and-behavior/grounded-ai-replies-from-business-knowledge/)

[راجع قاعدة المعرفة عند ظهور فجوة](/docs/ar/knowledge-and-behavior/knowledge-base-overview/)

[راجع ربط القنوات بعد نجاح الاختبار](/docs/ar/channels-and-launch/connect-channels/)

---

## Your first steps with Mr. AI

- Language: en
- Section: Start here
- Canonical: https://mrailabs.com/docs/en/getting-started/first-steps/
- Markdown: https://mrailabs.com/docs/en/getting-started/first-steps.md
- Published: 2026-07-13T18:51:40.226212

A practical path from account creation to your first successful customer conversation.

Mr. AI handles customer conversations using your business knowledge while keeping your team available whenever human help is needed.

## What to do

1. Complete setup with your business identity, services, hours, and contact details.
2. Add prices, policies, offers, and frequent questions to the Knowledge Base.
3. Test realistic questions before connecting one live channel.

> **Good practice**
> Start with one channel, review the first conversations, and improve missing knowledge before expanding.

[Open Your first steps with Mr. AI](/client/overview)

---

## How to use setup missions

- Language: en
- Section: Start here
- Canonical: https://mrailabs.com/docs/en/getting-started/setup-missions/
- Markdown: https://mrailabs.com/docs/en/getting-started/setup-missions.md
- Published: 2026-07-13T18:51:40.226212

Understand the mission order and how to know when your account is ready.

Setup missions collect the essential launch tasks in one place and recommend the safest next action.

## What to do

1. Open a mission and complete the linked operational settings.
2. Save your work, then return to setup and verify completion.
3. Finish a realistic AI test and connect at least one channel before going live.

> **Good practice**
> Your progress is based on real saved configuration, so you can leave and continue later.

[Open How to use setup missions](/client/onboarding)

---

## Set up your AI employee

- Language: en
- Section: Start here
- Canonical: https://mrailabs.com/docs/en/getting-started/ai-employee-setup/
- Markdown: https://mrailabs.com/docs/en/getting-started/ai-employee-setup.md
- Published: 2026-07-13T18:51:40.226212

Provide business information that helps your AI answer accurately.

Good setup data is specific, current, and written in the same terms your customers use.

## What to do

1. Add your business identity, locations, contact details, and working hours.
2. Describe every service with its price, conditions, duration, and booking requirements.
3. Choose the preferred language, tone, and situations that require a human handoff.

> **Good practice**
> Never store passwords, API keys, or sensitive customer information in AI instructions.

[Open Set up your AI employee](/client/ai-employee-setup)

---

## Test your AI Employee inside Mr. AI

- Language: en
- Section: Start here
- Canonical: https://mrailabs.com/docs/en/getting-started/test-assistant-before-live/
- Markdown: https://mrailabs.com/docs/en/getting-started/test-assistant-before-live.md
- Published: 2026-09-29T19:19:11.235236

Use Test Assistant as a safe space inside your account to try replies, context, images, and audio before relying on a change with customers.

## Where do I test my AI Employee?

Use Test Assistant inside your account. Testing conversations are separate from customer conversations, messages are not delivered to a real customer, and Testing messages do not deduct Customer Points. You can keep a different Chat for each scenario and test Text, Image, and Audio in the current Dashboard interface.

- Use a separate Chat for each important scenario.
- Write like a real customer.
- Start a fresh Chat after a major change.

## Start a clear test

1. Open Test Assistant and create a fresh Testing Chat.
2. Choose one clear scenario: pricing, product discovery, an objection, a conversation stage, or an Action.
3. Write the customer question naturally without feeding the expected answer into it.
4. Continue for multiple turns when context matters.
5. Review the reply, the current stage, and any Action the AI tried to reach.
6. After changing configuration, start a fresh Chat and repeat the same scenario.

## What can you test here?

- The actual reply, speaking style, language, and business identity.
- Multi-turn questions and conversation context.
- Catalog and Deep Knowledge using different customer wording.
- Conversation Stages and progression between stages.
- The AI decision around an Action without executing the real Business Action.
- Text, Image, and Audio in the current Dashboard Testing interface.

## What does Test Assistant not prove?

- It does not execute a real Production Business Action.
- It is not proof that a Booking, Order, Payment, Refund, or Update actually happened.
- It does not deliver a message to a real customer channel.
- It does not schedule a real Follow-up.
- A correct stage inside Testing does not prove that a real Stage Follow-up Task executed.

## Test a change before publishing it

When Testing is opened from a supported Change Proposal, you can evaluate the proposed configuration before applying it to Production. This helps you see the behavior of the change before customer conversations rely on it.

> **Test before publishing**
> Testing is recommended QA, but it is not a mandatory Publish Gate today. Testing before publishing is the safer workflow, but the system does not necessarily block Publish when Testing was skipped.

## Dashboard Testing and AI-assisted Testing limits

Dashboard Testing Chats are managed separately. Session and message limits in the ChatGPT testing guide apply to the AI-assisted Testing service, not to manual Test Assistant usage in the Dashboard.

[Open Test Assistant](/client/settings/test-assistant)

[Read the Testing Playbook](/docs/en/learn/test-ai-employee-before-real-customers/)

[Test with ChatGPT or a connected AI assistant](/docs/en/settings-and-usage/test-ai-employee-with-connected-assistant/)

[Understand the AI Employee quality loop](/docs/en/knowledge-and-behavior/continuous-ai-employee-quality-loop/)

---

## Understand the dashboard overview and alerts

- Language: en
- Section: Start here
- Canonical: https://mrailabs.com/docs/en/getting-started/dashboard-overview-and-insights/
- Markdown: https://mrailabs.com/docs/en/getting-started/dashboard-overview-and-insights.md
- Published: 2026-07-13T18:51:40.226212

Read system, customer, points, and response indicators and decide what to do next.

## What does the Mr. AI dashboard show?

The dashboard summarizes system, customer, channel, and points health, highlights work that needs attention, and shows response activity so you can choose the next action without opening every page.

- Check system and channel health first.
- Open Customer Operations when conversations need a human reply.
- Read response metrics together with conversation volume.

## How to use it

1. Review allowed, pending, and blocked customer counts.
2. Confirm the points balance is above the minimum and live AI is not paused.
3. Review connected channels and manual-work alerts.
4. Read first AI response, first human response, and peak-hour indicators.
5. Use quick actions to open chats, knowledge, or assistant testing.

## Frequently asked questions

### Why is a response metric unavailable?

The selected period does not contain enough valid data.

### Does the overview replace Performance Reports?

No. It is a quick operating summary; Performance Reports provide deeper conversation and action analysis.

[Open this page in Mr. AI](/client/overview)

---

## Understand the Knowledge Base

- Language: en
- Section: Knowledge and AI behavior
- Canonical: https://mrailabs.com/docs/en/knowledge-and-behavior/knowledge-base-overview/
- Markdown: https://mrailabs.com/docs/en/knowledge-and-behavior/knowledge-base-overview.md
- Published: 2026-09-03T20:38:56.667478

Learn where each kind of business information belongs.

## How do I choose the right place for information in the knowledge base?

Store each fact in the source that owns it: products and services in the catalog, offers in Offers, long-form details in Deep Knowledge, and response style or behavior in instruction sections. Clear ownership reduces conflicts and makes weak replies easier to fix.

The Knowledge Base separates structured facts from detailed documents and reply behavior so each source stays easy to maintain.

## What to do

1. Use Products for stable services, items, prices, and availability.
2. Use Offers for temporary promotions and their conditions.
3. Use Documents for detailed policies and Reply Behavior for tone, boundaries, and handoff rules.

> **Good practice**
> Update the smallest correct source instead of repeating the same fact in several places.

[Open Understand the Knowledge Base](/client/knowledge-base)

[Understand grounded business-knowledge replies](/docs/en/knowledge-and-behavior/grounded-ai-replies-from-business-knowledge/)

---

## Catalog 2.0: help Mr. AI understand your products and find the right one

- Language: en
- Section: Knowledge and AI behavior
- Canonical: https://mrailabs.com/docs/en/knowledge-and-behavior/products-and-services/
- Markdown: https://mrailabs.com/docs/en/knowledge-and-behavior/products-and-services.md
- Published: 2026-09-29T19:19:11.235236

Keep products and services in one place, give Mr. AI useful meaning, and support both natural discovery questions and precise customer lookups.

## What is Catalog useful for?

Catalog is the main place for the products and services your AI Employee needs to know. Instead of spreading prices, details, images, and search information across different places, keep each item together so Mr. AI can recommend the right item and answer customer questions accurately.

- If you are building a Catalog from scratch, start by giving AI the item data and business context before creating the items in Catalog.
- Let AI propose the Folders, Semantic Tree / Semantic Classification, Semantic Tags, AI Search Attributes, and Search Names from the full set of items.
- Review that structure, then use Build & Manage with AI to create and place the items. This is the path we currently recommend because it is easier to keep the Catalog consistent and review the work in batches.

## Recommended setup order for a new Catalog

1. Prepare the source that contains your products or services: a file, list, or other clear item data with useful business context.
2. Use Build & Manage with AI and ask it to analyze the whole set and propose Folders for internal organization.
3. Ask it to propose the Semantic Tree / Semantic Classification and useful Semantic Tags from the patterns and meaning across the items.
4. Ask it to propose AI Search Attributes, values, Aliases, and Search Names for precise customer questions, using facts supported by the source.
5. Review the proposals and correct anything that does not match how your business actually works.
6. Once the structure is approved, let AI create the items and attach each one to the right Folder, classification, Tags, and Search Attributes.
7. After indexing, test natural discovery questions and precise lookups in Test Assistant.

## How does Mr. AI search?

- If a customer says, “I need a course that helps me learn sales,” that is a discovery request and semantic search helps find relevant items.
- If the customer says, “show every course by Hassan Faleeh” or “how many courses are in the Cairo branch?”, AI Search Attributes support the more exact lookup.
- When an exact business fact is maintained in Catalog, such as price, instructor, or branch, the system can rely on that structured fact instead of guessing from similarity.

> **Let AI propose the structure first**
> Starting with AI lets it see the item set as a whole and propose one consistent structure instead of designing the Catalog item by item. Review the proposal before publishing: AI can help design and organize the Catalog, while your source data remains the authority for business facts.

## A quick example

1. Give AI the course list and useful context about the business.
2. Ask it to propose Folders, a Semantic Tree, and Tags for the whole set.
3. Ask it to identify useful Attributes such as Instructor and Level, plus Aliases and Search Name where needed.
4. Review the structure, then ask AI to create and place the courses instead of adding every item manually.
5. Review the result, then test one natural discovery question and one precise lookup in Test Assistant.

> **You do not need to rebuild everything**
> Older items and items without Semantic Classification or AI Search Attributes remain valid. These newer layers improve organization and retrieval; they are not required for an item to exist.

## Choose the guide for the step you are on

- Start with “Manage a large Catalog with AI” when you have a source or item set and want AI to propose the structure before creating the items.
- Use “Organize Catalog: Folders, Semantic Classification, and Tags” to understand and review the structure AI proposes.
- Use “Precise search: AI Search Attributes and Search Name” to understand and review exact search facts.
- Use “Add and edit a product or service correctly” as a field-by-field reference for one item or for manual edits.

[Open Products & Services Catalog](/client/knowledge-base/products)

---

## Manage current offers

- Language: en
- Section: Knowledge and AI behavior
- Canonical: https://mrailabs.com/docs/en/knowledge-and-behavior/current-offers/
- Markdown: https://mrailabs.com/docs/en/knowledge-and-behavior/current-offers.md
- Published: 2026-07-13T18:51:40.226212

Publish promotions with clear dates, eligibility, and conditions.

Offers should contain everything the AI needs to explain who qualifies and when the promotion ends.

## What to do

1. Name the offer and describe the customer benefit.
2. Add validity dates, conditions, exclusions, and the related product or service.
3. Disable or update the offer immediately when it expires.

> **Good practice**
> Keep permanent pricing in Products and temporary discounts in Offers.

[Open Manage current offers](/client/knowledge-base/offers)

---

## Add detailed knowledge and files

- Language: en
- Section: Knowledge and AI behavior
- Canonical: https://mrailabs.com/docs/en/knowledge-and-behavior/deep-knowledge-files/
- Markdown: https://mrailabs.com/docs/en/knowledge-and-behavior/deep-knowledge-files.md
- Published: 2026-07-13T18:51:40.226212

Upload policies, FAQs, menus, and guides, then review what the AI will index.

Documents are useful for detailed information that does not fit naturally into a product or offer record.

## What to do

1. Upload a supported PDF, DOCX, or TXT file.
2. Preview and edit the extracted knowledge so only accurate content remains.
3. Approve indexing, then test questions that depend on the document.

> **Good practice**
> Use Update Index after editing an indexed document so old knowledge is replaced.

[Open Add detailed knowledge and files](/client/knowledge-base/deep)

---

## Write clear AI reply instructions

- Language: en
- Section: Knowledge and AI behavior
- Canonical: https://mrailabs.com/docs/en/knowledge-and-behavior/ai-reply-instructions/
- Markdown: https://mrailabs.com/docs/en/knowledge-and-behavior/ai-reply-instructions.md
- Published: 2026-09-03T20:38:56.667478

Control tone, response boundaries, data collection, and human handoff behavior.

## What belongs in AI Employee response instructions?

Use instructions for tone, operating rules, and when a customer should move to a human, rather than copying every business fact into the prompt. Keep rules clear and test their effect across more than one scenario.

Reply instructions describe how the AI should respond; business facts should remain in their proper knowledge source.

## What to do

1. State the preferred language, tone, length, and formatting.
2. Define required customer details and when the AI must not guess.
3. Add explicit human-handoff rules with short examples.

> **Good practice**
> Prefer short, testable rules over long or conflicting prompts.

[Open Write clear AI reply instructions](/client/knowledge-base/instructions)

[Understand grounded business-knowledge replies](/docs/en/knowledge-and-behavior/grounded-ai-replies-from-business-knowledge/)

---

## Design the conversation journey

- Language: en
- Section: Knowledge and AI behavior
- Canonical: https://mrailabs.com/docs/en/knowledge-and-behavior/conversation-builder/
- Markdown: https://mrailabs.com/docs/en/knowledge-and-behavior/conversation-builder.md
- Published: 2026-07-13T18:51:40.226212

Create a clear route from the customer request to the desired outcome.

Conversation Builder organizes stages, goals, and transitions without replacing the underlying business knowledge.

## What to do

1. Define the purpose and completion condition of each stage.
2. Collect only the customer information needed at that point.
3. Publish the draft and test normal, incomplete, and unexpected paths.

> **Good practice**
> Keep a human escape route for cases the automated journey cannot safely complete.

[Open Design the conversation journey](/client/knowledge-base/conversation-builder)

---

## Create a Knowledge Base document with voice

- Language: en
- Section: Knowledge and AI behavior
- Canonical: https://mrailabs.com/docs/en/knowledge-and-behavior/create-knowledge-document-with-voice/
- Markdown: https://mrailabs.com/docs/en/knowledge-and-behavior/create-knowledge-document-with-voice.md
- Published: 2026-07-13T18:51:40.226212

Record an answer and turn it into an editable document before adding it to knowledge.

## How do I create a Knowledge Base document with my voice?

Choose a guided topic, record your answer naturally, then review and edit the generated text before adding it to Documents. The recording does not become approved knowledge until you review and add the document.

- Allow microphone access in the browser.
- State facts and exceptions clearly.
- Correct the draft before adding it to Documents.

## How to use it

1. Choose a prepared topic or create a custom one.
2. Start recording and explain the important details naturally.
3. Stop recording and wait for the draft; processing can continue after you leave the page.
4. Review the generated document and correct errors or missing facts.
5. Add it to Documents and monitor its state in Deep Knowledge.

> **Important**
> Always verify names, prices, and policies after transcription; a clear recording still requires human review.

## Frequently asked questions

### Can I record again?

Yes. You can create another recording before adding the final document.

### What if microphone access fails?

Allow microphone access for the site in browser settings and try again.

[Open this page in Mr. AI](/client/knowledge-base/file-generator)

---

## Write separate instructions for each section

- Language: en
- Section: Knowledge and AI behavior
- Canonical: https://mrailabs.com/docs/en/knowledge-and-behavior/knowledge-base-section-instructions/
- Markdown: https://mrailabs.com/docs/en/knowledge-and-behavior/knowledge-base-section-instructions.md
- Published: 2026-07-13T18:51:40.226212

Give knowledge sources and reply behavior their own rules instead of one mixed note.

## Why should I use instructions by section?

Section Instructions let you define scoped rules for identity, tone, policies, products, offers, documents, conversation flow, and handover/actions. An empty section is omitted from the active instruction block.

- Put each rule in its relevant section.
- Do not duplicate facts across sources.
- Each section supports up to 1,200 characters.

## How to use it

1. Open Knowledge Base, then Instructions by Section.
2. Choose the section matching the rule.
3. Write an actionable instruction with a clear example.
4. Leave unused sections empty instead of adding generic text.
5. Save and test the same scenario in Test Assistant.

## Frequently asked questions

### Which sections are available?

Identity & Business, Tone & Language, Business Policies, Products, Offers, Deep Knowledge, Conversation Flow, and Handover & Actions.

### Do these instructions replace product facts?

No. Facts stay in their source; instructions control how those facts are used.

[Open this page in Mr. AI](/client/knowledge-base/section-instructions)

---

## How AI Employee replies stay grounded in your business knowledge

- Language: en
- Section: Knowledge and AI behavior
- Canonical: https://mrailabs.com/docs/en/knowledge-and-behavior/grounded-ai-replies-from-business-knowledge/
- Markdown: https://mrailabs.com/docs/en/knowledge-and-behavior/grounded-ai-replies-from-business-knowledge.md
- Published: 2026-09-03T20:38:55.983279

Understand how the knowledge base, response instructions, and testing work together to improve answer accuracy and handle missing information safely.

## What does it mean for an AI Employee reply to be grounded in your business knowledge?

Operational facts such as services, prices, hours, and policies should come from the knowledge you maintain in Mr. AI, while response instructions define how the AI Employee uses those facts. If information is missing or a case needs a person, the safe path is to fix the source or hand off instead of inventing an answer.

- Knowledge answers: what facts can the AI Employee rely on?
- Instructions answer: how should those facts be used in the reply?
- Testing exposes gaps before they reach real customers.

## Use this concept when

- A reply is fast but inaccurate or generic.
- The AI Employee answer disagrees with current prices or policies.
- You need to decide whether the problem is missing knowledge or response behavior.

## A stronger improvement path

1. Identify the fact the AI Employee should know.
2. Put it in the right knowledge source instead of repeating it in temporary message patches.
3. Adjust behavior instructions if the problem is how the fact is being used.
4. Test the same intent with multiple phrasings, including a question with no supported answer.
5. Expand live use only after the expected behavior is clear.

> **Important limit**
> No knowledge base makes every question answerable. Some cases should acknowledge missing information or move to a human.

## Quick questions

### Should I repeat the same fact in instructions and the knowledge base?

Prefer one appropriate knowledge source for the fact and use instructions for behavior, so conflicting copies do not drift.

### What should I do after a wrong answer?

First decide whether the source is missing or stale or the instructions caused the AI Employee to use it badly, then fix the source and test again.

[Review the knowledge base overview](/docs/en/knowledge-and-behavior/knowledge-base-overview/)

[Review response instructions](/docs/en/knowledge-and-behavior/ai-reply-instructions/)

[Test the AI Employee](/docs/en/getting-started/test-assistant-before-live/)

[Fix weak answers](/docs/en/troubleshooting/improve-ai-answer-quality/)

---

## Add and edit a product or service correctly

- Language: en
- Section: Knowledge and AI behavior
- Canonical: https://mrailabs.com/docs/en/knowledge-and-behavior/build-and-edit-catalog-items/
- Markdown: https://mrailabs.com/docs/en/knowledge-and-behavior/build-and-edit-catalog-items.md
- Published: 2026-09-29T19:19:11.235236

Start with the information customers actually need, then add images, choices, organization, and search information without mixing their purposes.

## What should I put in a Catalog item first?

If the Catalog structure is already prepared, start with the facts a customer will depend on: a clear name, short summary, useful detail, and price/currency when known. Add choices, images, and notes, then attach the item to the right organization and search information.

- Keep Brief Summary easy to scan.
- Put longer detail in Content instead of overloading the name or summary.
- Double-check price, currency, and Options / Variants because these can appear directly in customer replies.

## Before adding many items

> **Let AI design the structure first**
> For a new Catalog, we recommend starting in Build & Manage with AI: give it your item data and business context, let it propose Folders, the Semantic Tree / Classification, and AI Search Attributes, review the structure, then let it create the items against that structure. Manual creation remains useful for small edits and one-off items, but it is not our recommended path for building a full Catalog.

## Core item data

- Name: a label customers and your team can recognize easily.
- Price / Money: the known amount and currency.
- Options / Variants: sizes, types, packages, or other customer choices when applicable.
- Brief Summary: one or two lines that explain the item quickly.
- Content: extra detail customers may need before deciding.
- AI Usage Guidance / Internal Notes: internal guidance for how the AI should use the item, not a customer-facing fact.
- Customer Delivery Note: supporting context that can be used when presenting the item to a customer.

## Images

Add images that genuinely help the customer understand the product or service. Catalog supports multiple images depending on the creation flow, so review the saved result and confirm the media belongs to the intended item.

## After the item facts are correct

- Use a Folder when your goal is team organization inside the dashboard.
- Use Semantic Classification and Semantic Tags when you want to add meaning for natural discovery.
- Use AI Search Attributes for recurring exact facts such as Instructor, Brand, Branch, or Level.
- Use Search Name in search information when a stable machine-friendly name helps the system recognize the same entity across language or spelling differences.

## Using AI Improve

AI Improve can propose Catalog changes, but it is not the source of truth for your business data. Review any proposed price, name, classification, or search information before accepting it.

> **Accuracy matters more than filling every field**
> If a fact is unknown, leave it missing instead of letting AI guess. A smaller accurate Catalog is better than a larger one filled with unreliable details.

[Open Catalog](/client/knowledge-base/products)

---

## How to continuously improve an AI Employee after launch

- Language: en
- Section: Knowledge and AI behavior
- Canonical: https://mrailabs.com/docs/en/knowledge-and-behavior/continuous-ai-employee-quality-loop/
- Markdown: https://mrailabs.com/docs/en/knowledge-and-behavior/continuous-ai-employee-quality-loop.md
- Published: 2026-09-03T20:38:55.983279

Use a repeatable quality loop that connects knowledge, instructions, testing, real conversations, and targeted improvement instead of random reply edits.

## How should you improve an AI Employee after it starts handling customers?

Treat quality as a loop: observe a weak reply or stalled step, identify whether the cause is knowledge, instructions, conversation flow, an Action, or a need for human intervention, fix the correct source, test the scenario again, then observe the result after applying the change. Avoid creating a separate reply patch for every symptom.

- Start from a specific real case.
- Fix the source, not only the visible symptom.
- Review and testing come before applying a change.

## The practical quality loop

1. Capture one clear weak reply or stalled customer step.
2. Classify the cause: knowledge, instructions, journey, Action, or human intervention.
3. Change the smallest source that removes the cause.
4. Test success, failure, and nearby variants of the scenario.
5. Apply the change and review later conversations to ensure the issue did not move elsewhere.

## Where Mr. AI tools fit

- Knowledge and response instructions fix the source.
- Test Assistant verifies behavior before live use.
- Customer Operations and Client Actions organize cases needing human work.
- Build & Manage with AI can optionally help prepare supported changes while review and testing stay part of the Mr. AI workflow.

> **Do not test only one example**
> One improved example is not proof that every related case is correct. Test more than one phrasing and keep human intervention for situations that require it.

[Test the AI Employee](/docs/en/getting-started/test-assistant-before-live/)

[Review the knowledge base overview](/docs/en/knowledge-and-behavior/knowledge-base-overview/)

[Fix weak answers](/docs/en/troubleshooting/improve-ai-answer-quality/)

---

## Organize Catalog: Folders, Semantic Classification, and Tags

- Language: en
- Section: Knowledge and AI behavior
- Canonical: https://mrailabs.com/docs/en/knowledge-and-behavior/organize-catalog-and-bulk-actions/
- Markdown: https://mrailabs.com/docs/en/knowledge-and-behavior/organize-catalog-and-bulk-actions.md
- Published: 2026-09-29T19:19:11.235236

Separate team organization from AI-visible meaning, then use filters and bulk actions to manage a large Catalog safely.

## What is the difference between a Folder, Semantic Classification, and a Tag?

A Folder organizes the Catalog for people inside the dashboard. Semantic Classification places an item inside a hierarchy of meaning the AI can use. Semantic Tags add flexible meaning that can apply across items in different parts of that hierarchy. For a new Catalog, we recommend letting AI analyze the item set and propose these structures first, then reviewing them before item creation.

- Folder is for team organization.
- Semantic Classification is for hierarchical AI-visible meaning.
- Semantic Tags are flexible meaning labels shared across different items.

## Semantic Classification or Semantic Tree

You can build a semantic path up to three levels deep. For example: Education > Courses > Professional Skills. Not every item needs all three levels; use only enough depth to make the meaning clearer.

## When should I use Semantic Tags?

- When a useful meaning applies to items across different classifications, such as “beginner friendly” or “online” when that meaning helps discovery.
- When you want to add flexible meaning without moving the item to another place in the Semantic Tree.
- Do not use a Tag instead of an exact business fact that should be an AI Search Attribute.

## A simple comparison

- Folder: September Offers — so the team can find campaign items quickly.
- Semantic Classification: Education > Courses > Sales — so AI understands the item type and context.
- Semantic Tag: Beginner Friendly — a flexible meaning that may appear across different course groups.
- AI Search Attribute: Instructor = Hassan Faleeh — an exact fact customers can ask about directly.

## Managing many items

1. Use Search plus status, Folder, and Semantic Classification filters to identify the target set.
2. Review the matching count before selecting everything.
3. Use cross-page bulk selection when the interface supports it and the filtered results are the intended set.
4. Apply the change only to that set, then monitor reindexing when the change affects AI-visible meaning.

> **For large Catalogs**
> The current safe interactive bulk limit for Semantic Classification is 500 items. If more items match, narrow your filters and split the work instead of applying one oversized change.

## If reindexing starts

- Large changes may continue in the background.
- Monitor the operation in Catalog instead of assuming a page refresh cancelled it.
- If failed items appear and a supported Retry action is available, retry the affected items rather than repeating the entire operation.

[Open and organize Catalog](/client/knowledge-base/products)

---

## Manage a large Catalog with AI

- Language: en
- Section: Knowledge and AI behavior
- Canonical: https://mrailabs.com/docs/en/knowledge-and-behavior/manage-catalog-with-ai/
- Markdown: https://mrailabs.com/docs/en/knowledge-and-behavior/manage-catalog-with-ai.md
- Published: 2026-09-29T19:19:11.235236

Use Build & Manage with AI to create, organize, and update Catalog data in reviewable batches instead of editing hundreds of items manually.

## How do I use AI with a large Catalog without losing control?

We currently recommend starting in Build & Manage with AI before creating the items: give it the product or service list and business context, let it propose Folders, Semantic Tree / Classification, Tags, AI Search Attributes, and Search Names, review the structure, then let it create and place the items in reviewable batches.

- Let AI analyze the whole set before item creation.
- Review the proposed structure and business facts, then apply bounded Proposals.
- After Publish and indexing, test the result with realistic customer questions.

## Recommended order for a large file or list

1. Give AI the source containing the products or services, useful business context, and the goal of the Catalog.
2. Ask it to analyze the full set and propose Folders, the Semantic Tree, and Tags before creating items.
3. Ask it to propose AI Search Attributes, values, Aliases, and Search Names that support precise questions without inventing unsupported business facts.
4. Review and adjust the proposed structure and facts where human input is needed.
5. Once approved, let AI create the items and place them into the right structure and values in reviewable batches. The current Catalog AI contract accepts at most 100 items in one logical proposal.
6. Review → Publish → allow required indexing to finish → test in Test Assistant.

## Example: a 1,000-item Catalog

Having 1,000 items does not mean sending 1,000 direct edits in one operation. Split the work into clear batches so a mistake can be stopped, reviewed, and retried without putting the entire Catalog into one change.

> **AI helps; it is not the source of truth**
> Pay special attention to price, currency, item names, and exact search values. AI can help with organization, but your source data remains the authority for business facts.

## After each batch

- Confirm the intended items were created or changed.
- Monitor any required reindexing.
- Test one natural discovery question.
- Test an exact lookup or count when you added AI Search Attributes.
- Start a fresh Test after an important change so old conversation context does not hide the result.

## Frequently asked questions

### Do I need to create 1,000 items manually?

No. AI can help organize and prepare changes, but large work should still be split into reviewable batches rather than one unreviewable one-shot operation.

### Can AI invent a Search Name or a missing value?

AI may suggest a search-friendly form, but you should confirm it represents the same real fact. Missing business values should stay missing until you have a reliable source.

[Open Catalog](/client/knowledge-base/products)

---

## Precise search: AI Search Attributes and Search Name

- Language: en
- Section: Knowledge and AI behavior
- Canonical: https://mrailabs.com/docs/en/knowledge-and-behavior/catalog-ai-search-attributes/
- Markdown: https://mrailabs.com/docs/en/knowledge-and-behavior/catalog-ai-search-attributes.md
- Published: 2026-09-29T19:19:11.235236

Use structured facts and stable search names so Mr. AI can answer precise questions such as “all products from this brand” or “how many courses does this instructor have?”.

## When do I need AI Search Attributes?

Use them for recurring exact facts that customers may ask about directly, such as instructor, brand, branch, level, or duration. Instead of relying only on text similarity, you give Mr. AI structured information it can use for precise lookup, filtering, and counting.

- Attribute = the type of fact, such as Instructor.
- Value = the fact attached to an item, such as Hassan Faleeh.
- Aliases and Search Name help the system recognize that same value across different wording.

> **Let AI propose precise search information**
> When you are preparing a new Catalog, let AI analyze the item set and propose the Attributes, values, Aliases, and Search Names that emerge from the business data before the items are created. Review the proposal: AI is useful for spotting patterns, but it must not invent a business fact that is absent from the source.

## Supported value types

- Text: an exact text fact such as an instructor or branch.
- Enum: a value from a known recurring set such as Level or Category.
- Number: a numeric fact such as Duration or Capacity when supported comparisons matter.
- Boolean: a clear yes/no fact such as Online.

## What is the difference between Value, Alias, and Search Name?

- Value is the main value that represents the fact inside Catalog.
- Alias is another way to write the same value, not a different value. For example, حسن فليح and Hassan Faleeh can be aliases when both identify the same person.
- Search Name is a stable machine-friendly name that helps the system connect the value to different language or spelling forms.
- Search Name does not replace the customer-facing name; it helps retrieval understand what the name refers to.

## Search Name format

- Use lowercase English letters.
- Use a single space between words.
- Do not use digits, underscores, hyphens, punctuation, or uppercase letters.
- Example: أمنية علي عامر can use omnia ali amer as its Search Name.
- Example: العربية can use arabic when that is the intended value.

## How does Mr. AI use it?

The system first tries to resolve what the customer actually wrote. If that value is not clear enough, Search Name can help connect it to the same entity through a stable form. If the result is still ambiguous, the system should avoid forcing a precise filter that could return the wrong item and can fall back to the safer semantic path.

## Attribute or Semantic Tag?

- Use an Attribute for an exact fact that can support direct lookup, filtering, or counting.
- Use a Semantic Tag for flexible discovery meaning that is not maintained as an exact business field.
- Do not turn AI inference or assumptions into hard Attributes without a reliable source.

> **Use structured facts for precise questions**
> Example: if you have 40 courses and customers ask “show every course by Omnia,” an Instructor Attribute with the correct value and Search Name is much stronger than depending on the instructor name appearing somewhere in every course description.

## What about older items?

Items without AI Search Attributes continue to be searchable and usable. Add Attributes gradually where you need higher precision instead of trying to convert the entire Catalog at once.

## Updating or disabling an Attribute

Definitions can be changed or disabled. When an Attribute already has values attached to items, use the safer Disable path when the product requires it instead of removing existing relationships unexpectedly.

[Open Catalog search information](/client/knowledge-base/products)

---

## Choose and connect a customer channel

- Language: en
- Section: Channels and launch
- Canonical: https://mrailabs.com/docs/en/channels-and-launch/connect-channels/
- Markdown: https://mrailabs.com/docs/en/channels-and-launch/connect-channels.md
- Published: 2026-07-13T18:51:40.226212

Prepare your account before connecting WhatsApp, Facebook, or website chat.

Connect one channel after knowledge and testing are ready, then validate the complete customer experience.

## What to do

1. Choose the channel your customers actively use.
2. Confirm AI replies, subscription status, and sufficient points.
3. Connect the channel and send a new message from a separate customer account.

> **Good practice**
> Do not launch every channel at once; validate one reliable path first.

[Open Choose and connect a customer channel](/client/settings/connect)

---

## Connect WhatsApp with a QR code

- Language: en
- Section: Channels and launch
- Canonical: https://mrailabs.com/docs/en/channels-and-launch/connect-whatsapp-qr/
- Markdown: https://mrailabs.com/docs/en/channels-and-launch/connect-whatsapp-qr.md
- Published: 2026-07-13T18:51:40.226212

Link WhatsApp safely and verify incoming and outgoing messages.

The QR flow links a WhatsApp session to Mr. AI so customer messages can enter the shared inbox.

## What to do

1. Generate a fresh QR code and scan it from WhatsApp linked devices.
2. Wait until the dashboard reports a connected state.
3. Send a test from another number and confirm both receipt and reply.

> **Good practice**
> If the session expires, remove the stale linked device and generate a new QR code.

[Open Connect WhatsApp with a QR code](/client/settings/connect/whatsapp)

---

## Connect Facebook Messenger

- Language: en
- Section: Channels and launch
- Canonical: https://mrailabs.com/docs/en/channels-and-launch/connect-facebook-messenger/
- Markdown: https://mrailabs.com/docs/en/channels-and-launch/connect-facebook-messenger.md
- Published: 2026-07-13T18:51:40.226212

Configure your Page connection, webhook, and permissions.

Messenger requires a valid Page connection and Meta webhook subscriptions before real messages can arrive.

## What to do

1. Provide the Page ID and a valid Page access token.
2. Verify the callback URL and subscribe to the required messaging events.
3. Use connection testing, then send a real message to the Page.

> **Good practice**
> Keep tokens private and replace them whenever permissions or Page ownership changes.

[Open Connect Facebook Messenger](/client/settings/connect/facebook)

---

## Add Mr. AI chat to your website

- Language: en
- Section: Channels and launch
- Canonical: https://mrailabs.com/docs/en/channels-and-launch/website-chat-widget/
- Markdown: https://mrailabs.com/docs/en/channels-and-launch/website-chat-widget.md
- Published: 2026-07-13T18:51:40.226212

Customize, install, and test the website chat widget.

The website widget gives visitors a direct chat experience using the same AI knowledge and controls.

## What to do

1. Choose appearance, greeting, behavior, and allowed domains.
2. Save settings and copy the current installation snippet into the website.
3. Test on desktop and mobile from a private browser window.

> **Good practice**
> The widget will not load on a domain that is missing from the allowed-domain list.

[Open Add Mr. AI chat to your website](/client/settings/connect/website)

---

## Add and manage multiple WhatsApp numbers

- Language: en
- Section: Channels and launch
- Canonical: https://mrailabs.com/docs/en/channels-and-launch/manage-multiple-whatsapp-numbers/
- Markdown: https://mrailabs.com/docs/en/channels-and-launch/manage-multiple-whatsapp-numbers.md
- Published: 2026-07-13T18:51:40.226212

Name each connection, scan its QR code, and rescan or manage it without targeting another number.

## Can I connect more than one WhatsApp number to Mr. AI?

The WhatsApp connection page supports multiple connections. When adding a number, you name the connection and scan its own QR code. Rescanning an existing connection uses its identifier so the QR is not generated for another number.

- Use a clear name for each number.
- Scan with the correct phone.
- Test every connection from an external number.

## How to use it

1. Open Settings, Connect, then WhatsApp.
2. Add a device or number and enter a branch or purpose name.
3. Scan the QR code from Linked Devices on the intended phone.
4. Wait for Connected status and test an inbound message.
5. Use rescan on the specific connection after a phone change or expired session.

## Frequently asked questions

### Does adding a number disconnect the primary number?

No. Each connection is managed independently unless you remove or disconnect it.

### Why name each connection?

Names help the team distinguish numbers and branches and avoid scanning a QR for the wrong connection.

[Open this page in Mr. AI](/client/settings/connect/whatsapp)

---

## Connect your application with the System API

- Language: en
- Section: Channels and launch
- Canonical: https://mrailabs.com/docs/en/channels-and-launch/system-api-chat-integration/
- Markdown: https://mrailabs.com/docs/en/channels-and-launch/system-api-chat-integration.md
- Published: 2026-07-13T18:51:40.226212

Create an independent chat key, call the chat endpoint, and revoke the key when needed.

## How do I use the System API inside my application?

Create a clearly named key on the System API page, copy it when it is shown once, then POST to /api/v1/chat using a Bearer token plus a stable user_id and message. The keys are chat-only and never expose the internal system key.

- The plaintext secret is shown only once.
- Use a stable user_id per customer for correct context.
- Revoke a key immediately if it may be exposed.

## How to use it

1. Open Settings, Connect, then API.
2. Name and create the key, then copy its secret immediately.
3. Store the key in a server-side secret manager or environment variable.
4. POST to /api/v1/chat with Authorization: Bearer and a JSON body.
5. Review last-used information and revoke unused keys.

> **Important**
> Never publish the key in GitHub, public JavaScript, or screenshots. Revoking it immediately stops applications that use it.

## Frequently asked questions

### Should I place the key in browser or mobile code?

No. Proxy the request through a backend you control so users cannot extract the secret.

### Can I display the same key again?

No. The complete value is shown once; create a new key if it is lost.

[Open this page in Mr. AI](/client/settings/connect/api)

---

## Use chats and conversation controls

- Language: en
- Section: Conversations and customers
- Canonical: https://mrailabs.com/docs/en/conversations-and-customers/chats-and-control/
- Markdown: https://mrailabs.com/docs/en/conversations-and-customers/chats-and-control.md
- Published: 2026-07-13T18:51:40.226212

Review customer conversations and control AI participation.

The chats workspace shows conversation history, customer state, and the controls used to pause or resume AI replies.

## What to do

1. Open a customer to review messages in chronological context.
2. Pause AI or take manual control before sending a human reply.
3. Resume automation only after the handoff or issue is complete.

> **Good practice**
> Always confirm the active conversation and customer before changing AI control.

[Open Use chats and conversation controls](/client/clients/chats)

---

## Use the Conversation Management Center

- Language: en
- Section: Conversations and customers
- Canonical: https://mrailabs.com/docs/en/conversations-and-customers/manual-reply-hub/
- Markdown: https://mrailabs.com/docs/en/conversations-and-customers/manual-reply-hub.md
- Published: 2026-07-13T18:51:40.226212

Track AI-handled conversations and quickly find conversations that need your team.

The Conversation Management Center brings AI-active conversations, conversations waiting for your team, recent team replies, assignment, and conversation history together.

## What to do

1. Choose AI employee replying, Waiting for your team, or Recent team replies.
2. Read recent messages and internal context before replying.
3. Resolve the team task and return the conversation to the AI employee only when appropriate.

> **Good practice**
> Coordinate ownership so two team members do not answer the same customer at once.

[Open Use the Conversation Management Center](/client/clients/manual-hub)

---

## Organize customer profiles

- Language: en
- Section: Conversations and customers
- Canonical: https://mrailabs.com/docs/en/conversations-and-customers/customer-profiles/
- Markdown: https://mrailabs.com/docs/en/conversations-and-customers/customer-profiles.md
- Published: 2026-07-13T18:51:40.226212

Keep customer identity, status, notes, and conversation context useful.

Customer profiles help the team understand who is speaking and what has already happened.

## What to do

1. Review and correct core contact details.
2. Use notes and status fields for relevant operational context.
3. Open the linked conversation or actions when following up.

> **Good practice**
> Store only information your team genuinely needs and is allowed to retain.

[Open Organize customer profiles](/client/clients/profiles)

---

## Track customer actions

- Language: en
- Section: Conversations and customers
- Canonical: https://mrailabs.com/docs/en/conversations-and-customers/client-actions/
- Markdown: https://mrailabs.com/docs/en/conversations-and-customers/client-actions.md
- Published: 2026-09-03T20:38:56.667478

Follow bookings, requests, leads, and other outcomes collected during conversations.

Customer Actions turn conversation outcomes into trackable work for your team.

## What to do

1. Filter by action type, status, customer, or date.
2. Open the source conversation before updating an unclear action.
3. Assign or update the action and record its final outcome.

> **Good practice**
> Use consistent statuses so reports represent real operational progress.

[Open Track customer actions](/client/actions)

[Learn how to identify conversations that need follow-up](/docs/en/learn/identify-customers-who-need-follow-up/)

---

## Understand performance reports

- Language: en
- Section: Conversations and customers
- Canonical: https://mrailabs.com/docs/en/conversations-and-customers/performance-reports/
- Markdown: https://mrailabs.com/docs/en/conversations-and-customers/performance-reports.md
- Published: 2026-09-03T20:38:56.667478

Read customer-action and response metrics in the right context.

Performance reports summarize activity over a selected period and help identify bottlenecks or missed follow-up.

## What to do

1. Choose a date range and relevant filters.
2. Compare volume, completion, response, and team performance metrics.
3. Open the underlying records before making decisions from an unusual number.

> **Good practice**
> Trends across comparable periods are more useful than one isolated total.

[Open Understand performance reports](/client/actions/performance-report)

> **Turn the report into an operating decision**
> Use reports with Customer Operations and Client Actions to understand where conversations stop and what needs follow-up or team intervention.

[Read the guide to finding customers who need follow-up](/docs/en/learn/identify-customers-who-need-follow-up/)

[Understand conversation intelligence](/docs/en/conversations-and-customers/conversation-intelligence-for-customer-operations/)

---

## Use the Customer Operations inbox

- Language: en
- Section: Conversations and customers
- Canonical: https://mrailabs.com/docs/en/conversations-and-customers/customer-operations-inbox/
- Markdown: https://mrailabs.com/docs/en/conversations-and-customers/customer-operations-inbox.md
- Published: 2026-09-03T20:38:56.667478

Review conversations needing human attention and coordinate work without duplicate replies.

## What is the Customer Operations inbox in Mr. AI?

Customer Operations is the human team’s daily work queue. It brings together conversations that need review or a manual reply and shows AI and unread state so important customer work does not disappear inside the full chat list.

- Start with conversations that need a reply.
- Read the context before intervening.
- Resume AI only when the conversation is ready.

## How to use it

1. Open Customer Operations from the sidebar.
2. Review queue counters and use search or filters.
3. Open a conversation and read recent customer and team messages.
4. Reply manually or change AI state when needed.
5. Complete the work and move to the next item.

## Frequently asked questions

### Why can I not reply to a conversation?

Another team member may hold the conversation lock to prevent conflicting replies.

### How is it different from Chats & Control?

Chats & Control covers the full customer and conversation list; Customer Operations focuses on the current human-work queue.

[Open this page in Mr. AI](/client/operations/inbox)

[Learn how to identify conversations that need follow-up](/docs/en/learn/identify-customers-who-need-follow-up/)

[Understand Customer Operations vs Client Actions](/docs/en/conversations-and-customers/customer-operations-vs-client-actions/)

[Understand human handoff and AI resumption](/docs/en/conversations-and-customers/human-ai-handoff-and-resume/)

---

## Manage customer profiles and contact data

- Language: en
- Section: Conversations and customers
- Canonical: https://mrailabs.com/docs/en/conversations-and-customers/manage-customer-profiles-and-contact-data/
- Markdown: https://mrailabs.com/docs/en/conversations-and-customers/manage-customer-profiles-and-contact-data.md
- Published: 2026-07-13T18:51:40.226212

Store contact details, preferences, and internal notes, and handle duplicate or archived profiles without losing chat history.

## What can I store in a Customer Profile in Mr. AI?

You can store the primary and additional phone numbers, email, social links, preferred contact method, speaking style, business type, and internal notes. Archiving a profile does not remove its linked chat history.

- Keep one profile per customer when possible.
- Review duplicate warnings before adding an existing number.
- Use structured fields for operational facts and Notes for internal context.

## Create or update a customer profile

1. Open Clients and Customer Profiles, then search before creating a new profile.
2. Add the primary phone, then additional numbers, email, and social links when available.
3. Set contact preference, speaking style, and business type when useful to the team.
4. Write clear internal notes that are not sent to the customer.
5. Save and review the linked conversation to confirm the correct profile is used.

## Review regularly

- Old or unused phone numbers and links.
- Duplicate profiles created from different channels.
- Notes that have become outdated or inaccurate.
- Archived profiles the team needs to display again.

## Frequently asked questions

### Does archiving delete conversations?

No. The profile can leave the active list while its linked chat history remains available.

### Why does an existing-phone warning appear?

The system is preventing a duplicate profile. Search for and update the existing profile.

### Can customers see internal profile notes?

Profile notes organize internal team work and are not automatically sent to the customer.

[Open Customer Profiles](/client/clients/profiles)

---

## Manage the Client Actions workflow

- Language: en
- Section: Conversations and customers
- Canonical: https://mrailabs.com/docs/en/conversations-and-customers/manage-client-actions-workflow/
- Markdown: https://mrailabs.com/docs/en/conversations-and-customers/manage-client-actions-workflow.md
- Published: 2026-09-03T20:38:56.667478

Review required actions, open the source conversation, add team notes, then complete or reopen the action.

## How do I use Client Actions to follow customer requests?

Client Actions collects cases that require a team step, such as follow-up, pending replies, orders, bookings, or cancellations. Filter the list, review details and the source chat, add notes, then mark the action complete or reopen it.

- Start with Pending and high-priority actions.
- Read the source conversation before deciding.
- Use Done only after the required operational step is complete.

## Recommended workflow

1. Open Client Actions and select Pending.
2. Filter by type, category, and date.
3. Open the action and read its description, fields, and existing notes.
4. Open the source conversation when you need context or must contact the customer.
5. Add a company note and mark Done, or reopen the action when work returns.

> **Accurate status**
> Completing an action means the required work is finished, not only that a team member opened the card.

## Frequently asked questions

### Can I reopen a completed action?

Yes. Use Reopen when the action requires new work.

### When should I export CSV?

Use it for an authorized operational review outside the system while protecting customer data.

### How is Client Actions different from Customer Operations?

Client Actions tracks a required task or result; Customer Operations organizes conversations requiring human attention now.

[Open Client Actions](/client/actions)

[Learn how to identify conversations that need follow-up](/docs/en/learn/identify-customers-who-need-follow-up/)

[Understand Customer Operations vs Client Actions](/docs/en/conversations-and-customers/customer-operations-vs-client-actions/)

---

## When to use automatic follow-up versus manual follow-up

- Language: en
- Section: Conversations and customers
- Canonical: https://mrailabs.com/docs/en/conversations-and-customers/automatic-vs-manual-customer-follow-up/
- Markdown: https://mrailabs.com/docs/en/conversations-and-customers/automatic-vs-manual-customer-follow-up.md
- Published: 2026-09-03T20:38:55.983279

Choose automatic follow-up, a human reply, or a Client Action based on the open step and customer context instead of using one follow-up pattern for every case.

## When should follow-up be automatic and when should a human handle it?

Use automatic follow-up when there is a clear unfinished customer step that can be reminded safely. Use a human reply when the case needs judgment, an exception, or negotiation. If the next step is internal work for the team, track it as a Client Action instead of messaging the customer before that work is done.

- Automatic Follow-up reopens a conversation with useful context.
- Customer Operations organizes human work needing attention now.
- Client Actions tracks an operational step until completion.

## Three different jobs

- Remind the customer: use Follow-up when a customer-side step is open.
- Intervene with the customer: use Customer Operations when a person needs to review or reply.
- Complete internal work: use a Client Action when the team owes a task or outcome.

## Ask before following up

1. Is there a meaningful open step?
2. Does the next message require human judgment?
3. Is there internal work that must happen first?
4. Has the customer situation changed or have they asked to stop?
5. Choose the least disruptive workflow that keeps ownership clear.

> **Context matters more than message age**
> Silence alone does not make a conversation a qualified lead and does not justify an automated message sequence.

[Configure automatic follow-up](/docs/en/settings-and-usage/automatic-customer-follow-up-settings/)

[Open Customer Operations](/docs/en/conversations-and-customers/customer-operations-inbox/)

[Review Client Actions](/docs/en/conversations-and-customers/manage-client-actions-workflow/)

---

## Stage Follow-up Automation

- Language: en
- Section: Conversations and customers
- Canonical: https://mrailabs.com/docs/en/conversations-and-customers/stage-follow-up-automation/
- Markdown: https://mrailabs.com/docs/en/conversations-and-customers/stage-follow-up-automation.md
- Published: 2026-09-19T23:45:18.097139

Automate follow-up when a customer stays inactive in a published stage for a time you choose.

## What is Stage Follow-up Automation in Mr. AI?

This feature watches the customer's published Conversation Builder stage. If the customer stays in the selected stage without replying for the configured time, the system runs a defined outcome: create a team task, schedule an AI follow-up, or try an AI follow-up and then create a human task when needed. The current release is specifically based on customer inactivity inside a stage; it is not a general-purpose rules engine for arbitrary conditions.

- The current trigger is customer inactivity inside a published stage.
- New rules never create work from historical stage events that happened before the rule was published.
- Opening the page does not invoke AI or create work; execution reacts to persisted server-side stage events in the background.

## How to use it

1. Open Customer Operations, then Stage Follow-up Automation.
2. Choose an active stage from the published Conversation Builder and set the customer inactivity duration.
3. Choose the outcome: team task, AI follow-up, or AI follow-up followed by a human task.
4. For a team task, configure work type, priority, assignment, due time, escalation, or expiry as needed.
5. Save a draft, then publish the rule. Monitor generated work in Operations Inbox.

> **Important**
> If an outcome uses AI follow-up, AI Follow-up Automation must already be enabled and valid for the account.

## Frequently asked questions

### How is this different from normal Follow-up Automation?

Normal Follow-up Automation configures general conversation follow-up messages. Stage Follow-up Automation ties execution to a specific published Conversation Builder stage and can create human work or use AI follow-up.

### What happens if Conversation Builder changes?

The rule is tied to the published Builder version. After the Builder changes, the rule may become stale and should be reviewed and republished before relying on it.

### Can Testing Chat create real tasks?

No. Testing Chat stage events are excluded from live rule execution.

[Open Stage Follow-up Automation](/client/operations/rules)

---

## How human takeover and AI resumption work in one conversation

- Language: en
- Section: Conversations and customers
- Canonical: https://mrailabs.com/docs/en/conversations-and-customers/human-ai-handoff-and-resume/
- Markdown: https://mrailabs.com/docs/en/conversations-and-customers/human-ai-handoff-and-resume.md
- Published: 2026-09-03T20:38:55.983279

Understand when a person should intervene, how AI should avoid conflicting with a manual reply, and when the AI Employee can safely resume.

## How do you prevent a human and the AI Employee from conflicting in the same conversation?

Treat human intervention as an explicit operating state. When a customer needs a person or the team replies manually, the team should check AI state and work from the human queue. After the exception or sensitive step is complete, AI can resume according to the Takeover configuration rather than because someone simply assumes the conversation is ready.

- Human intervention is part of the service design, not a failure.
- The team should understand conversation state before sending a reply.
- AI should resume only when the context is suitable for automation again.

## When a person should step in

- The customer explicitly asks for a person.
- An exception, complaint, or decision needs human authority.
- Information is not available and must be verified.
- Another automated reply could create conflict or misunderstanding.

## A safe handoff flow

1. Open the case from Customer Operations and read the context.
2. Check the AI state before replying manually.
3. Complete the human reply or operational action.
4. Keep AI paused while the case still needs human ownership.
5. Resume AI when the exception is complete and the context is suitable again.

> **Resumption depends on configuration**
> Pause duration or persistent manual mode determines how AI returns. Do not assume one duration is right for every business.

[Review Human Takeover settings](/docs/en/settings-and-usage/human-takeover-pause-settings/)

[Open Customer Operations](/docs/en/conversations-and-customers/customer-operations-inbox/)

---

## Customer Operations vs Client Actions: what is the difference?

- Language: en
- Section: Conversations and customers
- Canonical: https://mrailabs.com/docs/en/conversations-and-customers/customer-operations-vs-client-actions/
- Markdown: https://mrailabs.com/docs/en/conversations-and-customers/customer-operations-vs-client-actions.md
- Published: 2026-09-03T20:38:55.983279

Use Customer Operations for conversations needing human attention and Client Actions for a task or outcome the team must track to completion.

## What is the difference between Customer Operations and Client Actions in Mr. AI?

Customer Operations answers: which conversation needs human attention or a reply now? Client Actions answers: what task or outcome must the team complete and track? A case can start in Customer Operations and create a Client Action, but the two tools do not represent the same job.

- Operations = current human conversation queue.
- Actions = a task or outcome tracked until completion.
- Opening a conversation is not the same as completing the required action.

## Choose the tool by the question

- Who needs a reply now? Start in Customer Operations.
- What did the team promise to do? Review Client Actions.
- Was the work completed or only read? The Action status should reflect the real operational step.

## Example workflow

1. A customer requests a change or booking that needs a person.
2. The conversation enters the human workflow for context review and response.
3. If a task must be completed, track it as a Client Action.
4. After completing the task, update its status and continue the appropriate customer communication.

## Quick questions

### Does every Operations conversation need an Action?

No. Some cases need only a human response with no separate task.

### Does every Action require customer follow-up?

No. Some Actions are internal; send a follow-up only when there is a real reason to contact the customer.

[Open Customer Operations](/docs/en/conversations-and-customers/customer-operations-inbox/)

[Review Client Actions](/docs/en/conversations-and-customers/manage-client-actions-workflow/)

---

## How to use conversation data to understand customers and improve follow-up

- Language: en
- Section: Conversations and customers
- Canonical: https://mrailabs.com/docs/en/conversations-and-customers/conversation-intelligence-for-customer-operations/
- Markdown: https://mrailabs.com/docs/en/conversations-and-customers/conversation-intelligence-for-customer-operations.md
- Published: 2026-09-03T20:38:55.983279

Connect conversation context with customer profiles, actions, and reports to understand open work and recurring patterns without treating analysis as the operational source of truth.

## What does Conversation Intelligence mean in the Mr. AI operating workflow?

It means using available conversation context, customer profile data, actions, and reports to understand the customer situation, open next step, and performance patterns. The real conversations and actions remain operational source data; summaries or analysis help the team understand them but do not replace the original facts for important decisions.

- Customer Profiles organize useful customer context.
- Client Actions turns work into something trackable.
- Reports help the team see patterns after work is performed.

## Questions the workflow can help organize

- What did the customer ask for and what remains open?
- Does the team owe an action or does the customer need a follow-up message?
- Are certain case types or bottlenecks recurring?
- What knowledge or operating rule should be improved because of repeated issues?

## Use the data without overclaiming

1. Start from the actual conversation or Action.
2. Review the Customer Profile for relevant structured context.
3. Use reports to understand patterns, not to judge an individual case without context.
4. Turn the finding into a concrete change: knowledge, Action, Follow-up, or human intervention.

> **Analysis limits**
> Do not assume every conversation is a lead or every summary is real-time analysis. Use only the states and data the product actually exposes.

[Review Customer Profiles](/docs/en/conversations-and-customers/manage-customer-profiles-and-contact-data/)

[Review Client Actions](/docs/en/conversations-and-customers/manage-client-actions-workflow/)

[Review Performance Reports](/docs/en/conversations-and-customers/performance-reports/)

---

## Understand system and reply settings

- Language: en
- Section: Settings and usage
- Canonical: https://mrailabs.com/docs/en/settings-and-usage/system-settings/
- Markdown: https://mrailabs.com/docs/en/settings-and-usage/system-settings.md
- Published: 2026-07-13T18:51:40.226212

Configure automation, languages, limits, and operational behavior.

System settings affect how the account responds across channels, so changes should be tested before broad rollout.

## What to do

1. Review each setting and its current scope.
2. Change one behavior at a time and save it.
3. Test a new conversation on the affected channel.

> **Good practice**
> Document important operational changes so the team understands the new behavior.

[Open Understand system and reply settings](/client/settings/system)

---

## Build & Manage with AI: start here

- Language: en
- Section: Settings and usage
- Canonical: https://mrailabs.com/docs/en/settings-and-usage/build-and-manage-with-ai/
- Markdown: https://mrailabs.com/docs/en/settings-and-usage/build-and-manage-with-ai.md
- Published: 2026-08-30T12:41:09.172773

Understand the two supported AI improvement paths, where to start, and which controls always stay inside Mr.AI.

## What is Build & Manage with AI?

It is the Mr.AI workspace for improving your AI Employee with AI. You can connect a compatible assistant for a live connected workflow, or use the permanent manual workflow without connecting any assistant.

- The connected workflow is the preferred path when it is available and useful.
- The manual export and upload workflow remains a supported path.
- Review and production authority remain inside Mr.AI.

## Choose the right starting point

- On supported Knowledge, Behavior, Catalog, and other editing pages, use Improve with AI to work with the current page context without leaving it.
- Use Build & Manage with AI when you want the full Hub, connection status, proposals, or a broader AI improvement task.
- Use AI Settings when you want to connect, reconnect, inspect, refresh, or disconnect an AI assistant connection.

## Two supported workflows

- Connected assistant: authorize a compatible assistant, work through the capabilities Mr.AI exposes, then review proposed changes before anything becomes live.
- Manual AI workflow: export a supported editing package, work with your preferred AI, upload the result, then review and apply through the same protected Mr.AI editing journey.

> **Workspace authority**
> A connected assistant does not become the owner of your workspace and does not receive universal write access. Mr.AI controls the available areas and permissions.

## What to read next

- Connect an AI assistant: setup for ChatGPT or Claude, server-confirmed state, and permissions.
- Use AI without connecting: the permanent manual workflow from export to upload and review.
- Review, Test, Apply, and Rollback: how proposed changes move safely toward production.
- Connection management and troubleshooting: reconnect, disconnect, common failures, and credential safety.

[Open Build & Manage with AI](/client/manage-with-ai)

---

## Add fixed automatic messages

- Language: en
- Section: Settings and usage
- Canonical: https://mrailabs.com/docs/en/settings-and-usage/fixed-automatic-messages/
- Markdown: https://mrailabs.com/docs/en/settings-and-usage/fixed-automatic-messages.md
- Published: 2026-07-13T18:51:40.226212

Create deterministic replies for exact recurring messages or events.

Fixed messages are best for predictable responses that should not require AI generation.

## What to do

1. Define the trigger precisely.
2. Write a concise reply that is safe in every matching situation.
3. Enable it and test matching and non-matching messages.

> **Good practice**
> Avoid broad triggers that can intercept normal customer questions.

[Open Add fixed automatic messages](/client/settings/fixed-messages)

---

## Update your profile and password

- Language: en
- Section: Settings and usage
- Canonical: https://mrailabs.com/docs/en/settings-and-usage/profile-settings/
- Markdown: https://mrailabs.com/docs/en/settings-and-usage/profile-settings.md
- Published: 2026-07-13T18:51:40.226212

Maintain account identity and secure sign-in details.

Profile settings control the account information used for access and communication.

## What to do

1. Review your name, email, phone, and other editable details.
2. Save identity changes and confirm they appear correctly.
3. Use a unique strong password and store it securely.

> **Good practice**
> Never share login credentials between team members; create the appropriate user access instead.

[Open Update your profile and password](/client/settings/profile)

---

## Understand subscription, renewal, and points

- Language: en
- Section: Settings and usage
- Canonical: https://mrailabs.com/docs/en/settings-and-usage/subscription-and-renewal/
- Markdown: https://mrailabs.com/docs/en/settings-and-usage/subscription-and-renewal.md
- Published: 2026-07-13T18:51:40.226212

Know your plan status, validity period, and remaining usage balance.

The subscription overview combines account validity and points so you can plan continued service.

## What to do

1. Check the active plan and renewal or expiry date.
2. Monitor remaining points before high-volume campaigns.
3. Contact the responsible account team before service limits become urgent.

> **Good practice**
> Subscription time and points are separate limits; verify both when automation stops.

[Open Understand subscription, renewal, and points](/client/subscription/overview)

---

## Track points usage

- Language: en
- Section: Settings and usage
- Canonical: https://mrailabs.com/docs/en/settings-and-usage/points-usage-reports/
- Markdown: https://mrailabs.com/docs/en/settings-and-usage/points-usage-reports.md
- Published: 2026-07-13T18:51:40.226212

Understand where AI usage points are spent over time.

Usage reports break down consumption by date and account activity for operational review.

## What to do

1. Select a period that matches the question you are investigating.
2. Review totals and detailed records for unusual changes.
3. Compare usage with message volume, configuration, and business activity.

> **Good practice**
> A usage increase is not automatically a fault; confirm whether customer volume also increased.

[Open Track points usage](/client/subscription/usage-reports)

---

## Configure the incoming message debounce delay

- Language: en
- Section: Settings and usage
- Canonical: https://mrailabs.com/docs/en/settings-and-usage/incoming-message-debounce-delay/
- Markdown: https://mrailabs.com/docs/en/settings-and-usage/incoming-message-debounce-delay.md
- Published: 2026-07-27T17:29:45.554611

Choose how long to collect rapid customer messages into one AI request without unnecessary delay.

## What is the Incoming Message Debounce Delay in Mr. AI?

It is the number of seconds the system waits after an inbound message before generating an AI reply. Rapid messages are combined into one request. The default is 3 seconds and the allowed range is 2 to 30 seconds.

- Lower values reply sooner.
- Higher values collect more message fragments.
- Start with 3 seconds and adjust after reviewing real chats.

## How to use it

1. Open Knowledge Base, choose Response Behavior, then Response Timing & Handoff.
2. Find Combine rapid customer messages.
3. Enter an integer from 2 to 30 seconds.
4. Save response controls.
5. Test by sending two or three rapid messages from an external account.

> **Important**
> A longer delay reduces fragmented replies but increases waiting time. Do not choose 30 seconds by default without testing.

## Frequently asked questions

### Can I set it to zero?

No. Both the interface and backend enforce a minimum of 2 seconds.

### When should I increase it?

Increase it when customers commonly split one thought into short messages and AI replies before they finish.

[Open this page in Mr. AI](/client/knowledge-base/response-controls)

---

## Request immediate support securely

- Language: en
- Section: Settings and usage
- Canonical: https://mrailabs.com/docs/en/settings-and-usage/request-secure-immediate-support/
- Markdown: https://mrailabs.com/docs/en/settings-and-usage/request-secure-immediate-support.md
- Published: 2026-07-27T17:29:45.554611

Give Mr. AI support temporary, scoped access without sharing your account password.

## How do I give Mr. AI support secure access to my account?

Create a temporary support grant from Immediate Support, then choose its duration, permission level, and reason. You do not share your password, and you can review previous grants or revoke active access when the work is complete.

- Never share your password.
- Choose the lowest permission level that can solve the issue.
- Revoke access as soon as support work is complete.

## How to use it

1. Open Settings, then Immediate Support.
2. Choose a duration that fits the current issue.
3. Select only the permission level support needs.
4. Describe clearly what support should investigate.
5. Submit the request, monitor its status, and revoke access when the task is finished.

> **Important**
> Do not grant broader permissions or a longer duration than necessary, and never place passwords or secrets in the request reason.

## Frequently asked questions

### Does support receive my password?

No. The grant provides temporary, scoped access without exposing the password.

### What happens when the duration ends?

Access expires automatically, and you can revoke it earlier.

### Where can I review older requests?

Previous grants and their status appear on the same Immediate Support page.

[Open this page in Mr. AI](/client/settings/support-access)

---

## Enable and configure automatic customer follow-up

- Language: en
- Section: Settings and usage
- Canonical: https://mrailabs.com/docs/en/settings-and-usage/automatic-customer-follow-up-settings/
- Markdown: https://mrailabs.com/docs/en/settings-and-usage/automatic-customer-follow-up-settings.md
- Published: 2026-09-03T20:38:56.667478

Set attempt count, delay per attempt, and tone guidance safely.

## How does automatic follow-up work in Mr. AI?

When a customer stops replying, AI can send another message after the configured delay. You can enable the feature, choose 1 to 3 attempts, set each delay with a minimum of 30 minutes, and add optional tone guidance.

- The maximum is 3 attempts.
- Every interval must be at least 30 minutes.
- Use the prompt for tone guidance, not new business facts.

## How to use it

1. Open Customer Operations, then Follow-up Automation.
2. Enable follow-up and select the number of attempts.
3. Set a delay for every attempt; each must be at least 30 minutes.
4. Add short guidance such as be helpful and do not pressure the customer.
5. Save follow-up automation and monitor outcomes and human interventions.

> **Important**
> Avoid short intervals or pressuring language. Review local rules and channel policies before marketing follow-ups.

## Frequently asked questions

### Why is saving rejected after enabling it?

At least one attempt and one valid interval are required.

### Will follow-up continue after work is completed?

Conversation state such as a completed Client Action or no-follow-up-needed prevents unnecessary messages.

[Open this page in Mr. AI](/client/operations/followups)

> **Follow-up starts with context**
> Do not rely on one universal number for every business. Tie follow-up to a clear reason in the conversation, then review what happens afterward in Customer Operations.

[Learn when automatic follow-up is useful](/docs/en/learn/automatic-follow-up-when-customers-stop-replying/)

[Compare automatic and human follow-up](/docs/en/conversations-and-customers/automatic-vs-manual-customer-follow-up/)

---

## Configure the human takeover pause

- Language: en
- Section: Settings and usage
- Canonical: https://mrailabs.com/docs/en/settings-and-usage/human-takeover-pause-settings/
- Markdown: https://mrailabs.com/docs/en/settings-and-usage/human-takeover-pause-settings.md
- Published: 2026-09-03T20:38:56.667478

Choose whether AI pauses temporarily after a team reply or stays manual until resumed.

## What happens to AI after the team replies manually?

When Human Takeover is enabled, AI replies pause for that conversation after team intervention. Temporary mode uses a duration from 1 to 168 hours; permanent mode stays manual until a team member explicitly resumes AI.

- Use temporary mode for routine cases.
- Use permanent mode for sensitive or complex work.
- AI can be resumed manually from the conversation.

## How to use it

1. Open Knowledge Base, choose Response Behavior, then Response Timing & Handoff.
2. Enable Human handoff.
3. Choose automatic return after a waiting period or return only when a team member resumes AI.
4. For automatic return, set 1 to 168 hours.
5. Save response controls, send a manual reply, and verify the conversation state.

## Frequently asked questions

### Does disabling Human Takeover prevent manual replies?

No, but AI will not automatically pause after a human reply, increasing the chance of overlapping responses.

### How do I resume AI before the duration ends?

Open the conversation and use the resume-AI control when it is ready.

[Open this page in Mr. AI](/client/knowledge-base/response-controls)

> **Human takeover is part of the operating model**
> Use human takeover for situations the AI should not guess through or complete alone, then review how the conversation returns to the right operating flow.

[Learn how to keep slow replies from turning into lost opportunities](/docs/en/learn/prevent-losing-customers-slow-replies/)

[Understand human handoff and AI resumption](/docs/en/conversations-and-customers/human-ai-handoff-and-resume/)

---

## Control system and per-channel AI availability

- Language: en
- Section: Settings and usage
- Canonical: https://mrailabs.com/docs/en/settings-and-usage/system-channel-ai-and-new-user-controls/
- Markdown: https://mrailabs.com/docs/en/settings-and-usage/system-channel-ai-and-new-user-controls.md
- Published: 2026-07-27T17:29:45.554611

Understand the account-wide switch, WhatsApp and Messenger AI switches, and new-user mode.

## How is the system switch different from each channel’s AI switch?

The system switch controls live operation for the account, while WhatsApp and Messenger switches control automatic AI replies for those channels. New User Mode decides whether a new customer is automatically allowed, held for approval, or blocked.

- Check the points balance before re-enabling the system.
- Pause one channel during maintenance instead of stopping the full account.
- Use Pending when every new customer needs manual approval.

## How to use it

1. Open System Settings and review the account-wide state.
2. Choose Auto Allow, Pending, or Block for new users, then save settings.
3. Open Connect, then WhatsApp or Facebook, to control AI replies for that channel.
4. Save or verify the channel state after the change.
5. Test with a new account on every connected channel.

## Frequently asked questions

### Why can I not re-enable the system?

The points balance may have reached the allowed minimum; add points first.

### Does turning off channel AI disconnect the channel?

No. The connection remains, but automatic replies on that channel stop.

[Open this page in Mr. AI](/client/settings/system)

---

## Follow version history and release notes

- Language: en
- Section: Settings and usage
- Canonical: https://mrailabs.com/docs/en/settings-and-usage/version-history-and-release-notes/
- Markdown: https://mrailabs.com/docs/en/settings-and-usage/version-history-and-release-notes.md
- Published: 2026-07-13T18:51:40.226212

See what changed in Mr. AI and when, then open the detailed usage guide.

## How is Version History different from Help Center?

Version History explains what was added or changed in each release, including its date, feature list, and optional video. Help Center explains how to use the feature, its limits, and troubleshooting steps.

- The newest release appears first with a Latest badge.
- A listed feature may still require beta or account activation.
- Read the Help Center guide before changing live operations.

## How to use it

1. Open Version History from the sidebar footer.
2. Read the latest release description and feature list.
3. Watch the video when available.
4. Search the Help Center for the feature name.
5. Test the change with sample data before relying on it live.

## Frequently asked questions

### Is every listed feature enabled for my account?

Not always. Some features are beta or require account activation.

### Where are setup instructions?

Search Help Center by feature or problem name to open the detailed guide.

[Open this page in Mr. AI](/client/versions)

---

## Request account and data removal

- Language: en
- Section: Settings and usage
- Canonical: https://mrailabs.com/docs/en/settings-and-usage/request-account-and-data-removal/
- Markdown: https://mrailabs.com/docs/en/settings-and-usage/request-account-and-data-removal.md
- Published: 2026-07-13T18:51:40.226212

Understand password confirmation, the required reason, and the grace period before final account deletion.

## What happens when I request removal of my Mr. AI account?

After confirming the current password and entering a clear reason, the account is disabled, you are signed out, and final deletion is scheduled after 30 days. Keeping de-identified chat text is optional and requires explicit consent.

- The current password is required.
- The interface requires a reason of at least 10 characters.
- The account is disabled immediately after confirmation.

## Before confirming

1. Export or retain data your company is authorized to keep.
2. Open Settings and Profile, then find the account-removal area.
3. Enter the current password and explain why you are leaving.
4. Review the de-identified-chat option and leave it unchecked when you do not consent.
5. Review the final confirmation and submit; you will be signed out immediately.

> **Warning**
> This sensitive operation affects access and data. Do not use it as a test, and review team needs before confirming.

## Frequently asked questions

### Is final deletion immediate?

The account is disabled immediately; final deletion is scheduled after a 30-day grace period.

### Is keeping chat text required?

No. It is a separate explicit-consent option and applies only to text after identifying data is removed.

[Open account settings](/client/settings/profile)

---

## Test your AI Employee with ChatGPT or a connected AI assistant

- Language: en
- Section: Settings and usage
- Canonical: https://mrailabs.com/docs/en/settings-and-usage/test-ai-employee-with-connected-assistant/
- Markdown: https://mrailabs.com/docs/en/settings-and-usage/test-ai-employee-with-connected-assistant.md
- Published: 2026-09-29T19:19:10.681386

Let a connected AI assistant build scenarios, role-play customers, and review actual Mr. AI Testing replies instead of running every test manually.

## Can ChatGPT test my Mr. AI Employee for me?

Yes, when the Mr. AI account is connected to an assistant that supports the Testing tools. The assistant can build scenarios, start a Test Session, act as a customer, send messages into Mr. AI Testing, continue the conversation, then review the returned replies and summarize problems. The reply being evaluated must come from Mr. AI Testing itself, not from ChatGPT writing an answer on its own.

- The connected assistant organizes the test; Mr. AI Testing generates the reply under test.
- Use a separate Scenario for each important journey.
- Start a fresh Scenario after an important change.

## A practical request

> **Ready-to-use prompt**
> Test my AI Employee for pricing, product discovery, objection handling, and asking for a human agent. Use Mr. AI Testing on every turn, then summarize the problems you find.

## What can the connected assistant do?

- Build scenarios around the change you made.
- Start an isolated Test Session.
- Act as a customer and send real test messages into Mr. AI Testing.
- Continue multi-turn testing inside the same Session.
- Review AI Employee replies returned by Testing Chat.
- Try multiple Scenarios and summarize recurring gaps.
- Test supported Proposed Configuration before publishing it.

> **The most important rule**
> If ChatGPT writes an answer itself without running Mr. AI Testing, that is not a test of your AI Employee. Ask it to use Testing and evaluate the reply returned by Mr. AI.

## Current AI Testing service limits

- Current limit: 15 successful Testing messages per Session.
- Current limit: 6 new Testing Sessions per Workspace per day.
- Current limit: 90 Testing Messages per Workspace per day.
- Current Session lifetime: 4 hours.
- The daily boundary uses Africa/Cairo.
- MCP Testing messages do not deduct Customer Points.
- MCP Testing V1 accepts Text only; Image and Audio are available in Dashboard Testing.

> **Limits can change**
> These are current service limits and can change through server configuration. Treat them as current limits, not a permanent plan promise.

## After an important change

Start a fresh Scenario even if an older one is still active. This keeps the new replies from being blurred by conversation context created before the change. For supported proposals, you can also test the proposed configuration before Publish.

> **Test before Publish**
> Testing before publishing is the recommended quality workflow, but it is not a mandatory Publish Gate today.

## What remains inside Testing?

- No Customer Points are deducted for Testing messages.
- No delivery to a real customer channel.
- No real Business Action writes.
- No Follow-up scheduling and no real Stage Follow-up Task execution.

[Open Build & Manage with AI](/client/manage-with-ai)

[Read the Testing Playbook](/docs/en/learn/test-ai-employee-before-real-customers/)

[Test manually with Test Assistant](/docs/en/getting-started/test-assistant-before-live/)

[Review Build & Manage with AI](/docs/en/settings-and-usage/build-and-manage-with-ai/)

[Understand the AI Employee quality loop](/docs/en/knowledge-and-behavior/continuous-ai-employee-quality-loop/)

---

## Set up and manage the sales team

- Language: en
- Section: Sales team
- Canonical: https://mrailabs.com/docs/en/sales-team/manage-sales-team/
- Markdown: https://mrailabs.com/docs/en/sales-team/manage-sales-team.md
- Published: 2026-07-13T18:51:40.226212

Create sales users, assign customers, and maintain appropriate access.

Sales Team settings let managers control who can work with each assigned customer.

## What to do

1. Create an individual user for each sales team member.
2. Assign only the customers that person should access.
3. Review assignments and deactivate access promptly when responsibilities change.

> **Good practice**
> Sales users can access assigned customers only; managers retain the wider tenant view.

[Open Set up and manage the sales team](/client/sales-team)

---

## Use the sales member workspace

- Language: en
- Section: Sales team
- Canonical: https://mrailabs.com/docs/en/sales-team/sales-user-workspace/
- Markdown: https://mrailabs.com/docs/en/sales-team/sales-user-workspace.md
- Published: 2026-07-13T18:51:40.226212

Work assigned conversations, actions, stages, and internal collaboration.

The sales workspace gives each member a focused view of customers assigned to them.

## What to do

1. Open the assigned queue and select a customer.
2. Review the conversation, current stage, actions, and internal context.
3. Reply or update follow-up work while preserving team ownership.

> **Good practice**
> Internal comments are for team coordination and are never customer messages.

[Open Use the sales member workspace](/sales)

---

## Why is the AI not replying?

- Language: en
- Section: Troubleshooting
- Canonical: https://mrailabs.com/docs/en/troubleshooting/ai-not-replying/
- Markdown: https://mrailabs.com/docs/en/troubleshooting/ai-not-replying.md
- Published: 2026-09-03T20:38:56.667478

Check automation, conversation control, channel health, subscription, and points.

## Why might the AI Employee stop replying and what should I check first?

Check system, customer, conversation, channel, and points state in that order. If service and channel health are normal, verify whether the conversation is in manual mode or needs human intervention before changing knowledge or behavior.

First determine whether the customer message reached the dashboard and whether the conversation is currently AI-controlled.

## What to do

1. Confirm replies are enabled and the customer is not blocked or pending.
2. Check that AI is not paused and no manual takeover is active.
3. Verify channel connection, subscription validity, remaining points, and recent logs.

> **Good practice**
> After changing a setting, test with one new clear message instead of resending the old message repeatedly.

[Open Why is the AI not replying?](/client/clients/chats)

[Understand grounded business-knowledge replies](/docs/en/knowledge-and-behavior/grounded-ai-replies-from-business-knowledge/)

---

## Improve an inaccurate or unsuitable AI answer

- Language: en
- Section: Troubleshooting
- Canonical: https://mrailabs.com/docs/en/troubleshooting/improve-ai-answer-quality/
- Markdown: https://mrailabs.com/docs/en/troubleshooting/improve-ai-answer-quality.md
- Published: 2026-09-03T20:38:56.667478

Find whether the issue is a fact, behavior rule, or conversation journey.

## What should I check first when an AI Employee answer is weak?

Decide whether the cause is missing or stale knowledge, unclear behavior instructions, an unsuitable conversation journey, or a case that needs a person. Fix that source and rerun the scenario in Test Assistant instead of patching only the visible reply.

The fastest improvement comes from correcting the source of the problem instead of adding unrelated instructions.

## What to do

1. Update Products, Offers, or Documents when a business fact is wrong.
2. Update Reply Behavior when tone, length, boundaries, or handoff is wrong.
3. Update Conversation Builder when the journey fails to collect or complete the right outcome.

> **Good practice**
> Change one source, test several versions of the question, and make sure other scenarios still work.

[Open Improve an inaccurate or unsuitable AI answer](/client/knowledge-base)

[Understand grounded business-knowledge replies](/docs/en/knowledge-and-behavior/grounded-ai-replies-from-business-knowledge/)

[Use a continuous AI Employee quality loop](/docs/en/knowledge-and-behavior/continuous-ai-employee-quality-loop/)

---

## Fix a channel that stopped receiving messages

- Language: en
- Section: Troubleshooting
- Canonical: https://mrailabs.com/docs/en/troubleshooting/channel-not-receiving-messages/
- Markdown: https://mrailabs.com/docs/en/troubleshooting/channel-not-receiving-messages.md
- Published: 2026-07-13T18:51:40.226212

Separate channel delivery problems from AI response problems.

If messages do not appear in Chats, investigate the channel connection; if they appear without a reply, investigate AI controls.

## What to do

1. For WhatsApp, verify the linked device and reconnect with a fresh QR when needed.
2. For Messenger, test the Page token, webhook verification, subscriptions, and app mode.
3. For website chat, verify enablement, allowed domains, current snippet, and browser blockers.

> **Good practice**
> Test with a new message after the dashboard reports a healthy connection.

[Open Fix a channel that stopped receiving messages](/client/settings/connect)

---

## Connect an AI assistant

- Language: en
- Section: Build & Manage with AI
- Canonical: https://mrailabs.com/docs/en/build-manage-ai/connect-ai-assistant/
- Markdown: https://mrailabs.com/docs/en/build-manage-ai/connect-ai-assistant.md
- Published: 2026-08-30T12:41:09.172773

Connect ChatGPT or Claude through Mr.AI, verify the server-confirmed connection, and understand the permission boundary.

Connection settings use the same Mr.AI server connection state as the Build & Manage with AI Hub. There is no separate Settings-only connection state.

## Before connecting

- Connecting is optional; use the manual workflow if you do not want to connect an external assistant.
- Availability can depend on your workspace, rollout controls, and the current capabilities of the assistant host.
- Only the areas Mr.AI exposes to your workspace can be used through the connected assistant.

## Connect ChatGPT

1. Open AI Settings or Build & Manage with AI and choose Connect AI Assistant.
2. Use the current ChatGPT custom MCP app / Developer Mode flow available to your eligible account or workspace.
3. Enter exactly https://access.mrailabs.com/mcp as the Mr.AI MCP endpoint.
4. Choose OAuth when prompted, complete Mr.AI authorization, then run or finish Scan Tools.
5. Return to Mr.AI and confirm that the connection is reported as connected by the server before relying on it.

## Connect Claude

1. Open the current Claude Connectors settings and add a custom remote connector.
2. Enter exactly https://access.mrailabs.com/mcp as the connector URL.
3. Complete Mr.AI OAuth authorization and enable only the tools you need for the current task.
4. Review Claude tool approval prompts carefully.
5. Return to Mr.AI and confirm the server-reported connected state.

> **Trust the Mr.AI connection state**
> A successful generic MCP test, a stale connector entry, or a host-side success screen is not enough. Treat the connection as active only when Mr.AI confirms the server state.

## Permissions and capability limits

- Mr.AI decides which tools and areas are available for the workspace.
- A host name does not widen permissions.
- Limited capability is not a failure; use the manual workflow for an area that is not exposed to the connected assistant.

[Open AI Settings](/client/settings/ai)

---

## Use AI without connecting an assistant

- Language: en
- Section: Build & Manage with AI
- Canonical: https://mrailabs.com/docs/en/build-manage-ai/manual-ai-workflow/
- Markdown: https://mrailabs.com/docs/en/build-manage-ai/manual-ai-workflow.md
- Published: 2026-08-30T12:41:09.172773

Use the permanent export, external AI, upload, review, and apply workflow without authorizing an AI assistant connection.

## Can I use AI without connecting ChatGPT or Claude?

Yes. The manual AI workflow is a permanent supported path. It is useful when you prefer not to authorize a connection, when connection is unavailable, or when a connected assistant does not support the area you want to improve.

- No assistant connection is required.
- The result still returns to Mr.AI for review before production changes.

## From a supported page

1. Choose Improve with AI on the page you are currently editing.
2. Use the contextual workflow to keep the current scope and target resource attached to the task.
3. Export the supported editing package.
4. Work with your preferred AI assistant using that package.
5. Upload the result back into the same Mr.AI workflow.
6. Review the proposed result before Apply.

## From the full Hub

1. Open Build & Manage with AI.
2. Choose the manual workflow and the area you want to improve.
3. Export the package and complete your AI work externally.
4. Upload the result, review the semantic result and warnings, then continue through the supported review and apply path.

> **Keep the review boundary**
> Do not manually copy a proposed change into production to bypass review. The value of the workflow is that the result returns through Mr.AI validation and customer-controlled Apply.

[Open the AI Hub](/client/manage-with-ai)

---

## Review, Test, Apply, and Rollback AI changes

- Language: en
- Section: Build & Manage with AI
- Canonical: https://mrailabs.com/docs/en/build-manage-ai/review-test-apply-rollback-ai-changes/
- Markdown: https://mrailabs.com/docs/en/build-manage-ai/review-test-apply-rollback-ai-changes.md
- Published: 2026-08-30T12:41:09.172773

Understand the protected lifecycle for AI proposals before and after a production change.

## Does an AI assistant apply changes automatically?

No. A supported connected assistant prepares a proposal. The proposal does not become live until the customer reviews it and explicitly chooses Apply through Mr.AI.

- Proposal is not production.
- Testing does not publish the proposal.
- Apply requires an explicit customer action.

## Safe proposal lifecycle

1. Open Proposal Review and confirm the affected area, current status, semantic diff, and warnings.
2. Validate the proposal against the current workspace configuration.
3. If the configuration changed or the proposal is stale or conflicting, create and review a fresh proposal instead of forcing the old one.
4. Use Testing when the proposal type supports it. Testing runs separately from production.
5. Choose Apply explicitly only when the proposal is ready and the impact is understood.
6. After Apply, use Rollback only when that change type has a verified rollback snapshot and Mr.AI offers the action.

## How to interpret failures

- Validation failure: the proposal is not ready to apply; inspect the message and refresh the proposal if needed.
- Testing failure: production is not changed by the failed test.
- Apply failure: do not assume the proposal is live; use the returned Mr.AI state as the source of truth.
- Rollback failure: do not assume the previous state was restored until Mr.AI confirms rollback success.

> **Prefer a fresh proposal**
> When in doubt, stop at review and create a fresh proposal from the current configuration instead of trying to rescue a stale proposal.

[Open Build & Manage with AI](/client/manage-with-ai)

---

## Manage the connection and solve common problems

- Language: en
- Section: Build & Manage with AI
- Canonical: https://mrailabs.com/docs/en/build-manage-ai/ai-connection-management-troubleshooting/
- Markdown: https://mrailabs.com/docs/en/build-manage-ai/ai-connection-management-troubleshooting.md
- Published: 2026-08-30T12:41:09.172773

Reconnect, refresh, inspect, or disconnect an AI assistant safely and resolve common ChatGPT, Claude, authorization, and proposal issues.

## Connection management

- Refresh to request the current server connection state.
- Open connection details to inspect the active connection Mr.AI recognizes.
- Reconnect when authorization is expired, revoked, incomplete, or Mr.AI reports reconnect required.
- Disconnect when you no longer want that assistant connected. Disconnecting does not modify the live AI Employee configuration.
- The manual AI workflow remains available while disconnected, reconnecting, revoked, expired, or unavailable.

## Common connection states

## Troubleshooting

### Not connected

Connect only if you want the connected workflow. You can use the manual AI workflow immediately.

### Reconnect required

Reconnect from the assistant, complete authorization again, then refresh Mr.AI until the server confirms the connection.

### Limited capabilities

Use the areas Mr.AI currently exposes and use the manual workflow for unsupported areas.

### ChatGPT Scan Tools fails

Confirm the endpoint is exactly https://access.mrailabs.com/mcp, complete OAuth again, and retry the current ChatGPT custom-app flow.

### Claude connector is unauthorized

Reconnect the custom connector and complete Mr.AI OAuth again. A stale Claude connector entry is not proof of active authorization.

### Connection unavailable or failed

Refresh the connection state and retry the supported flow. A failed connection attempt does not change the live AI Employee configuration.

### Proposal validation failed

Read the review message. If the configuration changed or the proposal became stale, create and review a fresh proposal.

### Testing failed

Return to Proposal Review and start Testing again. Testing failure does not publish the proposal.

### Apply failed

Review the returned state before retrying. Do not treat the proposal as applied unless Mr.AI confirms success.

### Rollback failed

Review the returned state before retrying. Do not treat rollback as complete unless Mr.AI confirms success.

## Credential safety

> **Keep credentials private**
> Do not share passwords, API keys, authorization headers, OAuth codes, access tokens, refresh tokens, or assistant credentials in prompts, exported packages, screenshots, or support notes.

[Open AI Settings](/client/settings/ai)

---

## How to prevent losing customers because of slow replies

- Language: en
- Section: Learn
- Canonical: https://mrailabs.com/docs/en/learn/prevent-losing-customers-slow-replies/
- Markdown: https://mrailabs.com/docs/en/learn/prevent-losing-customers-slow-replies.md
- Published: 2026-09-03T20:38:55.983279

Reduce the cost of slow replies by combining fast response, company-grounded answers, conversation visibility, human intervention, and appropriate follow-up.

## How do you prevent losing customers because of slow replies?

Do more than send an instant generic message. Give the customer a fast first response grounded in your company information, keep the conversation visible to the team, let a human step in when the situation requires it, and follow up when there is a real reason to continue the conversation.

- Speed matters, but a fast irrelevant answer still fails the customer.
- The team needs a clear path for human attention.
- Follow-up should continue useful context, not replace it.

## Why slow replies become lost opportunities

A customer asking about a price, appointment, or service usually needs a next step. Long gaps create room for them to switch channels, choose another provider, or simply forget the conversation. The operational problem is not only response time; it is the gap between an incoming message and the right next action.

## What usually goes wrong

- An instant welcome message arrives but does not answer the real question.
- Outdated or missing business information makes a quick answer unreliable.
- The team has no clear queue for conversations that need human attention.
- AI keeps handling a case that should move to a person.
- A useful conversation stops and no appropriate follow-up happens.

## A stronger operating approach

1. Prepare services, prices, hours, and policies in the knowledge base.
2. Test the questions customers actually ask, including difficult ones.
3. Connect one channel and watch the first conversations before expanding.
4. Use Customer Operations for conversations that need human review.
5. Use follow-up only when the conversation context justifies it.

## How Mr. AI supports the workflow

Mr. AI combines knowledge-grounded responses, connected channels, assistant testing, Customer Operations, and human control. The currently supported customer channels are WhatsApp, Facebook Messenger, and Website/Webchat. The goal is not to remove the human team; it is to reduce the time messages spend waiting for the right response or action.

## Use these product guides

[Prepare the knowledge behind the response](/docs/en/knowledge-and-behavior/knowledge-base-overview/)

[Test the AI Employee before going live](/docs/en/getting-started/test-assistant-before-live/)

[Connect and test one channel](/docs/en/channels-and-launch/connect-channels/)

[Review conversations needing attention](/docs/en/conversations-and-customers/customer-operations-inbox/)

## Next step

Take a small set of common customer questions, improve knowledge and behavior until the answers are useful, then launch one channel and watch where your team still needs to intervene or follow up.

[Understand grounded business-knowledge replies](/docs/en/knowledge-and-behavior/grounded-ai-replies-from-business-knowledge/)

---

## How to automatically follow up when customers stop replying

- Language: en
- Section: Learn
- Canonical: https://mrailabs.com/docs/en/learn/automatic-follow-up-when-customers-stop-replying/
- Markdown: https://mrailabs.com/docs/en/learn/automatic-follow-up-when-customers-stop-replying.md
- Published: 2026-09-03T20:38:55.983279

Use automated follow-up to continue a conversation with a clear purpose and context, while keeping the team able to intervene or stop it when the customer situation changes.

## How can you automatically follow up when a customer stops replying?

Start with a conversation that has a clear unfinished step. The follow-up should continue that context rather than restart with a generic message. Monitor what happens afterward and keep human control so the team can intervene or stop follow-up when the customer situation changes.

- A useful follow-up refers to what the customer was already doing.
- Repeated messages without context can create friction instead of re-engagement.
- A first reply is not enough when the conversation stops before the next step.

## Why customers stop replying

They may be busy, comparing options, waiting for information, checking with someone else, or they may simply forget. Silence is not always rejection, but it is also not proof that every conversation deserves another automated message.

## When follow-up is useful

- There was a clear request such as a price, booking, quote, or next step.
- The conversation contains enough context to send a relevant message.
- The team can see what happened and intervene when needed.

## What bad follow-up looks like

- A generic message unrelated to the last question.
- Continuing after the customer situation has changed or they asked for a human.
- Repeating the same text without adding a useful next step.
- Treating every silent conversation as a qualified sales opportunity.

## How Mr. AI supports the workflow

Mr. AI provides automatic follow-up settings alongside Customer Operations, Client Actions, and reporting workflows. This guide does not assume one universal number of attempts or one timing rule. Configure follow-up for your operating context and test it instead of applying an unverified number to every customer journey.

[Configure automatic follow-up](/docs/en/settings-and-usage/automatic-customer-follow-up-settings/)

[Review human work in Customer Operations](/docs/en/conversations-and-customers/customer-operations-inbox/)

[Manage customer actions](/docs/en/conversations-and-customers/manage-client-actions-workflow/)

## Next step

Choose one kind of conversation that often stops before an important action, review its context with your team, and test an appropriate follow-up before using it more broadly.

[Compare automatic and human follow-up](/docs/en/conversations-and-customers/automatic-vs-manual-customer-follow-up/)

---

## How to identify customers who need follow-up from your conversations

- Language: en
- Section: Learn
- Canonical: https://mrailabs.com/docs/en/learn/identify-customers-who-need-follow-up/
- Markdown: https://mrailabs.com/docs/en/learn/identify-customers-who-need-follow-up.md
- Published: 2026-09-03T20:38:55.983279

Separate ordinary questions from active opportunities, pending actions, human-attention cases, and customers with a real unfinished next step.

## How do you identify customers who actually need follow-up?

Do not filter only by the age of the last message. Read the meaning of the conversation: was it a completed information request, an active opportunity, a pending customer action, work the team must complete, or a case needing human attention? Follow up when a meaningful next step is still open.

- Conversation meaning matters more than message age alone.
- Some conversations need an internal action before another customer message.
- Human attention and customer follow-up are different jobs.

## Five conversation states worth separating

- Normal conversation: the question was answered and nothing remains open.
- Information request: the customer is learning and may not be ready for a sales step.
- Active opportunity: there is clear intent around a booking, price, quote, or purchase step.
- Pending action: either the customer or the team still has something to complete.
- Human-attention case: an objection, exception, explicit human request, or context AI should not handle alone.

## Where the signals live in Mr. AI

Customer Operations focuses on the human work queue and conversations that need review or a manual response. Client Actions turns work into trackable actions instead of leaving it buried in chat text. Reports help the team inspect activity and performance patterns afterward. These tools do not automatically make every conversation a lead; follow-up still depends on the actual context.

## A practical team workflow

1. Start with Customer Operations for work needing attention now.
2. Read the latest context and decide whether a meaningful step is still open.
3. Use or create a Client Action when the team has work to complete.
4. Use customer follow-up when the next job is to re-open the conversation.
5. Review reports to see where cases repeatedly stall.

[Open the Customer Operations guide](/docs/en/conversations-and-customers/customer-operations-inbox/)

[Open the Client Actions guide](/docs/en/conversations-and-customers/manage-client-actions-workflow/)

## Next step

Agree on a team definition of an open opportunity or pending step, then apply it consistently to conversations instead of relying on intuition or last-message age alone.

[Understand Customer Operations vs Client Actions](/docs/en/conversations-and-customers/customer-operations-vs-client-actions/)

[Understand conversation intelligence](/docs/en/conversations-and-customers/conversation-intelligence-for-customer-operations/)

---

## How to add AI to customer service without replacing your whole system

- Language: en
- Section: Learn
- Canonical: https://mrailabs.com/docs/en/learn/add-ai-customer-service-without-replacing-system/
- Markdown: https://mrailabs.com/docs/en/learn/add-ai-customer-service-without-replacing-system.md
- Published: 2026-09-03T20:38:55.983279

Roll out AI incrementally: prepare knowledge and behavior, test, connect one existing channel, keep human control, observe the workflow, then expand gradually.

## How can you add AI to customer service without replacing your whole system?

Add AI as an incremental operating layer around a channel you already use. Prepare your business knowledge, define response behavior, test realistic scenarios, connect one channel, and keep a clear path for human intervention. Expand only after you can see what works and what still needs process changes.

- Start with a small scope you can review.
- Prepare and test before connecting live customer traffic.
- An incremental rollout avoids a full-system replacement, but it may still require changes to how the team works.

## Why incremental rollout is safer

If AI is launched everywhere at once, a missing policy, wrong price, or unclear handoff rule is repeated at a larger scale. One channel and a defined set of use cases make gaps easier to spot and fix.

## A practical rollout

1. Prepare business, service, pricing, hours, and policy information.
2. Define tone and the situations that should move to a human.
3. Test basic information, objections, bookings, and unsupported questions.
4. Connect one existing channel: WhatsApp, Facebook Messenger, or Website/Webchat.
5. Watch conversations and intervene manually when the situation requires it.
6. Improve knowledge and behavior, then decide whether to expand.

## How Mr. AI fits the rollout

Mr. AI combines the knowledge base, AI Employee behavior, assistant testing, channel connections, human control, and conversation operations in one product. That avoids building each layer from scratch, but your team still owns information quality, testing, and review of important customer situations.

[Start with the Mr. AI first steps](/docs/en/getting-started/first-steps/)

[Review the knowledge base](/docs/en/knowledge-and-behavior/knowledge-base-overview/)

[Test before launch](/docs/en/getting-started/test-assistant-before-live/)

[Connect one channel](/docs/en/channels-and-launch/connect-channels/)

[Understand Build & Manage with AI](/docs/en/settings-and-usage/build-and-manage-with-ai/)

[Use a continuous AI Employee quality loop](/docs/en/knowledge-and-behavior/continuous-ai-employee-quality-loop/)

---

## How to build and improve an AI Employee using ChatGPT or Claude

- Language: en
- Section: Learn
- Canonical: https://mrailabs.com/docs/en/learn/build-ai-employee-with-chatgpt-or-claude/
- Markdown: https://mrailabs.com/docs/en/learn/build-ai-employee-with-chatgpt-or-claude.md
- Published: 2026-09-03T20:38:55.983279

Use a compatible AI assistant you already work with to help build and improve your AI Employee, then review and test changes in Mr. AI before applying them.

## How can you build or improve an AI Employee using ChatGPT or Claude?

You can use a compatible AI assistant such as ChatGPT or Claude to help prepare and improve parts of your AI Employee, then review, test, and apply the proposed changes in Mr. AI. You can also manage the same AI Employee directly inside Mr. AI, or use both workflows together.

- Mr. AI remains the place where the AI Employee is operated and managed.
- Compatibility matters; not every AI assistant or capability is automatically supported.
- Review and test changes before they reach customers.

## Three ways to work

- Directly inside Mr. AI: manage knowledge, behavior, and settings in the product.
- With a compatible AI assistant: use the connection to help build or improve supported parts of the AI Employee.
- Use both: let the assistant help with thinking and preparation, then use Mr. AI for review, testing, and operation.

## What the connection changes

Instead of repeatedly copying material between an assistant conversation and product pages, a compatible connection can let the assistant work with specific Mr. AI capabilities. Each capability may be available, limited, or unavailable in a connection, so the workflow should follow what the product actually exposes rather than assume every setting is editable.

## Where MCP fits

MCP is a technical part of compatible connection flows, not the customer value to start with. Start with the job you want to complete, then use AI Assistant Connection when your assistant and the required capability are compatible.

## A safe change workflow

1. Identify the problem or part of the AI Employee you want to improve.
2. Ask the compatible assistant to prepare or propose the change.
3. Review the proposal instead of assuming generated means published.
4. Test the result against realistic scenarios in Mr. AI.
5. Apply the change after review and watch its effect on conversations.

[Open Build & Manage with AI](/docs/en/settings-and-usage/build-and-manage-with-ai/)

[Test the AI Employee before applying changes](/docs/en/getting-started/test-assistant-before-live/)

[Use a continuous AI Employee quality loop](/docs/en/knowledge-and-behavior/continuous-ai-employee-quality-loop/)

---

## How to test your AI Employee correctly

- Language: en
- Section: Learn
- Canonical: https://mrailabs.com/docs/en/learn/test-ai-employee-before-real-customers/
- Markdown: https://mrailabs.com/docs/en/learn/test-ai-employee-before-real-customers.md
- Published: 2026-09-29T19:19:11.235236

After an important change, test the key customer journeys, find the source of any problem, fix that source, and retest before relying on the change with customers.

## I changed my AI Employee. What should I do before relying on the change?

Run a short test on the most important customer questions, then focus on the area you changed. If a reply is wrong or weak, fix the source that owns that behavior and start a fresh test. The practical loop is: change → test → fix the cause → retest → then rely on it with customers.

- Test after every important change, even when saving succeeded.
- Write questions like a real customer instead of feeding the expected answer into the prompt.
- Evaluate the reply actually returned by Mr. AI Testing.

## A quick test after any important change

- Ask about one core Product or Service, then an important price, offer, schedule, or policy.
- Ask for the same meaning in different words, then include a wrong assumption and check whether the AI corrects it.
- Continue for several turns and verify that context is preserved without inventing missing customer data.
- Give a realistic objection and see whether the conversation continues naturally.
- Ask for information that is not available and verify that the AI does not fabricate it.
- Ask for a human agent while checking tone, language, business name, and identity.
- If you use Conversation Stages, run a full journey and make sure the stage does not advance too early.
- If you use an Action, test when the AI should and should not try to trigger it.

> **Start with the big picture**
> This is a fast regression check. Go deeper only in the area you changed instead of repeating a huge checklist every time.

## If you changed identity or speaking behavior

- Business name and AI Employee role.
- Tone, language, and speaking style.
- Things the AI must not say or do.
- How it handles a question whose answer is unknown.
- When it should suggest or request human help.

## If you changed Catalog

- Ask for a product or service by name, then verify price, currency, and Options / Variants.
- Ask a natural discovery question without repeating the item name.
- Test Semantic Classification and Semantic Tags with questions that match the meaning behind the structure.
- Test AI Search Attributes with a precise question about Instructor, Branch, Level, or another exact value.
- When you use Aliases or Search Name, ask for the same value using different wording or language and confirm Mr. AI still reaches the same correct item.
- Test two similar items so similarity alone does not return the wrong product.

## If you changed Deep Knowledge

- Ask for one direct fact.
- Ask for the same meaning using different wording.
- When information is distributed, ask a question that requires combining it.
- Ask for something that is not present and check for non-fabrication.
- After updating the Resource, start a fresh test and ask again.

## If you changed Conversation Stages

- Start the journey from the beginning and continue for multiple turns.
- Check that stage transitions happen at the right time, not too early.
- Take a small detour and then return to the main journey.
- Confirm the conversation reaches the correct final state.

## If you changed Actions

- Test the case that should trigger the Action.
- Test the same journey before required information is complete and confirm it does not trigger too early.
- Try missing or invalid data.
- Review what the AI would attempt if the conversation were Live.

> **Testing an Action is not executing it**
> Test Assistant evaluates the AI decision and behavior. It is not proof that a real Booking, Order, Payment, Refund, or other Business Action happened in the production system.

## If you changed Follow-up or Stage Follow-up

Test whether the conversation reaches the right stage and context for follow-up. A Test Chat itself does not prove that a real Follow-up or Task was scheduled or executed in Production.

## When you find a problem: fix the right source

1. Keep the customer question and the reply that exposed the problem.
2. Identify the owning source: Catalog, Deep Knowledge, identity and speaking behavior, Conversation Stages, or Action.
3. Change the smallest responsible source instead of adding one broad instruction to hide the symptom.
4. Start a fresh Testing Chat or Scenario after the important change.
5. Repeat the same question, then try nearby wording to make sure the fix is not overfitted to one sentence.
6. After the core tests pass, watch the first real conversations to verify quality in use.

> **Use a fresh test after changes**
> After an important change, start a fresh test so old conversation context does not blur the behavior of the new version.

[Open Test Assistant](/client/settings/test-assistant)

[Test manually with Test Assistant](/docs/en/getting-started/test-assistant-before-live/)

[Test with ChatGPT or a connected AI assistant](/docs/en/settings-and-usage/test-ai-employee-with-connected-assistant/)

[Understand the AI Employee quality loop](/docs/en/knowledge-and-behavior/continuous-ai-employee-quality-loop/)

[Understand grounded AI replies](/docs/en/knowledge-and-behavior/grounded-ai-replies-from-business-knowledge/)

[Review the knowledge base when you find a gap](/docs/en/knowledge-and-behavior/knowledge-base-overview/)

[Review channel setup after testing passes](/docs/en/channels-and-launch/connect-channels/)