Gerenciamento da janela de contexto
Aprenda como funciona a janela de contexto de 270.000 tokens do Bob, como cada categoria contribui para o uso de tokens e as melhores práticas para manter sessões focadas e econômicas.
Visão geral da janela de contexto
Cada sessão no Bob Shell tem uma janela de contexto — o orçamento de tokens para aquela conversa. O limite é de 270.000 tokens. Tudo que o Bob carrega conta contra esse total.
O que preenche a janela
| Categoria | O que inclui |
|---|---|
| Prompt do sistema | Instruções principais do Bob para a sessão |
| Definições de ferramentas | Schemas de ferramentas integradas e definições de ferramentas MCP conectadas |
| Ferramentas MCP | Instruções e descrições de ferramentas fornecidas por servidores MCP conectados |
| Regras | 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 |
| Mensagens | Seus prompts, respostas do Bob e atividade de ferramentas na conversa. Esta é a transcrição contada em tokens. |
Saídas de comandos e resultados de ferramentas contam para Mensagens. Conteúdos de arquivos não têm uma linha separada.
O relatório de tokens inclui dois campos de resumo:
- Reservado para resposta do modelo: Tokens reservados para a próxima resposta do Bob (tipicamente 20,0k).
- Espaço disponível: Tokens livres restantes.
Overhead de linha base
Categorias fixas usam contexto antes mesmo de você começar a trabalhar com o Bob. Mesmo um simples "Diz oi rapidamente." totaliza cerca de 8,5k tokens. A maior parte é de Definições de ferramentas (5,1k), Prompt do sistema (1,5k), Regras (830) e Skills (454). Apenas 590 está em Mensagens.
O Bob reenvia a pilha completa de overhead a cada prompt. Mais servidores MCP ou skills carregadas aumentam Ferramentas MCP, Definições de ferramentas e Skills antes de você digitar.
Monitorar o uso de tokens
O Bob Shell reporta o uso de tokens ao fim de cada troca. A tabela a seguir mostra o que influencia cada categoria:
| Categoria | O que a faz crescer |
|---|---|
| Prompt do sistema | Carregado quando a sessão inicia. Permanece estável durante o trabalho normal. |
| Definições de ferramentas | Schemas de ferramentas integradas. Definidas quando a sessão inicia. Permanecem estáveis durante o trabalho normal. |
| Ferramentas MCP | Servidores MCP conectados e ferramentas habilitadas. Cresce quando você adiciona servidores ou ferramentas, não ao enviar prompts. |
| Regras | Arquivos de regras de projeto e modo (por exemplo, AGENTS.md). Definidos quando a sessão abre. |
| Skills | Skills que o Bob carrega para a sessão. Pode aumentar se o Bob ativar uma skill durante a conversa. |
| Mensagens | Seus prompts, respostas do Bob, leituras de arquivos, saídas de ferramentas e de comandos. Cresce a cada turno e com a exploração do repositório. |
Em uma troca curta, categorias fixas frequentemente consomem a maior parte do total. Quando você pede ao Bob para ler arquivos ou executar ferramentas, Mensagens geralmente se torna a maior categoria. Fique atento a essa mudança.
Espaço disponível diminui à medida que qualquer categoria cresce. Reservado para resposta do modelo é separado para a próxima resposta do Bob. Não faz parte do total usado acima.
Limites de tokens
O limite máximo é de 270.000 tokens por sessão. O Bob começa a condensar antes de você atingir o limite. A condensação normalmente começa por volta de 190.000 tokens de uso total.
Condensação automática de contexto
No limiar de condensação, o Bob:
- Preserva o contexto mais recente e relevante.
- Resume ou remove segmentos mais antigos da conversa.
- Mantém instruções críticas do sistema, definições de ferramentas, regras e skills.
- Continua com o contexto condensado.
A condensação é com perda de dados. Detalhes do início de Mensagens podem não sobreviver. Inicie uma nova sessão quando mudar de assunto ou quando Mensagens estiver grande o suficiente para prejudicar a qualidade.
Impacto nos Bobcoins
Os Bobcoins rastreiam o uso de tokens. Tanto tokens de entrada quanto de saída contam.
- Cada mensagem envia novamente todo o contexto ativo, incluindo o overhead fixo.
- O Bob reprocessa o que já está carregado a cada envio.
- Sessões longas com Mensagens pesadas custam mais por prompt posterior.
Melhores práticas
A janela de contexto não é armazenamento. É memória de trabalho — o que o Bob pode usar em cada etapa. Controle o que entra. Reinicie quando a sessão se encher de saídas obsoletas. Verifique o resultado com testes, não apenas com a resposta do Bob.
Definir o escopo da sessão e da conversa
Use uma sessão por objetivo de trabalho e comece com um prompt focado. Declare o objetivo, o resultado esperado e as restrições antes de pedir ao Bob para explorar o repositório. Nomeie arquivos e funções explicitamente. Evite requisições vagas como "leia o repositório inteiro" ou "verifique o backend". Inicie uma nova sessão quando o assunto mudar — conteúdo não relacionado em Mensagens aumenta o custo e pode confundir o Bob.
Mantenha o contexto fixo enxuto
Categorias fixas consomem tokens antes de você digitar qualquer coisa. Para manter esse overhead baixo:
- Mantenha as regras personalizadas e o
AGENTS.mdcurtos — inclua apenas comandos de configuração, teste e estilo (por exemplo,pnpm test,mvn verify). - Conecte apenas os servidores MCP, ferramentas e skills que o trabalho atual precisa. Desconecte o que não estiver usando e prefira configuração MCP de escopo de projeto em vez de global.
- Reserve Mensagens para evidências situacionais específicas desta sessão — o bug, logs e arquivos relevantes. Não repita regras fixas em cada prompt.
Adicione contexto quando necessário
Deixe o Bob pesquisar e ler arquivos específicos em vez de colar grandes blocos de conteúdo no prompt do chat. Referencie caminhos de arquivo e intervalos de linha específicos no prompt e evite referências amplas a diretórios:
✓ Corrija a lógica de validação de e-mail em src/utils/validation.ts linhas 45-67
✗ Revise tudo em src/, tests/ e docs/ e sugira melhoriasTrabalhe em etapas — encontre arquivos prováveis, inspecione os relevantes, planeje, altere e valide. Para leituras amplas do repositório, use subagentes para que a sessão receba resultados condensados em vez de cada chamada read_file chegando em Mensagens. Quando fontes conflitam, confie em código executável e testes em vez de comentários obsoletos ou notas antigas do README.
Para mais táticas em repositórios grandes, veja Trabalhando com projetos grandes.
Reinicie quando Mensagens estiver cheio
Ao longo de uma sessão longa, Mensagens acumula conteúdos de arquivos repetidos, planos abandonados e saídas de ferramentas desatualizadas. Inicie uma nova sessão quando o objetivo de trabalho mudar ou quando a conversa estiver grande o suficiente para prejudicar a qualidade. Mantenha restrições, evidências e questões em aberto — remova o resto.
O Bob também pode condensar segmentos mais antigos automaticamente, mas a condensação é com perda de dados e detalhes do início de Mensagens podem não sobreviver. Prefira mudanças pequenas e aprovadas em vez de uma execução autônoma longa, para que os diffs permaneçam revisáveis e o Bob se mantenha no caminho certo.