أقسام قاعدة المعرفة ▾

التنقل

▸ ابدأ من هنا حسب الدور

الفئات

أدوات 52
قاموس المصطلحات 12

أدوات

GitHub Copilot BYOK — نماذجك الخاصة بدلاً من الحصة

BYOK (bring your own key) — هي آلية رسمية في GitHub Copilot تسمح لك بتوصيل مزود النماذج الخاص بك والعمل في جلسات الوكلاء (agent sessions) عليه، بدلاً من استخدام GPT و Claude المدمجين. منذ يناير 2026، يتم دعم أي endpoint متوافق مع OpenAI، ومنذ 23 يونيو أصبحت BYOK متاحة في تطبيق Copilot نفسه في مرحلة المعاينة العامة (public preview) على جميع الخطط المدفوعة، ومنذ 14 يوليو — في نسخة JetBrains. هذا يعني أنه يمكنك إبقاء Copilot كغلاف (shell)، وتوجيه عملية الاستدلال (inference) عبر JoinGonka Gateway — بأسعار شبكة Gonka اللامركزية وبدون استهلاك طلبات الاشتراك المميزة (premium requests). في VS Code، لا تحتاج BYOK إلى خطة Copilot أو تسجيل الدخول إلى حساب GitHub.

ما الذي تقدمه BYOK ومتى تحتاج إليها

يحد اشتراك Copilot من طلبات premium بحدود شهرية: جلسات الوكيل، إعادة بناء التعليمات البرمجية، والمهام متعددة الخطوات تستهلك الحصة بشكل أسرع. تقوم BYOK بتحويل هذه الطلبات إلى مزودك: يتم احتساب التكلفة وفقًا لأسعاره ولا تستهلك حصة premium الخاصة بـ Copilot. يتم تخزين المفاتيح في keychain النظام ولا تقرأها الواجهة مرة أخرى.

تكون BYOK مبررة إذا كنت تصل إلى الحد الأقصى، أو تريد نماذج ذات أوزان مفتوحة، أو تدفع مقابل الاستنتاج أقل بكثير: تقدم شبكة Gonka نفس نماذج open-source بسعر أرخص بمئات المرات من أسعار البائعين — الأسعار المحدثة متاحة دائماً في قائمة الأسعار المباشرة للبوابة.

التسلسل الزمني: التواريخ والميزات

التاريخما الجديد
نوفمبر 2025BYOK في مرحلة المعاينة العامة: Anthropic, OpenAI, xAI, Microsoft Foundry؛ أوضاع Agent, Plan, Ask, Edit في VS Code, JetBrains, Eclipse, Xcode
يناير 2026دعم أي مزود متوافق مع OpenAI + AWS Bedrock و Google AI Studio؛ نماذج مع Responses API
23 يونيو 2026BYOK في تطبيق GitHub Copilot — معاينة عامة لجميع الخطط المدفوعة
18 يونيو 2026VS Code: تعمل BYOK بدون تسجيل دخول إلى GitHub وبدون خطة Copilot؛ يتم الاستهلاك لدى المزود ولا تخصم من حصة طلبات Copilot
14 يوليو 2026نقاط نهاية (endpoints) مخصصة متوافقة مع OpenAI في Copilot لـ JetBrains — على جميع الخطط

توصيل JoinGonka Gateway: خطوات

ستحتاج إلى مفتاح jg-… — يُمنح عند التسجيل على البوابة مع 3M توكن مجاني للبداية، دون الحاجة إلى بطاقة. يُضبط المفتاح والطراز في كل عميل Copilot على حدة — وفيما يلي ثلاث طرق.

VS Code — مزوّد Custom Endpoint. هذا هو المسار الحالي: فقد أُعلن أن المزوّد السابق «OpenAI Compatible» والإعداد github.copilot.chat.customOAIModels أصبحا مهجورين.

الخطوةالإجراء
1. محرّر الطرازاتلوحة الأوامر → Chat: Manage Language Models (أو أيقونة الترس في قائمة طرازات الدردشة)
2. المزوّدAdd Models → Custom Endpoint؛ اسم المجموعة — مثلاً JoinGonka
3. المفتاحالصق مفتاحك jg-… — يخزّنه VS Code في مخزنه الآمن الخاص لا في ملف
4. نوع APIChat Completions
5. الطرازاتسيفتح VS Code ملف chatLanguageModels.json — استبدل مصفوفة "models" للمجموعة الجديدة بالكتلة أدناه واحفظ الملف
6. الاختياراختر الطراز من قائمة طرازات الدردشة؛ وإن لم يظهر — أعد تشغيل VS Code
"models": [
  {
    "id": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "name": "DeepSeek V4 Flash (Gonka)",
    "url": "https://gate.joingonka.ai/v1/chat/completions",
    "toolCalling": true,
    "vision": false,
    "maxInputTokens": 347232,
    "maxOutputTokens": 32768
  },
  {
    "id": "MiniMaxAI/MiniMax-M2.7",
    "name": "MiniMax M2.7 (Gonka)",
    "url": "https://gate.joingonka.ai/v1/chat/completions",
    "toolCalling": true,
    "vision": false,
    "maxInputTokens": 191808,
    "maxOutputTokens": 8192
  },
  {
    "id": "zai-org/GLM-5.3-Flash",
    "name": "GLM 5.3 Flash (Gonka)",
    "url": "https://gate.joingonka.ai/v1/chat/completions",
    "toolCalling": true,
    "vision": false,
    "maxInputTokens": 381808,
    "maxOutputTokens": 8192
  }
]

