snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)

packages/twenty-docs/l/ar/user-guide/ai/capabilities/ai-agents.mdx

@@ -0,0 +1,30 @@
+---
+title: وكلاء الذكاء الاصطناعي
+description: ادمج قدرات الذكاء الاصطناعي مباشرةً في سير العمل المؤتمت لديك.
+---
+
+## نظرة عامة
+
+ادمج قدرات الذكاء الاصطناعي مباشرةً في سير العمل المؤتمت لديك لمعالجة البيانات بذكاء واتخاذ القرارات.
+
+## القدرات
+
+| الميزة                       | الوصف                                              |
+| ---------------------------- | -------------------------------------------------- |
+| **إجراءات الذكاء الاصطناعي** | أضِف خطوات مدعومة بالذكاء الاصطناعي إلى أي سير عمل |
+| **إثراء البيانات**           | تحسين السجلات تلقائيًا ببيانات خارجية              |
+| **التصنيف**                  | تصنيف السجلات استنادًا إلى تحليل المحتوى           |
+| **التلخيص**                  | إنشاء ملخصات من حقول النص                          |
+| **مطالبات مخصصة**            | حدِّد بدقة كيف يعالج الذكاء الاصطناعي بياناتك      |
+
+## حالات الاستخدام
+
+* **تقييم العملاء المحتملين**: تقييم العملاء المحتملين الواردين تلقائيًا وتحديد أولوياتهم
+* **تنظيف البيانات**: توحيد أسماء الشركات ومعلومات الاتصال
+* **مسودات البريد الإلكتروني**: إنشاء رسائل متابعة عبر البريد الإلكتروني استنادًا إلى ملاحظات الاجتماعات
+* **توجيه السجلات**: إسناد السجلات إلى عضو الفريق المناسب بناءً على المحتوى
+
+## ذات صلة
+
+* [نظرة عامة على سير العمل](/l/ar/user-guide/workflows/overview) — أساسيات الأتمتة
+* [أذونات الذكاء الاصطناعي](/l/ar/user-guide/ai/capabilities/permissions-access-control) — التحكم في الوصول لوكلاء الذكاء الاصطناعي

packages/twenty-docs/l/ar/user-guide/ai/capabilities/ai-chatbot.mdx

@@ -0,0 +1,37 @@
+---
+title: روبوت محادثة بالذكاء الاصطناعي
+description: مساعد ذكي يساعدك على التفاعل مع بيانات إدارة علاقات العملاء باستخدام اللغة الطبيعية.
+---
+
+## نظرة عامة
+
+طرح أسئلة في اللغة الطبيعية والمساعد يسترجع ويفسر بيانات إدارة علاقات العملاء الخاصة بك لك.
+
+## القدرات
+
+| الميزة                        | الوصف                                                             |
+| ----------------------------- | ----------------------------------------------------------------- |
+| **استعلامات باللغة الطبيعية** | اطرح أسئلة باللغة الإنجليزية البسيطة بدلاً من إنشاء عوامل تصفية   |
+| **وصول كامل إلى البيانات**    | استعلم عن السجلات والعلاقات والمقاييس عبر مساحة عملك              |
+| **سياق الصفحة**               | الإشارة إلى "هذه الشركة" أو "هذه الفرصة" استناداً إلى عرضك الحالي |
+| **حواري**                     | تحافظ الأسئلة اللاحقة على السياق من الاستعلامات السابقة           |
+
+## أمثلة على التفاعلات
+
+### العثور على السجلات
+
+* "اعرض لي كل الفرص التي تزيد عن $50,000"
+* "ابحث عن جهات الاتصال التي لم أرسل لها بريد إلكتروني منذ أسبوعين"
+* "اسرد الشركات في قطاع الرعاية الصحية"
+
+### الحصول على رؤى
+
+* "ما القيمة الإجمالية لمسار المبيعات لدي?"
+* "كم عدد الصفقات التي أبرمت الشهر الماضي?"
+* "أي مرحلة تضم أكبر عدد من الفرص العالقة?"
+
+### استخدام سياق الصفحة
+
+* "لخص تفاعلاتي مع هذا الشخص" (على صفحة جهة اتصال)
+* "ما الفرص المرتبطة بهذه الشركة?" (على صفحة شركة)
+* "متى جرى آخر تحديث لهذه الصفقة?" (على صفحة فرصة)

packages/twenty-docs/l/ar/user-guide/ai/capabilities/mcp.mdx

