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

# Assistant no ClickHouse Cloud

> Saiba mais sobre como habilitar e usar o Assistant no console do ClickHouse Cloud

O Assistant permite usar linguagem natural para analisar dados em um serviço do ClickHouse Cloud. Ele pode gerar consultas, visualizações e resumos usando contextos como abas ativas, consultas salvas, esquemas e painéis.

O Assistant também inclui um modo Docs AI para fazer perguntas fundamentadas na documentação do ClickHouse. Use este guia para habilitar o Assistant e trabalhar com ambos os modos no console do ClickHouse Cloud.

**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. Abrir 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 “Assistant”.
3. (Atalho) Pressione <kbd>⌘</kbd> + <kbd>'</kbd> (macOS) ou <kbd>Ctrl</kbd> + <kbd>'</kbd> (Linux/Windows) para abrir ou fechar o painel.

![Abrir o flyout do AI Chat](https://mintcdn.com/private-7c7dfe99/RMrV3JZHbEy3aFh9/images/use-cases/AI_ML/AIChat/1_open_chat.webp?fit=max\&auto=format\&n=RMrV3JZHbEy3aFh9\&q=85\&s=ad98d16b98abcc8875a9fef907045155)

**3. Aceitar 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 continuar. Se recusar, o painel não será aberto.

![Caixa de diálogo de consentimento](https://mintcdn.com/private-7c7dfe99/RMrV3JZHbEy3aFh9/images/use-cases/AI_ML/AIChat/2_consent.webp?fit=max\&auto=format\&n=RMrV3JZHbEy3aFh9\&q=85\&s=ff56a1b3e6b5407ff95c4e1e89df7b9a)

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

Use o seletor de modo no canto inferior esquerdo do flyout para alternar entre eles.

![Seleção de modo](https://mintcdn.com/private-7c7dfe99/RMrV3JZHbEy3aFh9/images/use-cases/AI_ML/AIChat/3_modes.webp?fit=max\&auto=format\&n=RMrV3JZHbEy3aFh9\&q=85\&s=e695326686cbf96050905e3f1eb42a1e)

**5. Escrever e enviar uma mensagem**

1. Digite sua pergunta (por exemplo, “Crie uma visão materializada para agregar eventos diários por usuário”).
2. Pressione <kbd>Enter</kbd> para enviar (use <kbd>Shift</kbd> + <kbd>Enter</kbd> para inserir uma nova linha).
3. 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.

![Etapas de thinking](https://mintcdn.com/private-7c7dfe99/RMrV3JZHbEy3aFh9/images/use-cases/AI_ML/AIChat/4_thinking.webp?fit=max\&auto=format\&n=RMrV3JZHbEy3aFh9\&q=85\&s=23a1a324e86591f69328228de6c7c08d)

**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**

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.

![Lista do histórico de chats](https://mintcdn.com/private-7c7dfe99/RMrV3JZHbEy3aFh9/images/use-cases/AI_ML/AIChat/5_history.webp?fit=max\&auto=format\&n=RMrV3JZHbEy3aFh9\&q=85\&s=9b3c8d9265e906889c3ddd18d6d29485)

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

![Ações de resultado](https://mintcdn.com/private-7c7dfe99/RMrV3JZHbEy3aFh9/images/use-cases/AI_ML/AIChat/6_result_actions.webp?fit=max\&auto=format\&n=RMrV3JZHbEy3aFh9\&q=85\&s=1ca9b4c9c987b0dc3fd2c7b0c6d205c6)

![Abrir consulta gerada no editor](https://mintcdn.com/private-7c7dfe99/RMrV3JZHbEy3aFh9/images/use-cases/AI_ML/AIChat/7_open_in_editor.webp?fit=max\&auto=format\&n=RMrV3JZHbEy3aFh9\&q=85\&s=148eb60e6217aeea2c091ed40fc5e364)

**10. Parar ou interromper uma resposta**

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.

**11. Atalhos de teclado**

| Ação | Atalho |
| - | - |
| Abrir AI Chat | `⌘ + '` / `Ctrl + '` |
| Enviar mensagem | `Enter` |
| Nova linha | `Shift + Enter` |
