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

# Utiliser le chat ClickHouse Assistant dans ClickHouse Cloud

> Guide pour activer et utiliser la fonctionnalité AI Chat dans 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>;
};

> Ce guide explique comment activer et utiliser la fonctionnalité AI Chat dans la Console ClickHouse Cloud.

<Steps>
  <Step title="Prérequis" id="prerequisites">
    1. Vous devez avoir accès à une organisation ClickHouse Cloud avec les fonctionnalités d’IA activées (contactez l’administrateur de votre org ou le support si elles ne sont pas disponibles).
  </Step>

  <Step title="Ouvrir le panneau AI Chat" id="open-panel">
    1. Accédez à un service ClickHouse Cloud.
    2. Dans la barre latérale gauche, cliquez sur l’icône en forme d’étincelle libellée « ClickHouse Assistant ».
    3. (Raccourci) Appuyez sur <kbd>⌘</kbd> + <kbd>'</kbd> (macOS) ou <kbd>Ctrl</kbd> + <kbd>'</kbd> (Linux/Windows) pour l’ouvrir ou le fermer.

    <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="Ouvrir le volet AI Chat" size="md" width="1762" height="1364" data-path="images/use-cases/AI_ML/AIChat/1_open_chat.webp" />
  </Step>

  <Step title="Accepter le consentement d’utilisation des données (première utilisation)" id="consent">
    1. Lors de la première utilisation, une boîte de dialogue de consentement s’affiche pour décrire le traitement des données ainsi que les sous-traitants tiers des LLM.
    2. Prenez-en connaissance et acceptez pour continuer. Si vous refusez, le panneau ne s’ouvrira pas.

    <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="Boîte de dialogue de consentement" size="md" width="1342" height="922" data-path="images/use-cases/AI_ML/AIChat/2_consent.webp" />
  </Step>

  <Step title="Choisir un mode de chat" id="modes">
    AI Chat prend actuellement en charge :

    * **Agent** : raisonnement en plusieurs étapes sur le schéma et les métadonnées (le service doit être actif).
    * **Docs AI (Ask)** : questions-réponses ciblées, fondées sur la documentation officielle de ClickHouse et les références de bonnes pratiques.

    Utilisez le sélecteur de mode en bas à gauche du volet pour changer de mode.

    <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="Sélection du mode" size="sm" width="584" height="262" data-path="images/use-cases/AI_ML/AIChat/3_modes.webp" />
  </Step>

  <Step title="Rédiger et envoyer un message" id="compose">
    1. Saisissez votre question (par ex. « Create a materialized view to aggregate daily events by user »).
    2. Appuyez sur <kbd>Enter</kbd> pour envoyer (utilisez <kbd>Shift</kbd> + <kbd>Enter</kbd> pour insérer un retour à la ligne).
    3. Pendant le traitement par le modèle, vous pouvez cliquer sur « Stop » pour interrompre l’opération.
  </Step>

  <Step title="Comprendre les étapes de réflexion d’« Agent »" id="thinking-steps">
    En mode Agent, des étapes intermédiaires extensibles de « réflexion » ou de planification peuvent s’afficher. Elles apportent de la transparence sur la façon dont l’assistant élabore sa réponse. Réduisez-les ou développez-les selon vos besoins.

    <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="Étapes de réflexion" size="md" width="1702" height="1180" data-path="images/use-cases/AI_ML/AIChat/4_thinking.webp" />
  </Step>

  <Step title="Démarrer de nouvelles discussions" id="new-chats">
    Cliquez sur le bouton « New Chat » pour effacer le contexte et démarrer une nouvelle session.
  </Step>

  <Step title="Afficher l’historique des discussions" id="history">
    1. La section inférieure affiche vos discussions récentes.
    2. Sélectionnez une discussion précédente pour recharger ses messages.
    3. Supprimez une conversation à l’aide de l’icône de corbeille.

    <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="Liste de l’historique des discussions" size="md" width="1754" height="634" data-path="images/use-cases/AI_ML/AIChat/5_history.webp" />
  </Step>

  <Step title="Travailler avec le SQL généré" id="sql-actions">
    Lorsque l’assistant renvoie du SQL :

    * Vérifiez qu’il est correct.
    * Cliquez sur « Open in editor » pour charger la requête dans un nouvel onglet SQL.
    * Modifiez-la et exécutez-la dans la 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="Actions sur le résultat" 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="Ouvrir la requête générée dans l’éditeur" size="md" width="1662" height="284" data-path="images/use-cases/AI_ML/AIChat/7_open_in_editor.webp" />
  </Step>

  <Step title="Arrêter ou interrompre une réponse" id="interrupt">
    Si une réponse prend trop de temps ou s’écarte du sujet :

    1. Cliquez sur le bouton « Stop » (visible pendant le traitement).
    2. Le message est marqué comme interrompu ; vous pouvez affiner votre prompt et le renvoyer.
  </Step>

  <Step title="Raccourcis clavier" id="shortcuts">
    | Action             | Raccourci            |
    | ------------------ | -------------------- |
    | Ouvrir AI Chat     | `⌘ + '` / `Ctrl + '` |
    | Envoyer un message | `Enter`              |
    | Nouvelle ligne     | `Shift + Enter`      |
  </Step>
</Steps>