Gerenciamento do context window
Aprenda como funciona o context window de 270.000 tokens do Bob, como cada categoria contribui para o uso de tokens e as melhores práticas para manter as tasks focadas e com eficiência de custo.
Entendendo o context window
Cada task no painel de chat tem um context window — o orçamento de tokens para aquele thread. O limite é de 270.000 tokens. Tudo que o Bob carrega conta para esse total.
O que preenche o window
Passe o cursor sobre o token usage indicator no canto superior direito do painel de chat para ver um detalhamento do que está consumindo seu context window:
| Categoria | O que inclui |
|---|---|
| System prompt | As instruções principais do Bob para a sessão |
| Tool definitions | Esquemas de ferramentas integradas e definições de ferramentas MCP conectadas |
| MCP Tools | Instruções e descrições de ferramentas fornecidas por servidores MCP conectados |
| Rules | Instruções personalizadas de arquivos de regras de projeto e modo (por exemplo, AGENTS.md ou .bob/rules-*) |
| Skills | Instruções de skills que o Bob carregou para a conversa |
| Messages | Seus prompts, as respostas do Bob e a atividade de ferramentas na conversa. Este é o transcript contado em tokens. |
Menções @, saída de comandos e resultados de ferramentas contam para Messages. Conteúdos de arquivos não têm uma linha separada.
Em Estimated breakdown:
- Reserved for model response: tokens reservados para a próxima resposta do Bob (tipicamente 20,0k).
- Available space: tokens livres restantes.
Overhead base
As categorias fixas consomem context antes mesmo de você começar a trabalhar com o Bob. No projeto de exemplo Galaxium Travels, mesmo "Quickly say hi back." totaliza cerca de 8,5k tokens. A maior parte é de Tool definitions (5,1k), System prompt (1,5k), Rules (830) e Skills (454). Apenas 590 está em Messages.
O Bob reenvia o stack completo de overhead a cada prompt. Mais servidores MCP ou skills carregados aumentam MCP Tools, Tool definitions e Skills antes de você digitar.
Para números práticos e um tutorial de reset, consulte Create a new context window.
Monitorando o uso de tokens
O token usage indicator mostra a porcentagem de preenchimento e uma fração de usados/total em relação ao limite de 270.000 tokens. Clique nele para abrir o context window breakdown. Verifique qual categoria está crescendo.
A tabela a seguir mostra o que influencia cada categoria:
| Categoria | O que a faz crescer |
|---|---|
| System prompt | Carregado quando a task inicia. Permanece estável durante o trabalho normal. |
| Tool definitions | Esquemas de ferramentas integradas. Definidos quando a task inicia. Permanecem estáveis durante o trabalho normal. |
| MCP Tools | Servidores MCP conectados e ferramentas habilitadas. Cresce quando você adiciona servidores ou ferramentas, não ao enviar prompts. |
| Rules | Arquivos de regras de projeto e modo (por exemplo, AGENTS.md). Definidos quando a task é aberta. |
| Skills | Skills que o Bob carrega para a task. Pode aumentar se o Bob ativar um skill no meio do thread. |
| Messages | Seus prompts, as respostas do Bob, leituras de arquivos, saída de ferramentas e menções @. Cresce a cada turno e com a exploração do repositório. |
Em uma troca curta, as categorias fixas frequentemente ocupam a maior parte do total. Quando você pede ao Bob para ler arquivos ou executar ferramentas, Messages normalmente se torna a maior categoria. Fique atento a essa mudança.
Available space diminui à medida que qualquer categoria cresce. Reserved for model response é separado para a próxima resposta do Bob. Não faz parte do total usado exibido acima.
Para exemplos medidos em um repositório real, consulte Create a new context window.
Limites de tokens
O limite rígido é de 270.000 tokens por task. O Bob começa a condensar antes de você atingir o limite. A condensação normalmente começa ao redor de 190.000 tokens de uso total.
Condensação automática do context
No limiar de condensação, o Bob:
- Preserva o context mais recente e relevante.
- Resume ou remove segmentos de conversa mais antigos.
- Mantém instruções de sistema críticas, tool definitions, rules e skills.
- Continua com o context condensado.
A condensação tem perda. Detalhes do início de Messages podem não sobreviver. Inicie uma nova task com + (New task) quando mudar de assunto ou quando Messages for grande o suficiente para prejudicar a qualidade.
Impacto nos Bobcoins
Bobcoins rastreia o uso de tokens. Tokens de entrada e de saída contam.
- Cada mensagem reenvia todo o context ativo, incluindo o overhead fixo.
- O Bob reprocessa o que já está carregado a cada envio.
- Threads longos com Messages extenso custam mais por prompt posterior.
Melhores práticas
O context window não é armazenamento. É memória de trabalho — o que o Bob pode usar a cada etapa. Controle o que entra. Faça reset ou condense quando o thread estiver cheio de saída obsoleta. Verifique o resultado com testes, não apenas com a resposta do Bob.
Delimitar a task e a conversa
Use uma task por objetivo de trabalho e comece com um prompt focado. Informe o objetivo, resultado esperado e restrições antes de pedir ao Bob que explore o repositório. Nomeie arquivos e funções explicitamente. Evite pedidos vagos como "leia o repositório inteiro" ou "verifique o backend". Clique em + (New task) quando o assunto mudar — conteúdo não relacionado em Messages adiciona custo e pode confundir o Bob.
Manter o context permanente enxuto
As categorias fixas consomem tokens antes de você digitar qualquer coisa. Para manter esse overhead baixo:
- Mantenha as custom rules e
AGENTS.mdcurtas — coloque lá apenas comandos de configuração, teste e estilo (por exemplo,pnpm test,mvn verify). - Conecte apenas os servidores MCP, ferramentas e skills de que o trabalho atual precisa. Desconecte o que não estiver usando e prefira configuração MCP com escopo de projeto em vez de global.
- Reserve Messages para evidências situacionais específicas desta task — o bug, logs e arquivos relevantes. Não repita rules permanentes em cada prompt.
Adicionar context quando precisar
Deixe o Bob pesquisar e ler arquivos específicos em vez de colar grandes blocos de conteúdo no thread. Use context mentions para referenciar um arquivo ou intervalo de linhas específico, e evite menções amplas de diretórios:
✓ @/src/utils/validation.ts:45-67 Fix the email validation logic
✗ @/src @/tests @/docs Review everything and suggest improvementsVocê também pode destacar texto no editor e usar Cmd + L (Mac) ou Ctrl + L (Windows/Linux) para adicioná-lo diretamente ao chat.
Trabalhe em etapas — encontre os arquivos prováveis, inspecione os relevantes, planeje, altere e valide. Para leituras amplas do repositório, use subagents para que a task receba resultados condensados em vez de cada chamada read_file aterrissar em Messages. Quando as fontes conflitarem, confie no código em execução e nos testes em vez de comentários obsoletos ou notas antigas do README.
Para mais táticas em repositórios grandes, consulte Working with large projects.
Fazer reset ou condensar quando Messages estiver cheio
Ao longo de uma conversa longa, Messages acumula conteúdos de arquivos repetidos, planos abandonados e saída de ferramentas obsoleta. Inicie uma nova task com + (New task) quando o objetivo de trabalho mudar ou quando o thread for grande o suficiente para prejudicar a qualidade. Mantenha restrições, evidências e questões em aberto — remova o restante.
O Bob também pode condensar segmentos mais antigos automaticamente, mas a condensação tem perda e detalhes do início de Messages podem não sobreviver. Prefira mudanças pequenas e aprovadas a uma grande execução autônoma para que os diffs permaneçam revisáveis e o Bob se mantenha no rumo certo.
Saiba mais
Consulte Create a new context window para abrir o detalhamento no projeto de exemplo Galaxium Travels e praticar um reset.
Ferramentas
Aprenda como Bob usa ferramentas especializadas para ler arquivos, editar código, executar comandos, gerar subagentes, usar integrações MCP e alternar modos para otimizar seu fluxo de trabalho de codificação.
Envenenamento de contexto
Aprende o que é envenenamento de contexto, como reconhecê-lo numa conversa com o Bob e como recuperar iniciando uma task nova ou melhorando a higiene de contexto.