إذا كنت تبحث عن كود مصدر للذكاء الاصطناعي، فعادةً ما تحتاج أحد ثلاثة أشياء: كود النموذج وأوزانه، أو وكيل كود مفتوح المصدر يمكنه التخطيط واستخدام الأدوات، أو حزمة تطبيقية تسمح للنموذج بقراءة الملفات وتنفيذ الأوامر وإرجاع نتيجة قابلة للمراجعة. هذه الطبقات مترابطة، لكنها ليست نفس المنتج. أسرع طريقة لفهم المجال هي فصل النموذج، وحلقة الوكيل، وبيئة التشغيل المعزولة التي تنفذ العمل.
ما يعنيه “كود مصدر للذكاء الاصطناعي” عادةً
العبارة واسعة لدرجة أن شخصين يمكنهما استخدامها ويعنيان شيئين مختلفين تمامًا.
أحيانًا تعني كود مصدر النموذج: كود التدريب، كود الاستدلال، منطق الترميز، وأوزان قابلة للتنزيل لنموذج مفتوح. وأحيانًا تعني برنامج الوكيل: الأداة التي تعمل في طرفية أو متصفح، تقرأ مستودعًا، تخطط مهمة، تكتب كودًا، تجري اختبارات، وتنقح مخرجاتها الخاصة. وأحيانًا تعني السقالات المنتج حول ذلك الوكيل: استدعاءات API، المصادقة، دورة حياة البيئة المعزولة، معالجة الملفات، السجلات، المعاينات، ومراحل المراجعة.
هذا التمييز مهم لأن فريقًا يبحث عن نموذج مفتوح لا ينبغي أن يقيم نفس الأشياء التي يقيمها فريق يبحث عن وكيل برمجة مفتوح المصدر.
استخدم هذا الفلتر السريع:
| إذا كنت بحاجة إلى… | ابحث عن… |
|---|---|
| نموذج يمكنك تشغيله أو ضبطه بدقة أو استدعاؤه عبر API | مستودع النموذج، بطاقة النموذج، الترخيص، حدود السياق، دعم استدعاء الأدوات |
| أداة برمجة يمكنها العمل داخل مشروع | وكيل كود مفتوح المصدر، CLI، تطبيق سطح مكتب، أو منصة وكلاء |
| طبقة تنفيذ إنتاجية | بيئة تشغيل معزولة، عزل مساحة العمل، سياسة الحزم، معالجة الأسرار، السجلات، والمعاينات |
أين تجد كود المصدر لمشاريع الذكاء الاصطناعي
بالنسبة لمعظم سير عمل المطورين، الإجابة الحقيقية هي “في عدة مستودعات، وليس واحدًا”.
1. مستودعات النماذج
هنا تجد بنية النموذج، وثائق الاستخدام، نقاط التفتيش أو روابطها، شروط الترخيص، وملاحظات القياس. إذا كان هدفك هو الاستدلال المحلي، الضبط الدقيق، أو دراسة كيفية تغليف النموذج لمهام البرمجة، ابدأ من هنا.
على سبيل المثال، مستودع Qwen3-Coder الرسمي لـ Qwen يصف Qwen3-Coder-Next كنموذج مفتوح الأوزان مبني خصيصًا لوكلاء البرمجة والتطوير المحلي، مع دعم سياق طويل وتنسيق استدعاء دالة موجه لسير العمل الوكيل.
2. مستودعات الوكلاء
هنا تجد حلقة المخطط، توصيل الأدوات، واجهة الطرفية، محولات موفري النماذج، وأحيانًا تكاملات المتصفح أو MCP.
ثلاثة أمثلة مفيدة:
- OpenHands يضع نفسه كمنصة مفتوحة لوكلاء البرمجة السحابية ومركز تحكم يمكنه تشغيل الوكلاء محليًا، في Docker، على أجهزة ظاهرية، أو عبر خلفيات سحابية.
- Goose هو وكيل مفتوح المصدر مع واجهات سطح مكتب، CLI، وAPI يعمل على جهازك ولا يقتصر على مهام البرمجة.
- Qwen Code هو أداة برمجة موجهة للطرفية من Qweن تركز على سير الم العمل الوكيل في البرمجة بدلاً من الدردشة العامة.
إذا كان سؤالك الرئيسي هو “ما هو وكيل الكود مفتوح المصدر الذي يجب أن أفحصه أولاً؟”، فابدأ بمستودعات الوكيل، وليس أوزان النموذج.
3. وثائق البيئة المعزولة ووقت التنفيذ
هذه هي الطبقة التي يتخطاها العديد من الفرق في البداية، ثم يعودون إليها عندما يبدأ الوكيل في القيام بعمل حقيقي.
تصف وثائق Sandbox من Novita بيئة التشغيل كبيئة معزولة ذات حالة للوكلاء الذين يحتاجون إلى تشغيل الكود، تثبيت التبعيات، الوصول إلى الملفات، استخدام المتصفحات، والاحتفاظ بالحالة عبر الجلسات. هذه هي حدود التنفيذ، وليست مجرد غلاف ملائم. بمجرد أن يتمكن الوكيل من تشغيل الأوامر، تصبح بيئة التشغيل بنفس أهمية النموذج.
ما الذي يجعل وكيل الكود مفتوح المصدر مختلفًا
وكيل الكود مفتوح المصدر ليس مجرد LLM مع قالب تعليمات. يصبح وكيلًا عندما يمكنه مراقبة مساحة عمل، اتخاذ قرار بشأن الإجراء التالي، تنفيذ ذلك الإجراء من خلال الأدوات، قراءة النتيجة، ومواصلة التكرار.
تلك الحلقة تحتاج عادةً إلى أربعة أجزاء:
| الطبقة | المهمة |
|---|---|
| المخطط | تقسيم المهمة إلى خطوات وتحديد متى تكتمل المهمة |
| النموذج | التفكير في الملفات، مخرجات الأوامر، واستدعاءات الأدوات السابقة |
| طبقة الأدوات | قراءة الملفات، كتابة الملفات، البحث، تشغيل الأوامر، فتح المعاينات |
| البيئة المعزولة | عزل التنفيذ، الحفاظ على حالة مساحة العمل، واحتواء الآثار الجانبية |
بدون البيئة المعزولة، يتحول “وكيل الكود مفتوح المصدر” غالبًا إلى “نموذج مع وصول خطير إلى شل”.
هذا أيضًا هو المكان الذي تبدأ فيه المجموعة لتبدو أكثر كبنية تحتية هندسية من ميزة دردشة. بمجرد أن يتمكن النموذج من تثبيت الحزم، فتح المنافذ، وإعادة كتابة الملفات، تحتاج إلى الإجابة على أسئلة تشغيلية:
- ما هي حالة المستودع التي يبدأ منها الوكيل؟
- أي الأوامر تعمل تلقائيًا وأيها تتطلب موافقة؟
- هل يمكن للوكيل جلب الحزم أو تصفح عناوين URL عشوائية؟
- أين تذهب السجلات، الفروقات، المعاينات، والقطع الأثرية المُنشأة؟
- كيف توقف الجلسة مؤقتًا أو تستأنفها أو تنهيها؟
تحدد هذه الأسئلة ما إذا كان المشروع عرضًا توضيحيًا أم سير عمل يمكن لفريقك الوثوق به.
بنية وكيل برمجة عملية
أنظف طريقة للتفكير في كود المصدر لوكلاء الذكاء الاصطناعي هي كسلسلة:
- يصف المستخدم المهمة.
- يحول النموذج المهمة إلى خطة.
- يستدعي الوكيل أدوات لفحص قاعدة الكود.
- تنفذ بيئة التشغيل تلك الاستدعاءات في مساحة عمل معزولة.
- يقرأ النموذج النتائج ويقرر ما يفعله بعد ذلك.
- يعيد النظام فرقًا، ومخرجات اختبار، وملخصًا يمكن للمراجع التحقق منه.
هذه السلسلة تهم أكثر من أي رقم قياسي واحد. يمكن أن يكون النموذج ممتازًا في إنشاء الكود لمرة واحدة ومع ذلك يفشل كا وكيل إذا كان يعاني من استدعاء الأدوات، السياق الطويل، أو استرداد الأخطاء.
قبل الانطلاق في حلقة التخطيط، من الجدير ذكر اتجاه نموذج واحد يناسب هذه المجموعة جيدًا. إذا كنت تريد نموذجًا مفتوحًا يظل قريبًا من جودة البرمجة مفتوحة المصدر، فإن 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 لتنفيذ الكود المعزول وحالة مساحة العمل المستمرة
LLM API من Novita متوافق مع OpenAI، لذا يمكنك توجيه عميل OpenAI موجود إلى Novita عن طريق تغيير عنوان URL الأساسي واسم النموذج.
الخطوة 1: استدعاء نموذج من خلال API المتواقف مع OpeAI
from openai import OpenAI
client = OpenAI(
base_url="https://api.novita.ai/openai",
api_key="YOUR_NOVITA_API_KEY",
)
response = client.chat.completions.creat(
model="qwen/qwen3-coder-next",
messages=[
{"role": "system", "content": "You are a coding assistant."},
{"role": "user", "content": "Plan the steps to add rate limiting to a FastAPI login route."},
],
)
print(response.choices[0].message.content)
هذا يمنحك فقط طبقة النموذج. لا يمنح النموذج مكانًا آمنًا للعمل.
الخطوة 2: تشغيل الكود في بيئة معزولة بدلاً من جهاز الكمبيوتر المحمول
يستخدم الدليل السريع الحالي لـ Novita Sandbox كائن SDK Novita لإنشاء جلسة مترجم كود معزولة، تشغيل الكود، فحص الملفات، ثم إيقاف تشغيل الصندوق عند اكتمال المهمة.
from novita_sandbox import Novita
novita = Novita()
sandbox = novita.cod_enterpreter.creat()
try:
execution = sandbox.run_cod('print("hello from the sandbox")')
print(execution.logs)
files = sandbox.fils.list("/tmp")
print(files)
finally:
sandbox.kill()
هذا النمط هو أبسط نقطة بداية موثوقة لسير عمل برمجة الذكاء الاصطناعي:
- يقرر النموذج ما يجب أن يحدث بعد ذلك.
- تؤدي البيئة المعزولة الجزء الخطير في بيئة معزولة.
- يمكن للجلسة الاحتفاظ بالحالة عبر المهمة بدلاً من البدء من الصفر في كل خطوة.
الخطوة 3: توصيل قرارات النموذج بتنبذ الأداة
بمجرد إضافة استدعاء الأداة، تصبح حلقة الوكيل واضحة:
| الأداة | الغرض |
|---|---|
read_file |
تحميل ملفات المشروع إلى سياق النموذج |
write_file |
تطبيق تغييرات الكود |
search_files |
العثور على الرموز، المسارات، الاختبارات، أو إدخالات التكوين |
run_command |
تشغيل الاختبارات، البناء، المدققات، وأوامر الإعداد |
list_files |
اكتشاف بنية المستودع |
توثق Novita أيضًا استدعاء الدوال والمخرجات المنظمة لسير عمل النموذج المتوافق مع OpenAI. هذا مهم لأن حلقات الوكيل تنكسر بسهولة عنما تكون وسائط الأداة مشوهة أو غير متناسقة. في الممارسة، غالبًا ما يكون استدعاء الأداة المويق أههم من معيار وامض ذي لمحة واحدة.
متى يكفي المصدر المفتوح ومتء لا يكفي
المصدر المفتوح يكفي عادة عنما:
- تريد فحص كيقة عم النموذج أو الوكييل.
- تريد اسيتضافة جزء من المجموعة بنفسك.
- تحناج إلى السيطرة عل الإيعازات والأدوات وسلو وقت التنفيذ.
- تريح بامتلاك العمل التشيلي بنفسك.
المصدر المفتوح عادة لا يكفي بمفرده عنما:
- تحتاج إلى تنفيذ مستقر بعدة مستخدمين مع سجلات تدقيق وتدفقات مراجعة.
- تحتاج إلى عزلة كافية لكود غير موثوق.
- تحتاج إلى توجيه النموذج، رؤية التسعير، أو عدء مستوي ات نماذج خلف API واح.
- تريد أن يحتفظ الوكيل بالحالة عب أطوال أطول دو نباء وقت التنفيد ذل بنفسك.
هذة هي النقطة حيث تتوفق الفرق عن طلب “كود مصدر للذكاء الاصطناعي” بشك مجرد وتبدأ في طلب أي الأجزء تريد امتلكاه فعليًا. بعض الفرق تريد السيطرة الكاملة. أخرون يريدون نماذج مفتوحة وأدو مفتوحة المصدر، ولك ل عبئ تشغيل كل مكون وقت التنفيد بأنفسهم.
الخاتمة
أفهل طريقة لمعالجة كود المصدر للذكاء الاصطناعي هي التوقف عن معاملته كقطعة واحدة. مستودعات النماذج، وكلاء الكود مفتوحي المصدر، وبيئت التشغيل المعزولة تحل مشاكل مخلفة. إذا خلطتهم معًا، يصبح تقييمك غير واضح بسرعة.
ابدأ بالطبقة التي تحتاجها بالفعل:
- تريد سيطرة محلية أو مفتوحة المصدر عل النموذج؟ ابدا بمستودعات النموذج المف توحة.
- تريد وكي كود مفتوح المصدر؟ ابدا بـ OpenHands أو Goose أو Qwen Cod.
- تريد مجموعة برمجة عاملة يمكنا التخطيط والعم والتنفيد بأ مان؟ قم بقرن API نماذج متوافق مع OpeAI مع بيئة تشغيل معزولة ومعزولة.
لهذا السبب غالبًا ما يكون المزيج من نموذج برمجة مفتوح وحدود تنفيذ مُدارة هو المسار الأكثر عمليً. تحتفظ بالمرونة في طبقة النموذج دو تسليم وصو شل خام إل نموذج عل جهزك الرئيي.
الأسئلة الشائعة
أين يمك العثور عل كود مصدر للذكاء الاصطناعي؟
عادة في ثلثة أماكن: مستودعات النماذج، مستودعات الوكلاء، ووثائق البيئة المعزولة أو وقت التنفيذ. إذا كنت تريد وكيل كود مفتوح المصدر، ابدأ بمشاريع الوكيل مثل OpenHands أو Goose أو Qwen Code بدلاً من مستودعات النماذج العامة.
ما هو وكيل الكود مفتوح المصدر؟
هو وكيل يمكنه فحص الملفات، تخطيط مهمة، استخدام الأدوات، تشغيل الأوامر، وتنقيح مخرجاته داخل مشروع. الاختلاف المهم عن مساعد الكود هو الفعل، وليس مجرد التوليد.
هل كود مصدر النموذج كافٍ لبنء وكيل برمجة ذكاء اصطناعي؟
لا. النموذج وحده لا يمنحك الوصول إلى المستودع، توصيل الأدوات، السيطرة عل التنفيذ، السجلات، المعاينات، أو العزل. لا تزل تحتاج إلى حلق وكيل ووقت تنفيذ حي يمك تنفيد أفع النموذج بأ مان.
ما النموذج الذي يجب اختباره أولاً لسير عمل البرمجة المفتوحة؟
إذا كنت تريد نموذجًا مفتوحًا مبنيًا خصيصًا لوكلاء البرمجة، فإن Qwen3-Coder هو مكان قوي للبدء. يؤكد مستودع Qwen3-Coder الحالي على البرمجة الوكيلة ودعم السياق الطويل، ويعرض Novita عدة متغيرات من Qwen3-Coder من خلال نفس API.
لماذا يحتاج وكلاء البرمجة إلى بيئة معزولة؟
لأنهم يشغلون الأوامر ويثبتون التبعيات ويعدلون الملفات. توفر البيئة المعزولة وقت تنفيذ معزول للوكيل، وتحافظ على حالة المهمة، وتحد من نصف قطر الانفجار عندما يفعل النموذج شيئًا خاطئًا.
