قم ببناء وكيل برمجة ذكاء اصطناعي محلي خاص بك باستخدام Gemma 4 وOpenCode

بناء وكيل برمجة ذكي محلي خاص بك باستخدام Gemma 4 وOpenCode

يتغير مشهد تطوير البرمجيات بمساعدة الذكاء الاصطناعي بسرعة. بينما أصبحت مساعدات البرمجة السحابية مثل GitHub Copilot وChatGPT أدوات لا غنى عنها، إلا أنها تأتي مع مقايضات متأصلة: زمن الاستجابة، تكاليف الاشتراك، والأهم من ذلك—مخاوف الخصوصية عند إرسال كود خاص إلى خوادم خارجية.

نحن الآن في عصر وكلاء البرمجة الذكية المحليين. مع إصدار Gemma 4—نموذج لغة قوي مفتوح الوزن محسّن لتوليد الكود والاستدلال—وOpenCode، إطار عمل مفتوح المصدر لبناء وكلاء برمجة مستقلين، يمكنك الآن تشغيل مساعد برمجة ذكي كامل الوظائف بالكامل على أجهزتك الخاصة. تقدم هذه المقالة دليلاً عملياً خطوة بخطوة لبناء وكيل برمجة ذكي محلي خاص بك باستخدام هاتين التقنيتين.

لماذا نبني وكيل برمجة محلي؟

قبل الخوض في التفاصيل التقنية، من الجدير فهم مزايا تشغيل وكيل برمجة محلياً:

• **خصوصية البيانات**: كودك لا يغادر جهازك أبداً. هذا ضروري للمؤسسات ذات متطلبات الامتثال الصارمة أو للمطورين الذين يعملون على مشاريع خاصة.
• **زمن استجابة صفري**: لا توجد رحلات ذهاب وإياب عبر الشبكة. يتم إنشاء الردود بأسرع ما يمكن لوحدة معالجة الرسومات لديك.
• **بدون رسوم اشتراك**: بمجرد امتلاكك للعتاد، يكون البرنامج مجاني ومفتوح المصدر.
• **تحكم كامل**: يمكنك ضبط النموذج بدقة، تخصيص سلوك الوكيل، ودمجه مع سير عملك التطويري الحالي دون حدود لمعدل واجهة برمجة التطبيقات.

المقايضة الرئيسية هي متطلبات العتاد: تشغيل نموذج قادر مثل Gemma 4 محلياً يتطلب وحدة معالجة رسومات حديثة مع ذاكرة وصول عشوائي فيديو كافية (يفضل 16 جيجابايت أو أكثر) ومعالج مركزي جيد.

المتطلبات

لمتابعة هذا الدليل، ستحتاج إلى:

العتاد

• **وحدة معالجة رسومات**: NVIDIA مع 12 جيجابايت على الأقل من ذاكرة الوصول العشوائي للفيديو (16 جيجابايت+ موصى بها لـ Gemma 4 9B). النماذج ذات ذاكرة الوصول العشوائي للفيديو الأقل قد تتمكن من تشغيل إصدارات مكممة.
• **ذاكرة الوصول العشوائي**: 32 جيجابايت من ذاكرة الوصول العشوائي للنظام (16 جيجابايت كحد أدنى).
• **التخزين**: 20 جيجابايت من مساحة القرص الحرة للنماذج والأدوات.
• **الإنترنت**: مطلوب فقط للتنزيلات الأولية.

البرمجيات

• **نظام التشغيل**: Linux (Ubuntu 22.04/24.04 موصى به) أو Windows مع WSL2.
• **Python**: 3.10 أو أحدث.
• **CUDA**: 12.1 أو أحدث (إذا كنت تستخدم وحدة معالجة رسومات NVIDIA).
• **Git**: لاستنساخ المستودعات.

المعرفة

• إلمام أساسي بسطر الأوامر.
• فهم البيئات الافتراضية لـ Python.

التثبيت خطوة بخطوة

سنقوم بتثبيت نموذج Gemma 4 باستخدام مكتبة `transformers` من Hugging Face، ثم إعداد OpenCode كإطار عمل للوكيل.

الخطوة 1: إعداد بيئة Python

قم بإنشاء بيئة افتراضية مخصصة لتجنب تعارض التبعيات.

python3 -m venv gemma-opencode-env
source gemma-opencode-env/bin/activate

هذا ينشئ وينشط بيئة Python نظيفة. جميع التثبيتات اللاحقة ستكون معزولة داخلها.

الخطوة 2: تثبيت التبعيات الأساسية

