الانتقال إلى المحتوى الرئيسي

CodeInterpreterTool

مهجور: تمت إزالة CodeInterpreterTool من crewai-tools. كما أن معاملَي allow_code_execution وcode_execution_mode على Agent أصبحا مهجورَين. استخدم خدمة بيئة معزولة مخصصة — E2B أو Modal — لتنفيذ الكود بشكل آمن ومعزول.

الوصف

تمكّن CodeInterpreterTool وكلاء CrewAI من تنفيذ كود Python 3 الذي يولّدونه بشكل مستقل. هذه الوظيفة ذات قيمة خاصة لأنها تتيح للوكلاء إنشاء الكود وتنفيذه والحصول على النتائج واستخدام تلك المعلومات لاتخاذ القرارات والإجراءات اللاحقة. هناك عدة طرق لاستخدام هذه الأداة:

حاوية Docker (موصى بها)

هذا هو الخيار الأساسي. يُنفَّذ الكود في حاوية Docker آمنة ومعزولة، مما يضمن السلامة بغض النظر عن محتواه. تأكد من تثبيت Docker وتشغيله على نظامك. إذا لم يكن لديك، يمكنك تثبيته من هنا.

بيئة الحماية

إذا لم يكن Docker متاحاً - إما غير مُثبّت أو غير قابل للوصول لأي سبب - سيُنفَّذ الكود في بيئة Python مقيدة تُسمى بيئة الحماية. هذه البيئة محدودة جداً، مع قيود صارمة على العديد من الوحدات والدوال المدمجة.

التنفيذ غير الآمن

غير موصى به للإنتاج يسمح هذا الوضع بتنفيذ أي كود Python، بما في ذلك الاستدعاءات الخطيرة لـ sys, os.. والوحدات المماثلة. اطلع على كيفية تفعيل هذا الوضع

التسجيل

تسجّل CodeInterpreterTool استراتيجية التنفيذ المختارة في STDOUT

التثبيت

لاستخدام هذه الأداة، تحتاج إلى تثبيت حزمة أدوات CrewAI:

مثال

يوضح المثال التالي كيفية استخدام CodeInterpreterTool مع وكيل CrewAI:
Code
يمكنك أيضاً تفعيل تنفيذ الكود مباشرة عند إنشاء وكيل:
Code

تفعيل unsafe_mode

Code

المعاملات

تقبل CodeInterpreterTool المعاملات التالية أثناء التهيئة:
  • user_dockerfile_path: اختياري. مسار ملف Dockerfile مخصص لاستخدامه لحاوية مفسّر الكود.
  • user_docker_base_url: اختياري. عنوان URL لبرنامج Docker daemon لتشغيل الحاوية.
  • unsafe_mode: اختياري. ما إذا كان سيتم تشغيل الكود مباشرة على الجهاز المضيف بدلاً من حاوية Docker أو بيئة الحماية. القيمة الافتراضية False. استخدم بحذر!
  • default_image_tag: اختياري. وسم صورة Docker الافتراضي. القيمة الافتراضية code-interpreter:latest
عند استخدام الأداة مع وكيل، سيحتاج الوكيل لتقديم:
  • code: مطلوب. كود Python 3 المراد تنفيذه.
  • libraries_used: اختياري. قائمة المكتبات المستخدمة في الكود التي تحتاج إلى تثبيت. القيمة الافتراضية []

مثال على التكامل مع الوكيل

إليك مثالاً أكثر تفصيلاً عن كيفية دمج CodeInterpreterTool مع وكيل CrewAI:
Code

تفاصيل التنفيذ

تستخدم CodeInterpreterTool حاوية Docker لإنشاء بيئة آمنة لتنفيذ الكود:
Code
تقوم الأداة بالخطوات التالية:
  1. التحقق من وجود صورة Docker أو بنائها إذا لزم الأمر
  2. إنشاء حاوية Docker مع تركيب مجلد العمل الحالي
  3. تثبيت أي مكتبات مطلوبة حددها الوكيل
  4. تنفيذ كود Python في الحاوية
  5. إرجاع مخرجات تنفيذ الكود
  6. التنظيف عن طريق إيقاف الحاوية وإزالتها

اعتبارات الأمان

بشكل افتراضي، تشغّل CodeInterpreterTool الكود في حاوية Docker معزولة، مما يوفر طبقة من الأمان. ومع ذلك، هناك بعض اعتبارات الأمان التي يجب مراعاتها:
  1. تمتلك حاوية Docker وصولاً إلى مجلد العمل الحالي، لذا قد يتم الوصول إلى ملفات حساسة.
  2. إذا لم تكن حاوية Docker متاحة وكان الكود يحتاج للتشغيل بأمان، سيُنفَّذ في بيئة حماية. لأسباب أمنية، لا يُسمح بتثبيت مكتبات عشوائية
  3. يسمح معامل unsafe_mode بتنفيذ الكود مباشرة على الجهاز المضيف، ويجب استخدامه فقط في بيئات موثوقة.
  4. كن حذراً عند السماح للوكلاء بتثبيت مكتبات عشوائية، لأنها قد تتضمن كوداً ضاراً.

الخلاصة

توفر CodeInterpreterTool طريقة قوية لوكلاء CrewAI لتنفيذ كود Python في بيئة آمنة نسبياً. من خلال تمكين الوكلاء من كتابة وتشغيل الكود، توسّع قدراتهم في حل المشكلات بشكل كبير، خاصة للمهام التي تتضمن تحليل البيانات أو الحسابات أو أعمال حسابية أخرى. هذه الأداة مفيدة بشكل خاص للوكلاء الذين يحتاجون إلى إجراء عمليات معقدة يُعبَّر عنها بكفاءة أكبر في الكود مقارنة باللغة الطبيعية.