> ## 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.

# استخدام دردشة 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/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/AIChat/1_open_chat.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=99adfce6ae6ec1ea4e895688ebcb96f2" 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/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/AIChat/2_consent.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=54010396eff18df4fe545f4ad70f7b57" 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/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/AIChat/3_modes.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=39a7ccc19b995812b0ad6115ccd8fa46" 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/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/AIChat/4_thinking.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=0df1ca2235dcec9f8d0f49fa6271a892" 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/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/AIChat/5_history.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=dea90fb7824b49a2fb5b6af0f71fa987" 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/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/AIChat/6_result_actions.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=409c86a0ec90d48221a6dfdffcb7945f" 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/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/AIChat/7_open_in_editor.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=ff40fb5f4aea3697dda1db999622d341" 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>