Files
crewAI/docs/ar/tools/file-document/overview.mdx

98 lines
5.0 KiB
Plaintext

---
title: "نظرة عامة"
description: "قراءة وكتابة والبحث في صيغ ملفات متنوعة باستخدام أدوات معالجة المستندات من CrewAI"
icon: "face-smile"
mode: "wide"
---
تتيح هذه الأدوات لوكلائك العمل مع صيغ ملفات وأنواع مستندات متنوعة. من قراءة ملفات PDF إلى معالجة بيانات JSON، تتعامل هذه الأدوات مع جميع احتياجات معالجة المستندات الخاصة بك.
## **الأدوات المتاحة**
<CardGroup cols={2}>
<Card title="أداة قراءة الملفات" icon="folders" href="/ar/tools/file-document/filereadtool">
قراءة المحتوى من أي نوع ملف بما في ذلك النصوص و Markdown والمزيد.
</Card>
<Card title="أداة كتابة الملفات" icon="file-pen" href="/ar/tools/file-document/filewritetool">
كتابة المحتوى في الملفات وإنشاء مستندات جديدة وحفظ البيانات المعالجة.
</Card>
<Card title="أداة بحث PDF" icon="file-pdf" href="/ar/tools/file-document/pdfsearchtool">
البحث واستخراج محتوى نصي من مستندات PDF بكفاءة.
</Card>
<Card title="أداة بحث DOCX" icon="file-word" href="/ar/tools/file-document/docxsearchtool">
البحث في مستندات Microsoft Word واستخراج المحتوى ذي الصلة.
</Card>
<Card title="أداة بحث JSON" icon="brackets-curly" href="/ar/tools/file-document/jsonsearchtool">
تحليل والبحث في ملفات JSON بإمكانيات استعلام متقدمة.
</Card>
<Card title="أداة بحث CSV" icon="table" href="/ar/tools/file-document/csvsearchtool">
معالجة والبحث في ملفات CSV واستخراج صفوف وأعمدة محددة.
</Card>
<Card title="أداة بحث XML" icon="code" href="/ar/tools/file-document/xmlsearchtool">
تحليل ملفات XML والبحث عن عناصر وخصائص محددة.
</Card>
<Card title="أداة بحث MDX" icon="markdown" href="/ar/tools/file-document/mdxsearchtool">
البحث في ملفات MDX واستخراج المحتوى من الوثائق.
</Card>
<Card title="أداة بحث TXT" icon="file-lines" href="/ar/tools/file-document/txtsearchtool">
البحث في ملفات النص العادي بإمكانيات مطابقة الأنماط.
</Card>
<Card title="أداة بحث المجلدات" icon="folder-open" href="/ar/tools/file-document/directorysearchtool">
البحث عن الملفات والمجلدات داخل هياكل المجلدات.
</Card>
<Card title="أداة قراءة المجلدات" icon="folder" href="/ar/tools/file-document/directoryreadtool">
قراءة وعرض محتويات المجلدات وهياكل الملفات والبيانات الوصفية.
</Card>
<Card title="أداة OCR" icon="image" href="/ar/tools/file-document/ocrtool">
استخراج النص من الصور (ملفات محلية أو عناوين URL) باستخدام نموذج LLM مزود بالرؤية.
</Card>
<Card title="أداة كتابة نص PDF" icon="file-pdf" href="/ar/tools/file-document/pdf-text-writing-tool">
كتابة نص في إحداثيات محددة في ملفات PDF، مع خطوط مخصصة اختيارية.
</Card>
</CardGroup>
## **حالات الاستخدام الشائعة**
- **معالجة المستندات**: استخراج وتحليل المحتوى من صيغ ملفات متنوعة
- **استيراد البيانات**: قراءة بيانات منظمة من ملفات 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"
)
```
## **نصائح لمعالجة المستندات**
- **صلاحيات الملفات**: تأكد من أن وكيلك لديه صلاحيات القراءة/الكتابة المناسبة
- **الملفات الكبيرة**: فكر في التقسيم إلى أجزاء للمستندات الكبيرة جداً
- **دعم الصيغ**: راجع وثائق الأداة لمعرفة صيغ الملفات المدعومة
- **معالجة الأخطاء**: طبّق معالجة أخطاء مناسبة للملفات التالفة أو التي يتعذر الوصول إليها