إدارة المصادر

# إدارة المصادر

> إذا رأيت عناصر نائبة غير مألوفة أو كنت بحاجة للتحقق من الأدوات المتصلة، اطلع على [CONNECTORS.md](../../CONNECTORS.md).

تحديد المصادر المتاحة والمساعدة في ربط مصادر جديدة وإدارة طريقة الاستعلام عن المصادر.

## التحقق من المصادر المتاحة

حدد مصادر MCP المتصلة من خلال التحقق من الأدوات المتاحة. يتوافق كل مصدر مع مجموعة من أدوات MCP:

| المصدر | القدرات الرئيسية | |--------|-----------------| | **~~chat** | البحث في الرسائل، قراءة القنوات والمحادثات | | **~~email** | البحث في الرسائل، قراءة رسائل البريد الإلكتروني الفردية | | **~~cloud storage** | البحث عن الملفات، جلب محتويات المستندات | | **~~project tracker** | البحث عن المهام، البحث التلقائي | | **~~CRM** | الاستعلام عن السجلات (الحسابات والجهات والفرص) | | **~~knowledge base** | البحث الدلالي، البحث بالكلمات الرئيسية |

إذا كان بادئة أداة متاحة، فقد تم ربط المصدر وهو قابل للبحث.

## توجيه المستخدمين لربط المصادر

عندما يبحث المستخدم لكن لديه مصادر قليلة أو بدون مصادر متصلة:

``` لديك حالياً [N] مصدر(مصادر) متصل(ة): [القائمة].

لتوسيع نطاق البحث، يمكنك ربط مصادر إضافية في إعدادات MCP الخاصة بك: - ~~chat — الرسائل والمحادثات والقنوات - ~~email — البريد الإلكتروني والمحادثات والمرفقات - ~~cloud storage — المستندات والجداول والعروض التقديمية - ~~project tracker — المهام والمشاريع والأحداث البارزة - ~~CRM — الحسابات والجهات والفرص - ~~knowledge base — صفحات الويكي وموارد قاعدة المعرفة

كلما ربطت مصادر أكثر، حصلت على نتائج بحث أكثر اكتمالاً. ```

عندما يسأل المستخدم عن أداة محددة غير متصلة:

``` [اسم الأداة] غير متصل حالياً. للإضافة: 1. افتح إعدادات MCP الخاصة بك 2. أضف تكوين خادم [الأداة] MCP 3. تحقق من الهوية عند الطلب

بمجرد الاتصال، سيتم تضمينه تلقائياً في عمليات البحث المستقبلية. ```

## ترتيب أولويات المصدر

أنواع الاستعلامات المختلفة تستفيد من البحث في مصادر معينة أولاً. استخدم هذه الأولويات لترجيح النتائج، وليس لتخطي المصادر:

### حسب نوع الاستعلام

**الاستعلامات القرارية** ("ما الذي قررنا..."): ``` 1. ~~chat (المحادثات حيث تحدث القرارات) 2. ~~email (تأكيدات القرار والإعلانات) 3. ~~cloud storage (ملاحظات الاجتماع وسجلات القرارات) 4. Wiki (إذا تم توثيق القرارات) 5. Task tracker (إذا تم التقاط القرارات في المهام) ```

**استعلامات الحالة** ("ما حالة..."): ``` 1. Task tracker (~~project tracker — الحالة الموثوقة) 2. ~~chat (المناقشة في الوقت الفعلي) 3. ~~cloud storage (مستندات الحالة والتقارير) 4. ~~email (رسائل تحديث الحالة) 5. Wiki (صفحات المشروع) ```

**استعلامات المستند** ("أين المستند الخاص بـ..."): ``` 1. ~~cloud storage (تخزين المستندات الأساسي) 2. Wiki / ~~knowledge base (قاعدة المعرفة) 3. ~~email (المستندات المشاركة عبر البريد الإلكتروني) 4. ~~chat (المستندات المشاركة في القنوات) 5. Task tracker (المستندات المرتبطة بالمهام) ```

**استعلامات الأشخاص** ("من يعمل على..." / "من يعرف عن..."): ``` 1. ~~chat (مؤلفو الرسائل وأعضاء القناة) 2. Task tracker (المسؤولون عن المهام) 3. ~~cloud storage (مؤلفو المستندات والمتعاونون) 4. ~~CRM (أصحاب الحسابات والجهات) 5. ~~email (المشاركون في البريد الإلكتروني) ```

**استعلامات الحقائق والسياسات** ("ما سياستنا بشأن..."): ``` 1. Wiki / ~~knowledge base (الوثائق الرسمية) 2. ~~cloud storage (مستندات السياسة والأدلة) 3. ~~email (إعلانات السياسة) 4. ~~chat (نقاشات السياسة) ```

### الأولوية الافتراضية (الاستعلامات العامة)

عندما يكون نوع الاستعلام غير واضح: ``` 1. ~~chat (أعلى حجم، الأكثر فورية) 2. ~~email (الاتصالات الرسمية) 3. ~~cloud storage (المستندات والملفات) 4. Wiki / ~~knowledge base (المعرفة المنظمة) 5. Task tracker (عناصر العمل) 6. CRM (بيانات العملاء) ```

## توعية الحد من المعدل

قد تكون لمصادر MCP حدود معدل. تعامل معها بأناقة:

### الكشف

عادة ما تظهر استجابات الحد من المعدل كـ: - استجابات HTTP 429 - رسائل خطأ تذكر "rate limit" أو "too many requests" أو "quota exceeded" - استجابات مخنوقة أو متأخرة

### معالجة

عندما يكون المصدر محدود المعدل:

1. **عدم إعادة المحاولة فوراً** — احترم الحد 2. **المتابعة مع مصادر أخرى** — لا تحظر البحث بالكامل 3. **إخبار المستخدم**: ``` ملاحظة: [المصدر] محدود المعدل مؤقتاً. النتائج أدناه من [المصادر الأخرى]. يمكنك إعادة المحاولة في بضع دقائق لتضمين [المصدر]. ``` 4. **للملخصات** — إذا حدث حد معدل أثناء الفحص، لاحظ نطاق الوقت الذي تم تغطيته قبل بلوغ الحد

### الوقاية

- تجنب طلبات API غير الضرورية — تحقق من احتمالية أن يكون للمصدر نتائج ذات صلة قبل الاستعلام - استخدم الاستعلامات المستهدفة بدلاً من المسح الواسع عندما يكون ذلك ممكناً - للملخصات، ادمج الطلبات حيث يدعمها API - وعي التخزين المؤقت: إذا تم تشغيل البحث للتو، تجنب إعادة تشغيل نفس الاستعلام فوراً

## صحة المصدر

تتبع توفر المصدر أثناء جلسة:

``` حالة المصدر: ~~chat: ✓ متاح ~~email: ✓ متاح ~~cloud storage: ✓ متاح ~~project tracker: ✗ غير متصل ~~CRM: ✗ غير متصل ~~knowledge base: ⚠ محدود المعدل (أعد المحاولة في دقيقتين) ```

عند الإبلاغ عن نتائج البحث، قم بتضمين المصادر التي تم البحث فيها حتى يعرف المستخدم نطاق الإجابة.

## الإضافة