docs: add modern standard arabic translation of all documentation

2026-05-04 00:32:36 +00:00 · 2026-03-25 15:44:02 +08:00
parent b890ac0dd0
commit f5b3b2a355
242 changed files with 47411 additions and 0 deletions
--- a/docs/ar/enterprise/integrations/microsoft_sharepoint.mdx
+++ b/docs/ar/enterprise/integrations/microsoft_sharepoint.mdx
@@ -0,0 +1,270 @@
+---
+title: تكامل Microsoft SharePoint
+description: "إدارة المواقع والقوائم والمستندات مع تكامل Microsoft SharePoint لـ CrewAI."
+icon: "folder-tree"
+mode: "wide"
+---
+
+## نظرة عامة
+
+مكّن وكلاءك من الوصول إلى مواقع SharePoint والقوائم ومكتبات المستندات وإدارتها. استرجع معلومات المواقع، وأدر عناصر القوائم، وارفع الملفات ونظّمها، وبسّط سير عمل SharePoint باستخدام الأتمتة المدعومة بالذكاء الاصطناعي.
+
+## المتطلبات الأساسية
+
+قبل استخدام تكامل Microsoft SharePoint، تأكد من توفر ما يلي:
+
+- حساب [CrewAI AMP](https://app.crewai.com) مع اشتراك فعّال
+- حساب Microsoft 365 مع إمكانية الوصول إلى SharePoint
+- ربط حساب Microsoft الخاص بك عبر [صفحة التكاملات](https://app.crewai.com/crewai_plus/connectors)
+
+## إعداد تكامل Microsoft SharePoint
+
+### 1. ربط حساب Microsoft الخاص بك
+
+1. انتقل إلى [تكاملات CrewAI AMP](https://app.crewai.com/crewai_plus/connectors)
+2. ابحث عن **Microsoft SharePoint** في قسم تكاملات المصادقة
+3. انقر على **Connect** وأكمل عملية OAuth
+4. امنح الصلاحيات اللازمة للوصول إلى مواقع SharePoint ومحتوياتها
+5. انسخ رمز المؤسسة من [إعدادات التكامل](https://app.crewai.com/crewai_plus/settings/integrations)
+
+### 2. تثبيت الحزمة المطلوبة
+
+```bash
+uv add crewai-tools
+```
+
+### 3. إعداد متغير البيئة
+
+<Note>
+  لاستخدام التكاملات مع `Agent(apps=[])`, يجب تعيين متغير البيئة
+  `CREWAI_PLATFORM_INTEGRATION_TOKEN` برمز المؤسسة الخاص بك.
+</Note>
+
+```bash
+export CREWAI_PLATFORM_INTEGRATION_TOKEN="your_enterprise_token"
+```
+
+أو أضفه إلى ملف `.env`:
+
+```
+CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
+```
+
+## الإجراءات المتاحة
+
+<AccordionGroup>
+  <Accordion title="microsoft_sharepoint/get_sites">
+    **الوصف:** الحصول على جميع مواقع SharePoint التي يمكن للمستخدم الوصول إليها.
+
+    **المعاملات:**
+    - `search` (string, اختياري): استعلام بحث لتصفية المواقع
+    - `top` (integer, اختياري): عدد العناصر المراد إرجاعها. الحد الأدنى: 1، الحد الأقصى: 999
+
+  </Accordion>
+
+  <Accordion title="microsoft_sharepoint/get_site">
+    **الوصف:** الحصول على معلومات حول موقع SharePoint محدد.
+
+    **المعاملات:**
+    - `site_id` (string, مطلوب): معرّف موقع SharePoint
+
+  </Accordion>
+
+  <Accordion title="microsoft_sharepoint/get_drives">
+    **الوصف:** عرض جميع مكتبات المستندات (drives) في موقع SharePoint.
+
+    **المعاملات:**
+    - `site_id` (string, مطلوب): معرّف موقع SharePoint الكامل
+
+  </Accordion>
+
+  <Accordion title="microsoft_sharepoint/get_site_lists">
+    **الوصف:** الحصول على جميع القوائم في موقع SharePoint.
+
+    **المعاملات:**
+    - `site_id` (string, مطلوب): معرّف موقع SharePoint
+
+  </Accordion>
+
+  <Accordion title="microsoft_sharepoint/get_list_items">
+    **الوصف:** الحصول على عناصر من قائمة SharePoint.
+
+    **المعاملات:**
+    - `site_id` (string, مطلوب): معرّف موقع SharePoint
+    - `list_id` (string, مطلوب): معرّف القائمة
+    - `expand` (string, اختياري): توسيع البيانات المرتبطة (مثال: 'fields')
+
+  </Accordion>
+
+  <Accordion title="microsoft_sharepoint/create_list_item">
+    **الوصف:** إنشاء عنصر جديد في قائمة SharePoint.
+
+    **المعاملات:**
+    - `site_id` (string, مطلوب): معرّف موقع SharePoint
+    - `list_id` (string, مطلوب): معرّف القائمة
+    - `fields` (object, مطلوب): قيم الحقول للعنصر الجديد
+
+  </Accordion>
+
+  <Accordion title="microsoft_sharepoint/update_list_item">
+    **الوصف:** تحديث عنصر في قائمة SharePoint.
+
+    **المعاملات:**
+    - `site_id` (string, مطلوب): معرّف موقع SharePoint
+    - `list_id` (string, مطلوب): معرّف القائمة
+    - `item_id` (string, مطلوب): معرّف العنصر المراد تحديثه
+    - `fields` (object, مطلوب): قيم الحقول المراد تحديثها
+
+  </Accordion>
+
+  <Accordion title="microsoft_sharepoint/delete_list_item">
+    **الوصف:** حذف عنصر من قائمة SharePoint.
+
+    **المعاملات:**
+    - `site_id` (string, مطلوب): معرّف موقع SharePoint
+    - `list_id` (string, مطلوب): معرّف القائمة
+    - `item_id` (string, مطلوب): معرّف العنصر المراد حذفه
+
+  </Accordion>
+
+  <Accordion title="microsoft_sharepoint/upload_file_to_library">
+    **الوصف:** رفع ملف إلى مكتبة مستندات SharePoint.
+
+    **المعاملات:**
+    - `site_id` (string, مطلوب): معرّف موقع SharePoint
+    - `file_path` (string, مطلوب): المسار حيث يتم رفع الملف
+    - `content` (string, مطلوب): محتوى الملف المراد رفعه
+
+  </Accordion>
+
+  <Accordion title="microsoft_sharepoint/list_files">
+    **الوصف:** استرجاع الملفات والمجلدات من مكتبة مستندات SharePoint.
+
+    **المعاملات:**
+    - `site_id` (string, مطلوب): معرّف موقع SharePoint الكامل
+    - `drive_id` (string, مطلوب): معرّف مكتبة المستندات
+    - `folder_id` (string, اختياري): معرّف المجلد. الافتراضي: 'root'
+    - `top` (integer, اختياري): الحد الأقصى لعدد العناصر. الافتراضي: 50
+
+  </Accordion>
+
+  <Accordion title="microsoft_sharepoint/search_files">
+    **الوصف:** البحث عن الملفات والمجلدات في مكتبة مستندات SharePoint بالكلمات المفتاحية.
+
+    **المعاملات:**
+    - `site_id` (string, مطلوب): معرّف موقع SharePoint الكامل
+    - `drive_id` (string, مطلوب): معرّف مكتبة المستندات
+    - `query` (string, مطلوب): كلمات البحث المفتاحية
+
+  </Accordion>
+
+  <Accordion title="microsoft_sharepoint/delete_file">
+    **الوصف:** حذف ملف أو مجلد من مكتبة مستندات SharePoint.
+
+    **المعاملات:**
+    - `site_id` (string, مطلوب): معرّف موقع SharePoint الكامل
+    - `drive_id` (string, مطلوب): معرّف مكتبة المستندات
+    - `item_id` (string, مطلوب): المعرّف الفريد للملف أو المجلد المراد حذفه
+
+  </Accordion>
+
+  <Accordion title="microsoft_sharepoint/create_folder">
+    **الوصف:** إنشاء مجلد جديد في مكتبة مستندات SharePoint.
+
+    **المعاملات:**
+    - `site_id` (string, مطلوب): معرّف موقع SharePoint الكامل
+    - `drive_id` (string, مطلوب): معرّف مكتبة المستندات
+    - `folder_name` (string, مطلوب): اسم المجلد الجديد
+    - `parent_id` (string, اختياري): معرّف المجلد الأصلي. الافتراضي: 'root'
+
+  </Accordion>
+
+  <Accordion title="microsoft_sharepoint/download_file">
+    **الوصف:** تحميل محتوى ملف خام من مكتبة مستندات SharePoint.
+
+    **المعاملات:**
+    - `site_id` (string, مطلوب): معرّف موقع SharePoint الكامل
+    - `drive_id` (string, مطلوب): معرّف مكتبة المستندات
+    - `item_id` (string, مطلوب): المعرّف الفريد للملف المراد تحميله
+
+  </Accordion>
+
+  <Accordion title="microsoft_sharepoint/copy_file">
+    **الوصف:** نسخ ملف أو مجلد إلى موقع جديد داخل SharePoint.
+
+    **المعاملات:**
+    - `site_id` (string, مطلوب): معرّف موقع SharePoint الكامل
+    - `drive_id` (string, مطلوب): معرّف مكتبة المستندات
+    - `item_id` (string, مطلوب): المعرّف الفريد للملف أو المجلد المراد نسخه
+    - `destination_folder_id` (string, مطلوب): معرّف مجلد الوجهة
+
+  </Accordion>
+
+  <Accordion title="microsoft_sharepoint/move_file">
+    **الوصف:** نقل ملف أو مجلد إلى موقع جديد داخل SharePoint.
+
+    **المعاملات:**
+    - `site_id` (string, مطلوب): معرّف موقع SharePoint الكامل
+    - `drive_id` (string, مطلوب): معرّف مكتبة المستندات
+    - `item_id` (string, مطلوب): المعرّف الفريد للملف أو المجلد المراد نقله
+    - `destination_folder_id` (string, مطلوب): معرّف مجلد الوجهة
+
+  </Accordion>
+</AccordionGroup>
+
+## أمثلة الاستخدام
+
+### إعداد Agent أساسي لـ SharePoint
+
+```python
+from crewai import Agent, Task, Crew
+
+# Create an agent with SharePoint capabilities
+sharepoint_agent = Agent(
+    role="SharePoint Manager",
+    goal="Manage SharePoint sites, lists, and documents efficiently",
+    backstory="An AI assistant specialized in SharePoint content management and collaboration.",
+    apps=['microsoft_sharepoint']  # All SharePoint actions will be available
+)
+
+# Task to organize SharePoint content
+content_organization_task = Task(
+    description="List all accessible SharePoint sites and organize content by department",
+    agent=sharepoint_agent,
+    expected_output="SharePoint sites listed and content organized by department"
+)
+
+# Run the task
+crew = Crew(
+    agents=[sharepoint_agent],
+    tasks=[content_organization_task]
+)
+
+crew.kickoff()
+```
+
+## استكشاف الأخطاء وإصلاحها
+
+### المشاكل الشائعة
+
+**أخطاء الصلاحيات**
+
+- تأكد من أن حساب Microsoft الخاص بك لديه الصلاحيات المناسبة لمواقع SharePoint
+- تحقق من أن اتصال OAuth يتضمن النطاقات المطلوبة (Sites.Read.All, Sites.ReadWrite.All)
+
+**مشاكل معرّفات المواقع والقوائم**
+
+- تحقق من صحة معرّفات المواقع والقوائم وصيغتها الصحيحة
+- استخدم إجراءات get_sites وget_site_lists لاكتشاف المعرّفات الصالحة
+
+**مشاكل الحقول والمخطط**
+
+- تأكد من تطابق أسماء الحقول تماماً مع مخطط قائمة SharePoint
+- تحقق من تضمين الحقول المطلوبة عند إنشاء أو تحديث عناصر القوائم
+
+### الحصول على المساعدة
+
+<Card title="تحتاج مساعدة؟" icon="headset" href="mailto:support@crewai.com">
+  تواصل مع فريق الدعم للحصول على المساعدة في إعداد تكامل Microsoft SharePoint
+  أو استكشاف الأخطاء وإصلاحها.
+</Card>