AI Agents · درس

التنفيذ المعزول لوكلاء الشيفرة

لا تشغّل الشيفرة التي ينشئها النموذج على مضيفك مطلقًا؛ استخدم بيئات gVisor أو Firecracker أو E2B المعزولة.

التنفيذ المعزول لوكلاء الشيفرة درس مجاني في AI Agents على CoddyKit. هذا هو الدرس 3 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في AI Agents، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة AI Agents 4 دروس في المجموع.

بعض أجزاء هذا الدرس لم تُترجم بعد وتظهر باللغة الإنجليزية.

لماذا نستخدم بيئة معزولة؟

تشغّل وكلاء التعليمات البرمجية (Devin وClaude Code وOpenDevin) تعليمات برمجية ينشئها النموذج. إذا شغّلتم تلك التعليمات البرمجية على مضيفكم، فقد يتمكن النموذج من:

قراءة أسراركم أو مفاتيح API
حذف الملفات
إجراء اتصالات بالشبكة الخارجية
تعدين العملات المشفرة

البيئة المعزولة = بيئة منفصلة تحد من الأضرار.

مستويات العزل

المستوى	الأداة	الاستخدام
العملية	subprocess + chroot	أمان منخفض، للتطوير فقط
الحاوية	Docker	خيار افتراضي مناسب
VM / microVM	Firecracker وgVisor	عزل قوي
بيئة معزولة مستضافة	E2B وDaytona	الأسهل للإنتاج

Docker Sandbox Basics

docker run \
  --rm \
  --network=none \
  --memory=512m \
  --cpus=0.5 \
  --read-only \
  --user=nobody \
  -v /tmp/work:/work:rw \
  python:3.11-slim \
  python /work/script.py

عزل الشبكة

يؤدي --network=none إلى تعطيل حركة المرور الصادرة. تحتاج بعض المهام إلى إنترنت محدود — استخدموا وكيل خروج يسمح بقائمة محددة من المضيفين.

حدود الموارد

تمنع الحدود الاستهلاك المنفلت لوحدة المعالجة المركزية والذاكرة:

--memory — حد الذاكرة العشوائية
--cpus — حصة وحدة المعالجة المركزية
--pids-limit — عدد العمليات
--ulimit — واصفات الملفات

Firecracker وgVisor

للحصول على عزل أقوى من Docker:

Firecracker — microVM من AWS، وتستخدمه Lambda
gVisor — نواة في مساحة المستخدم من Google، وتعمل كبديل مباشر لـ Docker
Kata Containers — تجربة Docker مع عزل VM

بيئة E2B المعزولة المستضافة

توفّر E2B (e2b.dev) بيئة معزولة بعيدة عبر API:

# pip install e2b
import e2b
sandbox = e2b.Sandbox(template='python', api_key='...')

result = sandbox.run_code('print(2 + 2)')
print(result.stdout)   # '4'

sandbox.close()

Daytona

يوفر Daytona إمكانات مشابهة للبيئات المعزولة المستضافة، وموجهة نحو مساحات عمل التطوير.

بيئة نظام الملفات المعزولة

ركّبوا فقط ما يحتاجه الوكيل بصلاحيات القراءة والكتابة، واجعلوا كل ما عداه للقراءة فقط أو مخفيًا:

docker run -v ${PWD}/workdir:/workdir:rw \
           -v ${PWD}/readonly:/readonly:ro ...

الحدود الزمنية

حدّدوا وقت التنفيذ الفعلي لمنع الحلقات اللانهائية:

docker run --rm --stop-timeout 30 ... \
  python -c 'import resource; resource.setrlimit(resource.RLIMIT_CPU, (30, 30)); exec(open("/work/script.py").read())'

التسجيل

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

بيئات معزولة متعددة المستأجرين

تمنع البيئات المعزولة الخاصة بكل مستخدم المستخدمين من تلويث حالة بعضهم بعضًا. أنشئوا بيئة معزولة جديدة لكل جلسة، ثم أزيلوها بعد ذلك.

التكلفة مقابل الأمان

يعني العزل الأقوى تكلفة أعلى (بسبب النفقات العامة لكل VM). وازنوا المستوى مع درجة المخاطر:

بالنسبة إلى البرامج التعليمية أو ميزة البيئة المعزولة للمستخدمين: يكفي Docker
بالنسبة إلى تعليمات برمجية في الإنتاج تتعامل مع الأسرار: استخدموا Firecracker أو E2B

تقييد الشبكة

كيف تمنعون وكيلًا برمجيًا من إجراء أي اتصالات صادرة عبر الشبكة؟

مراجعة

لا تشغّلوا مطلقًا تعليمات برمجية أنشأها النموذج على المضيف لديكم. اختاروا مستوى العزل وفقًا للمخاطر: Docker للتطوير، وgVisor / Firecracker / E2B للإنتاج. حدّدوا استهلاك وحدة المعالجة المركزية والذاكرة والوقت والشبكة.

الأسئلة الشائعة

هل درس «التنفيذ المعزول لوكلاء الشيفرة» مجاني؟

نعم — نص درس «التنفيذ المعزول لوكلاء الشيفرة» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة AI Agents، انتقل إلى CoddyKit PRO. تتضمن دورة AI Agents 4 دروس في المجموع.

ماذا ستتعلم في «التنفيذ المعزول لوكلاء الشيفرة»؟

لا تشغّل الشيفرة التي ينشئها النموذج على مضيفك مطلقًا؛ استخدم بيئات gVisor أو Firecracker أو E2B المعزولة. تتمرن على AI Agents مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.

هل أحتاج إلى خبرة سابقة لأبدأ AI Agents؟

لا تُشترط خبرة سابقة. AI Agents على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 3 من أصل 4.

كم من الوقت يستغرق درس «التنفيذ المعزول لوكلاء الشيفرة»؟

معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.

هل يمكنني كتابة وتشغيل أكواد في درس AI Agents هذا؟

نعم. كل درس في AI Agents يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.

جميع الدروس في هذه الدورة

← العودة إلى AI Agents