Engenharia de Contexto
A engenharia de contexto seleciona o menor conjunto de tokens de alto sinal para tarefas de LLM. O objetivo: maximizar a qualidade do raciocínio enquanto minimiza o uso de tokens.
Quando Ativar
- Projetando/depurando sistemas de agentes
- Limites de contexto restringem o desempenho
- Otimizando custo/latência
- Construindo coordenação multi-agente
- Implementando sistemas de memória
- Avaliando o desempenho de agentes
- Desenvolvendo pipelines baseados em LLM
Princípios Fundamentais
- Qualidade do contexto > quantidade - Tokens de alto sinal superam conteúdo exaustivo
- A atenção é finita - Curva em forma de U favorece posições inicial e final
- Divulgação progressiva - Carregue informações no momento certo
- Isolamento previne degradação - Distribua o trabalho entre subagentes
- Meça antes de otimizar - Conheça sua linha de base
IMPORTANTE:
- Sacrifique a gramática pela concisão.
- Garanta a eficiência de tokens enquanto mantém alta qualidade.
- Passe estas regras para subagentes.
Referência Rápida
| Tópico | Quando Usar | Referência |
|---|---|---|
| Fundamentos | Entendendo anatomia do contexto, mecânica de atenção | context-fundamentals.md |
| Degradação | Depurando falhas, perdido-no-meio, envenenamento | context-degradation.md |
| Otimização | Compactação, mascaramento, cache, particionamento | context-optimization.md |
| Compressão | Sessões longas, estratégias de sumarização | context-compression.md |
| Memória | Persistência entre sessões, grafos de conhecimento | memory-systems.md |
| Multi-Agente | Padrões de coordenação, isolamento de contexto | multi-agent-patterns.md |
| Avaliação | Testando agentes, LLM-como-Juiz, métricas | evaluation.md |
| Design de Ferramentas | Consolidação de ferramentas, engenharia de descrições | tool-design.md |
| Pipelines | Desenvolvimento de projetos, processamento em lote | project-development.md |
| Consciência de Runtime | Limites de uso, monitoramento da janela de contexto | runtime-awareness.md |
Métricas Chave
- Utilização de tokens: Aviso em 70%, acionar otimização em 80%
- Variância de tokens: Explica 80% da variância de desempenho do agente
- Custo multi-agente: ~15x da linha de base de agente único
- Alvo de compactação: Redução de 50-70%, perda de qualidade <5%
- Alvo de cache hit: 70%+ para cargas de trabalho estáveis
Estratégia de Quatro Baldes
- Escrever: Salvar contexto externamente (scratchpads, arquivos)
- Selecionar: Puxar apenas o contexto relevante (recuperação, filtragem)
- Comprimir: Reduzir tokens enquanto preserva informações (sumarização)
- Isolar: Dividir entre subagentes (particionamento)
Anti-Padrões
- Contexto exaustivo em vez de contexto curado
- Informação crítica em posições intermediárias
- Sem gatilhos de compactação antes dos limites
- Agente único para tarefas paralelizáveis
- Ferramentas sem descrições claras
Diretrizes
- Coloque informações críticas no início/fim do contexto
- Implemente compactação em 70-80% de utilização
- Use subagentes para isolamento de contexto, não role-play
- Projete ferramentas com a estrutura de 4 perguntas (o que, quando, entradas, retornos)
- Otimize para tokens-por-tarefa, não tokens-por-solicitação
- Valide com avaliação baseada em sonda
- Monitore taxas de cache KV em produção
- Comece minimalista, adicione complexidade apenas quando comprovadamente necessária
Consciência de Runtime
O sistema injeta automaticamente a consciência de uso através do hook PostToolUse:
<usage-awareness>
Limites de Uso do Claude: 5h=45%, 7d=32%
Uso da Janela de Contexto: 67%
</usage-awareness>
Limiares:
- 70%: AVISO - considere otimização/compactação
- 90%: CRÍTICO - ação imediata necessária
Fontes de Dados:
- Limites de uso: API OAuth Anthropic (
https://api.anthropic.com/api/oauth/usage) - Janela de contexto: Arquivo temporário Statusline (
/tmp/ck-context-{session_id}.json)
Scripts
- context_analyzer.py - Análise de saúde do contexto, detecção de degradação
- compression_evaluator.py - Avaliação de qualidade da compressão