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