> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-trino-dialect.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# ClickHouse Assistant في ClickHouse Cloud
> تعرّف على ClickHouse Assistant، ومكّنه واستخدمه في ClickHouse Cloud console
export const Image = ({img, alt, size = "lg", background}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
const backgroundColor = background === "white" ? "white" : background === "black" ? "rgb(31 31 28)" : undefined;
return
;
};
يتيح لك ClickHouse Assistant استخدام اللغة الطبيعية لتحليل البيانات في خدمة ClickHouse Cloud. ويمكنه إنشاء استعلامات وتصورات وملخصات باستخدام سياق مثل علامات التبويب النشطة والاستعلامات المحفوظة والمخططات ولوحات المعلومات.
يتضمن Assistant أيضًا وضع Docs AI لطرح أسئلة تستند إلى وثائق ClickHouse. استخدم هذا الدليل لتمكين Assistant والعمل مع كلا الوضعين في وحدة تحكم ClickHouse Cloud.
1. يجب أن تكون لديك صلاحية الوصول إلى organization في ClickHouse Cloud مع تمكين ميزات AI (تواصل مع مسؤول org أو فريق الدعم إذا لم تكن الميزة متاحة).
1. انتقل إلى خدمة ClickHouse Cloud.
2. في الشريط الجانبي الأيسر، انقر على أيقونة اللمعان المسمّاة “ClickHouse Assistant”.
3. (اختصار) اضغط ⌘ + ' (macOS) أو Ctrl + ' (Linux/Windows) لفتح اللوحة أو إغلاقها.
1. عند الاستخدام لأول مرة، سيظهر لك مربع حوار للموافقة يوضح كيفية التعامل مع البيانات والمعالِجات الفرعية الخارجية الخاصة بـ LLM.
2. راجعه ووافق عليه للمتابعة. إذا رفضت، فلن تفتح اللوحة.
يدعم AI Chat حاليًا:
* **Agent**: استدلال متعدد الخطوات على مخطط وmetadata (يجب أن تكون خدمة نشطة).
* **Docs AI (Ask)**: أسئلة وأجوبة مركّزة تستند إلى وثائق ClickHouse الرسمية ومراجع أفضل الممارسات.
استخدم محدد الوضع في أسفل يسار اللوحة الجانبية للتبديل بين الأوضاع.
1. اكتب سؤالك (مثلًا: “Create a materialized view to aggregate daily events by user”).
2. اضغط Enter للإرسال (استخدم Shift + Enter للانتقال إلى سطر جديد).
3. أثناء processing لدى model، يمكنك النقر على “Stop” للمقاطعة.
في وضع Agent، قد تظهر لك خطوات وسيطة قابلة للتوسيع خاصة بـ “thinking” أو التخطيط. توفّر هذه الخطوات شفافية حول كيفية صياغة المساعد لإجابته. قم بطيّها أو توسيعها حسب الحاجة.
انقر على زر “New Chat” لمسح Context وبدء session جديدة.
1. يسرد القسم السفلي دردشاتك الأخيرة.
2. اختر دردشة سابقة لتحميل رسائلها.
3. احذف conversation باستخدام أيقونة سلة المهملات.
عندما يعرض المساعد SQL:
* راجعه للتأكد من صحته.
* انقر على “Open in editor” لتحميل query في tab SQL جديدة.
* عدّله ونفّذه داخل Console.
إذا كانت response تستغرق وقتًا طويلًا أو تنحرف عن المطلوب:
1. انقر على زر “Stop” (يكون ظاهرًا أثناء processing).
2. ستُعلَّم الرسالة على أنها مقاطَعة؛ ويمكنك تحسين prompt ثم إعادة الإرسال.
| الإجراء | الاختصار |
| ----------- | -------------------- |
| فتح AI Chat | `⌘ + '` / `Ctrl + '` |
| إرسال رسالة | `Enter` |
| سطر جديد | `Shift + Enter` |