S3ReaderTool
الوصف
صُممتS3ReaderTool لقراءة الملفات من حاويات Amazon S3. تتيح هذه الأداة لوكلاء CrewAI الوصول إلى المحتوى المخزن في S3 واسترجاعه، مما يجعلها مثالية لسير العمل الذي يتطلب قراءة البيانات أو ملفات الإعداد أو أي محتوى آخر مخزن في تخزين AWS S3.
التثبيت
لاستخدام هذه الأداة، تحتاج إلى تثبيت التبعيات المطلوبة:خطوات البدء
لاستخدامS3ReaderTool بفعالية، اتبع الخطوات التالية:
- تثبيت التبعيات: ثبّت الحزم المطلوبة باستخدام الأمر أعلاه.
- إعداد بيانات اعتماد AWS: عيّن بيانات اعتماد AWS كمتغيرات بيئة.
- تهيئة الأداة: أنشئ مثيلاً من الأداة.
- تحديد مسار S3: قدّم مسار S3 للملف المراد قراءته.
مثال
يوضح المثال التالي كيفية استخدامS3ReaderTool لقراءة ملف من حاوية S3:
Code
المعاملات
تقبلS3ReaderTool المعامل التالي عند استخدامها من قبل وكيل:
- file_path: مطلوب. مسار ملف S3 بتنسيق
s3://bucket-name/file-name.
بيانات اعتماد AWS
تتطلب الأداة بيانات اعتماد AWS للوصول إلى حاويات S3. يمكنك إعداد هذه البيانات باستخدام متغيرات البيئة:- CREW_AWS_REGION: منطقة AWS حيث تقع حاوية S3. القيمة الافتراضية
us-east-1. - CREW_AWS_ACCESS_KEY_ID: معرّف مفتاح الوصول لـ AWS.
- CREW_AWS_SEC_ACCESS_KEY: مفتاح الوصول السري لـ AWS.
الاستخدام
عند استخدامS3ReaderTool مع وكيل، سيحتاج الوكيل لتقديم مسار ملف S3:
Code
معالجة الأخطاء
تتضمنS3ReaderTool معالجة أخطاء لمشكلات S3 الشائعة:
- تنسيق مسار S3 غير صالح
- ملفات مفقودة أو غير قابلة للوصول
- مشكلات الأذونات
- مشكلات بيانات اعتماد AWS
تفاصيل التنفيذ
تستخدمS3ReaderTool حزمة AWS SDK لـ Python (boto3) للتفاعل مع S3:
Code
الخلاصة
توفرS3ReaderTool طريقة مباشرة لقراءة الملفات من حاويات Amazon S3. من خلال تمكين الوكلاء من الوصول إلى المحتوى المخزن في S3، تسهّل سير العمل الذي يتطلب وصولاً سحابياً للملفات. هذه الأداة مفيدة بشكل خاص لمعالجة البيانات وإدارة الإعدادات وأي مهمة تتضمن استرجاع المعلومات من تخزين AWS S3.