> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-detect-table-modification.mintlify.site/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.
## 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).
## 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.
## 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.
## 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.
## 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.
## 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.
## Iniciar novos chats
Clique no botão “New Chat” para limpar o contexto e iniciar uma nova sessão.
## 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.
## 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.
## 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.
## Atalhos de teclado
| Ação | Atalho |
| --------------- | -------------------- |
| Abrir AI Chat | `⌘ + '` / `Ctrl + '` |
| Enviar mensagem | `Enter` |
| Nova linha | `Shift + Enter` |