التكاملات

لوحة التحكم ← التكاملات — اربط مصادر المحتوى وقنوات الوصول إلى المعرفة.

#مصادر المحتوى

#المتصلة (نشطة دائمًا)

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

#ربط GitHub

#الخطوة 1 — التفويض

1. في LiKE انتقل إلى التكاملات ← GitHub ← «ربط»
2. اختر طريقة تفويض:

#الخطوة 2 — اختيار المحتوى

1. بعد الربط، تُعرض شجرة المستودع بالمجلدات والملفات
2. حدّد الملفات أو المجلدات المعيّنة للاستيراد (Selective Sync)
3. الصيغ المدعومة: .md, .mdx, صفحات Wiki

#الخطوة 3 — تشغيل المزامنة

1. انقر «مزامنة»
2. يُعرض التقدّم في الوقت الفعلي
3. عند الانتهاء، تظهر المقالات في القائمة بوسم GitHub

#ربط GitLab

#الخطوة 1 — التفويض

1. في LiKE انتقل إلى التكاملات ← GitLab ← «ربط»
2. اختر طريقة تفويض:

#الخطوة 2 — اختيار المحتوى

1. تُعرض شجرة المشروع بصفحات Wiki وملفات Markdown
2. حدّد الصفحات المعيّنة للاستيراد (Selective Sync)

#الخطوة 3 — تشغيل المزامنة

كما في GitHub — انقر «مزامنة» وانتظر انتهاءها.

#ربط Gitea

Gitea منصة git مُستضافة ذاتيًا. تُربَط عبر Personal Access Token ورابط إلزامي لنسختك (لا توجد Gitea سحابية افتراضيًا).

#الخطوة 1 — أنشئ رمزًا في Gitea

1. في Gitea افتح Settings ← Applications ← Generate New Token
2. امنح النطاقين read:repository و**read:user**
3. انسخ الرمز

#الخطوة 2 — اربط في LiKE

