Compactação de contexto é o processo de resumir uma conversa longa com um agente de IA para liberar espaço na janela de contexto. O resumo substitui o histórico antigo, e o trabalho continua sem recomeçar do zero.

Como funciona

Todo modelo tem um limite de texto que consegue considerar de uma vez, a janela de contexto. Em tarefas longas, como programar durante horas, o histórico de mensagens, arquivos lidos e resultados de comandos vai enchendo esse espaço.

Quando o limite se aproxima, a ferramenta pede ao modelo que escreva um resumo do que importa: o objetivo, as decisões tomadas, os arquivos alterados e o que falta fazer. Esse resumo vira o novo início da conversa, e o histórico detalhado sai do contexto.

Algumas ferramentas fazem isso sozinhas. Outras oferecem um comando manual, que o usuário aciona quando quiser.

Exemplo prático

Você está pedindo a um agente de código para migrar um projeto de JavaScript para TypeScript. Depois de várias dezenas de trocas, a conversa está enorme e o modelo começa a perder detalhes.

Você aciona a compactação. O resumo guarda algo assim:

Texto
Objetivo: migrar o projeto para TypeScript.
Feito: pastas utils e api convertidas.
Pendente: pasta components e ajustes no tsconfig.
Decisão: manter modo estrito desligado até o fim.

Com isso, o agente segue de onde parou, usando bem menos espaço.

Para que serve

A compactação serve para:

  • Continuar tarefas longas sem estourar a janela de contexto.
  • Reduzir o custo, já que menos texto é enviado ao modelo a cada rodada.
  • Manter o modelo focado no que importa, em vez de se perder em detalhes antigos.

Em plataformas que coordenam vários agentes, como o bridgecode, manter o contexto de cada agente enxuto ajuda a conduzir projetos maiores.

Limites e cuidados

Resumir sempre perde alguma coisa. Um detalhe importante pode ficar de fora. Para reduzir o risco, escreva as regras permanentes do projeto em um arquivo de instruções, como o AGENTS.md ou o CLAUDE.md, em vez de depender só da conversa.

Outra boa prática é pedir que o resumo cite os arquivos e as decisões principais, e conferir se está correto antes de continuar.

Diferença entre compactação e janela de contexto longa

Uma janela de contexto maior dá mais espaço, mas não elimina o limite nem o custo de enviar muito texto. A compactação trabalha o problema de outro ângulo: reduz o que precisa ocupar o espaço. As duas técnicas podem ser usadas juntas.