نظرة عامة
يدعم CrewAI مدخلات الملفات متعددة الوسائط الأصلية، مما يتيح لك تمرير الصور وملفات PDF والصوت والفيديو والنصوص مباشرة إلى وكلائك. يتم تنسيق الملفات تلقائيًا وفقًا لمتطلبات API لكل مزود LLM.يتطلب دعم الملفات حزمة
crewai-files الاختيارية. ثبّتها بـ:واجهة معالجة الملفات حاليًا في مرحلة الوصول المبكر.
أنواع الملفات
يدعم CrewAI خمسة أنواع ملفات محددة بالإضافة إلى فئةFile العامة التي تكتشف النوع تلقائيًا:
| النوع | الفئة | حالات الاستخدام |
|---|---|---|
| صورة | ImageFile | صور، لقطات شاشة، مخططات، رسوم بيانية |
PDFFile | مستندات، تقارير، أوراق بحثية | |
| صوت | AudioFile | تسجيلات صوتية، بودكاست، اجتماعات |
| فيديو | VideoFile | تسجيلات شاشة، عروض تقديمية |
| نص | TextFile | ملفات كود، سجلات، ملفات بيانات |
| عام | File | اكتشاف تلقائي للنوع من المحتوى |
مصادر الملفات
يقبل معاملsource أنواع إدخال متعددة ويكتشف تلقائيًا المعالج المناسب:
من مسار
من عنوان URL
من بايتات
استخدام الملفات
يمكن تمرير الملفات على مستويات متعددة، حيث تأخذ المستويات الأكثر تحديدًا الأولوية.مع الأطقم
مرر الملفات عند تشغيل طاقم:مع المهام
أرفق الملفات بمهام محددة:مع التدفقات
مرر الملفات إلى التدفقات، والتي تنتقل تلقائيًا إلى الأطقم:مع الوكلاء المستقلين
مرر الملفات مباشرة إلى تشغيل الوكيل:أولوية الملفات
عند تمرير الملفات على مستويات متعددة، تتجاوز المستويات الأكثر تحديدًا المستويات الأوسع:"chart"، تُستخدم نسخة المهمة.
دعم المزودين
تدعم المزودات المختلفة أنواع ملفات مختلفة. يقوم CrewAI تلقائيًا بتنسيق الملفات وفقًا لواجهة كل مزود.| المزود | صورة | صوت | فيديو | نص | |
|---|---|---|---|---|---|
| OpenAI (completions API) | ✓ | ||||
| OpenAI (responses API) | ✓ | ✓ | ✓ | ||
| Anthropic (claude-3.x) | ✓ | ✓ | |||
| Google Gemini (gemini-1.5, 2.0, 2.5) | ✓ | ✓ | ✓ | ✓ | ✓ |
| AWS Bedrock (claude-3) | ✓ | ✓ | |||
| Azure OpenAI (gpt-4o) | ✓ | ✓ |
تدعم نماذج Google Gemini جميع أنواع الملفات بما في ذلك الفيديو (حتى ساعة واحدة، 2 جيجابايت). استخدم Gemini عندما تحتاج لمعالجة محتوى الفيديو.
إذا مررت نوع ملف لا يدعمه المزود (مثل الفيديو إلى OpenAI)، ستتلقى خطأ
UnsupportedFileTypeError. اختر مزودك بناءً على أنواع الملفات التي تحتاج لمعالجتها.كيف تُرسل الملفات
يختار CrewAI تلقائيًا الطريقة المثلى لإرسال الملفات إلى كل مزود:| الطريقة | الوصف | متى تُستخدم |
|---|---|---|
| Inline Base64 | الملف مضمّن مباشرة في الطلب | ملفات صغيرة (< 5 ميجابايت عادة) |
| File Upload API | الملف يُرفع بشكل منفصل، يُشار إليه بمعرّف | ملفات كبيرة تتجاوز العتبة |
| URL Reference | عنوان URL مباشر يُمرر إلى النموذج | مصدر الملف هو عنوان URL بالفعل |
طرق الإرسال حسب المزود
| المزود | Inline Base64 | File Upload API | URL References |
|---|---|---|---|
| OpenAI | ✓ | ✓ (> 5 MB) | ✓ |
| Anthropic | ✓ | ✓ (> 5 MB) | ✓ |
| Google Gemini | ✓ | ✓ (> 20 MB) | ✓ |
| AWS Bedrock | ✓ | ✓ (S3 URIs) | |
| Azure OpenAI | ✓ | ✓ |
لا تحتاج لإدارة هذا بنفسك. يستخدم CrewAI تلقائيًا الطريقة الأكثر كفاءة بناءً على حجم الملف وقدرات المزود. المزودات بدون واجهات رفع الملفات تستخدم inline base64 لجميع الملفات.
أوضاع معالجة الملفات
تحكم في كيفية معالجة الملفات عندما تتجاوز حدود المزود:قيود المزودين
لكل مزود حدود محددة لأحجام الملفات والأبعاد:OpenAI
- الصور: حد أقصى 20 ميجابايت، حتى 10 صور لكل طلب
- PDF: حد أقصى 32 ميجابايت، حتى 100 صفحة
- الصوت: حد أقصى 25 ميجابايت، حتى 25 دقيقة
Anthropic
- الصور: حد أقصى 5 ميجابايت، أقصى 8000x8000 بكسل، حتى 100 صورة
- PDF: حد أقصى 32 ميجابايت، حتى 100 صفحة
Google Gemini
- الصور: حد أقصى 100 ميجابايت
- PDF: حد أقصى 50 ميجابايت
- الصوت: حد أقصى 100 ميجابايت، حتى 9.5 ساعة
- الفيديو: حد أقصى 2 جيجابايت، حتى ساعة واحدة
AWS Bedrock
- الصور: حد أقصى 4.5 ميجابايت، أقصى 8000x8000 بكسل
- PDF: حد أقصى 3.75 ميجابايت، حتى 100 صفحة