قم بتثبيت المكتبات الرئيسية المطلوبة لتشغيل النموذج وإطار عمل الوكيل.

pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu121
pip install transformers accelerate bitsandbytes
pip install opencode

السطر الأول يثبت PyTorch مع دعم CUDA 12.1. السطر الثاني يثبت `transformers` من Hugging Face (لتحميل Gemma 4)، و`accelerate` (لاستخدام متعدد وحدات معالجة الرسومات بكفاءة)، و`bitsandbytes` (للكم 4 بت لتقليل استخدام ذاكرة الوصول العشوائي للفيديو). السطر الثالث يثبت إطار عمل OpenCode.

الخطوة 3: تنزيل نموذج Gemma 4

يتوفر Gemma 4 على Hugging Face بموجب ترخيص مسموح به. يجب عليك قبول شروط الاستخدام على بطاقة النموذج قبل التنزيل.

أولاً، قم بتثبيت واجهة سطر الأوامر لـ Hugging Face وسجل الدخول:

pip install huggingface-hub
huggingface-cli login

سيطلب منك هذا رمز وصول. قم بإنشاء واحد من إعدادات حساب Hugging Face الخاص بك (الإعدادات → رموز الوصول). ثم، قم بتنزيل النموذج:

huggingface-cli download google/gemma-4-9b-it --local-dir ./gemma-4-9b-it

هذا يقوم بتنزيل الإصدار المعدّل بالتعليمات من Gemma 4 (9B معلمة). إذا كانت ذاكرة الوصول العشوائي للفيديو لديك محدودة، فكر في استخدام الإصدار 2B (`google/gemma-4-2b-it`) أو تطبيق الكم أثناء التحميل.

الخطوة 4: تكوين OpenCode

يستخدم OpenCode ملف تكوين YAML. قم بإنشاء ملف باسم `opencode_config.yaml` في دليل العمل الخاص بك:

model:
  name: "google/gemma-4-9b-it"
  load_in_4bit: true
  device_map: "auto"

agent:
  max_tokens: 2048
  temperature: 0.2
  top_p: 0.95
  system_prompt: "أنت مهندس برمجيات خبير. اكتب كوداً نظيفاً وفعالاً وموثقاً جيداً. اشرح دائماً منطقك بإيجاز."
  
tools:
  - file_reader
  - file_writer
  - shell_executor
  - code_analyzer

هذا التكوين يخبر OpenCode بما يلي:

• تحميل Gemma 4 في وضع الكم 4 بت (يقلل استخدام ذاكرة الوصول العشوائي للفيديو بحوالي 4 مرات).
• استخدام درجة حرارة محافظة (0.2) لتوليد كود حتمي.
• تمكين أدوات معالجة الملفات وتنفيذ الصدفة.

الخطوة 5: تشغيل الوكيل

مع كل شيء مهيأ، ابدأ الوكيل:

opencode --config opencode_config.yaml

يجب أن ترى مخرجات تشير إلى أن النموذج يتم تحميله وأن الوكيل جاهز. قد يستغرق التشغيل الأول بضع دقائق حيث يتم تحميل النموذج في الذاكرة وكمه.

أمثلة الاستخدام

بمجرد تشغيل الوكيل، يمكنك التفاعل معه من خلال واجهة طرفية. إليك أمثلة عملية لما يمكنك أن تطلب منه فعله.

المثال 1: إنشاء سكريبت Python

**الطلب:** "أنشئ سكريبت Python يقرأ ملف CSV، وينظف القيم المفقودة بملئها بمتوسط العمود، ويحفظ البيانات المنظفة في ملف جديد."

سيقوم الوكيل داخلياً باستدعاء أداة `file_writer` لإنشاء السكريبت، ثم اختيارياً استخدام `shell_executor` لاختباره. سترى مخرجات مثل:

الوكيل: سأقوم بإنشاء سكريبت باسم `clean_csv.py`. إليك التنفيذ:

import pandas as pd
import sys

def clean_csv(input_file, output_file):
    df = pd.read_csv(input_file)
    for col in df.columns:
        if df[col].dtype in ['float64', 'int64']:
            df[col].fillna(df[col].mean(), inplace=True)
    df.to_csv(output_file, index=False)
    print(f"تم حفظ البيانات المنظفة في {output_file}")

if __name__ == "__main__":
    if len(sys.argv) != 3:
        print("الاستخدام: python clean_csv.py <input.csv> <output.csv>")
        sys.exit(1)
    clean_csv(sys.argv[1], sys.argv[2])

المثال 2: تصحيح مقطع كود

