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

# Chat

> Conversas, favoritos, conversas fixadas, fork, atalhos de teclado e compartilhamento de chats no ClickHouse Agents

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
  if (link) {
    return <a href={link} target="_blank" rel="noopener noreferrer" className="betaBadge" onClick={galaxyTrack && galaxyEvent ? galaxyOnClick(galaxyEvent) : undefined}>
                <Icon />
                <span>Beta</span>
            </a>;
  }
  return <div className="betaBadge">
            <Icon />
            <span>
                Funcionalidade Beta. 
                <u>
                    <a href="/docs/docs/beta-and-experimental-features#beta-features">
                        Saiba mais.
                    </a>
                </u>
            </span>
        </div>;
};

<BetaBadge />

A interface de chat no ClickHouse Agents permite gerenciar conversas, forks e compartilhamento.

<Image img="https://mintcdn.com/private-7c7dfe99/A68-kVUDkVcT2W3b/images/cloud/agent-builder/chat/chat.webp?fit=max&auto=format&n=A68-kVUDkVcT2W3b&q=85&s=40b793ab5116b74db09a7e7d949c43ab" alt="Interface de chat do ClickHouse Agent mostrando a navegação à esquerda, o cabeçalho com a identidade do agente e o composer" size="lg" width="3836" height="1938" data-path="images/cloud/agent-builder/chat/chat.webp" />

<div id="conversations">
  ## Conversas
</div>

Inicie uma nova conversa clicando no ícone de composição na navegação à esquerda.
Selecione o agente que deseja usar na caixa de diálogo do seletor de agente, no canto superior esquerdo da janela da conversa — por padrão, o **ClickHouse Agent** fica selecionado.
Agora você pode digitar sua mensagem no composer e clicar em enviar. Cada conversa é salva no histórico da barra lateral e pode ser reaberta, renomeada ou excluída depois.

<Image img="https://mintcdn.com/private-7c7dfe99/A68-kVUDkVcT2W3b/images/cloud/agent-builder/chat/conversation.webp?fit=max&auto=format&n=A68-kVUDkVcT2W3b&q=85&s=e2136c5ef501977addd78dc876ec4506" alt="Interface de chat com o ícone de composição destacado na navegação à esquerda, a barra lateral mostrando o histórico de Chats com uma conversa salva chamada Top 10 Tables Ranked e o composer com uma pergunta de exemplo digitada" size="lg" width="3838" height="1934" data-path="images/cloud/agent-builder/chat/conversation.webp" />

Você pode editar qualquer uma das suas mensagens no próprio chat, e o agente regenerará a resposta a partir desse ponto no histórico da conversa.
Você também pode regenerar apenas a última resposta do agente, sem reenviar sua mensagem.

<div id="bookmarks">
  ## Favoritos
</div>

Marque uma mensagem ou uma conversa inteira como favorita para encontrá-la rapidamente depois. Os favoritos são visíveis apenas para você e permanecem mesmo após a conversa ser renomeada.

<Image img="https://mintcdn.com/private-7c7dfe99/A68-kVUDkVcT2W3b/images/cloud/agent-builder/chat/bookmark.webp?fit=max&auto=format&n=A68-kVUDkVcT2W3b&q=85&s=4dcc2c1f6ca113239ee66fd92d4249af" alt="Cabeçalho do chat com o ícone de favorito destacado e a dica de ferramenta Add Bookmarks visível" size="lg" width="3836" height="1938" data-path="images/cloud/agent-builder/chat/bookmark.webp" />

<div id="pinned-conversations">
  ## Conversas fixadas
</div>

Fixe uma conversa para mantê-la no topo da barra lateral, separada do histórico agrupado por data logo abaixo. Abra o menu de opções da conversa (o ícone de três pontos) na barra lateral e selecione **Fixar**. As conversas fixadas aparecem em uma seção **Fixadas** acima dos grupos **Hoje**, **Ontem** e dos mais antigos.

Para desafixar, abra o mesmo menu e selecione **Desafixar**.

<div id="forking">
  ## Forking
</div>

O fork cria uma nova conversa a partir de uma mensagem específica. Você pode usá-lo para explorar um caminho alternativo sem alterar a thread original.
Há três modos de fork disponíveis:

* **Somente mensagens visíveis** - permite copiar o caminho direto até a mensagem bifurcada.
* **Incluir ramificações relacionadas** - permite copiar o caminho principal mais todas as ramificações existentes.
* **Incluir tudo até aqui** - permite copiar tudo até a mensagem bifurcada.

As conversas criadas por fork são independentes, portanto as alterações não são sincronizadas de volta com a original.

<Image img="https://mintcdn.com/private-7c7dfe99/A68-kVUDkVcT2W3b/images/cloud/agent-builder/chat/fork.webp?fit=max&auto=format&n=A68-kVUDkVcT2W3b&q=85&s=625c66f6474f782c4f9c7bd7621501b3" alt="Caixa de diálogo de seleção de opção de fork mostrando três ícones de modo de fork, as caixas de seleção Start fork here e Remember e a barra de ferramentas de ação da mensagem abaixo" size="lg" width="3836" height="1938" data-path="images/cloud/agent-builder/chat/fork.webp" />

