مقدمة إلى بوابة الذكاء الاصطناعي ServBay (AI Gateway)
بوابة الذكاء الاصطناعي ServBay (AI Gateway) هي بوابة محلية موحّدة لمزوّدي الذكاء الاصطناعي مدمجة داخل ServBay. تعمل على جهازك كنقطة نهاية وسيطة تجمع الطلبات الموجّهة إلى مختلف مزوّدي النماذج اللغوية الكبيرة (OpenAI، Anthropic، DeepSeek، Qwen وغيرها من نحو 20 مزوّدًا) في مدخل واحد، فتساعدك على إدارة المفاتيح مركزيًا، وحصر الاستخدام والتكلفة، وتوجيه أدوات البرمجة بالذكاء الاصطناعي مثل Claude Code وCodex إلى البوابة المحلية بنقرة واحدة.
تشرح هذه الوثيقة ما هي بوابة الذكاء الاصطناعي، والمشكلات التي تحلّها، ومعماريتها العامة. أما الخطوات التفصيلية، فراجع:
- إدارة القنوات — إضافة مختلف المزوّدين وإعدادهم
- المفاتيح الافتراضية — إنشاء المفاتيح وتحديد صلاحياتها وتدويرها وإبطالها
- الاستيلاء على أدوات البرمجة بالذكاء الاصطناعي بنقرة واحدة — توجيه أدوات سطر الأوامر مثل Claude Code إلى البوابة
- الإحصاءات والمراقبة — الاستخدام والتكلفة والميزانية
- نقاط النهاية ومتغيّرات البيئة — استدعاء البوابة من داخل الكود الخاص بك
نظرة عامة
في تطوير الذكاء الاصطناعي اليومي، قد تحمل في الوقت نفسه مفاتيح API من عدة مزوّدين، موزّعة بين مشاريع مختلفة وملفات إعداد أدوات مختلفة، فيصعب عليك حساب التكاليف أو التبديل بينها بشكل موحّد. تجمع بوابة الذكاء الاصطناعي ServBay كل هذه المشكلات في مكان واحد:
- مدخل واحد للاتصال بعدّة مزوّدين — بعد إعداد قنوات المزوّدين، تُمرَّر جميع الطلبات عبر العنوان المحلي
http://127.0.0.1:11580، فلا يحتاج تطبيقك إلى التعامل إلا مع عنوان واحد. - مفاتيح افتراضية بدلًا من المفاتيح الحقيقية — تُصدر البوابة «مفاتيح افتراضية» لتوزيعها على التطبيقات والأدوات، بينما تبقى مفاتيح API الحقيقية للمزوّدين محفوظة على جانب البوابة فقط، دون أن تتناثر في كل مكان. يمكن تقييد هذه المفاتيح الافتراضية أو تدويرها أو إبطالها في أي وقت.
- عرض موحّد للاستخدام والتكلفة — تُسجَّل كل الطلبات المارّة عبر البوابة، وتوفّر إحصاءات لعدد الطلبات واستهلاك الرموز (Tokens) والتكلفة وزمن الاستجابة والاستخدام متعدّد الوسائط، مع دعم إدارة الميزانية.
- الاستيلاء على أدوات البرمجة بالذكاء الاصطناعي الرئيسية بنقرة واحدة — دون الحاجة إلى تعديل ملفات الإعداد يدويًا، يمكن للبوابة توجيه أدوات مثل Claude Code وCodex وQwen Code وKimi CLI وCodeBuddy وopencode وCrush إلى البوابة المحلية بنقرة واحدة.
- تتبّع حسابات الاشتراك والحصص — يدعم ربط حسابات المزوّدين بنظام الاشتراك (مثل تفويض OAuth لحسابات Claude Pro / Max)، فعرض معلومات الباقة ونقاط النهاية المتاحة وحدود طول المخرجات بصريًا داخل البوابة، مع تتبّع الحصص عبر النوافذ الزمنية المتعددة في الوقت الحقيقي (النسبة المستخدمة / المتبقية، وحالة نفاد الحصة، ووقت إعادة التعيين)، لتبقى مطلعًا دائمًا على رصيد اشتراكك.
- استكشاف قدرات القنوات والتوجيه الذكي — عند إضافة قناة، تستكشف البوابة تلقائيًا قدرات المزوّد (نوع تفويض OAuth / نوع باقة البرمجة / نوع النماذج المُصنّفة)، وبعد التأكيد تُكتب تخطيطات البوابة الثلاثية تلقائيًا وفق نتائج الاستكشاف، دون الحاجة إلى التخمين اليدوي لتوافق النماذج.
المعمارية والمنافذ
تتكوّن بوابة الذكاء الاصطناعي من خدمتين محليتين، تَستمِعان فقط إلى عنوان الاسترجاع (127.0.0.1):
| المنفذ | الغرض | الوصف |
|---|---|---|
11580 | منفذ الوسيط (Proxy) | المدخل الموحّد الموجّه إلى التطبيقات. تُرسل شيفرتك والأدوات المُسيطَر عليها طلباتها إلى هنا، وتوجّه البوابة الطلب إلى قناة المزوّد المناسبة وفق صلاحيات المفتاح الافتراضي. |
11581 | منفذ الإدارة | يُستخدم داخليًا في تطبيق ServBay لإدارة القنوات والمفاتيح والإحصاءات، ولا حاجة عمومًا إلى الوصول إليه مباشرة. |
يوفّر منفذ الوسيط في الوقت نفسه نقاط نهاية متوافقة بصيغ متعدّدة (متوافقة مع OpenAI، ومتوافقة مع Anthropic، ومتوافقة مع Gemini)، راجع نقاط النهاية ومتغيّرات البيئة.
قنوات المزوّدين المدعومة
تضمّ بوابة الذكاء الاصطناعي إعدادات مسبقة لنحو 20 مزوّدًا، مصنّفة في مجموعات يمكن اختيارها مباشرة عند إضافة قناة:
- الرئيسية (Mainstream): OpenAI، Anthropic، Google Gemini، Azure OpenAI، AWS Bedrock، OpenRouter.
- الصين (China): DeepSeek، Qwen، Zhipu GLM، Kimi (Moonshot)، Doubao·Volcano، ERNIE Bot، Hunyuan، MiniMax، 01.AI، StepFun. ومن بينها Qwen وZhipu GLM وKimi وDoubao·Volcano وHunyuan وMiniMax وStepFun تدعم التبديل بين نقاط النهاية المحلية / العالمية.
- المحلية (Local): Ollama (افتراضيًا
127.0.0.1:11434)، LM Studio (افتراضيًا127.0.0.1:1234). - المخصّصة (Custom): OpenAI Compatible (أي خدمة متوافقة مع OpenAI)، Custom (مخصّصة بالكامل).
راجع إدارة القنوات للاطّلاع على خطوات الإضافة والإعداد الكاملة.
المتطلبات المسبقة
- يجب أن يكون ServBay مثبّتًا وقيد التشغيل على macOS أو Windows.
- بوابة الذكاء الاصطناعي ميزة إضافية في ServBay، ويتطلّب إضافة القنوات / المفاتيح تسجيل الدخول إلى حساب ServBay أولًا. وإن لم تكن مسجّلًا، سترشدك الواجهة لإكمال تسجيل الدخول.
TIP
تتشابه وظائف بوابة الذكاء الاصطناعي في ServBay for macOS وServBay for Windows، كما يتطابق منفذ الوسيط (11580) ومنفذ الإدارة (11581) ومسارات ملفات إعداد الأدوات المُسيطَر عليها. وسيُشار إلى أي اختلافات بين المنصّات بشكل منفصل في الوثيقة.
الحساب والباقات
ترتبط بعض قدرات بوابة الذكاء الاصطناعي بباقة حساب ServBay:
- الحدّ الأقصى لعدد القنوات / المفاتيح — يختلف عدد القنوات والمفاتيح الافتراضية المتاح إنشاؤها بين الباقة المجانية والمدفوعة. وعند الوصول إلى الحد الأقصى، تظهر لك الواجهة تنبيهًا بالترقية.
- إدارة الحصص والميزانية — يندرج تقييد الحصص (الرموز / عدد الطلبات / المبلغ) ولوحة الميزانية ضمن قدرات VIP / الباقات المدفوعة، وإن لم تكن مشتركًا فسيُقفل القسم المقابل مع تنبيه بالترقية.
لمعرفة تفاصيل الباقات، راجع ServBay Pro وServBay Team.
حسابات الاشتراك وتتبّع الحصص
تدعم بوابة الذكاء الاصطناعي ربط حسابات المزوّدين بنظام الاشتراك (مثل Claude Pro / Max المتصلة عبر تفويض OAuth)، لتتيح لك عرض هذه الموارد وإدارتها مباشرة داخل البوابة المحلية دون الحاجة إلى تسجيل الدخول إلى لوحات التحكم على مواقع المزوّدين.
ما الذي يمكنك فعله بحسابات الاشتراك
- معلومات الباقة في لمحة — عرض اسم باقة الاشتراك وبنية الفوترة ومدة الصلاحية.
- نقاط النهاية المتاحة وحدود المخرجات — الاطّلاع على قائمة نقاط النهاية التي يمكن لهذا الحساب استدعاؤها، وحدود طول المخرجات القصوى لكل نموذج.
- تتبّع الحصص عبر نوافذ متعددة — عرض بصري للنسبة المئوية المستخدمة / المتبقية، وما إذا كانت الحصة قد نضبت، ووقت إعادة التعيين، لمساعدتك على توزيع موارد اشتراكك بذكاء.
- ظهور انتهاء صلاحية بيانات الاعتماد — عند انتهاء صلاحية تفويض حساب الاشتراك أو تعطّله، تُوسَم الحالة بوضوح في الواجهة لتنبيهك إلى إعادة التفويض.
ميزة تجريبية
يُعدّ ربط حسابات الاشتراك عبر تفويض OAuth حاليًا ميزة تجريبية، وسيتم توسيع قائمة المزوّدين المدعومين تدريجيًا. يتطلّب التفويض إكمال عملية OAuth الخاصة بالمزوّد في المتصفح، ولا تُخزَّن رموز التفويض إلا محليًا.
تخزين البيانات
- تُدار بيانات إعداد القنوات والمفاتيح الافتراضية وإحصاءات الاستخدام محليًا من قِبل خدمة البوابة الخلفية.
- لا يُعرض النص الصريح للمفتاح الافتراضي إلا مرة واحدة عند الإنشاء (أو التدوير)، وبعدها لا تحتفظ البوابة إلا بالبادئة للتعرّف عليه، لذا احرص على نسخه وحفظه فور إنشائه.
- عند الاستيلاء على الأدوات بنقرة واحدة، تنسخ البوابة أولًا ملف الإعداد الأصلي للأداة المستهدفة بامتداد
.bak، ثم تكتب الإعداد الموجّه إلى البوابة المحلية، مما يسهّل استعادته في أي وقت.
سير العمل النموذجي
- سجّل الدخول إلى حساب ServBay وادخل إلى بوابة الذكاء الاصطناعي.
- أضف قناة مزوّد واحدة على الأقل من صفحة القنوات (مثل OpenAI أو DeepSeek)، وأدخل مفتاح API الحقيقي واختبر الاتصال.
- أنشئ مفتاحًا افتراضيًا من صفحة المفاتيح الافتراضية، وحدّد حسب الحاجة النماذج / القنوات المتاحة ومعدّل الطلبات.
- من صفحة نقاط النهاية، ضع المفتاح الافتراضي في تطبيقك، أو استخدم الاستيلاء بنقرة واحدة في الصفحة نفسها لأدوات البرمجة بالذكاء الاصطناعي التي تستخدمها عادةً.
- راقب الاستخدام والتكلفة وزمن الاستجابة من صفحة الإحصاءات والمراقبة، واضبط الميزانية عند الحاجة.
الخلاصة
تختصر بوابة الذكاء الاصطناعي ServBay واقع تطوير الذكاء الاصطناعي المُفتّت المتمثّل في «عدّة مزوّدين، وعدّة مفاتيح، وعدّة أدوات» إلى «مدخل محلي واحد، ومجموعة مفاتيح افتراضية واحدة، وعرض واحد للاستخدام». فهي تمكّنك من إدارة قدرات الذكاء الاصطناعي مركزيًا وأمانًا على جهازك، والتحكّم الدقيق في التكاليف، وربط مختلف أدوات البرمجة بالذكاء الاصطناعي ببوابة موحّدة بأقل جهد ممكن، وهي إحدى القدرات الأساسية في ServBay الموجّهة لتطوير الذكاء الاصطناعي الأصيل (AI-native).