**الطلب:** "إليك دالة بها أخطاء. ابحث عن المشكلة وأصلحها: `def add(a, b): return a - b`"

سيقوم الوكيل بتحليل الكود والرد:

الوكيل: الخطأ هو خطأ منطقي في العملية الحسابية. الدالة اسمها `add` لكنها تقوم بعملية طرح. إليك النسخة المصححة:

def add(a, b):
    return a + b

المثال 3: إعادة هيكلة قاعدة كود

**الطلب:** "أعد هيكلة دالة JavaScript التالية لاستخدام صيغة ES6+ الحديثة: `function multiply(x, y) { return x * y; }`"

الوكيل: إليك النسخة المعاد هيكلتها باستخدام دوال السهم في ES6+:

const multiply = (x, y) => x * y;

يمكن للوكيل أيضاً التعامل مع المشاريع متعددة الملفات باستخدام أدوات قراءة وكتابة الملفات بالتسلسل.

المثال 4: توليد اختبارات تلقائية

**الطلب:** "قم بتوليد اختبارات وحدة في pytest لدالة `clean_csv` التي أنشأناها سابقاً."

سيقوم الوكيل بإنشاء ملف `test_clean_csv.py` مع حالات اختبار مناسبة، تغطي الحالات الحدودية مثل الملفات الفارغة، القيم المفقودة، والأعمدة غير الرقمية.

ضبط الأداء

إذا واجهت مشاكل في الأداء (استجابات بطيئة أو أخطاء نفاد الذاكرة)، جرب هذه التعديلات:

تقليل حجم النموذج

استخدم إصدار 2B معلمة بدلاً من 9B:

model:
  name: "google/gemma-4-2b-it"

زيادة الكم

استخدم 8 بت بدلاً من 4 بت لجودة أفضل قليلاً ولكن استخدام أعلى لذاكرة الوصول العشوائي للفيديو:

load_in_8bit: true

تقليل نافذة السياق

قلل `max_tokens` في تكوين الوكيل إلى 1024 أو 512 للحصول على استجابات أسرع في المهام الأقصر.

تفريغ وحدة المعالجة المركزية

إذا كانت ذاكرة الوصول العشوائي للفيديو لديك محدودة ولكن ذاكرة الوصول العشوائي للنظام وفيرة، قم بتمكين تفريغ وحدة المعالجة المركزية:

# في سكريبت تشغيل مخصص
from transformers import AutoModelForCausalLM
model = AutoModelForCausalLM.from_pretrained(
    "google/gemma-4-9b-it",
    device_map="auto",
    offload_folder="./offload"
)

التكامل مع بيئة التطوير المتكاملة الخاصة بك

لتجربة تطوير سلسة، يمكنك توصيل OpenCode بمحررك. الطريقة الأبسط هي استخدام مضاعف طرفية مثل `tmux` أو `screen` لتشغيل الوكيل بجانب محركك.

لمستخدمي VS Code، قم بتثبيت "إضافة OpenCode لـ VS Code" (إذا كانت متوفرة) أو استخدم لوحة الطرفية المدمجة للتفاعل مع الوكيل دون مغادرة محركك.

الخلاصة

بناء وكيل برمجة ذكي محلي خاص بك باستخدام Gemma 4 وOpenCode ليس فقط ممكناً بل ومباشر بشكل مدهش. باتباع الخطوات الموضحة في هذه المقالة، لديك الآن مساعد برمجة كامل الوظائف، يحافظ على الخصوصية، ومجاني التكلفة يعمل على أجهزتك الخاصة.

النقاط الرئيسية هي:

• **Gemma 4** يوفر قدرات توليد كود متطورة في صيغة مفتوحة الوزن.
• **OpenCode** يقدم إطار عمل مرن لإنشاء وكلاء مستقلين مع قدرات استخدام الأدوات.
• **النشر المحلي** يلغي مخاوف الخصوصية وزمن استجابة الشبكة، مع منحك تحكماً كاملاً.

مع استمرار نضوج نظام الذكاء الاصطناعي مفتوح المصدر، أدوات مثل Gemma 4 وOpenCode تعمل على ديمقراطية الوصول إلى المساعدة الذكية المتقدمة. القدرة على تشغيل وكلاء برمجة قادرين محلياً لم تعد رؤية مستقبلية—إنها حقيقة عملية متاحة لأي مطور يمتلك وحدة معالجة رسومات لائقة.

ابدأ التجربة اليوم. وكيل البرمجة المحلي الخاص بك على بعد بضعة أوامر فقط.