يشرح هذا الدليل كيفية تمكين ميزة AI Chat واستخدامها في ClickHouse Cloud Console.
1
المتطلبات الأساسية
- يجب أن تكون لديك صلاحية الوصول إلى organization في ClickHouse Cloud مع تمكين ميزات الذكاء الاصطناعي (تواصل مع مسؤول org أو فريق الدعم إذا لم تكن متاحة).
2
افتح لوحة AI Chat
- انتقل إلى خدمة ClickHouse Cloud.
- في الشريط الجانبي الأيسر، انقر على أيقونة الوميض المسمّاة “ClickHouse Assistant”.
- (اختصار) اضغط ⌘ + ’ (macOS) أو Ctrl + ’ (Linux/Windows) للتبديل إلى الفتح.
3
قبول الموافقة على استخدام البيانات (عند أول تشغيل)
- عند الاستخدام الأول، ستظهر لك نافذة موافقة توضّح كيفية التعامل مع البيانات والمعالِجات الفرعية التابعة لجهات خارجية الخاصة بنماذج LLM.
- راجعها ثم وافق عليها للمتابعة. إذا رفضت، فلن تُفتح اللوحة.
4
اختر وضع الدردشة
يدعم AI Chat حاليًا ما يلي:- Agent: استدلال متعدد الخطوات على مستوى schema وmetadata (يجب أن تكون الخدمة نشطة).
- Docs AI (Ask): أسئلة وأجوبة مركزة تستند إلى وثائق ClickHouse الرسمية ومراجع أفضل الممارسات.
5
اكتب رسالة وأرسلها
- اكتب سؤالك (مثل: “أنشئ materialized view لتجميع الأحداث اليومية حسب المستخدم”).
- اضغط Enter للإرسال (استخدم Shift + Enter لإضافة سطر جديد).
- أثناء معالجة model، يمكنك النقر على “Stop” للمقاطعة.
6
فهم خطوات Thinking في “Agent”
في وضع Agent، قد ترى خطوات وسيطة قابلة للتوسيع لـ “Thinking” أو التخطيط. توفّر هذه الخطوات شفافية حول كيفية صياغة المساعد لإجابته. اطوِها أو وسّعها حسب الحاجة.7
بدء دردشات جديدة
انقر على زر “New Chat” لمسح Context وبدء session جديدة.8
عرض history الدردشة
- يعرض القسم السفلي دردشاتك الأخيرة.
- حدّد دردشة سابقة لتحميل رسائلها.
- احذف conversation باستخدام أيقونة سلة المهملات.
9
العمل مع generated SQL
عندما يعرض المساعد SQL:- راجعه للتأكد من صحته.
- انقر على “Open in editor” لتحميل query في SQL tab جديدة.
- عدّله ونفّذه داخل Console.
10
إيقاف response أو مقاطعتها
إذا كانت response تستغرق وقتًا طويلًا أو تنحرف عن المطلوب:- انقر على زر “Stop” (يكون مرئيًا أثناء processing).
- تُعلَّم الرسالة على أنها متوقفة؛ ويمكنك تحسين prompt ثم إعادة الإرسال.
11