Este guia explica como habilitar e usar o recurso AI Chat no ClickHouse Cloud Console.
1
Pré-requisitos
- Você deve ter acesso a uma organização do ClickHouse Cloud com recursos de IA habilitados (entre em contato com o administrador da sua organização ou com o suporte caso eles não estejam disponíveis).
2
Abrir o painel do AI Chat
- Acesse um serviço do ClickHouse Cloud.
- Na barra lateral esquerda, clique no ícone de brilho com o rótulo “ClickHouse Assistant”.
- (Atalho) Pressione ⌘ + ’ (macOS) ou Ctrl + ’ (Linux/Windows) para abrir ou fechar o painel.
3
Aceitar o consentimento de uso de dados (primeiro uso)
- No primeiro uso, é exibida uma caixa de diálogo de consentimento descrevendo o tratamento de dados e os subprocessadores de LLM de terceiros.
- Revise e aceite para continuar. Se recusar, o painel não será aberto.
4
Escolher um modo de chat
Atualmente, o AI Chat oferece suporte a:
- Agent: Raciocínio em várias etapas sobre esquema + metadados (o serviço deve estar ativo).
- Docs AI (Ask): Perguntas e respostas focadas, fundamentadas na documentação oficial do ClickHouse e em referências de boas práticas.
5
Escrever e enviar uma mensagem
- Digite sua pergunta (por exemplo, “Crie uma visão materializada para agregar eventos diários por usuário”).
- Pressione Enter para enviar (use Shift + Enter para inserir uma nova linha).
- Enquanto o modelo estiver processando, você pode clicar em “Stop” para interromper.
6
Entender as etapas de thinking do “Agent”
No modo Agent, você pode ver etapas intermediárias expansíveis de “thinking” ou planejamento. Elas dão transparência sobre como o assistente formula a resposta. Recolha ou expanda conforme necessário.
7
Iniciar novos chats
Clique no botão “New Chat” para limpar o contexto e iniciar uma nova sessão.
8
Ver o histórico de chats
- A seção inferior lista seus chats recentes.
- Selecione um chat anterior para carregar as mensagens.
- Exclua uma conversa usando o ícone de lixeira.
9
Trabalhar com SQL gerado
Quando o assistente retornar SQL:
- Revise para verificar se está correto.
- Clique em “Open in editor” para carregar a consulta em uma nova aba SQL.
- Modifique e execute no Console.
10
Parar ou interromper uma resposta
Se uma resposta estiver demorando demais ou saindo do foco:
- Clique no botão “Stop” (visível durante o processamento).
- A mensagem será marcada como interrompida; você poderá ajustar o prompt e enviar novamente.
11
Atalhos de teclado