--- title: "نظرة عامة" description: "قراءة وكتابة والبحث في صيغ ملفات متنوعة باستخدام أدوات معالجة المستندات من CrewAI" icon: "face-smile" mode: "wide" --- تتيح هذه الأدوات لوكلائك العمل مع صيغ ملفات وأنواع مستندات متنوعة. من قراءة ملفات PDF إلى معالجة بيانات JSON، تتعامل هذه الأدوات مع جميع احتياجات معالجة المستندات الخاصة بك. ## **الأدوات المتاحة** قراءة المحتوى من أي نوع ملف بما في ذلك النصوص و Markdown والمزيد. كتابة المحتوى في الملفات وإنشاء مستندات جديدة وحفظ البيانات المعالجة. البحث واستخراج محتوى نصي من مستندات PDF بكفاءة. البحث في مستندات Microsoft Word واستخراج المحتوى ذي الصلة. تحليل والبحث في ملفات JSON بإمكانيات استعلام متقدمة. معالجة والبحث في ملفات CSV واستخراج صفوف وأعمدة محددة. تحليل ملفات XML والبحث عن عناصر وخصائص محددة. البحث في ملفات MDX واستخراج المحتوى من الوثائق. البحث في ملفات النص العادي بإمكانيات مطابقة الأنماط. البحث عن الملفات والمجلدات داخل هياكل المجلدات. قراءة وعرض محتويات المجلدات وهياكل الملفات والبيانات الوصفية. استخراج النص من الصور (ملفات محلية أو عناوين URL) باستخدام نموذج LLM مزود بالرؤية. كتابة نص في إحداثيات محددة في ملفات PDF، مع خطوط مخصصة اختيارية. ## **حالات الاستخدام الشائعة** - **معالجة المستندات**: استخراج وتحليل المحتوى من صيغ ملفات متنوعة - **استيراد البيانات**: قراءة بيانات منظمة من ملفات CSV و JSON و XML - **بحث المحتوى**: العثور على معلومات محددة داخل مجموعات مستندات كبيرة - **إدارة الملفات**: تنظيم ومعالجة الملفات والمجلدات - **تصدير البيانات**: حفظ النتائج المعالجة في صيغ ملفات متنوعة ## **مثال للبدء السريع** ```python from crewai_tools import FileReadTool, PDFSearchTool, JSONSearchTool # Create tools file_reader = FileReadTool() pdf_searcher = PDFSearchTool() json_processor = JSONSearchTool() # Add to your agent agent = Agent( role="Document Analyst", tools=[file_reader, pdf_searcher, json_processor], goal="Process and analyze various document types" ) ``` ## **نصائح لمعالجة المستندات** - **صلاحيات الملفات**: تأكد من أن وكيلك لديه صلاحيات القراءة/الكتابة المناسبة - **الملفات الكبيرة**: فكر في التقسيم إلى أجزاء للمستندات الكبيرة جداً - **دعم الصيغ**: راجع وثائق الأداة لمعرفة صيغ الملفات المدعومة - **معالجة الأخطاء**: طبّق معالجة أخطاء مناسبة للملفات التالفة أو التي يتعذر الوصول إليها