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

S3WriterTool

الوصف

صُممت S3WriterTool لكتابة المحتوى إلى ملفات في حاويات Amazon S3. تتيح هذه الأداة لوكلاء CrewAI إنشاء أو تحديث الملفات في S3، مما يجعلها مثالية لسير العمل الذي يتطلب تخزين البيانات أو حفظ ملفات الإعداد أو حفظ أي محتوى آخر في تخزين AWS S3.

التثبيت

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

خطوات البدء

لاستخدام S3WriterTool بفعالية، اتبع الخطوات التالية:
  1. تثبيت التبعيات: ثبّت الحزم المطلوبة باستخدام الأمر أعلاه.
  2. إعداد بيانات اعتماد AWS: عيّن بيانات اعتماد AWS كمتغيرات بيئة.
  3. تهيئة الأداة: أنشئ مثيلاً من الأداة.
  4. تحديد مسار S3 والمحتوى: قدّم مسار S3 حيث تريد كتابة الملف والمحتوى المراد كتابته.

مثال

يوضح المثال التالي كيفية استخدام S3WriterTool لكتابة محتوى إلى ملف في حاوية S3:
Code

المعاملات

تقبل S3WriterTool المعاملات التالية عند استخدامها من قبل وكيل:
  • file_path: مطلوب. مسار ملف S3 بتنسيق s3://bucket-name/file-name.
  • content: مطلوب. المحتوى المراد كتابته في الملف.

بيانات اعتماد AWS

تتطلب الأداة بيانات اعتماد AWS للوصول إلى حاويات S3. يمكنك إعداد هذه البيانات باستخدام متغيرات البيئة:
  • CREW_AWS_REGION: منطقة AWS حيث تقع حاوية S3. القيمة الافتراضية us-east-1.
  • CREW_AWS_ACCESS_KEY_ID: معرّف مفتاح الوصول لـ AWS.
  • CREW_AWS_SEC_ACCESS_KEY: مفتاح الوصول السري لـ AWS.

الاستخدام

عند استخدام S3WriterTool مع وكيل، سيحتاج الوكيل لتقديم كل من مسار ملف S3 والمحتوى المراد كتابته:
Code

معالجة الأخطاء

تتضمن S3WriterTool معالجة أخطاء لمشكلات S3 الشائعة:
  • تنسيق مسار S3 غير صالح
  • مشكلات الأذونات (مثل عدم وجود صلاحية كتابة للحاوية)
  • مشكلات بيانات اعتماد AWS
  • الحاوية غير موجودة
عند حدوث خطأ، ستعيد الأداة رسالة خطأ تتضمن تفاصيل حول المشكلة.

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

تستخدم S3WriterTool حزمة AWS SDK لـ Python (boto3) للتفاعل مع S3:
Code

الخلاصة

توفر S3WriterTool طريقة مباشرة لكتابة المحتوى إلى ملفات في حاويات Amazon S3. من خلال تمكين الوكلاء من إنشاء وتحديث الملفات في S3، تسهّل سير العمل الذي يتطلب تخزين ملفات سحابي. هذه الأداة مفيدة بشكل خاص لحفظ البيانات وإدارة الإعدادات وتوليد التقارير وأي مهمة تتضمن تخزين المعلومات في تخزين AWS S3.