Skip to main content
Este guia explica como habilitar e usar o recurso AI Chat no ClickHouse Cloud Console.
1

​
Pré-requisitos

  1. 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

​
Abra o painel do AI Chat

  1. Acesse um serviço do ClickHouse Cloud.
  2. Na barra lateral esquerda, clique no ícone de brilho com o rótulo “ClickHouse Assistant”.
  3. (Atalho) Pressione ⌘ + ’ (macOS) ou Ctrl + ’ (Linux/Windows) para abrir ou fechar o painel.
3

​
Aceite o consentimento de uso de dados (primeiro uso)

  1. No primeiro uso, é exibida uma caixa de diálogo de consentimento descrevendo o tratamento de dados e os subprocessadores de LLM de terceiros.
  2. Revise e aceite para prosseguir. Se você recusar, o painel não será aberto.
4

​
Escolha um modo de chat

Atualmente, o AI Chat oferece suporte a:
  • Agent: Raciocínio em várias etapas com base em schema + 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.
Use o seletor de modo no canto inferior esquerdo do flyout para alternar.
5

​
Escreva e envie uma mensagem

  1. Digite sua pergunta (por exemplo, “Crie uma visão materializada para agregar eventos diários por usuário”).
  2. Pressione Enter para enviar (use Shift + Enter para inserir uma nova linha).
  3. Enquanto o modelo estiver processando, você pode clicar em “Stop” para interromper.
6

​
Entendendo 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

​
Visualizar o histórico de chats

  1. A seção inferior lista seus chats recentes.
  2. Selecione um chat anterior para carregar as mensagens.
  3. 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 rumo:
  1. Clique no botão “Stop” (visível durante o processamento).
  2. A mensagem é marcada como interrompida; você pode refinar seu prompt e reenviar.
11

​
Atalhos de teclado

Última modificação em 3 de julho de 2026