> ## Documentation Index
> Fetch the complete documentation index at: https://docs.windsurf.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Visão geral do Chat

> Converse com sua base de código usando o Windsurf Chat no VS Code e nos IDEs JetBrains. Use @-mentions, contexto persistente, arquivos fixados e citações inline.

<Note>
  O Chat e seus recursos relacionados são compatíveis apenas em: VS Code, IDEs JetBrains, Eclipse, Xcode e Visual Studio.
</Note>

**Windsurf Chat** permite que você converse com sua base de código diretamente no editor.
O Chat é alimentado pelo nosso mecanismo de [consciência de contexto](/pt-BR/context-awareness/overview.mdx).
Ele combina recuperação de contexto nativa com orientação opcional do usuário para fornecer respostas precisas e bem fundamentadas.

<Tabs>
  <Tab title="VS Code">
    No VS Code, o Windsurf Chat fica, por padrão, na barra lateral esquerda.
    Se quiser movê-lo, clique e arraste o ícone do Windsurf para o local desejado.

    <Frame>
      <img src="https://mintcdn.com/codeium/DnGnXhZxl1qb2EWt/assets/chat_vscode_where_to_find.png?fit=max&auto=format&n=DnGnXhZxl1qb2EWt&q=85&s=7834d605c66fe4413718ad0d6e54ba29" width="1037" height="702" data-path="assets/chat_vscode_where_to_find.png" />
    </Frame>

    Você pode usar `⌘+⇧+A` no Mac ou `Ctrl+⇧+A` no Windows/Linux para abrir o painel do chat e alternar o foco entre ele e o editor.
    Você também pode destacar o chat do IDE clicando no ícone de página na parte superior do painel do chat.
  </Tab>

  <Tab title="JetBrains">
    Nos IDEs JetBrains, o Windsurf Chat fica, por padrão, na barra lateral direita.
    Se quiser movê-lo, clique e arraste o ícone do Windsurf para o local desejado.

    <Frame>
      <img src="https://mintcdn.com/codeium/DnGnXhZxl1qb2EWt/assets/chat_jetbrains_where_to_find.png?fit=max&auto=format&n=DnGnXhZxl1qb2EWt&q=85&s=d2679679c30f27acf855984e168e9707" width="989" height="771" data-path="assets/chat_jetbrains_where_to_find.png" />
    </Frame>

    Você pode usar `⌘+⇧+L` no Mac ou `Ctrl+⇧+L` no Windows/Linux para abrir o painel do chat enquanto digita no editor.
    Você também pode abrir o chat em uma janela de navegador separada clicando em `Tools > Windsurf > Open Windsurf Chat in Browser` na barra de menus superior.
  </Tab>
</Tabs>

<div id="mentions">
  ## Menções com @
</div>

<Tip>Uma menção com @ é uma forma determinística de trazer contexto e é garantido que fará parte do contexto usado para responder a um Chat.</Tip>

Em qualquer mensagem de chat que você enviar, é possível se referir explicitamente a itens de contexto no campo de entrada do chat, prefixando uma palavra com `@`.

Itens de contexto disponíveis para menção com @:

* Funções e classes
  * Apenas funções e classes indexadas localmente
  * E somente para linguagens para as quais temos analisadores de AST (Python, TypeScript, JavaScript, Go, Java, C, C++, PHP, Ruby, C#, Perl, Kotlin, Dart, Bash, COBOL e outras)
* Diretórios e arquivos na sua base de código
* Repositórios remotos
* O conteúdo do terminal no seu IDE (apenas no VS Code).

<Frame>
  <img src="https://mintcdn.com/codeium/DnGnXhZxl1qb2EWt/assets/at_mentions.png?fit=max&auto=format&n=DnGnXhZxl1qb2EWt&q=85&s=941c76f7691cd053706a4bc281112cc5" width="1456" height="814" data-path="assets/at_mentions.png" />
</Frame>

Você também pode usar `@diff`, que permite conversar sobre o `git diff` atual do seu repositório.
O recurso `@diff` está atualmente em beta.

<Tip>Se você quiser trazer um trecho de código para o Chat e não tiver Menções com @ disponíveis, você pode: 1. selecionar o código -> 2. clicar com o botão direito -> 3. selecionar "Windsurf: Explain Selected Code Block"</Tip>

<div id="persistent-context">
  ## Contexto Persistente
</div>

Você pode instruir o modelo de IA do Chat a usar determinado contexto ao longo de uma conversa e entre conversas diferentes
clicando na guia `Advanced` no painel do Chat.

<Frame caption="O Chat mostra o contexto que está considerando.">
  <img src="https://mintcdn.com/codeium/DnGnXhZxl1qb2EWt/assets/chat_context.png?fit=max&auto=format&n=DnGnXhZxl1qb2EWt&q=85&s=414beb483cf5725f5999ae090b01c986" width="1314" height="624" data-path="assets/chat_context.png" />
</Frame>

Nesta guia, você pode ver:

* **Instruções personalizadas do Chat**: uma breve diretriz de prompt, como "Responda em Kotlin e assuma que tenho pouca familiaridade com a linguagem", para orientar o modelo a um determinado tipo de resposta.
* **Contextos fixados**: itens da sua base de código, como arquivos, diretórios e trechos de código, que você deseja que o modelo considere explicitamente.
  Veja também [Fixação de contexto](/pt-BR/context-awareness/overview#context-pinning).
* **Documento ativo**: um marcador para o arquivo que você está usando no momento, que recebe foco especial.
* **Índices locais**: uma lista de repositórios locais que o mecanismo de contexto do Windsurf indexou.

<div id="slash-commands">
  ## Comandos com barra
</div>

Você pode começar uma mensagem com `/explain` para pedir ao modelo de IA que explique algo à sua escolha.
Atualmente, `/explain` é o único comando com barra compatível.
[Conte para nós](https://discord.com/invite/3XFf78nAx5) se houver outros fluxos de trabalho comuns que você gostaria de ver em um comando com barra.

<div id="copy-and-insert">
  ## Copiar e inserir
</div>

Às vezes, as respostas do Chat incluem blocos de código. Você pode copiar um bloco de código para a área de transferência ou inseri-lo diretamente no editor, na posição do cursor, clicando no botão apropriado no topo do bloco de código.

<Note>
  Se você quiser que a IA faça uma alteração diretamente no seu editor com base em uma instrução,
  considere usar o [Windsurf Command](/pt-BR/command/plugins-overview).
</Note>

<div id="inline-citations">
  ## Citações inline
</div>

O Chat reconhece itens de contexto de código e suas respostas frequentemente incluem referências com links para trechos de código nos seus arquivos.

<Frame>
  <video autoPlay muted loop playsInline src="https://exafunction.github.io/public/videos/chat/inline-citations.mp4" />
</Frame>

<div id="regenerate-with-context">
  ## Regenerate com contexto
</div>

Por padrão, o Windsurf decide se uma determinada pergunta é geral ou se requer contexto do repositório de código.

Você pode forçar o modelo de IA a usar o contexto do repositório enviando sua pergunta com `⌘⏎`.
Para uma pergunta que já recebeu resposta, você pode executar novamente com contexto clicando no ícone de brilho.

<Frame>
  <img src="https://mintcdn.com/codeium/DnGnXhZxl1qb2EWt/assets/chat_regenerate_with_context.png?fit=max&auto=format&n=DnGnXhZxl1qb2EWt&q=85&s=6da54122318e3b654ba4613abe6a68a1" width="440" height="206" data-path="assets/chat_regenerate_with_context.png" />
</Frame>

<div id="stats-for-nerds">
  ## Estatísticas para nerds
</div>

Muita coisa acontece nos bastidores a cada mensagem no Chat. Clique no ícone de estatísticas para ver esses números você mesmo.

<Frame>
  <img src="https://mintcdn.com/codeium/DnGnXhZxl1qb2EWt/assets/chat_stats_for_nerds.png?fit=max&auto=format&n=DnGnXhZxl1qb2EWt&q=85&s=048a60359f0330d1281175296804fbcb" width="1634" height="1180" data-path="assets/chat_stats_for_nerds.png" />
</Frame>

<div id="chat-history">
  ## Histórico do Chat
</div>

Para revisar conversas anteriores, clique no ícone de histórico na parte superior do painel do Chat.
Você pode clicar em `+` para criar uma nova conversa e
clicar no botão `⋮` para exportar a conversa. Isso se aplica apenas ao Windsurf Plugins.

<Frame>
  <img src="https://mintcdn.com/codeium/DnGnXhZxl1qb2EWt/assets/chat_history.png?fit=max&auto=format&n=DnGnXhZxl1qb2EWt&q=85&s=2c18d444db63df1329fa744079e7a05d" width="828" height="210" data-path="assets/chat_history.png" />
</Frame>

<div id="settings">
  ## Configurações
</div>

Clique no ícone de engrenagem para acessar a guia `Settings`. Aqui, você pode ver as configurações aplicáveis à sua conta. Por exemplo, é possível atualizar suas preferências de tema (claro ou escuro), ajustar a velocidade do Autocomplete, visualizar o plano atual e alterar o tamanho da fonte.
O painel de configurações também oferece a opção de baixar diagnósticos, que são logs de depuração que podem ajudar a equipe do Windsurf a investigar um problema, caso você encontre um.

<Frame caption="No Windsurf Chat, clique no ícone de engrenagem no canto superior direito">
  <img src="https://mintcdn.com/codeium/DnGnXhZxl1qb2EWt/assets/chat_settings.png?fit=max&auto=format&n=DnGnXhZxl1qb2EWt&q=85&s=d32c713a4055cf8f5c9cb0472671a5f0" width="1488" height="1536" data-path="assets/chat_settings.png" />
</Frame>

<div id="telemetry">
  ## Telemetria
</div>

<Note>Você pode ter problemas com o Chat se a telemetria não estiver ativada.</Note>

<Tabs>
  <Tab title="VS Code">
    Para ativar a telemetria, abra as configurações do VS Code e navegue até Usuário > Aplicativo > Telemetria. No menu suspenso a seguir, selecione "all".

    <img width="350" src="https://mintcdn.com/codeium/vRt4FQOyBeZpD2Pu/assets/vscode_telemetry_settings.png?fit=max&auto=format&n=vRt4FQOyBeZpD2Pu&q=85&s=0d4cd0b8d2c1dfaf0fa5c3a87e9e639f" data-path="assets/vscode_telemetry_settings.png" />
  </Tab>

  <Tab title="JetBrains">
    Para ativar a telemetria nos IDEs JetBrains, abra as configurações e navegue até Appearance & Behavior > System Settings > Data Sharing.

    <img width="350" src="https://mintcdn.com/codeium/d8O4q6w3H2CjrirL/assets/jetbrains_telemetry_settings.png?fit=max&auto=format&n=d8O4q6w3H2CjrirL&q=85&s=ded930e34656b692d02371b36b9d612b" data-path="assets/jetbrains_telemetry_settings.png" />
  </Tab>
</Tabs>