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

> O mecanismo de contexto baseado em RAG do Windsurf indexa sua base de código para gerar sugestões inteligentes. Saiba mais sobre fixação de contexto, base de conhecimento e recuperação com M-Query.

O mecanismo de contexto do Windsurf cria um entendimento profundo da sua base de código, das ações passadas e da próxima intenção.

Historicamente, as abordagens de geração de código focaram em ajustar grandes modelos de linguagem (LLMs) a uma base de código,
o que é difícil de escalar para as necessidades de cada usuário.
Uma abordagem mais recente e popular utiliza a geração aumentada por recuperação (RAG),
que se concentra em técnicas para construir prompts altamente relevantes e ricos em contexto
a fim de obter respostas precisas de um LLM.

Implementamos uma abordagem RAG otimizada para contexto de base de código,
que produz sugestões de maior qualidade e reduz alucinações.

<Note>
  O Windsurf oferece ajuste fino completo para organizações Enterprise, e a melhor solução
  combina ajuste fino com RAG.
</Note>

<div id="default-context">
  ## Contexto padrão
</div>

Pronto para uso, o Windsurf considera várias fontes relevantes de contexto.

* O arquivo atual e outros arquivos abertos no seu IDE, que geralmente são muito relevantes para o código que você está escrevendo.
* Todo o repositório de código local é então indexado (incluindo arquivos que não estão abertos),
  e trechos de código relevantes são obtidos pelo mecanismo de recuperação do Windsurf enquanto você escreve código, faz perguntas ou invoca Commands.
* Para usuários Pro, oferecemos contextos mais longos, limites de indexação maiores e limites superiores para contexto personalizado e itens de contexto fixados.
* Para usuários Teams e Enterprise, o Windsurf também pode indexar repositórios remotos.
  Isso é útil para empresas cuja organização de desenvolvimento trabalha em vários repositórios.

<div id="knowledge-base-beta">
  ## Base de Conhecimento (Beta)
</div>

<Note>Disponível apenas para clientes Teams e Enterprise.</Note>

Este recurso permite que as equipes importem Google Docs como contexto compartilhado ou fontes de conhecimento para toda a equipe.

Atualmente, apenas Google Docs são compatíveis. Imagens não são importadas, mas gráficos, tabelas e texto formatado têm suporte completo.

<Card title="Knowledge Base" icon="people-group" href="https://windsurf.com/team/settings">
  Configure as definições da base de conhecimento da sua equipe. Esta página só ficará visível para administradores.
</Card>

Os administradores devem conectar-se manualmente ao Google Drive via OAuth e, em seguida, podem adicionar até 50 Google Docs como fontes de conhecimento da equipe.

O Cascade terá acesso aos documentos especificados no painel do Windsurf. Esses documentos não respeitam os controles de acesso individuais dos usuários; ou seja, se um administrador disponibilizar um documento para a equipe, todos os usuários terão acesso a ele, independentemente dos controles de acesso no Google Drive.

<div id="best-practices">
  ### Melhores práticas
</div>

O Context Pinning é ótimo quando sua tarefa no arquivo atual depende de informações de outros arquivos.
Tente fixar apenas o que for necessário. Fixar itens demais pode deixar tudo mais lento ou prejudicar o desempenho do model.

Aqui estão algumas ideias para um Context Pinning eficaz:

* Definições de módulos: fixe arquivos de definição de classes/structs que estão no seu repositório, mas em um módulo separado do arquivo atualmente ativo.
* Frameworks/bibliotecas internas: fixe diretórios com exemplos de código para uso de frameworks/bibliotecas.
* Tarefas específicas: fixe um arquivo ou pasta que define uma interface específica (por exemplo, arquivos `.proto`, classes abstratas, modelos de configuração).
* Área de foco atual: fixe o diretório com o “menor denominador comum” que contenha a maioria dos arquivos necessários para sua sessão de codificação atual.
* Testes: fixe um arquivo específico com a classe para a qual você está escrevendo testes unitários.

<div id="chat-specific-context-features">
  ## Recursos de contexto específicos do Chat
</div>

Ao conversar com o Windsurf Chat, você tem várias maneiras de aproveitar o contexto do código,
como [@-menções](/pt-BR/chat/overview/#mentions) ou diretrizes personalizadas.
Veja a [página do Chat](/pt-BR/chat/overview) para mais informações.

<video autoPlay muted loop playsInline className="w-full aspect-video" src="https://exafunction.github.io/public/videos/chat/inline-mention.mp4" />

<div id="frequently-asked-questions-faqs">
  ## Perguntas frequentes (FAQ)
</div>

<div id="does-windsurf-index-my-codebase">
  ### O Windsurf indexa meu código?
</div>

Sim, o Windsurf indexa seu código. Ele também usa LLMs para realizar geração aumentada por recuperação (RAG) no seu código usando nossas próprias técnicas de [M-Query](https://youtu.be/DuZXbinJ4Uc?feature=shared\&t=606).

O desempenho e os recursos de indexação variam conforme seu fluxo de trabalho e seu plano do Windsurf. Para mais informações, visite nossa [página sobre compreensão de contexto](https://windsurf.com/context).