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

S3ReaderTool

الوصف

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

التثبيت

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

خطوات البدء

لاستخدام S3ReaderTool بفعالية، اتبع الخطوات التالية:
  1. تثبيت التبعيات: ثبّت الحزم المطلوبة باستخدام الأمر أعلاه.
  2. إعداد بيانات اعتماد AWS: عيّن بيانات اعتماد AWS كمتغيرات بيئة.
  3. تهيئة الأداة: أنشئ مثيلاً من الأداة.
  4. تحديد مسار 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.