> ## 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.
# Utiliser le chat de ClickHouse Assistant dans ClickHouse Cloud
> Guide d’activation et d’utilisation de 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
;
};
> Ce guide explique comment activer et utiliser la fonctionnalité AI Chat dans la Console ClickHouse Cloud.
## Prérequis
1. Vous devez avoir accès à une organisation ClickHouse Cloud avec les fonctionnalités d’IA activées (contactez l’administrateur de votre organisation ou le support si elles ne sont pas disponibles).
## Ouvrir le panneau AI Chat
1. Accédez à un service ClickHouse Cloud.
2. Dans la barre latérale gauche, cliquez sur l’icône en forme d’étincelle intitulée « ClickHouse Assistant ».
3. (Raccourci) Appuyez sur ⌘ + ' (macOS) ou Ctrl + ' (Linux/Windows) pour l’ouvrir ou le fermer.
## Accepter le consentement relatif à l’utilisation des données (première utilisation)
1. Lors de la première utilisation, une boîte de dialogue de consentement s’affiche pour décrire le traitement des données et les sous-traitants LLM tiers.
2. Vérifiez ces informations et acceptez pour continuer. Si vous refusez, le panneau ne s’ouvrira pas.
## Choisir un mode de discussion
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 panneau pour changer de mode.
## Rédiger et envoyer un message
1. Saisissez votre question (par ex. « Create a materialized view to aggregate daily events by user »).
2. Appuyez sur Enter pour envoyer (utilisez Shift + Enter pour insérer un retour à la ligne).
3. Pendant que le modèle traite la demande, vous pouvez cliquer sur « Stop » pour l’interrompre.
## Comprendre les étapes de réflexion « Agent »
En mode Agent, vous pouvez voir des étapes intermédiaires de « réflexion » ou de planification, que vous pouvez développer. Elles offrent plus de transparence sur la manière dont l’assistant construit sa réponse. Réduisez-les ou développez-les selon vos besoins.
## Démarrer de nouvelles discussions
Cliquez sur le bouton « New Chat » pour réinitialiser le contexte et démarrer une nouvelle session.
## Afficher l’historique des discussions
1. La section inférieure répertorie vos discussions récentes.
2. Sélectionnez une discussion précédente pour charger ses messages.
3. Supprimez une conversation à l’aide de l’icône de corbeille.
## Travailler avec le SQL généré
Lorsque l’assistant renvoie du SQL :
* Vérifiez son exactitude.
* Cliquez sur « Open in editor » pour charger la requête dans un nouvel onglet SQL.
* Modifiez-la et exécutez-la dans la Console.
## Arrêter ou interrompre une réponse
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.
## Raccourcis clavier
| Action | Raccourci |
| ------------------ | -------------------- |
| Ouvrir AI Chat | `⌘ + '` / `Ctrl + '` |
| Envoyer le message | `Enter` |
| Nouvelle ligne | `Shift + Enter` |