1. في LiKE انتقل إلى التكاملات ← Gitea ← «ربط»
2. حدّد Base URL لنسختك (على سبيل المثال https://gitea.company.com) — هذا الحقل إلزامي، وبدونه لن يتم الاتصال
3. الصق الرمز
4. اختر مساحة/مجموعة ووضعًا (مزامنة — مرآة مستمرة / استيراد — نسخة لمرة واحدة)

يُدعم أيضًا OAuth 2.0 إذا كان مسؤول Gitea قد أعدّ تطبيق OAuth مسبقًا. المسار الأساسي هو الرمز.

#الخطوة 3 — اختيار المحتوى والمزامنة

1. تُعرض شجرة المستودع بصفحات Wiki وملفات Markdown (.md, .mdx)
2. حدّد العُقد التي تحتاجها (Selective Sync) وانقر «مزامنة»
3. للتحديثات التلقائية عند الدفع، أعدّ webhook — يُولَّد السرّ في بطاقة الموصّل. ومقالات Gitea للقراءة فقط (كما هو الحال مع GitHub/GitLab)

#اختيار الملفات ومرشّحات المزامنة (GitHub, GitLab, Gitea)

بالنسبة لمصادر git (GitHub وGitLab وGitea)، فإن منطق اختيار ما يُزامَن أدقّ من مجرّد «تشغيل/إيقاف المستودع»:

#ما الذي يُزامَن

#مرشّحات المسارات (المزامنة الانتقائية)

يمكنك تضييق ما تأخذه بالضبط من المستودع:

#كشف التغييرات (التغييرات الأخيرة)

لا «يُنزّل» LiKE كل شيء في كل تشغيل. يُستخدم كشف التغييرات:

• GitHub — عبر webhook (موصى به) أو الاستطلاع باستخدام ترويسات If-Modified-Since. يتفاعل الـ webhook مع الدفع فورًا، أما الاستطلاع فكل 6/12/24/48 ساعة (حسب المزامنة التلقائية).
• GitLab — كذلك: webhook أو استطلاع حسب last_activity_at عبر Projects API.
• Gitea — webhook (توقيع X-Gitea-Signature) أو استطلاع. لا يُطلَق مُشغّل الدفع إلا عند تغيّر *.md/*.mdx.

بمجرّد اكتشاف تغيير، تُزامَن الملفات المتأثّرة فقط؛ ولا يُعاد احتساب بقية المجموعة. وهذا يوفّر قدرًا كبيرًا من حصّة GitHub/GitLab API ومن وقت التنفيذ.

#الفرع والوسوم

#السجلّ والتعارضات

• سجلّ المزامنة — تبويب «السجلّ» في بطاقة الموصّل: التاريخ، والحالة (✅ سليم / ⚠ تحذيرات / ❌ خطأ)، وعدد المقالات المُضافة / المُحدَّثة / المحذوفة، ومدة التشغيل. مفيد لتصحيح «لماذا لم تظهر مقالة من المستودع».
• تعارضات التحرير — إذا حُرِّرت مقالة من المصدر في LiKE (بالنسبة لـ GitHub/GitLab هذا غير مسموح افتراضيًا — المقالات للقراءة فقط). وإذا كان الوضع استيراد (نسخة لمرة واحدة)، تصبح المقالات قابلة للتحرير ويُقطَع الرابط بالمصدر.

#المزامنة الانتقائية للموصّلات الأخرى

Notion وConfluence وWiki.js — لها منطق اختيار خاص بها (شجرة صفحات)، لكن المبدأ نفسه:

1. عند الربط، تُعرض شجرة محتوى المصدر
2. مربّعات الاختيار — علّم على العُقد التي تحتاجها
3. لا يُستورَد الباقي
4. عند إعادة المزامنة، تُحدَّث العناصر المختارة فقط

#ربط Wiki.js

#الخطوة 1 — احصل على رمز Wiki.js API

1. افتح Wiki.js الخاص بك ← Administration ← API Access
2. فعّل الـ API (إذا كان معطّلًا)
3. انقر New API Key
4. سمِّ المفتاح (على سبيل المثال LiKE Integration)
5. المجموعة: Administrators (الوصول إلى جميع الصفحات مطلوب)
6. انتهاء الصلاحية: بلا انتهاء أو سنة واحدة
7. انسخ الرمز المُولَّد

#الخطوة 2 — اربط في LiKE

1. في LiKE انتقل إلى التكاملات ← Wiki.js ← «ربط»
2. أدخل URL الخاص بـ Wiki.js لديك (على سبيل المثال https://wiki.company.com)
3. الصق رمز API
4. اختر وضعًا:

5. انقر حفظ

#الخطوة 3 — اضبط المزامنة

#ربط Confluence

يُربَط Confluence عبر OAuth 2.0 — تفويض آمن دون إدخال كلمات مرور.

#الخطوة 1 — انقر "Connect Confluence"

1. في LiKE انتقل إلى لوحة التحكم ← التكاملات
2. اعثر على بطاقة Confluence ← انقر «ربط»
3. تفتح نافذة تفويض Atlassian

#الخطوة 2 — فوّض في Atlassian

1. سجّل الدخول إلى حساب Atlassian الخاص بك (إن لم تكن قد فعلت)
2. يعرض Atlassian طلبًا: "LiKE is requesting access to your Confluence"
3. راجِع الأذونات — يطلب LiKE القراءة فقط: محتوى الصفحات وقائمة المساحات
4. انقر "Accept"

#الخطوة 3 — تعود إلى LiKE

بعد التأكيد تُعاد توجيهك تلقائيًا إلى التكاملات. تُظهر بطاقة Confluence:

• الحالة: متصل
• اسم موقع Confluence الخاص بك
• زرّ «مزامنة»

#الخطوة 4 — شغّل المزامنة

1. انقر «مزامنة» لأول استيراد
2. يحمّل LiKE جميع الصفحات من مساحات Confluence المتاحة
3. تظهر المقالات في كتالوج المعرفة

#الخطوة 5 — اضبط المزامنة التلقائية

افتح الإعدادات (أيقونة الترس على بطاقة Confluence):

مقالات Confluence للقراءة فقط. للتحرير، غيّر الأصل في Confluence، وسيحدّثه LiKE عند المزامنة التالية.

عند فصل Confluence، يمكنك الاحتفاظ بنسخة من المقالات في LiKE (تصبح قابلة للتحرير) أو حذفها.

#ربط Notion

#الخطوة 1 — أنشئ تكاملًا في Notion

1. افتح Notion ← انقر صورتك الرمزية (الزاوية العلوية اليسرى) ← Settings
2. في القائمة اليسرى اختر My connections (أو Integrations)
3. انقر Develop or manage integrations ← New integration
4. أدخل اسمًا (على سبيل المثال LiKE Import)، واختر مساحة عمل
5. انقر Submit ← انسخ Internal Integration Secret (يبدأ بـ ntn_؛ للتكاملات الأقدم — بـ secret_)

#الخطوة 2 — امنح التكامل وصولًا إلى الصفحات

افتراضيًا، لا يملك التكامل وصولًا إلى أي صفحات. عليك السماح بذلك صراحةً:

1. في Notion، افتح كل صفحة (أو الصفحة/قاعدة البيانات الأصل) تريد استيرادها
2. انقر ⋯ (ثلاث نقاط، الزاوية العلوية اليمنى) ← Connect to ← اختر تكامل LiKE Import الخاص بك
3. أكّد الوصول

#الخطوة 3 — اربط في LiKE

1. في LiKE ← لوحة التحكم ← التكاملات ← Notion ← «ربط»
2. الصق Integration Secret (المنسوخ في الخطوة 1)
3. اختر مساحة للاستيراد (موجودة أو أنشئ واحدة جديدة)
4. اختر وضعًا:

5. انقر «ربط»
6. يحمّل LiKE جميع الصفحات التي يملك التكامل وصولًا إليها

#الخطوة 4 — اضبط المزامنة التلقائية

افتح الإعدادات (أيقونة الترس على بطاقة Notion):

عند فصل Notion، يمكنك الاحتفاظ بنسخة من المقالات في LiKE (تصبح قابلة للتحرير) أو حذفها.

#ربط موقع التوثيق

يجلب هذا الموصل المقالات من موقع عام: يقرأ خريطة الموقع (sitemap) ويحافظ على نسخة محدَّثة داخل LiKE. وهو مناسب عندما تكون الوثائق منشورة بالفعل — على نطاقكم الخاص أو في Docusaurus أو GitBook أو Docsify وما شابهها.

#الخطوة 1 — عنوان الموقع

التكاملات ← موقع التوثيق ← ربط الموقع. ألصِقوا العنوان؛ يكفي عنوان أي صفحة، فنحن نأخذ الموقع بأكمله. أما الخريطة فنبحث عنها بأنفسنا: أولًا عبر robots.txt ثم عبر /sitemap.xml.

#الخطوة 2 — ما وجدناه

اضغطوا فحص الموقع. الفحص لا يحفظ شيئًا: يقرأ الخريطة فقط ويعرض عدد الصفحات المكتشفة وعدد ما سيُضاف بعد تطبيق عوامل التصفية. وإذا لم تكن هناك خريطة، لا يبدأ الربط ونقول ذلك بوضوح بدل استيراد لا شيء بصمت.

#الخطوة 3 — أين نضعها

اختاروا المساحة والمجموعة — ويمكن إنشاء المجموعة من المعالج نفسه. بعد ربط يبدأ الزحف فورًا: ويظهر التقدّم على بطاقة الموصل («يجري المرور على الموقع 22 من 92») وفي مؤشر المهام في الخلفية.

#ما يُؤخذ وما لا يُؤخذ

• يُؤخذ محتوى الصفحة دون قائمة الموقع ورأسه وتذييله؛
• أقسام الموقع تحصر الزحف بمسارات (/docs/، /guides/)؛ وتركها فارغة يعني الموقع كاملًا؛
• الأقسام الخدمية مثل البحث والوسوم تُتجاوز افتراضيًا؛
• عدد الصفحات في المرة الواحدة يحدّ من الجولة الواحدة — حماية من المواقع الضخمة؛
• الصفحات الممنوعة في robots.txt لا تُجلب، ويظهر عددها في ملخّص الجولة.

#التحديثات اللاحقة

مع تفعيل المزامنة التلقائية نعيد قراءة الموقع وفق الجدولة. تُعاد فهرسة الصفحات المتغيّرة فقط — وهكذا يقول الملخّص: «أُضيفت»، «حُدِّثت»، «دون تغيير». والصفحات غير المتغيّرة لا تستهلك حصة الفهرسة.

إزالة الصفحات المفقودة معطَّلة افتراضيًا: فإذا اختفت صفحة من الموقع تبقى المقالة في قاعدتكم. فعِّلوها إن كان لا بد أن تطابق النسخةُ الموقعَ بدقّة.

#أي المواقع تصلح وأيها لا

يصلح الموقع العام الذي له خريطة (sitemap) — وهكذا تعمل معظم مولّدات التوثيق. أما ما عدا ذلك فنرفضه في خطوة الفحص، لا بعد الربط:

وحتى بعد نجاح الربط قد تبقى بعض الصفحات خارجًا: الممنوعة في robots.txt، والتي تردّ بخطأ، والتي يتجاوز حجمها 10 ميغابايت، أو التي لا تعيد HTML. وكلّها تظهر في ملخّص الجولة مع السبب: «متجاوَزة» و«ممنوعة بـ robots.txt».

الملفات (PDF وZIP والصور) لا تُجلب من الموقع. ولها مسار مستقل — استيراد الملفات، بمعالجته الخاصة.

#القيود

• موقع واحد لكل مؤسسة؛
• يجب أن يكون الموقع عامًا — فالصفحات المحمية بكلمة مرور لا تُقرأ؛
• خريطة الموقع مطلوبة: فبدونها لا يتم الربط؛
• نلتزم بـrobots.txt، بما في ذلك مهلة الانتظار بين الطلبات المذكورة فيه.

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

#استيراد الملفات

#رفع الملفات

1. لوحة التحكم ← استيراد
2. اسحب الملفات إلى الداخل أو انقر منطقة الرفع
3. الصيغ المدعومة: PDF, DOCX, TXT, MD, RTF, ZIP
4. يولّد الذكاء الاصطناعي عنوانًا وslug تلقائيًا لكل ملف
5. قبل النشر يمكنك تحرير العنوان أو فتحه في المحرّر

#أرشيفات ZIP

ارفع أرشيف ZIP يحوي مستندات كثيرة — يفكّه LiKE تلقائيًا ويعالج كل ملف. مفيد لترحيل قاعدة معرفة بأكملها.

الملفات المدعومة داخل ZIP: PDF, DOCX, TXT, MD, RTF. أما الملفات الأخرى (الصور، الملفات التنفيذية) فتُتخطّى.

#الاستيراد عبر رابط

الصق رابطًا إلى مستند — يحمّله LiKE ويستورده:

1. لوحة التحكم ← استيراد ← قسم «الاستيراد عبر رابط»
2. الصق URL ← انقر «إضافة»
3. يمكنك إضافة حتى 10 روابط في المرة الواحدة
4. انقر «استيراد»

المصادر المدعومة:

• Google Docs — يُصدَّر تلقائيًا كـ DOCX
• Google Sheets — يُصدَّر كـ CSV
• Dropbox — رابط ملف مباشر
• أي URL مباشر إلى ملف PDF أو DOCX أو TXT أو MD أو RTF

#الظهور الافتراضي

لكل مصدر يمكنك ضبط ظهور افتراضي:

• مسودة — تُنشأ المقالات مخفية
• الفريق — مرئية للمستخدمين المصرَّح لهم
• عام — مرئية للجميع، بما في ذلك المستخدمون المجهولون

يُضبط في التكاملات ← بطاقة المصدر ← الظهور.

#قنوات الوصول

تتيح القنوات لموظفيك البحث عن المعلومات عبر أدوات مألوفة.

#روبوت Slack

الميزات:

• /like how do I set up SSO? ← إجابة ذكاء اصطناعي مباشرة في Slack
• ذكر @LiKE في أي قناة ← إجابة في المناقشة
• روابط إلى المقالات المصدر (قابلة للنقر)

#روبوت Telegram

الميزات:

• الرسائل المباشرة إلى الروبوت ← إجابة ذكاء اصطناعي
• في محادثة جماعية: /ask question ← إجابة
• دعم 25+ لغة

#أداة JS (لموقعك)

زرّ بحث ذكاء اصطناعي عائم للتضمين في أي موقع. أكثر تكامل شيوعًا — يرى المستخدم زرًا في زاوية الصفحة، وينقره، فتُفتح محادثة مع الذكاء الاصطناعي وبحث في قاعدة معرفتك.

#تثبيت بسيط

#المعلمات الأساسية

#Dual-auth: وضعا مصادقة (ADR 0032)

في LiKE يمكن أن تعمل الأداة بأحد وضعين — يُختار عند الإنشاء:

للاطّلاع على تفاصيل ضبط كل وضع والتكامل مع خادومك الخلفي، راجع API والأداة.

#النطاق: ما الذي يمكن للأداة أن تجده

عند إنشاء أداة، تضبط نطاقًا — ما الذي تبحث فيه بالضبط:

يمكنك ضمن أداة واحدة دمج عدة مدخلات نطاق (على سبيل المثال، مجموعتان من المساحة نفسها).

#أدوات متعددة لكل مستأجر (ADR 0029 Stage 4)

يمكنك ضمن المؤسسة إنشاء عدة أدوات مستقلة بنطاقات وأوضاع مختلفة:

لكلٍّ منها api-key وتحليلات استخدام خاصة، ويمكن إبطال المفتاح على نحو مستقل. الإدارة في التكاملات ← الأدوات ← «+ إنشاء».

#إدارة الجلسات (وضع Session JWT)

في وضع Session JWT، لكل جلسة مستخدم sessionId فريد. يمكن للمسؤول عرض الجلسات النشطة لأداة معيّنة وإبطال رمز قسريًا (على سبيل المثال، عند الاشتباه في تسريب). القائمة في التكاملات ← الأدوات ← [الأداة] ← الجلسات.

#iframe / رابط مباشر

ضمّن واجهة بحث LiKE الكاملة في أي صفحة:

1. التكاملات ← iframe ← انسخ الشيفرة
2. الصق <iframe src="..."> في صفحتك
3. أو استخدم الرابط المباشر للتنقّل (صفحة كاملة، وليس تضمينًا)

يدعم iframe والرابط المباشر أيضًا dual-auth — يُختار عند الإنشاء.

#REST API

واجهة برمجية كاملة للتكامل البرمجي (على سبيل المثال، واجهتك الخاصة أو التكامل مع أنظمة أخرى):

1. التكاملات ← API Keys ← «إنشاء مفتاح»
2. حدّد اسمًا (لأي غرض المفتاح) ونطاقًا (كما للأداة — public_umbrella / space / collection)
3. انسخ المفتاح — يُعرض مرة واحدة فقط، وبعد إعادة الفتح سيُخفى

استخدم المفتاح في ترويسة X-API-Key أو كرمز Bearer.

نقاط النهاية الرئيسية:

الحدود: تعتمد حدود المعدّل على الباقة وترتبط بـ api-key. تجاوزها يُرجِع HTTP 429 مع ترويسة Retry-After. القيم الدقيقة لباقتك موجودة في صفحة الباقات وفي لوحة الإدارة.

وثائق API الكاملة: API والأداة.

#اللغات

يدعم LiKE 25+ لغة لبحث الذكاء الاصطناعي والبحث متعدّد اللغات (الواجهة نفسها متاحة بـ 11 لغة واجهة):

Русский, English, Deutsch, Français, Español, Português, Italiano, Nederlands, Polski, Čeština, Svenska, Dansk, Suomi, Română, Magyar, Hrvatski, Türkçe, Afrikaans, Kiswahili, Bahasa Indonesia, Tiếng Việt, Українська, Српски, Български, Ελληνικά, 한국어, 日本語, 中文, हिन्दी, ไทย, עברית, العربية.

البحث متعدّد اللغات: سؤال بلغة ما ← إجابة من مقالات بلغة أخرى.