> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Use o chat do ClickHouse Assistant no ClickHouse Cloud
> Guia para ativar e usar o recurso AI Chat no console do ClickHouse Cloud
export const Image = ({img, alt, size = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return
;
};
> Este guia explica como habilitar e usar o recurso AI Chat no ClickHouse Cloud Console.
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).
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.
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 continuar. Se recusar, o painel não será aberto.
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.
Use o seletor de modo no canto inferior esquerdo do flyout para alternar entre eles.
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.
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.
Clique no botão “New Chat” para limpar o contexto e iniciar uma nova sessão.
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.
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.
Se uma resposta estiver demorando demais ou saindo do foco:
1. Clique no botão “Stop” (visível durante o processamento).
2. A mensagem será marcada como interrompida; você poderá ajustar o prompt e enviar novamente.
| Ação | Atalho |
| --------------- | -------------------- |
| Abrir AI Chat | `⌘ + '` / `Ctrl + '` |
| Enviar mensagem | `Enter` |
| Nova linha | `Shift + Enter` |