> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# LibreChat

> كيف يعمل LibreChat كواجهة الدردشة والوكلاء الأمامية في Agentic Data Stack

يُعد LibreChat **واجهة الدردشة والوكلاء الأمامية** لـ [Agentic Data Stack](/ar/products/agentic-data-stack/overview). فبدلًا من كتابة SQL، يطرح المستخدم سؤالًا بلغة طبيعية، فيتولى وكيل الإجابة عنه.

يعمل الوكيل عبر خادم MCP لفحص قواعد البيانات والجداول لديك، وتشغيل استعلامات للقراءة فقط، وبناء إجابة استنادًا إلى النتائج. ويتكفّل هذا المكدس بتهيئة ذلك لك، بحيث يستعلم LibreChat بياناتك منذ أول تسجيل دخول. شغّل المكدس الكامل باستخدام [دليل إعداد Docker](/ar/products/agentic-data-stack/docker-setup).

<div id="capabilities">
  ## إمكانات LibreChat
</div>

| الإمكانية                                                                                       | ما الذي تفعله                                                                                                                                                                                                                                                                   |
| ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [أنشئ وكيلاً اعتمادًا على بياناتك](https://www.librechat.ai/docs/features/agents)               | أنشئ وكيلاً قابلاً لإعادة الاستخدام للإجابة عن سؤال متكرر. وهناك خياران يجعلان الوكيل على دراية بـ ClickHouse: زوّده بـ **تعليمات** تصف المخطط والجداول المفضلة لديك، وأضف خادم MCP **ClickHouse-Local** حتى يتمكن من عرض قواعد البيانات والجداول وتشغيل استعلامات للقراءة فقط. |
| [اربط المزيد من خوادم MCP](https://www.librechat.ai/docs/features/mcp)                          | لا يقتصر الوكيل على ClickHouse. أضف أي خادم MCP عبر إعدادات MCP في LibreChat حتى تتمكن محادثة واحدة من الوصول إلى قواعد بيانات أخرى، أو واجهات برمجة تطبيقات داخلية، أو أدوات SaaS.                                                                                             |
| [أنشئ مخططات وتصورات](https://www.librechat.ai/docs/features/artifacts)                         | اطلب من الوكيل عرض نتائجك بصريًا، على سبيل المثال: "اعرض مخططًا لأفضل 10 منتجات حسب الإيرادات"، وسيُرجع مخططًا تفاعليًا يمكنك استكشافه ومشاركته. تستخدم التصورات ميزة LibreChat Artifacts، وهي مفعّلة لكل وكيل.                                                                 |
| [شغّل الشيفرة باستخدام مفسر الشيفرة](https://www.librechat.ai/docs/features/code_interpreter)   | إلى جانب SQL، يمكن للوكيل تشغيل الشيفرة داخل بيئة معزولة آمنة لتحويل نتائجك أو تحليلها، مثل تحويل استعلام إلى ملف أو إلى مقياس محسوب.                                                                                                                                           |
| [شغّل الاستعلامات الطويلة في الخلفية](https://www.librechat.ai/docs/features/resumable_streams) | قد يستغرق الاستعلام بعض الوقت، وليس عليك الانتظار. باستخدام التدفقات القابلة للاستئناف، ابدأ عملية إنشاء، وانتقل إلى محادثة أخرى، ثم عد إلى الاستجابة بعد اكتمالها.                                                                                                             |
| [شارك تحليلاً كرابط للقراءة فقط](https://www.librechat.ai/docs/features/shareable_links)        | شارك محادثة كرابط للقراءة فقط حتى يتمكن الآخرون من مراجعة تحليل من دون إعادة تشغيله. ويتضمن العرض المشترك استدعاءات الأدوات وSQL وراء كل إجابة، مما يوفّر سلسلة تتبع واضحة لكيفية إنتاج النتيجة.                                                                                |
| [تحكم في الوصول إلى خوادم MCP](https://www.librechat.ai/docs/features/access_control)           | في بيئة نشر خاصة بفريق، يحدّد التحكم في الوصول المستند إلى الأدوار من يمكنه استخدام خوادم MCP والوكلاء وإنشاءها ومشاركتها، وعلى أي مستوى (Viewer أو Editor أو Owner).                                                                                                           |

<div id="in-the-stack">
  ## ضمن المكدس
</div>

يكون LibreChat مُعدًّا مسبقًا عبر `librechat.yaml`، لذا يعمل مباشرةً:

* يُسجَّل [ClickHouse خادم MCP](/ar/products/agentic-data-stack/components/mcp-server) كمصدر للأدوات، بحيث يمكن للوكيل استكشاف ClickHouse وتنفيذ استعلامات عليه دون أي إعداد إضافي.
* يُجرى تتبّع كل محادثة إلى [Langfuse](/ar/products/agentic-data-stack/components/langfuse) لأغراض observability، مع التقاط المطالبات، واستدعاءات الأدوات، والاستجابات، والتكلفة، وزمن الاستجابة.
* تُعد [Admin Panel](https://github.com/ClickHouse/librechat-admin-panel) (المنفذ 3081) واجهة مستخدم قائمة على المتصفح لتغيير هذا الإعداد (endpoints، وخوادم MCP، وإعدادات الوكيل) دون الحاجة إلى تحرير `librechat.yaml` يدويًا.

لتوصيل ClickHouse خادم MCP بمثيل LibreChat مستقل، راجع الدليل المعتمد: [Using ClickHouse MCP server with LibreChat](/ar/core/guides/use-cases/ai-ml/MCP/librechat). وللاطلاع على التوثيق الكامل لميزات LibreChat، راجع [وثائق LibreChat](https://www.librechat.ai/docs).

<Info>
  **هل تفضّل تجربة مُدارة؟** يوفّر ClickHouse Cloud [ClickHouse Agents](/ar/products/cloud/features/ai-ml/agents) (Beta) — تجربة وكلاء مستضافة لا تتطلب إعدادًا، ومبنية على الأساس نفسه، مع إتاحة ميزات إنشاء الوكلاء عبر وحدة تحكم Cloud.
</Info>