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

# استخدام ClickHouse Assistant chat في ClickHouse Cloud

> دليل لتمكين ميزة AI Chat واستخدامها في ClickHouse Cloud Console

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

> يشرح هذا الدليل كيفية تمكين ميزة AI Chat واستخدامها في ClickHouse Cloud Console.

<Steps>
  <Step>
    ## المتطلبات الأساسية

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

  <Step>
    ## افتح لوحة AI Chat

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

    <Image img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/pp61YI9DMmfgXVsV/images/use-cases/AI_ML/AIChat/1_open_chat.webp?fit=max&auto=format&n=pp61YI9DMmfgXVsV&q=85&s=e6ca411fde8f85af29eca3344f32a12b" alt="فتح لوحة AI Chat الجانبية" size="md" width="1762" height="1364" data-path="images/use-cases/AI_ML/AIChat/1_open_chat.webp" />
  </Step>

  <Step>
    ## قبول الموافقة على استخدام البيانات (عند أول تشغيل)

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

    <Image img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/pp61YI9DMmfgXVsV/images/use-cases/AI_ML/AIChat/2_consent.webp?fit=max&auto=format&n=pp61YI9DMmfgXVsV&q=85&s=2c23641e5b4fe3f2d9074efde2ae33c0" alt="نافذة الموافقة" size="md" width="1342" height="922" data-path="images/use-cases/AI_ML/AIChat/2_consent.webp" />
  </Step>

  <Step>
    ## اختر وضع الدردشة

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

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

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

    <Image img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/pp61YI9DMmfgXVsV/images/use-cases/AI_ML/AIChat/3_modes.webp?fit=max&auto=format&n=pp61YI9DMmfgXVsV&q=85&s=485fa9c515b763c1d6adaa0b78fb6afa" alt="اختيار الوضع" size="sm" width="584" height="262" data-path="images/use-cases/AI_ML/AIChat/3_modes.webp" />
  </Step>

  <Step>
    ## اكتب رسالة وأرسلها

    1. اكتب سؤالك (مثل: “أنشئ materialized view لتجميع الأحداث اليومية حسب المستخدم”).
    2. اضغط <kbd>Enter</kbd> للإرسال (استخدم <kbd>Shift</kbd> + <kbd>Enter</kbd> لإضافة سطر جديد).
    3. أثناء معالجة model، يمكنك النقر على “Stop” للمقاطعة.
  </Step>

  <Step>
    ## فهم خطوات Thinking في “Agent”

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

    <Image img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/pp61YI9DMmfgXVsV/images/use-cases/AI_ML/AIChat/4_thinking.webp?fit=max&auto=format&n=pp61YI9DMmfgXVsV&q=85&s=a10b67c236ec7336d14db8856e3c93a5" alt="خطوات Thinking" size="md" width="1702" height="1180" data-path="images/use-cases/AI_ML/AIChat/4_thinking.webp" />
  </Step>

  <Step>
    ## بدء دردشات جديدة

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

  <Step>
    ## عرض history الدردشة

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

    <Image img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/pp61YI9DMmfgXVsV/images/use-cases/AI_ML/AIChat/5_history.webp?fit=max&auto=format&n=pp61YI9DMmfgXVsV&q=85&s=719ce94c7f0d417926a83123c6de2ede" alt="قائمة history الدردشة" size="md" width="1754" height="634" data-path="images/use-cases/AI_ML/AIChat/5_history.webp" />
  </Step>

  <Step>
    ## العمل مع generated SQL

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

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

    <Image img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/pp61YI9DMmfgXVsV/images/use-cases/AI_ML/AIChat/6_result_actions.webp?fit=max&auto=format&n=pp61YI9DMmfgXVsV&q=85&s=4447b965b50964525834b3e541558098" alt="إجراءات النتائج" size="md" width="1746" height="1362" data-path="images/use-cases/AI_ML/AIChat/6_result_actions.webp" />

    <Image img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/pp61YI9DMmfgXVsV/images/use-cases/AI_ML/AIChat/7_open_in_editor.webp?fit=max&auto=format&n=pp61YI9DMmfgXVsV&q=85&s=13ef1fc0eb3148a656d03af17c1a0131" alt="فتح query المُنشأة في المحرر" size="md" width="1662" height="284" data-path="images/use-cases/AI_ML/AIChat/7_open_in_editor.webp" />
  </Step>

  <Step>
    ## إيقاف response أو مقاطعتها

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

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

  <Step>
    ## اختصارات لوحة المفاتيح

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