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

# استخدام دردشة ClickHouse Assistant في 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 title="المتطلبات المسبقة" id="prerequisites">
    1. يجب أن تكون لديك صلاحية الوصول إلى organization في ClickHouse Cloud مع تمكين ميزات AI (تواصل مع مسؤول org أو فريق الدعم إذا لم تكن الميزة متاحة).
  </Step>

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

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

  <Step title="قبول الموافقة على استخدام البيانات (عند أول تشغيل)" id="consent">
    1. عند الاستخدام لأول مرة، سيظهر لك مربع حوار للموافقة يوضح كيفية التعامل مع البيانات والمعالِجات الفرعية الخارجية الخاصة بـ LLM.
    2. راجعه ووافق عليه للمتابعة. إذا رفضت، فلن تفتح اللوحة.

    <Image img="https://mintcdn.com/private-7c7dfe99-vortex-format/mc_CXbtYxT_GqYxL/images/use-cases/AI_ML/AIChat/2_consent.webp?fit=max&auto=format&n=mc_CXbtYxT_GqYxL&q=85&s=19c9d953b5028f861ae2556c36c622f3" alt="مربع حوار الموافقة" size="md" width="1342" height="922" data-path="images/use-cases/AI_ML/AIChat/2_consent.webp" />
  </Step>

  <Step title="اختيار وضع الدردشة" id="modes">
    يدعم AI Chat حاليًا:

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

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

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

  <Step title="كتابة رسالة وإرسالها" id="compose">
    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” للمقاطعة.
  </Step>

  <Step title="فهم خطوات Thinking في “Agent”" id="thinking-steps">
    في وضع Agent، قد تظهر لك خطوات وسيطة قابلة للتوسيع خاصة بـ “thinking” أو التخطيط. توفّر هذه الخطوات شفافية حول كيفية صياغة المساعد لإجابته. قم بطيّها أو توسيعها حسب الحاجة.

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

  <Step title="بدء دردشات جديدة" id="new-chats">
    انقر على زر “New Chat” لمسح Context وبدء session جديدة.
  </Step>

  <Step title="عرض history الدردشة" id="history">
    1. يسرد القسم السفلي دردشاتك الأخيرة.
    2. اختر دردشة سابقة لتحميل رسائلها.
    3. احذف conversation باستخدام أيقونة سلة المهملات.

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

  <Step title="العمل مع generated SQL" id="sql-actions">
    عندما يعرض المساعد SQL:

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

    <Image img="https://mintcdn.com/private-7c7dfe99-vortex-format/mc_CXbtYxT_GqYxL/images/use-cases/AI_ML/AIChat/6_result_actions.webp?fit=max&auto=format&n=mc_CXbtYxT_GqYxL&q=85&s=b956ee8f6bc682bf9520d0c974affbe1" 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-vortex-format/mc_CXbtYxT_GqYxL/images/use-cases/AI_ML/AIChat/7_open_in_editor.webp?fit=max&auto=format&n=mc_CXbtYxT_GqYxL&q=85&s=95dcdb18741d3e8921b23f90d97088fa" alt="فتح query المُنشأ في المحرر" size="md" width="1662" height="284" data-path="images/use-cases/AI_ML/AIChat/7_open_in_editor.webp" />
  </Step>

  <Step title="إيقاف response أو مقاطعته" id="interrupt">
    إذا كانت response تستغرق وقتًا طويلًا أو تنحرف عن المطلوب:

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

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