دليل وكلاء Flaq AI

دليل عملي لاستخدام ZCode مع خدمات API من Flaq AI

اربط بيئة البرمجة المكتبية المدعومة بالذكاء الاصطناعي ZCode بواجهة API المتوافقة مع OpenAI من Flaq AI، ثم استخدم نماذج GLM 5.2 أو Kimi K3 أو DeepSeek v4 لطرح أسئلة حول مستودع الشفرة وتنفيذ مهام البرمجة. يتناول هذا الدليل تنزيل ZCode الرسمي وإعداد موفر مخصص واختيار النموذج وإجراء اختبار بسيط لمساحة العمل.

أدلة الوكلاء

Claude Code/cc-apiOpenAI Codex/codex-api/v1Hermes Agent/api/v1DeepSeek Harness/api/v1ZCode/api/v1

التثبيت

تثبيت ZCode

نزّل تطبيق ZCode المكتبي الرسمي لنظام macOS أو Windows أو Linux، وثبّته وفق الخطوات المعتادة في نظامك، ثم اختر دليل مشروع عند تشغيله للمرة الأولى. يوفر ZCode حاليًا ملف AppImage لنظام Linux x64 إلى جانب تنزيلاته لنظامي macOS وWindows.

1

تنزيل ZCode

افتح صفحة التثبيت الرسمية واختر الحزمة المطابقة لنظام التشغيل وبنية جهازك.

اختر ملف .dmg المخصص لـ Apple Silicon أو Intel، واسحب ZCode إلى Applications، ثم افتح التطبيق من Launchpad.

تنزيل ZCode لنظام macOS

https://zcode.z.ai/en/docs/install

الإعداد

ربط ZCode بـ Flaq AI

افتح إعدادات النماذج في ZCode، وأضف Flaq AI كموفر تابع لجهة خارجية باستخدام بروتوكول OpenAI، وأدخل مفتاح API الخاص بك في Flaq، ثم أضف معرّف النموذج المحدد يدويًا. يستطيع ZCode استخدام خدمات النماذج المتوافقة عبر موفرين مخصصين حتى إن لم تكن مدرجة ضمن قائمة الموفرين المدمجة فيه.

الخيار الافتراضي الموصى به لمهام البرمجة في ZCode، ومهام المستودعات متعددة الخطوات، والتخطيط، وتحليل الشفرة.

انقر على اسم النموذج في مربع دردشة ZCode، وحدد Manage Models، ثم افتح Settings → Model Settings. انقر على Add Provider، واختر بروتوكول OpenAI، وأدخل إعدادات Flaq الموضحة أدناه، ثم فعّل الموفر. إذا لم تُحمّل قائمة النماذج تلقائيًا، فانقر على Add Model وأدخل معرّف النموذج المحدد يدويًا.

  • استخدم عنوان URL الأساسي لواجهة Flaq API كما هو تمامًا، واستبدل العنصر النائب بمفتاح Flaq API الخاص بك.
  • أبقِ معرّف النموذج المحدد مطابقًا تمامًا لما هو معروض.

إعدادات موفر Flaq AI

Provider name: Flaq AIProtocol: OpenAIAPI base URL: https://api.flaq.ai/api/v1API key: Your_Flaq_Api_KeyModel ID: glm-5.2-text-to-textEnable provider: On

التحقق

التحقق من Flaq في ZCode

اختر نموذج Flaq الذي أعددته من محدد النماذج، وافتح دليل مشروع بوصفه مساحة العمل الحالية، وابدأ جلسة ZCode Agent جديدة، ثم أرسل أولاً مهمة للقراءة فقط في المستودع.

استخدم هذه المطالبة للتحقق من أن النموذج المحدد يجيب بمعلومات من مساحة العمل الحالية من دون طلب إجراء تغييرات على الملفات.

اختبار الوصول إلى المشروع

List the files in this project and summarize its main purpose. Do not modify any files.

الموقع الرسمي

زيارة موقع ZCode الرسمي

زُر موقع ZCode الرسمي للحصول على أحدث تنزيلات تطبيق سطح المكتب، وتعليمات التثبيت، ووثائق إعداد النماذج، وملاحظات الإصدارات، وتحديثات المنتج.

موقع ZCode الرسمي

افتح موقع ZCode الرسمي لتنزيل التطبيق ومراجعة أحدث خطوات الإعداد لأنظمة macOS وWindows وLinux.

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

الأسئلة الشائعة حول ZCode

قد يؤدي استخدام هذا الإعداد في هذا الدليل إلى زيادة استخدام الرموز بشكل ملحوظ.