maxInputTokens هو نافذة سياق الطراز بعد خصم حدّ الاستجابة: وهو مع maxOutputTokens يشكّلان النافذة. ومن دون toolCalling: true لن يظهر الطراز في القائمة عند العمل مع الوكلاء.

Copilot CLI — متغيّرات البيئة فقط. لا يملك هذا المزوّد ملف إعدادات، بل تُضبط القيم في الصدفة التي تُشغّل منها copilot:

export COPILOT_PROVIDER_BASE_URL=https://gate.joingonka.ai/v1
export COPILOT_PROVIDER_TYPE=openai
export COPILOT_PROVIDER_API_KEY=jg-your-key
export COPILOT_MODEL=deepseek-ai/DeepSeek-V4-Flash-0731
export COPILOT_PROVIDER_MAX_PROMPT_TOKENS=347232
export COPILOT_PROVIDER_MAX_OUTPUT_TOKENS=32768
copilot

لا يقرأ أسماء COPILOT_PROVIDER_* سوى Copilot CLI، لذا لا يمسّ هذا الإعداد بقية أدواتك. ويطلب CLI من الطراز دعم tool calling وstreaming — وجميع طرازات الشبكة تجيد ذلك.

JetBrains — إضافة GitHub Copilot. افتح Copilot Chat → قائمة الطرازات → Manage Models، واختر مزوّداً بنقطة نهاية متوافقة مع OpenAI، واضغط Add Models ثم أدخل Base URL https://gate.joingonka.ai/v1 والمفتاح jg-… ومعرّف الطراز. اضغط Save، وحدّد الطراز تحت مفتاحك واحفظ مرة أخرى — سيظهر في القائمة إلى جانب الطرازات المدمجة.

نصيحة. الأمر npx @joingonka/setup --tool copilot-byok سيطبع الأقسام الثلاثة جميعها بمفتاحك وبالحدود الفعلية للطراز المختار — بما في ذلك مصفوفة "models" جاهزة لـ VS Code — وسيتحقق بطلب حيّ من أن البوابة تقبل المفتاح والطراز. وهو لا يكتب أي ملفات: فكل عميل Copilot يحفظ المفتاح في مخزنه الخاص.

أي نموذج شبكة تختار

تدعم جميع نماذج الشبكة الثلاثة البث (streaming) ونداء الأدوات (tool calling). deepseek-ai/DeepSeek-V4-Flash-0731 — واحد من أطول سياقات الشبكة (380 ألف رمز) وأكبر مخرجات، تصل إلى 32768 رمزاً: استخدمه للمستودعات الكبيرة وجلسات الوكيل الطويلة. MiniMaxAI/MiniMax-M2.7 — نموذج متعدد الأغراض، مخرجات تصل إلى 8192 رمزاً. zai-org/GLM-5.3-Flash — نموذج الاستدلال (reasoning) من Z.ai مع أطول سياق في الشبكة (390 ألف رمز): يفكر قبل الإجابة، المخرجات تصل إلى 8192 رمزاً؛ يذهب جزء من ميزانية الإجابة إلى الاستدلال، لذا لا تقلل حد المخرجات في الإعدادات.

قيود المعاينة العامة — بكل صراحة

تغطي BYOK جلسات الوكلاء والمحادثة؛ تظل الاقتراحات المضمنة (inline-suggestions) والبحث الدلالي في المشروع على نماذج Copilot وتتطلب حساب GitHub — هذا قيد من Copilot نفسه وليس من المزود. في Copilot Business و Enterprise، تتم إدارة BYOK محلياً بواسطة سياسة المسؤول («Bring Your Own Language Model Key»): إذا لم يكن الخيار موجوداً في الواجهة، فهو معطل على مستوى المؤسسة. مهام الرؤية (Vision) لا تعمل عبر البوابة: نماذج الشبكة نصية. إذا كانت الأداة ترسل طلبات بتنسيق Responses API — فستقبلها البوابة: POST /v1/responses، والبث (streaming) و function tools يعملان. نحن لا نخزن الحوارات، لذا يتم تجاهل store، وسيعيد previous_response_id خطأ — قم بنقل التاريخ بالكامل في input.

تحول BYOK خدمة Copilot من اشتراك ذي حدود إلى غلاف فوق الاستنتاج (inference) الخاص بك. في VS Code — Chat: Manage Language Models → Add Models → Custom Endpoint، وفي Copilot CLI — متغيرات COPILOT_PROVIDER_*، وفي JetBrains — Manage Models → Add Models؛ عنوان gate.joingonka.ai/v1 ومفتاح jg- — وستنتقل جلسات الوكلاء إلى نماذج شبكة Gonka بأسعارها الحية دون المساس بحصة طلبات Copilot الخاصة بك. ابدأ بالرموز المجانية الأولية.

تريد معرفة المزيد؟

استكشف الأقسام الأخرى أو ابدأ في كسب GNK الآن.

احصل على رموز مجانية →