<div id="sharing-chats">
  ## Compartilhar conversas
</div>

Gere um link compartilhável para qualquer conversa para enviá-la a um colega de equipe ou salvá-la para referência. Os destinatários veem uma visualização somente leitura, incluindo artefatos e ramificações visíveis. Você pode revogar um link no dashboard de compartilhamento a qualquer momento.

As edições em mensagens existentes aparecem na visualização compartilhada; mensagens adicionadas após a geração do link não aparecem.

Qualquer pessoa que visualizar um link compartilhado pode continuar a conversa na própria conta clicando em **Continue this chat**. Isso copia a conversa — incluindo a ramificação que a pessoa está visualizando — para o histórico dela como uma nova conversa privada, sem alterar a sua conversa original.

Para compartilhar uma conversa, abra o menu dela na barra lateral e selecione **Share**:

<Image img="https://mintcdn.com/private-7c7dfe99/A68-kVUDkVcT2W3b/images/cloud/agent-builder/chat/share.webp?fit=max&auto=format&n=A68-kVUDkVcT2W3b&q=85&s=b17141a695c412b3e6257f636fdc4ef3" alt="Menu da conversa na barra lateral com as opções Share, Rename, Duplicate, Archive e Delete visíveis" size="lg" width="3838" height="1934" data-path="images/cloud/agent-builder/chat/share.webp" />

Em seguida, clique em **Create link** na caixa de diálogo de compartilhamento:

<Image img="https://mintcdn.com/private-7c7dfe99/A68-kVUDkVcT2W3b/images/cloud/agent-builder/chat/share-modal.webp?fit=max&auto=format&n=A68-kVUDkVcT2W3b&q=85&s=58d6f829ef37ec6b5f29788431b9b080" alt="Caixa de diálogo Share link to chat com o botão Create link e uma observação de que seu nome e quaisquer mensagens adicionadas após o compartilhamento permanecem privados" size="md" width="1098" height="424" data-path="images/cloud/agent-builder/chat/share-modal.webp" />

<div id="keyboard-shortcuts">
  ## Atalhos de teclado
</div>

Abra a referência de atalhos de teclado com `Cmd+Shift+/` (`Ctrl+Shift+/` no Windows e Linux) ou pelo menu da conta, em **Ajuda** → **Atalhos de teclado**. Todos os atalhos podem ser personalizados: clique em uma linha na caixa de diálogo para registrar uma nova combinação e use **Redefinir tudo para os padrões** para restaurar os atalhos padrão.

Os atalhos padrão são:

| Ação                               | macOS                 | Windows e Linux        |
| ---------------------------------- | --------------------- | ---------------------- |
| Mostrar atalhos de teclado         | `Cmd+Shift+/`         | `Ctrl+Shift+/`         |
| Novo chat                          | `Cmd+Shift+O`         | `Ctrl+Shift+O`         |
| Ir para o campo de entrada do chat | `Shift+Esc`           | `Shift+Esc`            |
| Fazer upload de arquivo            | `Cmd+Shift+U`         | `Ctrl+Shift+U`         |
| Copiar a última resposta           | `Cmd+Shift+;`         | `Ctrl+Shift+;`         |
| Enviar mensagem                    | `Cmd+Enter`           | `Ctrl+Enter`           |
| Alternar a barra lateral           | `Cmd+Shift+S`         | `Ctrl+Shift+S`         |
| Abrir o seletor de modelo          | `Cmd+Shift+M`         | `Ctrl+Shift+M`         |
| Ir para a Busca                    | `Cmd+/`               | `Ctrl+/`               |
| Abrir configurações                | `Cmd+Shift+,`         | `Ctrl+Shift+,`         |
| Favoritar conversa                 | `Cmd+Shift+B`         | `Ctrl+Shift+B`         |
| Parar geração                      | `Cmd+Shift+X`         | `Ctrl+Shift+X`         |
| Regenerar resposta                 | `Cmd+Shift+E`         | `Ctrl+Shift+E`         |
| Editar a última mensagem           | `Cmd+Shift+I`         | `Ctrl+Shift+I`         |
| Continuar resposta                 | `Cmd+Shift+C`         | `Ctrl+Shift+C`         |
| Copiar o último bloco de código    | `Cmd+Shift+K`         | `Ctrl+Shift+K`         |
| Rolar até o topo                   | `Cmd+Shift+Up`        | `Ctrl+Shift+Up`        |
| Rolar até o fim                    | `Cmd+Shift+Down`      | `Ctrl+Shift+Down`      |
| Arquivar conversa                  | `Cmd+Shift+L`         | `Ctrl+Shift+L`         |
| Excluir conversa                   | `Cmd+Shift+Backspace` | `Ctrl+Shift+Backspace` |

Você também pode atribuir seus próprios atalhos para abrir painéis como agents, Prompts, arquivos e favoritos — eles não têm teclas padrão.