> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Assistant في ClickHouse Cloud

> تعرّف على Assistant، ومكّنه واستخدمه في ClickHouse Cloud console

يتيح لك Assistant استخدام اللغة الطبيعية لتحليل البيانات في خدمة ClickHouse Cloud. ويمكنه إنشاء استعلامات وتصورات وملخصات باستخدام سياق مثل علامات التبويب النشطة والاستعلامات المحفوظة والمخططات ولوحات المعلومات.

يتضمن Assistant أيضًا وضع Docs AI لطرح أسئلة تستند إلى وثائق ClickHouse. استخدم هذا الدليل لتمكين Assistant والعمل مع كلا الوضعين في وحدة تحكم ClickHouse Cloud.

**1. المتطلبات المسبقة**

1. يجب أن تكون لديك صلاحية الوصول إلى organization في ClickHouse Cloud مع تمكين ميزات AI (تواصل مع مسؤول org أو فريق الدعم إذا لم تكن الميزة متاحة).

**2. فتح لوحة AI Chat**

1. انتقل إلى خدمة ClickHouse Cloud.
2. في الشريط الجانبي الأيسر، انقر على أيقونة اللمعان المسمّاة “Assistant”.
3. (اختصار) اضغط <kbd>⌘</kbd> + <kbd>'</kbd> (macOS) أو <kbd>Ctrl</kbd> + <kbd>'</kbd> (Linux/Windows) لفتح اللوحة أو إغلاقها.

![فتح لوحة AI Chat الجانبية](https://mintcdn.com/private-7c7dfe99/RMrV3JZHbEy3aFh9/images/use-cases/AI_ML/AIChat/1_open_chat.webp?fit=max\&auto=format\&n=RMrV3JZHbEy3aFh9\&q=85\&s=ad98d16b98abcc8875a9fef907045155)

**3. قبول الموافقة على استخدام البيانات (عند أول تشغيل)**

1. عند الاستخدام لأول مرة، سيظهر لك مربع حوار للموافقة يوضح كيفية التعامل مع البيانات والمعالِجات الفرعية الخارجية الخاصة بـ LLM.
2. راجعه ووافق عليه للمتابعة. إذا رفضت، فلن تفتح اللوحة.

![مربع حوار الموافقة](https://mintcdn.com/private-7c7dfe99/RMrV3JZHbEy3aFh9/images/use-cases/AI_ML/AIChat/2_consent.webp?fit=max\&auto=format\&n=RMrV3JZHbEy3aFh9\&q=85\&s=ff56a1b3e6b5407ff95c4e1e89df7b9a)

**4. اختيار وضع الدردشة**

يدعم AI Chat حاليًا:

* **Agent**: استدلال متعدد الخطوات على مخطط وmetadata (يجب أن تكون خدمة نشطة).
* **Docs AI (Ask)**: أسئلة وأجوبة مركّزة تستند إلى وثائق ClickHouse الرسمية ومراجع أفضل الممارسات.

استخدم محدد الوضع في أسفل يسار اللوحة الجانبية للتبديل بين الأوضاع.

![اختيار الوضع](https://mintcdn.com/private-7c7dfe99/RMrV3JZHbEy3aFh9/images/use-cases/AI_ML/AIChat/3_modes.webp?fit=max\&auto=format\&n=RMrV3JZHbEy3aFh9\&q=85\&s=e695326686cbf96050905e3f1eb42a1e)

**5. كتابة رسالة وإرسالها**

1. اكتب سؤالك (مثلًا: “Create a materialized view to aggregate daily events by user”).
2. اضغط <kbd>Enter</kbd> للإرسال (استخدم <kbd>Shift</kbd> + <kbd>Enter</kbd> للانتقال إلى سطر جديد).
3. أثناء processing لدى model، يمكنك النقر على “Stop” للمقاطعة.

**6. فهم خطوات Thinking في “Agent”**

في وضع Agent، قد تظهر لك خطوات وسيطة قابلة للتوسيع خاصة بـ “thinking” أو التخطيط. توفّر هذه الخطوات شفافية حول كيفية صياغة المساعد لإجابته. قم بطيّها أو توسيعها حسب الحاجة.

![خطوات Thinking](https://mintcdn.com/private-7c7dfe99/RMrV3JZHbEy3aFh9/images/use-cases/AI_ML/AIChat/4_thinking.webp?fit=max\&auto=format\&n=RMrV3JZHbEy3aFh9\&q=85\&s=23a1a324e86591f69328228de6c7c08d)

**7. بدء دردشات جديدة**

انقر على زر “New Chat” لمسح Context وبدء session جديدة.

**8. عرض history الدردشة**

1. يسرد القسم السفلي دردشاتك الأخيرة.
2. اختر دردشة سابقة لتحميل رسائلها.
3. احذف conversation باستخدام أيقونة سلة المهملات.

![قائمة history الدردشة](https://mintcdn.com/private-7c7dfe99/RMrV3JZHbEy3aFh9/images/use-cases/AI_ML/AIChat/5_history.webp?fit=max\&auto=format\&n=RMrV3JZHbEy3aFh9\&q=85\&s=9b3c8d9265e906889c3ddd18d6d29485)

**9. العمل مع generated SQL**

عندما يعرض المساعد SQL:

* راجعه للتأكد من صحته.
* انقر على “Open in editor” لتحميل query في tab SQL جديدة.
* عدّله ونفّذه داخل Console.

![إجراءات النتائج](https://mintcdn.com/private-7c7dfe99/RMrV3JZHbEy3aFh9/images/use-cases/AI_ML/AIChat/6_result_actions.webp?fit=max\&auto=format\&n=RMrV3JZHbEy3aFh9\&q=85\&s=1ca9b4c9c987b0dc3fd2c7b0c6d205c6)

![فتح query المُنشأ في المحرر](https://mintcdn.com/private-7c7dfe99/RMrV3JZHbEy3aFh9/images/use-cases/AI_ML/AIChat/7_open_in_editor.webp?fit=max\&auto=format\&n=RMrV3JZHbEy3aFh9\&q=85\&s=148eb60e6217aeea2c091ed40fc5e364)

**10. إيقاف response أو مقاطعته**

إذا كانت response تستغرق وقتًا طويلًا أو تنحرف عن المطلوب:

1. انقر على زر “Stop” (يكون ظاهرًا أثناء processing).
2. ستُعلَّم الرسالة على أنها مقاطَعة؛ ويمكنك تحسين prompt ثم إعادة الإرسال.

**11. اختصارات لوحة المفاتيح**

| الإجراء | الاختصار |
| - | - |
| فتح AI Chat | `⌘ + '` / `Ctrl + '` |
| إرسال رسالة | `Enter` |
| سطر جديد | `Shift + Enter` |
