> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-trino-dialect.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# ClickHouse Assistant dans ClickHouse Cloud
> Découvrir, activer et utiliser ClickHouse Assistant dans la Console ClickHouse Cloud
export const Image = ({img, alt, size = "lg", background}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
const backgroundColor = background === "white" ? "white" : background === "black" ? "rgb(31 31 28)" : undefined;
return
;
};
ClickHouse Assistant vous permet d’utiliser le langage naturel pour analyser les données d’un service ClickHouse Cloud. Il peut générer des requêtes, des visualisations et des résumés en s’appuyant sur le contexte, tel que les onglets actifs, les requêtes enregistrées, les schémas et les tableaux de bord.
L’Assistant inclut également un mode Docs AI pour poser des questions fondées sur la documentation ClickHouse. Utilisez ce guide pour activer l’Assistant et utiliser les deux modes dans la Console ClickHouse Cloud.
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).
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 ⌘ + ' (macOS) ou Ctrl + ' (Linux/Windows) pour l’ouvrir ou le fermer.
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.
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.
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 le traitement par le modèle, vous pouvez cliquer sur « Stop » pour interrompre l’opération.
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.
Cliquez sur le bouton « New Chat » pour effacer le contexte et démarrer une nouvelle session.
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.
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.
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.
| Action | Raccourci |
| ------------------ | -------------------- |
| Ouvrir AI Chat | `⌘ + '` / `Ctrl + '` |
| Envoyer un message | `Enter` |
| Nouvelle ligne | `Shift + Enter` |