CodeInterpreterTool
الوصف
تمكّن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
- التحقق من وجود صورة Docker أو بنائها إذا لزم الأمر
- إنشاء حاوية Docker مع تركيب مجلد العمل الحالي
- تثبيت أي مكتبات مطلوبة حددها الوكيل
- تنفيذ كود Python في الحاوية
- إرجاع مخرجات تنفيذ الكود
- التنظيف عن طريق إيقاف الحاوية وإزالتها
اعتبارات الأمان
بشكل افتراضي، تشغّلCodeInterpreterTool الكود في حاوية Docker معزولة، مما يوفر طبقة من الأمان. ومع ذلك، هناك بعض اعتبارات الأمان التي يجب مراعاتها:
- تمتلك حاوية Docker وصولاً إلى مجلد العمل الحالي، لذا قد يتم الوصول إلى ملفات حساسة.
- إذا لم تكن حاوية Docker متاحة وكان الكود يحتاج للتشغيل بأمان، سيُنفَّذ في بيئة حماية. لأسباب أمنية، لا يُسمح بتثبيت مكتبات عشوائية
- يسمح معامل
unsafe_modeبتنفيذ الكود مباشرة على الجهاز المضيف، ويجب استخدامه فقط في بيئات موثوقة. - كن حذراً عند السماح للوكلاء بتثبيت مكتبات عشوائية، لأنها قد تتضمن كوداً ضاراً.
الخلاصة
توفرCodeInterpreterTool طريقة قوية لوكلاء CrewAI لتنفيذ كود Python في بيئة آمنة نسبياً. من خلال تمكين الوكلاء من كتابة وتشغيل الكود، توسّع قدراتهم في حل المشكلات بشكل كبير، خاصة للمهام التي تتضمن تحليل البيانات أو الحسابات أو أعمال حسابية أخرى. هذه الأداة مفيدة بشكل خاص للوكلاء الذين يحتاجون إلى إجراء عمليات معقدة يُعبَّر عنها بكفاءة أكبر في الكود مقارنة باللغة الطبيعية.