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 organisation 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 intitulée « ClickHouse Assistant ».
- (Raccourci) Appuyez sur ⌘ + ’ (macOS) ou Ctrl + ’ (Linux/Windows) pour l’ouvrir ou le fermer.
3
Accepter le consentement relatif à l’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 et les sous-traitants LLM tiers.
- Vérifiez ces informations et acceptez pour continuer. Si vous refusez, le panneau ne s’ouvrira pas.
4
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.
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 que le modèle traite la demande, vous pouvez cliquer sur « Stop » pour l’interrompre.
6
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.7
Démarrer de nouvelles discussions
Cliquez sur le bouton « New Chat » pour réinitialiser le contexte et démarrer une nouvelle session.8
Afficher l’historique des discussions
- La section inférieure répertorie vos discussions récentes.
- Sélectionnez une discussion précédente pour charger 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 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.
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