إذا كنت تبحث عن كود مصدري للذكاء الاصطناعي، فعادةً ما تحتاج إلى أحد ثلاثة أشياء: كود النموذج والأوزان، أو وكيل كود مفتوح المصدر يمكنه التخطيط واستخدام الأدوات، أو مكدس تطبيق يسمح للنموذج بقراءة الملفات وتنفيذ الأوامر وإرجاع نتيجة قابلة للمراجعة. هذه الطبقات مترابطة، لكنها ليست نفس المنتج. أسرع طريقة لفهم المجال هي فصل النموذج، وحلقة الوكيل، وبيئة التشغيل المعزولة التي تنفذ العمل.
ما يعنيه “الكود المصدري للذكاء الاصطناعي” عادةً
العبارة واسعة لدرجة أن شخصين يمكنهما استخدامها ويعنيان شيئين مختلفين تماماً.
أحياناً تعني كود النموذج المصدر: كود التدريب، كود الاستدلال، منطق الرمز المميز (tokenizer)، وأوزان قابلة للتحميل لنموذج مفتوح. وأحياناً تعني برنامج الوكيل: الأداة التي تعمل في طرفية أو متصفح، تقرأ مستودعاً، تخطط لمهمة، تكتب كوداً، تشغل اختبارات، وتراجع مخرجاتها الخاصة. وأحياناً تعني السقالات (scaffolding) حول هذا الوكيل: استدعاءات API، المصادقة، دورة حياة الصندوق الرملي، التعامل مع الملفات، السجلات، المعاينات، وبوابات المراجعة.
هذا التمييز مهم لأن فريقاً يبحث عن نموذج مفتوح لا ينبغي أن يقيم نفس الأشياء التي يقيمها فريق يبحث عن وكيل كود مفتوح المصدر.
استخدم هذا المرشح السريع:
| إذا كنت بحاجة إلى… | ابحث عن… |
|---|---|
| نموذج يمكن تشغيله أو ضبطه (fine-tune) أو استدعاؤه عبر API | مستودع النموذج، بطاقة النموذج، الترخيص، حدود السياق، دعم استدعاء الأدوات |
| أداة برمجة يمكنها العمل داخل مشروع | وكيل كود مفتوح المصدر، CLI، تطبيق سطح مكتب، أو منصة وكيل |
| طبقة تنفيذ إنتاجية | بيئة تشغيل معزولة (sandbox)، عزل مساحة العمل، سياسة الحزم، التعامل مع الأسرار، السجلات، والمعاينات |
أين تجد الكود المصدري لمشاريع الذكاء الاصطناعي
بالنسبة لمعظم سير عمل المطورين، الإجابة الحقيقية هي “في عدة مستودعات، وليس واحداً”.
1. مستودعات النماذج
هنا تجد بنية النموذج، وثائق الاستخدام، نقاط التفتيش (checkpoints) أو روابطها، شروط الترخيص، وملاحظات المعايير. إذا كان هدفك هو الاستدلال المحلي، أو الضبط الدقيق، أو دراسة كيفية تعبئة النموذج لمهام البرمجة، ابدأ من هنا.
على سبيل المثال، مستودع Qwen الرسمي Qwen3-Coder يصف Qwen3-Coder-Next كنموذج مفتوح الأوزان بُني خصيصاً لوكلاء البرمجة والتطوير المحلي، مع دعم سياق طويل وصيغة استدعاء دالة موجهة لسير العمل الوكيل.
2. مستودعات الوكلاء
هنا تجد حلقة المخطط، توصيل الأدوات، واجهة المستخدم الطرفية، محولات مزودي النماذج، وأحياناً تكاملات المتصفح أو MCP.
ثلاثة أمثلة مفيدة:
- OpenHands يضع نفسه كمنصة مفتوحة لوكلاء البرمجة السحابية ومركز تحكم يمكنه تشغيل الوكلاء محلياً، في Docker، على VMs، أو من خلال خلفيات سحابية.
- Goose هو وكيل مفتوح المصدر بواجهات سطح مكتب، CLI، و API يعمل على جهازك ولا يقتصر على مهام البرمجة.
- Qwen Code هو أداة برمجة موجهة للطرفية من Qwen تركز على سير عمل البرمجة الوكيل بدلاً من الدردشة العامة.
إذا كان سؤالك الرئيسي هو “أي وكيل كود مفتوح المصدر يجب أن أفحصه أولاً؟”، ابدأ بمستودعات الوكلاء، وليس بأوزان النموذج.
3. وثائق الصندوق الرملي وبيئة التشغيل
هذه هي الطبقة التي يتجاهلها العديد من الفرق في البداية، ثم يعودون إليها عندما يبدأ الوكيل في العمل الحقيقي.
تصف وثائق Novita Sandbox بيئة التشغيل بأنها بيئة معزولة، تحتفظ بالحالة (stateful) للوكلاء الذين يحتاجون إلى تشغيل الكود، تثبيت التبعيات، الوصول إلى الملفات، استخدام المتصفحات، والحفاظ على الحالة عبر الجلسات. هذا هو الحدود التنفيذية، وليس مجرد غلاف تسهيلي. بمجرد أن يتمكن الوكيل من تشغيل الأوامر، تصبح بيئة التشغيل بنفس أهمية النموذج.
ما الذي يجعل وكيل الكود مفتوح المصدر مختلفاً
وكيل الكود مفتوح المصدر ليس مجرد LLM مع قالب مطالبة (prompt template). يصبح وكيلاً عندما يمكنه ملاحظة مساحة عمل، اتخاذ قرار بشأن الإجراء التالي، تنفيذ ذلك الإجراء من خلال الأدوات، قراءة النتيجة، ومواصلة التكرار.
تتطلب هذه الحلقة عادةً أربعة أجزاء:
| الطبقة | الوظيفة |
|---|---|
| المخطط (Planner) | تقسيم المهمة إلى خطوات وتحديد متى تكتمل المهمة |
| النموذج (Model) | الاستدلال على الملفات، مخرجات الأوامر، واستدعاءات الأدوات السابقة |
| طبقة الأدوات (Tool layer) | قراءة الملفات، كتابتها، البحث، تشغيل الأوامر، فتح المعاينات |
| الصندوق الرملي (Sandbox) | عزل التنفيذ، الحفاظ على حالة مساحة العمل، واحتواء الآثار الجانبية |
بدون الصندوق الرملي، غالباً ما يتحول “وكيل الكود مفتوح المصدر” إلى “نموذج مع وصول خطير إلى الصدفة shell”.
وهذا أيضاً هو المكان الذي يبدأ فيه المكدس في الظهور بشكل أشبه ببنية تحتية هندسية أكثر من كونه ميزة محادثة. بمجرد أن يتمكن النموذج من تثبيت الحزم، فتح المنافذ، وإعادة كتابة الملفات، تحتاج إلى الإجابة على أسئلة تشغيلية:
- ما هي حالة المستودع التي يبدأ منها الوكيل؟
- أي الأوامر تعمل تلقائياً وأيها تتطلب موافقة؟
- هل يمكن للوكيل جلب الحزم أو تصفح عناوين URL عشوائية؟
- أين تذهب السجلات، الفروقات (diffs)، المعاينات، والتحف (artifacts) المولدة؟
- كيف يمكن إيقاف جلسة مؤقتاً، استئنافها، أو إنهاؤها؟
تحدد هذه الأسئلة ما إذا كان المشروع مجرد عرض توضيحي أم سير عمل يمكن لفريقك الوثوق به.
بنية عملية لوكيل برمجة
أفضل طريقة للتفكير في الكود المصدري لوكلاء الذكاء الاصطناعي هي كسلسلة:
- يصف المستخدم المهمة.
- يحول النموذج المهمة إلى خطة.
- يستدعي الوكيل الأدوات لفحص قاعدة الكود.
- تنفذ بيئة التشغيل استدعاءات الأدوات هذه في مساحة عمل معزولة.
- يقرأ النموذج النتائج ويقرر ما يفعله بعد ذلك.
- يعيد النظام فرقاً (diff)، مخرجات اختبار، وملخصاً يمكن للمراجع التحقق منه.
هذه السلسلة أهم من أي رقم معياري واحد. يمكن أن يكون النموذج ممتازاً في توليد الكود لمرة واحدة ومع ذلك يفشل كوكيل إذا كان يعاني من استدعاء الأدوات، السياق الطويل، أو التعافي من الأخطاء.
قبل الانطلاق في حلقة التخطيط، من الجدير ذكر اتجاه نموذج واحد يناسب هذا المكدس جيداً. إذا كنت تريد نموذجاً مفتوحاً يظل قريباً من جودة البرمجة مغلقة المصدر، فإن Qwen3-Coder هو أحد أكثر الخيارات عملية للتقييم أولاً. يصف مستودع Qwen الرسمي Qwen3-Coder-Next كنموذج برمجة مفتوح الأوزان للوكلاء والتطوير المحلي، بنتائج مماثلة لـ Claude Sonnet في مهام البرمجة الوكيلة. كما يعرض كتالوج Novita الحالي للنماذج Qwen3 Coder Next و Qwen3 Coder 480B A35B Instruct و Qwen3 Coder 30B A3B Instruct من خلال LLM API، مما يسهل اختبار نفس العائلة عبر درجات مختلفة من التكلفة والجودة دون إعادة بناء التكامل.
كيفية بناء المكدس مع Novita
إذا كنت تريد نقطة بداية عملية بدلاً من تجميع مزودين منفصلين، فإن التقسيم المفيد هو:
- Novita LLM API للاستدلال، التوليد، ونماذج استدعاء الأدوات
- Novita Sandbox لتنفيذ الكود المعزول وحالة مساحة العمل المستمرة
واجهة Novita LLM API متوافقة مع OpenAI، لذا يمكنك توجيه عميل OpenAI موجود نحو Novita عن طريق تغيير عنوان URL الأساسي واسم النموذج.
الخطوة 1: استدعاء نموذج من خلال API المتوافق مع OpenAI
```python from openai import OpenAI
client = OpenAI( base_url=“https://api.novita.ai/openai”, api_key=“YOUR_NOVITA_API_KEY”, )
response = client.chat.completions.create( model=“qwen/qwen3-coder-next”, messages=[ {“role”: “system”, “content”: “أنت مساعد برمجة.”}, {“role”: “user”, “content”: “خطط للخطوات اللازمة لإضافة تحديد المعدل (rate limiting) إلى مسار تسجيل الدخول في FastAPI.”}, ], )
print(response.choices[0].message.content) ```
هذا يعطيك طبقة النموذج فقط. لا يعطي النموذج مكاناً آمناً للعمل.
الخطوة 2: تشغيل الكود في صندوق رملي بدلاً من حاسوبك المحمول
يستخدم دليل Novita Sandbox السريع الحالي كائن Novita SDK لإنشاء جلسة مترجم كود معزولة، تشغيل الكود، فحص الملفات، ثم إغلاق الصندوق الرملي عند اكتمال المهمة.
```python from novita_sandbox import Novita
novita = Novita() sandbox = novita.code_interpreter.create()
try: execution = sandbox.run_code(‘print(“مرحباً من الصندوق الرملي”)’) print(execution.logs)
files = sandbox.files.list("/tmp")
print(files)
finally: sandbox.kill() ```
هذا النمط هو أبسط نقطة بداية موثوقة لسير عمل برمجي بالذكاء الاصطناعي:
- يقرر النموذج ما يجب أن يحدث بعد ذلك.
- ينفذ الصندوق الرملي الجزء الخطير في بيئة معزولة.
- يمكن للجلسة الحفاظ على الحالة عبر المهمة بدلاً من البدء من الصفر في كل خطوة.
الخطوة 3: توصيل قرارات النموذج بتنفيذ الأدوات
بمجرد إضافة استدعاء الأدوات، تصبح حلقة الوكيل مباشرة:
| الأداة | الغرض |
|---|---|
read_file |
تحميل ملفات المشروع إلى سياق النموذج |
write_file |
تطبيق تغييرات الكود |
search_files |
البحث عن الرموز، المسارات، الاختبارات، أو إدخالات التكوين |
run_command |
تشغيل الاختبارات، البناء، أدوات التحليل، وأوامر الإعداد |
list_files |
اكتشاف بنية المستودع |
كما توثق Novita استدعاء الدوال والمخرجات المنظمة لسير عمل النماذج المتوافقة مع OpenAI. هذا مهم لأن حلقات الوكيل تنكسر بسهولة عندما تكون وسيطات الأدوات غير صحيحة أو غير متناسقة. عملياً، غالباً ما يكون استدعاء الأدوات الموثوق أكثر أهمية من معيار مثير للانتباه لدورة واحدة.
متى يكون المصدر المفتوح كافياً ومتى لا يكون؟
المصدر المفتوح يكون كافياً عادةً عندما:
- تريد فحص كيفية عمل النموذج أو الوكيل.
- تريد استضافة جزء من المكدس بنفسك.
- تحتاج إلى التحكم في المطالبات والأدوات وسلوك بيئة التشغيل.
- أنت مرتاح لتحمل العمل التشغيلي.
المصدر المفتوح عادةً لا يكون كافياً بمفرده عندما:
- تحتاج إلى تنفيذ متعدد المستخدمين مستقر مع سجلات تدقيق وتدفقات مراجعة.
- تحتاج إلى عزل قوي بما يكفي للكود غير الموثوق.
- تحتاج إلى توجيه النماذج، رؤية التسعير، أو عدة مستويات نماذج خلف API واحد.
- تريد أن يحافظ الوكيل على الحالة عبر مهام أطول دون بناء بيئة التشغيل تلك بنفسك.
هذه هي النقطة التي يتوقف عندها الفرق عن طلب “الكود المصدري للذكاء الاصطناعي” بشكل تجريدي ويبدأون بطرح الأجزاء التي يريدون امتلاكها فعلاً. بعض الفرق تريد السيطرة الكاملة. البعض الآخر يريد نماذج مفتوحة وأدوات مفتوحة المصدر، لكن ليس عبء تشغيل كل مكون بيئة تشغيل بأنفسهم.
الخاتمة
أفضل طريقة للتعامل مع الكود المصدري للذكاء الاصطناعي هي التوقف عن معاملته كقطعة واحدة. مستودعات النماذج، وكلاء الكود مفتوحو المصدر، وبيئات التشغيل المعزولة تحل مشاكل مختلفة. إذا مزجتهم معاً، يصبح تقييمك ضبابياً بسرعة.
ابدأ بالطبقة التي تحتاجها فعلاً:
- تريد تحكماً محلياً أو مستضافاً ذاتياً في النموذج؟ ابدأ بمستودعات النماذج المفتوحة.
- تريد وكيل كود مفتوح المصدر؟ ابدأ بـ OpenHands أو Goose أو Qwen Code.
- تريد مكدس برمجة عملي يمكنه التخطيط والعمل والتنفيذ بأمان؟ اقرن API نموذج متوافق مع OpenAI ببيئة تشغيل معزولة مدارة.
لهذا السبب فإن الجمع بين نموذج برمجة مفتوح وحدود تنفيذ مدارة هو غالباً المسار الأكثر عملية. تحتفظ بالمرونة في طبقة النموذج دون تسليم وصول خام للصدفة (shell) إلى نموذج على جهازك الأساسي.
الأسئلة الشائعة
أين يمكنني العثور على كود مصدري للذكاء الاصطناعي؟
عادةً في ثلاثة أماكن: مستودعات النماذج، مستودعات الوكلاء، ووثائق الصندوق الرملي أو بيئة التشغيل. إذا كنت تريد وكيل كود مفتوح المصدر، ابدأ بمشاريع الوكلاء مثل OpenHands أو Goose أو Qwen Code بدلاً من مستودعات النماذج العامة.
ما هو وكيل الكود مفتوح المصدر؟
هو وكيل يمكنه فحص الملفات، تخطيط مهمة، استخدام الأدوات، تشغيل الأوامر، ومراجعة مخرجاته داخل مشروع. الفرق المهم عن مساعد البرمجة هو الفعل، وليس مجرد التوليد.
هل كود النموذج المصدر كافٍ لبناء وكيل برمجة بالذكاء الاصطناعي؟
لا. النموذج وحده لا يعطيك الوصول إلى المستودع، توصيل الأدوات، التحكم في التنفيذ، السجلات، المعاينات، أو العزل. لا تزال بحاجة إلى حلقة وكيل وبيئة تشغيل حيث يمكن لأفعال النموذج التنفيذ بأمان.
ما النموذج الذي يجب أن أختبره أولاً لسير العمل البرمجي المفتوح؟
إذا كنت تريد نموذجاً مفتوحاً بُني خصيصاً لوكلاء البرمجة، فإن Qwen3-Coder هو نقطة انطلاق قوية. يركز مستودع Qwen3-Coder الحالي على البرمجة الوكيلة ودعم السياق الطويل، وتوفر Noviva عدة متغيرات من Qwen3-Coder من خلال نفس API.
لماذا يحتاج وكلاء البرمجة إلى صندوق رملي؟
لأنهم يشغلون أوامر، يثبتون تبعيات، ويعدلون ملفات. يوفر الصندوق الرملي للوكيل بيئة تشغيل معزولة، ويحافظ على حالة المهمة، ويحد من نصف القطر الانفجاري عندما يفعل النموذج شيئاً خاطئاً.
