Captain هو مساعد ذكاء اصطناعي يساعدك على الرد بشكل أسرع وأكثر دقة. مع **إحضار مفتاحك الخاص (BYOK)**، يمكنك استخدام مفتاح API الخاص بك من OpenAI أو أي خدمة ذكاء اصطناعي متوافقة. أنت تتحكم في البيانات والتكاليف وأي نموذج يُستخدم. في بيئة الاستضافة الذاتية، يقوم Captain فقط بإرسال البيانات إلى نموذج الذكاء الاصطناعي الذي تختاره.

سيرشدك هذا الدليل حول كيفية تفعيل Captain في **إصدار المؤسسات المستضاف ذاتياً**، وإضافة مفتاح API الخاص بك، وإعداد نموذج مخصص إذا رغبت بذلك.

## المتطلبات الأساسية

قبل أن تبدأ، تأكد من توفر ما يلي لديك:

* **إصدار Chatwoot المؤسساتي** مع خطة مدفوعة.

* صلاحية مسؤول في **وحدة تحكم السوبر أدمن**.

* مفتاح **OpenAI API** صالح.

* (اختياري) **نقطة نهاية API متوافقة مع OpenAI** مستضافة ذاتياً.

* (اختياري) [**مفتاح Firecrawl API**](https://www.firecrawl.dev/) لتحسين الزحف على الوثائق.

## تفعيل Captain في وحدة تحكم السوبر أدمن

لتفعيل Captain على مستوى التثبيت:

سجّل الدخول إلى **وحدة تحكم السوبر أدمن**. انتقل إلى **الإعدادات → Captain**.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCTmNKL1FFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--a3ab35644fcf7dc2bd5efc131fbe219e1305ca31/Screenshot%202025-08-15%20at%2011.51.50%E2%80%AFAM.png)

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQ3NLL1FFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--8a4b8f28eaaa80f8fae85881aa9345ea1e8cb8c4/Screenshot%202025-08-15%20at%2011.50.26%E2%80%AFAM.png)

قم بتعبئة حقول الإعدادات:

1. **مفتاح OpenAI API** *(إلزامي)* – المفتاح لمصادقة الطلبات إلى OpenAI أو خدمة متوافقة.

2. **نموذج OpenAI** *(إلزامي)* – الافتراضي هو `gpt-4o-mini`. يمكنك اختيار نموذج آخر مدعوم مثل `gpt-5`.

3. **نقطة نهاية OpenAI API** *(اختياري)* – أدخل نقطة النهاية المخصصة إذا كنت تستخدم نموذجاً مستضافاً ذاتياً.

4. **مفتاح Firecrawl API** *(اختياري)* – يُنصح به لتحسين زحف المواقع والوثائق.

   اضغط على **إرسال** لحفظ الإعدادات.

## تفعيل Captain لحساب معيّن

بعد تفعيل Captain على مستوى التثبيت، فعّله للحسابات الفردية:

1. في **وحدة تحكم السوبر أدمن**، انتقل إلى **الحسابات**.

2. اختر الحساب الذي ترغب في تفعيل Captain له ثم اضغط على **تعديل**.

3. ضمن قسم **الميزات المميزة**، فعّل خيار **Captain**.

4. احفظ التغييرات.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQjRLL1FFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--df5095b551827cac323bd59ce90b30b932a5b50a/Screenshot%202025-08-15%20at%2011.52.31%E2%80%AFAM.png)

## استكشاف الأخطاء وإصلاحها

إذا لم يكن Captain يستجيب كما هو متوقع:

* تحقق من أن **مفتاح OpenAI API** صحيح وفعّال.

* تأكد من أن **اسم النموذج** يطابق أحد النماذج المدعومة.

* تأكد من أن **مفتاح Firecrawl API** لديك صالح في حال كنت تستخدم الزحف.

* تحقق من أن Captain مفعّل على مستوى التثبيت والحساب.

إذا استمر Captain في عدم الاستجابة، راجع سجلات خادم Chatwoot لكل من عمليات الويب وعمليات العامل (worker) لتحديد أي أخطاء، وشارك تفاصيل هذه الأخطاء مع فريق الدعم لمزيد من المساعدة.