Ce guide explique comment activer et utiliser la fonctionnalité AI Chat dans la Console ClickHouse Cloud.
1
Prérequis
- 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).
2
Ouvrir le panneau AI Chat
- Accédez à un service ClickHouse Cloud.
- Dans la barre latérale gauche, cliquez sur l’icône en forme d’étincelle libellée « ClickHouse Assistant ».
- (Raccourci) Appuyez sur ⌘ + ’ (macOS) ou Ctrl + ’ (Linux/Windows) pour l’ouvrir ou le fermer.
3
Accepter le consentement d’utilisation des données (première utilisation)
- 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.
- Prenez-en connaissance et acceptez pour continuer. Si vous refusez, le panneau ne s’ouvrira pas.
4
Choisir un mode de chat
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.
5
Rédiger et envoyer un message
- Saisissez votre question (par ex. « Create a materialized view to aggregate daily events by user »).
- Appuyez sur Enter pour envoyer (utilisez Shift + Enter pour insérer un retour à la ligne).
- Pendant le traitement par le modèle, vous pouvez cliquer sur « Stop » pour interrompre l’opération.
6
Comprendre les étapes de réflexion d’« Agent »
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.
7
Démarrer de nouvelles discussions
Cliquez sur le bouton « New Chat » pour effacer le contexte et démarrer une nouvelle session.
8
Afficher l’historique des discussions
- La section inférieure affiche vos discussions récentes.
- Sélectionnez une discussion précédente pour recharger ses messages.
- Supprimez une conversation à l’aide de l’icône de corbeille.
9
Travailler avec le SQL généré
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.
10
Arrêter ou interrompre une réponse
Si une réponse prend trop de temps ou s’écarte du sujet :
- Cliquez sur le bouton « Stop » (visible pendant le traitement).
- Le message est marqué comme interrompu ; vous pouvez affiner votre prompt et le renvoyer.
11
Raccourcis clavier