Warp + JoinGonka Gateway — وكيل طرفية على نقطة النهاية الخاصة بك

مفتاح JoinGonka. سجل في البوابة، وافتح قسم "مفاتيح API" في لوحة التحكم واضغط على "إنشاء مفتاح". يبدأ المفتاح بـ jg- ويظهر مرة واحدة فقط — احفظه فورًا. من المريح إنشاء مفتاح منفصل لـ Warp: حينها في قسم "الاستخدام"، سيكون استهلاك وكيل الطرفية مرئيًا في سطر منفصل، وليس مختلطًا مع أدوات أخرى.

خطة Warp. نقطة النهاية الخاصة بك متاحة ليس فقط في الخطط المدفوعة — الشروط تعتمد على حجم الفريق:

عنوان HTTPS عام. هذا مطلب لـ Warp قد لا يخطر ببالك بسهولة: الطلبات إلى نقطة النهاية الخاصة بك لا يتم إرسالها بواسطة التطبيق الموجود على جهازك، بل بواسطة خوادم Warp، لذا يجب أن يكون العنوان متاحًا من الإنترنت. يتم رفض localhost و 127.0.0.1 وعناوين الشبكات الخاصة من قبل النموذج، ويُسمح فقط ببروتوكول https://. JoinGonka Gateway هي خدمة HTTPS عامة، لذا فإن الأنفاق مثل ngrok، التي تنصح بها وثائق Warp للنماذج المحلية، ليست ضرورية هنا.

نسخة تطبيق حديثة. تم تضمين نقطة النهاية الخاصة في البناء المستقر منذ إصدار 20 مايو 2026، وظهر اختيار مخطط API في النموذج في إصدار 31 يوليو 2026. إذا لم يظهر حقل API schema في النموذج — قم بتحديث Warp.

تتم كل عملية الإعداد داخل واجهة التطبيق — دون أي حاجة لتعديل الملفات يدويًا.

1. افتح Settings واكتب inference endpoint في مربع البحث عن الإعدادات — سينتقل Warp إلى قسم مفاتيح المزوّدين ونقاط النهاية الخاصة (وهو موجود في صفحة إعدادات Warp Agent).
2. اضغط Add custom endpoint — ستُفتح استمارة الإدخال.
3. املأ الحقول بالقيم من الجدول ثم اضغط Add endpoint.

زر + Add model يضيف سطرًا جديدًا. أضف فورًا كل طرازات الشبكة حتى تستطيع التنقل بينها لاحقًا دون العودة إلى الإعدادات: deepseek-ai/DeepSeek-V4-Flash-0731 و MiniMaxAI/MiniMax-M2.7 و zai-org/GLM-5.3-Flash. القائمة المحدَّثة متاحة دائمًا عبر GET https://gate.joingonka.ai/v1/models. اكتب المعرّفات حرفًا بحرف: فالاستمارة تتحقق فقط من شكل العنوان وامتلاء الحقول، ولا تجري طلبًا تجريبيًا عند الحفظ، لذا فإن أي خطأ مطبعي في اسم الطراز لن يظهر إلا أثناء المحادثة مع الوكيل.

بعد الحفظ تظهر الطرازات في مبدّل الطرازات الخاص بالوكيل. وإذا كان الطراز الافتراضي ما زال أحد طرازات Warp، فقد يقترح التطبيق تغييره من تلقاء نفسه — وافق واختر طرازًا من نقطة النهاية الخاصة بك. وهناك تفصيل مهم: خيارات Auto في المبدّل تعمل دائمًا على بنية Warp التحتية وتستهلك أرصدتها، حتى مع وجود نقطة نهاية خاصة مُعدّة. ولكي يُرسَل الطلب إلى البوابة، يجب اختيار طراز محدّد من قائمتك في المبدّل.

اختر طراز الـ endpoint الخاص بك من المبدّل، وأعطِ الوكيل مهمة قصيرة، مثل: «اعرض أكبر خمسة ملفات في المجلد الحالي واشرح الأمر». يجب أن يقترح الوكيل الأمر، وينفّذه بإذنك، ويعلّق على المخرجات.

الآن افتح لوحة تحكم البوابة، قسم «الاستخدام». في كتلة «حسب المفاتيح» سيظهر للمفتاح الذي أنشأته لـ Warp عدد الطلبات ووقت آخر استخدام، وفي كتلة «حسب الطرازات» سيظهر الطراز المختار. إذا كانت العدّادات ترتفع فهذا يعني أن الـ inference يمر عبر JoinGonka Gateway وليس من رصيد Warp. ومن جانبه، يعرض Warp استهلاك التوكنات مباشرةً في المحادثة مع الوكيل — تحت الأسماء القصيرة التي حدّدتها في حقل alias.

إذا حدث خطب ما، يمكن عادةً قراءة السبب من الاستجابة:

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

سعر نماذج الشبكة متساوٍ، لذا فإن الاختيار يتعلق بالسلوك وليس بالميزانية. يقرأ وكيل الطرفية (terminal agent) الكثير (مخرجات الأوامر، السجلات، الملفات) ويستدعي الأدوات باستمرار؛ جميع النماذج في الجدول تدعم native tool calling.

