> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gorbit.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# نظرة عامة

> إدارة الموصلات ومصادر البيانات في Gorbit

تنشئ موصلات Gorbit جسرًا بين مصادر بيانات مؤسستك وميزات الذكاء الاصطناعي التوليدي في Gorbit.
تقريبًا جميع الموصلات دائمة وتزامن التغييرات بانتظام من مصدرك.

<Note>
  يمكن تخصيص كل من البيانات المسترجعة من المصدر والبيانات التي يمكن لمستخدميك الوصول إليها عبر Gorbit
  وفقًا لاحتياجاتك!
</Note>

للعثور على تعليمات محددة لكل موصل، راجع قسم [الموصلات المدعومة](#supported-connectors).

<img className="rounded-image" src="https://mintcdn.com/gorbit/i9pIrvFbh53KkrjR/assets/admins/connectors/add_connector.png?fit=max&auto=format&n=i9pIrvFbh53KkrjR&q=85&s=32246800e9f947297ac6279f01169313" alt="Gorbit Add Connector page" width="5104" height="2170" data-path="assets/admins/connectors/add_connector.png" />

## إضافة موصل

لإضافة موصل جديد، انتقل إلى **لوحة الإدارة** وانقر على **إضافة موصل** في الشريط الجانبي.
تعرض هذه الصفحة جميع الموصلات المدعومة رسميًا.

<Info>
  يمكنك رؤية الموصلات غير الرسمية المدعومة من المجتمع بتعيين `SHOW_EXTRA_CONNECTORS=true` في بيئتك.
</Info>

انقر على أي من البلاط لبدء إنشاء موصل جديد.

### بيانات الاعتماد

تتطلب معظم الموصلات شكلاً من أشكال المصادقة لكي يصل Gorbit إلى مصدرك.
تسمى هذه المصادقة بيانات اعتماد وتختلف حسب الموصل.

<img className="rounded-image" src="https://mintcdn.com/gorbit/klR7erNMN33AvYm0/assets/admins/connectors/generic_credentials.png?fit=max&auto=format&n=klR7erNMN33AvYm0&q=85&s=84d372589ffa3238ef597643fa8338de" alt="Gorbit Connector Credentials page" width="1810" height="811" data-path="assets/admins/connectors/generic_credentials.png" />

### التكوين

يجب إعطاء كل موصل اسمًا. بالإضافة إلى ذلك،
لكل موصل خيارات تكوينه الخاصة لتحديد البيانات التي يجب فهرستها.

<img className="rounded-image" src="https://mintcdn.com/gorbit/klR7erNMN33AvYm0/assets/admins/connectors/generic_config.png?fit=max&auto=format&n=klR7erNMN33AvYm0&q=85&s=8fc1da9ba50d3003fe29167176bdc9b7" alt="Gorbit Connector Configuration page" width="1810" height="1728" data-path="assets/admins/connectors/generic_config.png" />

### ضوابط الوصول إلى المستندات

يمكن تكوين الموصلات لتكون **خاصة**، أو **عامة**، أو **مزامنة الأذونات تلقائيًا**.

**خاصة**: فقط المستخدم الذي أنشأ الموصل يمكنه رؤية البيانات من هذا الموصل في Gorbit.
يمكنك أيضًا تعيين مستخدمين محددين ومجموعات مستخدمين للوصول إلى بيانات هذا الموصل.

**عامة**: يمكن لجميع مستخدمي Gorbit رؤية البيانات من هذا الموصل.

<Warning>
  إذا قمت بتكوين الموصل للوصول إلى بيانات خاصة في المصدر، سيتمكن جميع مستخدمي Gorbit من رؤية هذه البيانات.
</Warning>

#### موصلات مزامنة الأذونات

إذا قمت بتعيين نوع وصول موصلك إلى **مزامنة الأذونات تلقائيًا**،
سيحافظ Gorbit على قائمة تحكم في الوصول من المصدر ويقيد المستخدمين على رؤية البيانات التي لديهم حق الوصول إليها فقط.

مزامنة الأذونات متاحة فقط للموصلات التالية:

* Confluence
* Jira
* Google Drive (يجب استخدام حساب خدمة أو بيانات اعتماد OAuth لمسؤول Google Workspace)
* Gmail (يجب استخدام حساب خدمة أو بيانات اعتماد OAuth لمسؤول Google Workspace)
* Slack (راجع وثائق Slack الفيدرالية)
* Salesforce
* GitHub
* SharePoint (يجب استخدام مصادقة قائمة على الشهادات)

<Note>
  موصلات مزامنة الأذونات هي ميزة في نسخة المؤسسات.
</Note>

### التكوين المتقدم

النقر على **التكوين المتقدم** في أسفل يسار صفحة تكوين الموصل سيكشف عن إعدادات إضافية،
اختيارية للفهرسة.

**تكرار التقليم**: التكرار الذي يجب به إزالة البيانات القديمة (التي لم تعد موجودة في المصدر) من Gorbit.
هذا مضبوط على 30 يومًا افتراضيًا.

**تكرار التحديث**: التكرار الذي يجب به استرجاع بيانات جديدة من المصدر.
هذا مضبوط على 30 دقيقة افتراضيًا.

**تاريخ بدء الفهرسة**:
التاريخ والوقت الذي يجب فهرسة البيانات منه (لن يتم فهرسة البيانات المنشأة أو المحدثة قبل هذا التاريخ).
هذا مضبوط على أقرب تاريخ ممكن في المصدر افتراضيًا.

<img className="rounded-image" src="https://mintcdn.com/gorbit/klR7erNMN33AvYm0/assets/admins/connectors/generic_advanced_config.png?fit=max&auto=format&n=klR7erNMN33AvYm0&q=85&s=a665f47e108be2a89386f467bbf0d334" alt="Gorbit Connector Advanced Configuration page" width="1810" height="1728" data-path="assets/admins/connectors/generic_advanced_config.png" />

## إدارة الموصلات الموجودة

لرؤية موصلاتك الموجودة، انتقل إلى **لوحة الإدارة** وانقر على **الموصلات الموجودة** في الشريط الجانبي.
ستعرض هذه الصفحة نظرة عامة على موصلاتك، وحالتها، وكمية البيانات التي فهرستها.

<img className="rounded-image" src="https://mintcdn.com/gorbit/klR7erNMN33AvYm0/assets/admins/connectors/indexing_status.png?fit=max&auto=format&n=klR7erNMN33AvYm0&q=85&s=a903ef97812d153b4415a629c7d4e1d5" alt="Gorbit Existing Connectors page showing connector statuses" width="4046" height="1830" data-path="assets/admins/connectors/indexing_status.png" />

### حالة الموصل

يمكن أن تكون حالة الموصل:

#### نشط

| الحالة                   | الوصف                                                                                   |
| ------------------------ | --------------------------------------------------------------------------------------- |
| **مفهرس**                | الموصل يعمل بالكامل وجميع البيانات متزامنة اعتبارًا من آخر محاولة فهرسة.                |
| **مجدول**                | موصلات منشأة حديثًا أو موصلات وصلت إلى تكرار التحديث ولكنها لم تبدأ محاولة فهرسة جديدة. |
| **يُفهرس / فهرسة أولية** | الموصل يسترجع البيانات حاليًا من المصدر.                                                |

#### غير نشط أو شبه نشط

| الحالة           | الوصف                                                                                                                                                 |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| **متوقف مؤقتًا** | تم إيقاف الموصل مؤقتًا ولن يسترجع بيانات جديدة حتى يتم إلغاء إيقافه. لا يزال بإمكان المستخدمين الوصول إلى البيانات المفهرسة.                          |
| **خطأ**          | واجه الموصل خطأ أثناء الفهرسة. ستظل أي بيانات مفهرسة قبل الخطأ متاحة. سيحاول Gorbit الفهرسة مرة أخرى. إذا حدثت أخطاء كثيرة، سيتم إيقاف الموصل مؤقتًا. |

<Note>
  معظم حالات الخطأ مؤقتة وستحل نفسها بشكل طبيعي خلال بضع ساعات.
  إذا رأيت حالة خطأ تستمر، يرجى التواصل معنا.
</Note>

### تفاصيل الموصل

النقر على موصل موجود سيظهر لك تفاصيل حول تكوينه وحالته ومحاولات الفهرسة.

في قائمة **إدارة**، يمكنك إيقاف أو استئناف أو حذف أو بدء إعادة فهرسة كاملة للموصل.

تحت قسم **متقدم**، يمكنك رؤية إعدادات التقليم والتحديث، بالإضافة إلى سجل محاولات الفهرسة.

<img className="rounded-image" src="https://mintcdn.com/gorbit/i9pIrvFbh53KkrjR/assets/admins/connectors/connector_details.png?fit=max&auto=format&n=i9pIrvFbh53KkrjR&q=85&s=bbf1530c95ab7f9efbe8544f227eac54" alt="Gorbit Connector details page showing connector details" width="1760" height="930" data-path="assets/admins/connectors/connector_details.png" />

<img className="rounded-image" src="https://mintcdn.com/gorbit/klR7erNMN33AvYm0/assets/admins/connectors/indexing_attempts.png?fit=max&auto=format&n=klR7erNMN33AvYm0&q=85&s=05e85d744fc01618ff1f3e68c04c8fd9" alt="Gorbit Connector details page showing indexing attempts and failures" width="1716" height="880" data-path="assets/admins/connectors/indexing_attempts.png" />

### فشل الفهرسة

نادرًا، سترى محاولة فهرسة **اكتملت مع أخطاء**. إذا حدث هذا،
يمكنك النقر على زر **حل جميع الأخطاء** لبدء إعادة فهرسة كاملة للموصل.

## الموصلات المدعومة

<Warning>
  لا تجد الموصل الذي تبحث عنه؟
  أعلمنا عبر [مناقشات GitHub](https://github.com/gorbit-dot-app/gorbit/discussions)!
</Warning>

### قواعد المعرفة والويكي

<Columns cols={3}>
  <Card title="Confluence" icon="confluence" href="/admins/connectors/official/confluence" horizontal />

  <Card title="SharePoint" icon="microsoft" href="/admins/connectors/official/sharepoint" horizontal />

  <Card title="Notion" icon="notion" href="/admins/connectors/official/notion" horizontal />

  <Card title="BookStack" icon="book" href="/admins/connectors/official/bookstack" horizontal />

  <Card title="Document360" icon="file-text" href="/admins/connectors/official/document360" horizontal />

  <Card title="Discourse" icon="comments" href="/admins/connectors/official/discourse" horizontal />

  <Card title="GitBook" icon="book-open" href="/admins/connectors/official/gitbook" horizontal />

  <Card title="Slab" icon="book" href="/admins/connectors/official/slab" horizontal />

  <Card title="Outline" icon="book" href="/admins/connectors/official/outline" horizontal />

  <Card title="Google Sites" icon="google" href="/admins/connectors/official/google_sites" horizontal />

  <Card title="Guru" icon="lightbulb" href="/admins/connectors/official/guru" horizontal />
</Columns>

### التخزين السحابي

<Columns cols={3}>
  <Card title="Google Drive" icon="google-drive" href="/admins/connectors/official/google_drive/overview" horizontal />

  <Card title="Dropbox" icon="dropbox" href="/admins/connectors/official/dropbox" horizontal />

  <Card title="AWS S3" icon="aws" href="/admins/connectors/official/s3/overview" horizontal />

  <Card title="Google Storage" icon="google" href="/admins/connectors/official/google_storage" horizontal />

  <Card title="Egnyte" icon="cloud" href="/admins/connectors/official/egnyte" horizontal />

  <Card title="Oracle Storage" icon="cloud" href="/admins/connectors/official/oci_storage" horizontal />

  <Card title="Cloudflare R2" icon="cloud" href="/admins/connectors/official/r2" horizontal />
</Columns>

### إدارة التذاكر والمهام

<Columns cols={3}>
  <Card title="Jira" icon="jira" href="/admins/connectors/official/jira" horizontal />

  <Card title="Zendesk" icon="headset" href="/admins/connectors/official/zendesk" horizontal />

  <Card title="Airtable" icon="table" href="/admins/connectors/official/airtable" horizontal />

  <Card title="Linear" icon="linear" href="/admins/connectors/official/linear" horizontal />

  <Card title="Freshdesk" icon="headset" href="/admins/connectors/official/freshdesk" horizontal />

  <Card title="Asana" icon="check" href="/admins/connectors/official/asana" horizontal />

  <Card title="ClickUp" icon="mouse-pointer" href="/admins/connectors/official/clickup" horizontal />

  <Card title="ProductBoard" icon="trello" href="/admins/connectors/official/productboard" horizontal />
</Columns>

### المراسلة

<Columns cols={3}>
  <Card title="Slack" icon="slack" href="/admins/connectors/official/slack/slack_indexed" horizontal />

  <Card title="Microsoft Teams" icon="microsoft" href="/admins/connectors/official/teams" horizontal />

  <Card title="Gmail" icon="envelope" href="/admins/connectors/official/gmail/overview" horizontal />

  <Card title="Discord" icon="discord" href="/admins/connectors/official/discord" horizontal />

  <Card title="XenForo" icon="comments" href="/admins/connectors/official/xenforo" horizontal />

  <Card title="Zulip" icon="zulip" href="/admins/connectors/official/zulip" horizontal />
</Columns>

### المبيعات

<Columns cols={3}>
  <Card title="Salesforce" icon="salesforce" href="/admins/connectors/official/salesforce" horizontal />

  <Card title="HubSpot" icon="hubspot" href="/admins/connectors/official/hubspot" horizontal />

  <Card title="Gong" icon="phone" href="/admins/connectors/official/gong" horizontal />

  <Card title="Fireflies" icon="microphone" href="/admins/connectors/official/fireflies" horizontal />

  <Card title="Highspot" icon="chart-line" href="/admins/connectors/official/highspot" horizontal />
</Columns>

### مستودع الأكواد

<Columns cols={3}>
  <Card title="GitHub" icon="github" href="/admins/connectors/official/github" horizontal />

  <Card title="GitLab" icon="gitlab" href="/admins/connectors/official/gitlab" horizontal />

  <Card title="Bitbucket" icon="bitbucket" href="/admins/connectors/official/bitbucket" horizontal />
</Columns>

### أخرى

<Columns cols={3}>
  <Card title="زاحف الويب" icon="globe" href="/admins/connectors/official/web" horizontal />

  <Card title="رفع الملفات" icon="upload" href="/admins/connectors/official/file" horizontal />
</Columns>