@@ -0,0 +1,137 @@
+---
+title: خادم MCP
+description: اربط مساعدي الذكاء الاصطناعي بمساحة عمل Twenty الخاصة بك باستخدام بروتوكول سياق النموذج.
+---
+
+تعرض Twenty خادم [MCP](https://modelcontextprotocol.io/) بحيث تتمكّن مساعدات الذكاء الاصطناعي — Claude Desktop وClaude Code وCursor وChatGPT وغيرها — من قراءة وكتابة بيانات نظام إدارة علاقات العملاء (CRM) لديك باستخدام اللغة الطبيعية.
+
+استخدم **عنوان URL لمساحة العمل** (عنوان URL الذي تستخدمه للوصول إلى Twenty) كنقطة نهاية MCP. على Twenty Cloud، قد يكون عنوان URL لمساحة العمل هو `https://{mycompany}.twenty.com` أو نطاق مخصص. الخادم متاح على:
+
+| البيئة                | نقطة نهاية MCP                                                                           |
+| --------------------- | ---------------------------------------------------------------------------------------- |
+| **السحابة**           | `https://{your-workspace-url}/mcp` (على سبيل المثال: `https://mycompany.twenty.com/mcp`) |
+| **الاستضافة الذاتية** | `https://{your-domain}/mcp`                                                              |
+
+## طرق المصادقة
+
+لديك طريقتان لمصادقة عميل MCP: **OAuth** (مُوصى بها) أو **مفتاح API**.
+
+### الخيار أ — OAuth (مُوصى به)
+
+باستخدام OAuth، يفتح عميل MCP لديك نافذة متصفح لتسجيل الدخول. لا يتم تخزين أي أسرار في ملفات الإعداد، ويتم تحديث الرموز المميِّزة تلقائيًا.
+
+<Note>
+يتطلب OAuth عميل MCP يدعم [مواصفة تفويض MCP](https://modelcontextprotocol.io/specification/2025-03-26/basic/authorization). تدعمه Claude Desktop وClaude Code وCursor وChatGPT.
+</Note>
+
+أضِف ما يلي إلى تهيئة عميل MCP لديك، واستبدِل `{your-workspace-url}` بمضيف مساحة العمل لديك (على سبيل المثال: `mycompany.twenty.com`):
+
+```json
+{
+  "mcpServers": {
+    "twenty": {
+      "type": "streamable-http",
+      "url": "https://{your-workspace-url}/mcp"
+    }
+  }
+}
+```
+
+هذا كل شيء — لا حاجة إلى مفتاح API. عند اتصال العميل للمرة الأولى، سيفعل ما يلي:
+
+1. اكتشاف بيانات التعريف الخاصة بـ OAuth لدى Twenty عبر `/.well-known/oauth-protected-resource` و`/.well-known/oauth-authorization-server`
+2. تسجيل نفسه كعميل OAuth عبر التسجيل الديناميكي للعميل (RFC 7591)
+3. فتح متصفحك لتفويض الوصول
+4. استلام الرموز المميِّزة والاتصال بخادم MCP
+
+تعيد الاتصالات اللاحقة استخدام الرموز المميِّزة المخزنة وتحدِّثها تلقائيًا.
+
+### الخيار ب — مفتاح API
+
+إذا كان عميل MCP لديك لا يدعم OAuth، أو كنت تفضّل بيانات اعتماد ثابتة، فمرِّر مفتاح API في ترويسة `Authorization`:
+
+```json
+{
+  "mcpServers": {
+    "twenty": {
+      "type": "streamable-http",
+      "url": "https://{your-workspace-url}/mcp",
+      "headers": {
+        "Authorization": "Bearer YOUR_API_KEY"
+      }
+    }
+  }
+}
+```
+
+<Warning>
+يمنح مفتاح API الخاص بك حق الوصول إلى بيانات مساحة العمل. أبعِده عن أنظمة التحكم في الإصدارات وملفات dotfiles المشتركة.
+</Warning>
+
+لإنشاء مفتاح API، انتقل إلى **Settings → MCP & APIs → API → + Create key**. راجع [واجهات برمجة التطبيقات](/l/ar/developers/extend/api#create-an-api-key) للتفاصيل.
+
+## البدء السريع
+
+### 1. انسخ الإعداد
+
+انتقل إلى **Settings → MCP & APIs → MCP** في Twenty. اختر طريقة المصادقة (OAuth أو مفتاح API)، وانسخ مقطع JSON (سيستخدم بالفعل عنوان URL لمساحة العمل لديك)، ثم الصقه في ملف إعدادات عميل MCP لديك.
+
+| العميل             | موقع ملف الإعداد                                                                                                                                    |
+| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Claude Desktop** | `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) أو `%APPDATA%\Claude\claude_desktop_config.json` (Windows)                |
+| **Claude Code**    | `~/.claude.json` (المستخدم) أو `.mcp.json` (المشروع)                                                                                                |
+| **Cursor**         | `.cursor/mcp.json` ضمن مشروعك، أو `~/.cursor/mcp.json` عالميًا                                                                                      |
+| **ChatGPT**        | فعِّل وضع المطوّر في **Settings → Apps & Connectors → Advanced settings**، ثم استخدم **Create** في **Settings → Apps & Connectors** لإضافة خادم MCP |
+
+### 2. الاتصال
+
+أعِد تشغيل عميل MCP لديك (أو أعد تحميل ملف الإعداد). إذا كنت تستخدم OAuth فسيتم توجيهك إلى Twenty لتفويض الوصول. إذا كنت تستخدم مفتاح API فسيكون الاتصال فوريًا.
+
+### 3. ابدأ باستخدامه
+
+اطلب من مساعد الذكاء الاصطناعي التفاعل مع نظام إدارة علاقات العملاء (CRM) لديك:
+
+* *"أرني أحدث 5 شركات تم إنشاؤها"*
+* *"أنشئ شخصًا جديدًا باسم Jane Doe في Acme Corp"*
+* *"اعثر على جميع الفرص المفتوحة التي تزيد قيمتها عن 10 آلاف دولار"*
+
+## الأدوات المتاحة
+
+بعد الاتصال، يوفّر خادم MCP أدوات تعكس واجهة برمجة تطبيقات Twenty (API). سير العمل الموصى به هو:
+
+1. **`learn_tools`** — احصل على مخطط الإدخال لأدوات محددة
+2. **`execute_tool`** — شغّل أداة
+
+لا تحتاج إلى تذكّر أسماء الأدوات. اسأل مساعد الذكاء الاصطناعي عمّا يمكنه فعله وسيستدعي `learn_tools` تلقائيًا.
+
+## الصلاحيات
+
+ترث اتصالات MCP أذونات المستخدم المُصادَق عليه (OAuth) أو الدور المُعيَّن لمفتاح API. لتقييد ما يمكن لخادم MCP القيام به:
+
+* **OAuth**: ينطبق دور المستخدم في مساحة العمل.
+* **API Key**: عيِّن دورًا لمفتاح API ضمن **Settings → Members → Roles**. راجع [الأذونات](/l/ar/user-guide/permissions-access/capabilities/permissions).
+
+## التكوين ذاتي الاستضافة
+
+في حالات الاستضافة الذاتية، استبدِل `{your-workspace-url}` بعنوان URL الخاص بالخادم لديك. تأكّد من أن قيمة `SERVER_URL` في بيئتك تطابق عنوان URL العام لمثيل Twenty لديك — إذ يُستخدَم ذلك لإنشاء بيانات تعريف اكتشاف OAuth.
+
+```bash
+SERVER_URL=https://twenty.yourcompany.com
+```
+
+تُشتق نقطة نهاية MCP ونقاط نهاية OAuth وبيانات تعريف الاكتشاف جميعها من هذه القيمة.
+
+## استكشاف الأخطاء وإصلاحها
+
+**أخطاء "Unauthorized" أو 401**
+
+* OAuth: أعد التفويض عبر مسح الرموز المميِّزة المخزنة في عميل MCP لديك ثم أعد الاتصال.
+* API Key: تحقّق من أن المفتاح صالح ولم تنتهِ صلاحيته. أعِد توليده إذا لزم الأمر.
+
+**عملية OAuth لا تفتح متصفحًا**
+
+* تأكّد من أن عميل MCP لديك يدعم تفويض MCP. ارجع إلى طريقة مفتاح API إذا لم يكن كذلك.
+
+**انتهاء مهلة الاتصال**
+
+* تحقّق من إمكانية الوصول إلى عنوان URL لنقطة نهاية MCP من جهازك. بالنسبة لحالات الاستضافة الذاتية، تحقّق من أن الخادم يعمل وأن `SERVER_URL` مُعيَّن بشكل صحيح.

packages/twenty-docs/l/ar/user-guide/ai/capabilities/permissions-access-control.mdx

@@ -0,0 +1,35 @@
+---
+title: الأذونات والتحكم في الوصول
+description: تحكّم بما يمكن لوكلاء الذكاء الاصطناعي الوصول إليه وتعديله في مساحة عملك.
+---
+
+## نظرة عامة
+
+يحترم وكلاء الذكاء الاصطناعي هيكل الأذونات الحالي لديك. وهذا مهم بشكل خاص للفرق التي تريد التحكّم بدقة في ما يمكن لعمليات الذكاء الاصطناعي المؤتمتة الوصول إليه أو تعديله في مساحة عملها.
+
+## تعيين دور لوكيل ذكاء اصطناعي
+
+1. انتقل إلى **الإعدادات → الأعضاء → الأدوار**
+2. انقر على الدور الذي ترغب في تعيينه
+3. افتح علامة التبويب **التعيين**
+4. ضمن **وكلاء الذكاء الاصطناعي**، انقر **+ تعيين لوكيل ذكاء اصطناعي**
+5. اختر وكيل الذكاء الاصطناعي من القائمة
+6. أكد التعيين
+
+## لماذا نعيّن أدوارًا لوكلاء الذكاء الاصطناعي؟
+
+| الفائدة             | الوصف                                                                 |
+| ------------------- | --------------------------------------------------------------------- |
+| **الأمان**          | قيِّد ما يمكن لوكلاء الذكاء الاصطناعي الوصول إليه أو تعديله من بيانات |
+| **الامتثال**        | ضمان أن يعالج الذكاء الاصطناعي فقط البيانات التي يحتاجها              |
+| **التحكم**          | منع الإجراءات غير المقصودة الناتجة عن أتمتة الذكاء الاصطناعي          |
+| **إمكانية التدقيق** | تتبُّع الإجراءات التي نفّذها كل وكيل                                  |
+
+<Note>
+بالنسبة لوكلاء الذكاء الاصطناعي الذين يعملون ضمن سير العمل، يضمن تعيين الدور ألا يتمكّن الوكيل من الوصول إلى البيانات أو تعديلها خارج نطاقه المقصود — حتى إذا كانت لسير العمل أذونات أوسع.
+</Note>
+
+## ذات صلة
+
+* [الأذونات](/l/ar/user-guide/permissions-access/capabilities/permissions) — معلومات مفصلة حول إنشاء الأدوار وإدارتها
+* [وكلاء الذكاء الاصطناعي](/l/ar/user-guide/ai/capabilities/ai-agents) — قدرات الذكاء الاصطناعي ضمن سير العمل

packages/twenty-docs/l/ar/user-guide/ai/how-tos/ai-faq.mdx

@@ -0,0 +1,31 @@
+---
+title: الأسئلة الشائعة حول الذكاء الاصطناعي
+description: الأسئلة الشائعة حول ميزات الذكاء الاصطناعي في Twenty.
+---
+
+<AccordionGroup>
+
+  <Accordion title="ما هي قدرات الذكاء الاصطناعي المتاحة؟">
+    القدرتان الرئيسيتان للذكاء الاصطناعي هما:
+
+    1. **روبوت دردشة بالذكاء الاصطناعي**: مساعد مدرك للسياق يمكنه الوصول إلى بياناتك في Twenty ومساعدتك في الاستفسارات
+    2. **وكلاء الذكاء الاصطناعي في سير العمل**: أتمتة ذكية يمكنها معالجة البيانات واتخاذ القرارات وتنفيذ المهام ضمن سير عملك
+  </Accordion>
+
+  <Accordion title="هل لوكلاء الذكاء الاصطناعي حق الوصول إلى جميع بياناتي؟">
+    ويعمل وكلاء الذكاء الاصطناعي بموجب نظام التصريح. يمكنك تعيين أدوار محددة لوكلاء الذكاء الاصطناعي ضمن **الإعدادات → الأعضاء → الأدوار**، مما يمنحك سيطرة كاملة على البيانات التي يمكنهم الوصول إليها والإجراءات التي يمكنهم القيام بها.
+  </Accordion>
+
+  <Accordion title="كيف تعمل أرصدة الذكاء الاصطناعي؟">
+    تستهلك إجراءات الذكاء الاصطناعي أرصدة سير العمل بناءً على تعقيد المهمة ونموذج الذكاء الاصطناعي المستخدم.
+  </Accordion>
+
+  <Accordion title="هل يمكنني استخدام نماذج الذكاء الاصطناعي الخاصة بي؟">
+    في السحابة، يمكنك استخدام نماذج الذكاء الاصطناعي التي توفرها Twenty فقط. في مثيلك المُستضاف ذاتيًا، يمكنك استخدام نماذج الذكاء الاصطناعي الخاصة بك بعد الحصول على ترخيص المؤسسة.
+  </Accordion>
+
+  <Accordion title="لا أرى الدور الذي أسنده لوكيل الذكاء الاصطناعي، أين هي؟">
+    افتراضيًا، تتم تصفية قائمة الأدوار لتشمل الأدوار القابلة للإسناد لأعضاء مساحة العمل. إذا كان الدور يمكن تعيينه فقط لوكلاء الذكاء الاصطناعي، تحتاج إلى تغيير الفلتر ليشمل أدوار وكيل AI.
+  </Accordion>
+
+</AccordionGroup>

packages/twenty-docs/l/ar/user-guide/ai/overview.mdx

@@ -0,0 +1,58 @@
+---
+title: الذكاء الاصطناعي
+description: ميزات مدعومة بالذكاء الاصطناعي في Twenty.
+---
+
+<Frame>
+  <img src="/images/user-guide/workflows/robot.png" alt="الذكاء الاصطناعي" />
+</Frame>
+
+## الميزات
+
+حاليًا، يوفّر Twenty ما يلي:
+
+### 1. روبوت محادثة بالذكاء الاصطناعي
+
+مساعد محادثة يفهم سياقك ولديه إمكانية الوصول إلى جميع بياناتك في Twenty.
+
+**القدرات الرئيسية:**
+
+* **وصول كامل إلى البيانات**: الاستعلام عن أي سجل أو علاقة أو مقياس في مساحة العمل لديك
+* **إدراك سياق الصفحة**: الإشارة إلى "هذه الشركة" أو "هذه الفرصة" بناءً على مكانك في Twenty
+* **اللغة الطبيعية**: اطرح الأسئلة واحصل على الإجابات دون التنقل عبر القوائم
+
+**أمثلة على الموجهات:**
+
+* "ما الفرص التي ستُغلق هذا الشهر؟"
+* "ما الصفقات التي كانت في مرحلة التفاوض لمدة تزيد على 30 يومًا؟"
+* "لخِّص تفاعلاتي مع هذا الشخص"
+
+### ٢. وكلاء الذكاء الاصطناعي في سير العمل
+
+وسِّع سير العمل لديك بإجراءات مدعومة بالذكاء الاصطناعي ووكلاء مستقلين.
+
+**القدرات الرئيسية:**
+
+* **إجراءات الذكاء الاصطناعي**: استخدم الذكاء الاصطناعي لإثراء البيانات، وتصنيف السجلات، وإنشاء الملخصات، والمزيد
+* **وكلاء مستقلون**: اسمح للوكلاء بتنفيذ مهام متعددة الخطوات ضمن سير عمل
+* **موجهات مخصّصة**: حدِّد بدقة كيف ينبغي للذكاء الاصطناعي معالجة بياناتك
+
+**حالات الاستخدام:**
+
+* تصنيف العملاء المحتملين الواردين تلقائيًا
+* إثراء بيانات الشركة من المصادر العامة
+* إنشاء مسودات رسائل متابعة عبر البريد الإلكتروني استنادًا إلى ملاحظات الاجتماعات
+* تقييم الفرص استنادًا إلى أنماط التفاعل
+
+## الأذونات والتحكّم في الوصول
+
+يُدار وكلاء الذكاء الاصطناعي عبر نظام الأذونات الحالي:
+
+1. انتقل إلى **الإعدادات → الأعضاء → الأدوار**
+2. حدِّد البيانات التي يمكن لكل وكيل ذكاء اصطناعي الوصول إليها
+3. عيّن أذونات القراءة/الكتابة لكل كائن
+
+يضمن ذلك التزام وكلاء الذكاء الاصطناعي بسياسات حوكمة البيانات لديك والوصول فقط إلى ما يحتاجون إليه.
+
+* تابع [GitHub](https://github.com/twentyhq/twenty) للاطّلاع على تحديثات التطوير
+* انضم إلى [Discord](https://discord.gg/UfGNZJfAG6) لمشاركة الملاحظات وطلبات الميزات