المخطط العملي: DeepSeek V4 Flash هو النموذج الرئيسي، MiniMax M2.7 للمهام الصغيرة، GLM-5.3 Flash عندما تعتمد المهمة على المنطق وليس على الحجم. التبديل يستغرق ثانية واحدة لأن جميع النماذج معرفة بالفعل في endpoint، وتساعد الأسماء القصيرة من حقل alias على عدم الخلط بين المعرفات الطويلة. المزيد من التفاصيل حول النموذج الأكثر شيوعاً منها في نظرة عامة على DeepSeek V4 Flash.

استهلاك الرموز (tokens) للوكيل في الطرفية أعلى منه في الدردشة: يضيف Warp لكل طلب تعليمات النظام، سياق الحوار ووصف الأدوات، والمهمة الواحدة تتكون من عدة خطوات. لذلك، السعر لكل رمز هنا أكثر أهمية مما هو عليه في المراسلات العادية.

من خلال JoinGonka Gateway، تبلغ تكلفة الرموز $0.0069 للمليون عند المدخل و $0.021 للمليون عند المخرج — السعر متساوٍ لجميع نماذج الشبكة ويتم استجلابه في هذه الصفحة من مصدر مباشر. تقدير التكاليف لشهر سبتمبر 2026:

للمقارنة — ثلاث طرق لدفع تكاليف وكيل Warp:

لا يخصم Warp أرصدة للأفراد والفرق التي يصل عددها إلى 10 أشخاص عند العمل عبر الـ endpoint الخاص بهم — أنت تدفع فقط مقابل الرموز في البوابة. يتم شحن الرصيد في لوحة التحكم، حيث يتم عرض الرصيد المتبقي والاستهلاك حسب الأيام والنماذج.

بالنسبة لمعظم الأدوات، يعني الـ endpoint الخاص أن «الطلبات تذهب من جهازي مباشرة إلى المزود». مع Warp الأمر مختلف: يعمل جزء الوكيل (agent) التنفيذي على خوادم Warp، ويقوم الـ endpoint الخاص بتغيير الوجهة النهائية والمفتاح فقط. وفقًا لـ توثيق Warp، مسار الطلب هو كالتالي:

1. يأخذ التطبيق عنوان الـ endpoint والمفتاح من وحدة تخزين آمنة على الجهاز ويرسلها إلى خوادم Warp مع الـ prompt الخاص بك.
2. يقوم الوكيل على جانب Warp بتجميع الطلب الكامل — تعليمات النظام، سياق الحوار، الأدوات — ويستدعي الـ endpoint الخاص بك باستخدام هذا المفتاح.
3. يتم إرجاع الرد إلى التطبيق عبر تدفق (stream) من خلال نفس الخوادم.

ماذا يعني هذا من الناحية العملية:

• المفتاح. يتم تخزينه فقط على الجهاز. يمر عبر خوادم Warp مع كل طلب، ولكن وفقًا لتصريحات Warp، لا يتم حفظه هناك: يتم استخدامه فوراً ثم يتم التخلص منه.
• الـ Prompts والردود. تمر عبر backend الخاص بـ Warp. تصرح Warp بأنها لا تستخدم هذا المحتوى للتدريب، وأن التخزين والتحليلات تخضع لإعدادات الخصوصية والقياس عن بعد لحسابك. ضمان ZDR، الذي يسري على نماذج Warp نفسها، لا يمكن تطبيقه على الـ endpoint الخاص بك: ما يتم تخزينه يحدده المزود.
• جانب البوابة. لا تقوم JoinGonka Gateway بتخزين الحوارات: الـ prompts والردود لا تبقى على البوابة بعد الرد، ولا يظهر في لوحة التحكم سوى عدادات الطلبات والـ tokens.
• ما يظل على بنية Warp التحتية. خيارات Auto، وموجهات النماذج المخصصة، وCodebase Context، وتلميحات Active AI، والوكلاء السحابيون (cloud agents) — لا يؤثر الـ endpoint الخاص على هذه العناصر.

إذا كان المسار عبر خوادم خارجية غير مقبول لمهامك، فاستخدم وكيلاً يتصل بالـ endpoint مباشرة من جهازك — على سبيل المثال، Codex CLI أو أي أداة من دليل البدء السريع لـ API. تعد Warp نفسها في إعلانها بخيار جانبي للعميل: وحدة وكيل خفيفة بلغة Rust في مستودع مفتوح المصدر، ستتصل بالنماذج المحلية دون المرور عبر خوادم Warp، مع دعم Agent Client Protocol. ومنذ إصدار 2 سبتمبر 2026، يتم تخزين أوصاف الـ endpoint في ملف إعدادات بتنسيق مشترك بين التطبيق و Warp Agent CLI؛ ولا يتم إدراج المفاتيح في هذا الملف بل تظل في وحدة التخزين الآمنة.