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

التنقل

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

الفئات

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

أدوات

Pi + بوابة JoinGonka — وكيل طرفية على استدلال رخيص

Pi (pi.dev) وكيل برمجي طرفي بأسلوب بسيط، وهو من أسرع أُطُر العمل المفتوحة نمواً في 2026. تُعرَّف المزوّدات فيه تعريفاً تصريحياً في ~/.pi/agent/models.json، ويصلح معه أي endpoint يتحدث OpenAI Completions أو Anthropic Messages — أي أن JoinGonka Gateway يتصل بالطريقين كليهما. وطرز شبكة Gonka اللامركزية أرخص بمئات المرات من أسعار البطاقات لدى المورّدين، كما أن 3M رمزاً في البداية مجانية.

يُثبَّت Pi نفسه من npm: npm install -g --ignore-scripts @earendil-works/pi-coding-agent. اسم الحزمة جديد: فقد انتقل المشروع إلى مستودع earendil-works/pi، وأُعلنت الحزمة السابقة @mariozechner/pi-coding-agent مهجورة ولم تعد تُحدَّث. وإن كان Pi لديك بالاسم القديم — فأعد تثبيته؛ فقد بقي مجلد الإعدادات ~/.pi/agent على حاله بعد الانتقال.

الطريق السريع: المثبت

أقصر طريقة هي استخدام مثبتنا:

npx @joingonka/setup --tool pi

سيقوم بكتابة المزود مع نماذج الشبكة الحالية في ~/.pi/agent/models.json، وتعيين النموذج الافتراضي في ~/.pi/agent/settings.json (لا يعترض النموذج الذي اخترته بنفسك — فقط علم --model minimax|deepseek|glm الصريح هو الذي يغيره) والتحقق عبر طلب مباشر من قبول البوابة للمفتاح والنموذج. إذا تم نقل دليل الإعدادات عبر المتغير PI_CODING_AGENT_DIR، فسيقوم المثبت بالكتابة فيه. يتم وضع المفتاح كحرفي (literal) في ملف التكوين بصلاحيات 0600 — لا حاجة لتصدير متغير بيئة.

الإعداد اليدوي: المزود في models.json

احصل على مفتاح jg-… عند التسجيل وأضف المزوّد إلى ~/.pi/agent/models.json:

baseUrlhttps://gate.joingonka.ai/v1
apiopenai-completions
apiKeyمفتاحك jg-… كتابةً حرفية. يفهم Pi أيضاً المراجع $VAR/${VAR} و!command، لكن الكتابة الحرفية تعمل دون متغيّر مُصدَّر — فأبقِ الملف بأذونات 0600
modelsمصفوفة: id، name، contextWindow، maxTokens

القيم الصحيحة لطرازات الشبكة: deepseek-ai/DeepSeek-V4-Flash-0731 — contextWindow 380000، maxTokens 32768؛ MiniMaxAI/MiniMax-M2.7 — contextWindow 180000، maxTokens 8192؛ zai-org/GLM-5.3-Flash — contextWindow 390000، maxTokens 8192. القيم الافتراضية في Pi (128000/16384) لا تطابق الحدود الفعلية للشبكة، لذا حدّد الحقلين صراحةً. الطراز الافتراضي يقيم في ملف آخَر — ~/.pi/agent/settings.json، في الحقلين defaultProvider وdefaultModel. للتحقق: يجب أن يُظهر pi --list-models الطرازات المضافة.

طريق Anthropic كبديل

توفر البوابة أيضاً Anthropic Messages: مزود بـ api: "anthropic-messages" و baseUrl: "https://gate.joingonka.ai" — بدون المسار /v1/messages، سيقوم العميل بإضافته بنفسه. للعمل اليومي يكفي طريق OpenAI؛ خيار Anthropic مفيد إذا كانت ملحقات Pi الخاصة بك مخصصة لتنسيق Messages.

ملاحظة حول الأمان

لا يمتلك Pi افتراضياً طبقة أذونات كاملة: يقوم الوكيل بتنفيذ الأوامر في الطرفية دون تأكيدات خطوة بخطوة الموجودة في الأنظمة الأكثر تعقيداً. قم بتشغيله في بيئة معزولة (sandbox) — حاوية أو حساب منفصل — خاصة في المهام متعددة الخطوات المستقلة. هذه خاصية في Pi نفسه، وليست في البوابة.

أي نموذج تختار وما التكلفة

تدعم جميع نماذج الشبكة الثلاثة استدعاء الأدوات (tool calling) والبث (streaming). للجلسات الطويلة والمستودعات الكبيرة — DeepSeek V4 Flash (واحد من أطول سياقات الشبكة ومخرج يصل إلى 32768). MiniMax M2.7 هو الخيار الشامل، و GLM-5.3 Flash هو نموذج استنتاجي (reasoning) بأطول سياق في الشبكة (390K): فهو يقوم بالاستنتاج قبل الرد، لذا لا تقم بخفض maxTokens الخاص به. السعر موحد، والأسعار الحية موجودة في قائمة أسعار البوابة.

إذا لم تكن بساطة Pi كافية، ألقِ نظرة على نسختها المعدلة omp (Oh My Pi): نفس فكرة الموفرين التقريريين (declarative providers)، ولكن مع أدوار النماذج، وخوادم اللغات، والوكلاء الفرعيين. ملفات التكوين الخاصة بهم مختلفة، لذا يتم إعداد omp بشكل منفصل.

يتصل Pi بـ JoinGonka Gateway بإدخال واحد في ~/.pi/agent/models.json: baseUrl gate.joingonka.ai/v1، api openai-completions، مفتاح literal، نماذج مع contextWindow/maxTokens دقيقة. والأسرع هو npx @joingonka/setup --tool pi. قم بتشغيل الوكيل في بيئة معزولة وابدأ بالرموز المجانية الأولية.

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

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

احصل على توكنات مجانية →