Seu agente recebeu todo o histórico. Mas recebeu o que importa?

Um vendedor pede à IA a próxima ação para uma conta. Para “dar bastante contexto”, o sistema envia três anos de notas do CRM, transcrições, pedidos, tabelas de preço, campanhas e uma lista inteira de ferramentas. No meio desse volume está o que realmente decide o caso: o cliente mudou de CNPJ, o último boleto foi liquidado ontem e a política comercial vigente limita o desconto.

O agente responde usando uma observação antiga, sugere uma condição que já venceu e ainda custa mais para chegar à decisão. Ele não falhou por falta de informação. Falhou porque recebeu informação demais, sem prioridade, validade ou fronteira.

Este artigo apresenta o método FILTRO para montar o contexto de trabalho de um agente: o conjunto mínimo de instruções, dados, histórico e ferramentas necessário para executar a etapa atual. A regra central é simples: contexto bom não é o maior; é o que preserva a decisão certa.

Engenharia de contexto é mais do que escrever um prompt

O prompt orienta o comportamento. O contexto inclui também o caso atual, os documentos recuperados, as respostas dos sistemas, as ferramentas disponíveis e o histórico da execução. Em um agente que trabalha em várias etapas, esse material cresce a cada consulta e pode carregar estados que já foram substituídos.

A orientação técnica da Anthropic sobre engenharia de contexto define o problema como selecionar, entre todas as informações possíveis, os elementos de maior sinal para a próxima inferência. A recomendação é recuperar informação sob demanda, manter referências leves e evitar conjuntos de ferramentas inchados ou sobrepostos.

A OpenAI descreveu em março de 2026 o mesmo desafio em tarefas longas: saídas extensas de ferramentas e o histórico do loop ocupam a janela disponível. Entre as práticas apresentadas estão limitar resultados, compactar o estado e consultar arquivos ou bancos de dados de forma direcionada, em vez de despejar todo o material no prompt.

Um resultado recente que merece atenção — e cautela

Um preprint submetido em junho de 2026 comparou políticas de contexto em um benchmark de 50 tarefas de lançamento de despesas no Microsoft Dynamics 365. Com o mesmo modelo de usuário, manter o histórico completo atingiu 71% de tarefas totalmente concluídas. Reter as cinco interações mais recentes com ferramentas e resumir parte do histórico chegou a 91,6%, usando 62,7% menos tokens.

Isso não prova que toda empresa deve usar uma janela de cinco interações, nem que resumir sempre melhora o resultado. O estudo é restrito a um fluxo, tem 50 tarefas, usa dados de teste e ainda não passou pela revisão formal de um periódico. O achado útil para gestores é mais modesto: estado antigo pode ser ruído ativo, e a política de contexto precisa ser testada como qualquer outra parte do processo.

O próprio experimento mostra o risco do corte cego. Apenas podar o histórico reduziu referências a estados vencidos, mas aumentou encerramentos prematuros; o resumo recuperou parte da consciência do objetivo. Portanto, “mandar menos” não basta. É preciso decidir o que permanece literal, o que vira resumo, o que será buscado sob demanda e o que deve ser excluído.

Quatro camadas que não devem ser misturadas

1. Mandato estável: objetivo, limites, alçada, critérios de aceite e regras que valem para todos os casos elegíveis.
2. Estado do caso: entidade correta, etapa atual, valores, prazos, pendências, última ação confirmada e versão vigente.
3. Evidência recuperável: documentos, conversas e registros que podem ser consultados quando a etapa exigir, com fonte, data e escopo.
4. Trilha de execução: ações tentadas, respostas de ferramentas, erros, aprovações e efeitos já reconciliados.

Quando tudo vira uma transcrição única, uma regra estrutural pode se perder entre mensagens; uma observação histórica pode parecer estado atual; e uma tentativa com erro pode ser confundida com ação concluída. As camadas permitem aplicar políticas diferentes de atualização, retenção e acesso.

Método FILTRO: seis controles para o contexto operacional

F — Finalidade e etapa atual

Descreva qual decisão ou artefato precisa sair agora. “Atender o cliente” é amplo; “classificar o motivo, confirmar identidade e preparar o próximo passo permitido” é verificável. Registre também o critério de término. Sem isso, o agente acumula informação e continua trabalhando sem saber quando a etapa acabou.

I — Identidade do caso e fonte oficial

Fixe cliente, pedido, obra, talhão, imóvel, paciente ou contrato por identificador confiável. Para cada atributo decisivo, defina o sistema oficial e a data da leitura. Nome parecido, telefone compartilhado ou endereço desatualizado não podem unir históricos de entidades distintas.

L — Limite de escopo, tempo e exposição

Determine período relevante, campos autorizados, profundidade de histórico e dados proibidos. Uma ação de recompra pode precisar dos últimos pedidos e do estoque atual, não de todas as conversas desde a abertura da empresa. Reduzir contexto também é minimizar exposição de dados pessoais, comerciais e estratégicos que a etapa não necessita.

T — Tools e recuperação direcionada

Dê ao agente poucas ferramentas com propósito distinto e respostas enxutas. Em vez de “listar todos os clientes”, prefira “buscar cliente por identificador”; em vez de retornar um log inteiro, devolva as linhas relevantes e o entorno necessário. A orientação da Anthropic para ferramentas de agentes destaca justamente que respostas completas e catálogos sobrepostos consomem o contexto e dificultam a escolha correta.

R — Registro compacto do que não pode se perder

Ao encerrar uma etapa, gere um estado estruturado: fatos confirmados, decisões, pendências, responsáveis, prazos, fontes e ações efetuadas. Resumo livre não substitui campos críticos. Valor, unidade, identificador, negação, exceção e autorização precisam permanecer literais e verificáveis.

O — Owner, observação e revisão

Defina quem responde pela política de contexto e quem revisa os casos de maior consequência. Observe quais itens entraram, foram descartados ou resumidos; meça erros por informação ausente e por informação vencida. Se ninguém consegue explicar por que um documento entrou na decisão, o contexto não é governado.

Matriz prática: relevância para a etapa × consequência

• Alta relevância + alta consequência: manter de forma explícita, atualizada e citada; validar identidade, fonte e versão antes da ação.
• Alta relevância + baixa consequência: incluir no pacote atual ou recuperar automaticamente com filtros definidos.
• Baixa relevância + alta consequência: não despejar por padrão; criar uma consulta ou checkpoint que a traga quando o gatilho correto aparecer.
• Baixa relevância + baixa consequência: manter fora do contexto de trabalho e disponível apenas para investigação posterior.

“Alta consequência” considera dano possível, valor exposto, irreversibilidade, obrigação regulatória, impacto em cliente e dificuldade de correção. Um dado pode ser pouco frequente e ainda ser obrigatório: alergia registrada em uma clínica, bloqueio financeiro em uma distribuidora ou restrição ambiental em uma área rural.

Cartão de contexto em 14 campos

Antes de ligar o agente ao fluxo real, documente:

1. objetivo da etapa;
2. resultado e formato esperados;
3. critério de conclusão;
4. identificador da entidade;
5. estado atual confirmado;
6. fonte oficial por atributo crítico;
7. data, hora e validade das leituras;
8. período histórico necessário;
9. dados obrigatórios e dados proibidos;
10. ferramentas liberadas e finalidade de cada uma;
11. limite e filtro das respostas;
12. fatos que devem permanecer literais;
13. gatilhos para buscar mais contexto ou perguntar;
14. owner, alçada e evidência de revisão.

Esse cartão não precisa aparecer inteiro para o usuário final. Ele é o contrato entre processo, integração e agente. Quando o resultado muda, permite investigar se o problema veio do modelo, da fonte, do recorte ou da regra de montagem.

Como aplicar nas verticais da V7

• v7 Obras: para cobrar uma pendência, carregar responsável, prazo, local e última atualização; recuperar plantas e revisões técnicas apenas quando a decisão exigir.
• v7 Carteira: para sugerir próxima ação, usar cadastro mestre, situação financeira atual, pedidos recentes e política vigente; não misturar observações de outro CNPJ do grupo.
• v7 Agro: separar safra, cultura, área, janela e condição comercial atuais de históricos que pertencem a ciclos anteriores.
• v7 Imob: filtrar por empreendimento, disponibilidade confirmada, faixa e etapa do lead; evitar que tabela antiga ou conversa de outro imóvel contamine a oferta.
• v7 Clínicas Retorno: limitar o agente administrativo aos dados necessários para agenda e retorno; informação clínica sensível só entra quando finalidade, acesso e supervisão justificarem.
• v7 Custom: projetar consultas orientadas à tarefa em ERP, CRM e documentos, com paginação, campos permitidos e retorno estruturado.

Placar de qualidade do contexto

• resultado aceito sem correção por caso elegível;
• erros por estado vencido e por dado obrigatório ausente;
• casos com identidade e fonte oficial confirmadas;
• volume médio retornado por ferramenta e proporção efetivamente usada;
• consultas repetidas porque o primeiro retorno veio amplo ou insuficiente;
• resumos que perderam valor, unidade, negação, prazo ou autorização;
• tempo e custo por resultado aceito;
• escaladas corretas por contexto insuficiente e escaladas evitáveis.

Não use “quantidade de documentos conectados” como indicador de maturidade. Uma integração boa reduz a distância até a evidência certa. Ela não transforma o drive inteiro em contexto permanente.

Piloto assistido de 20 dias

1. Dias 1 a 4: escolha uma decisão repetitiva, delimite casos elegíveis e reconstrua três falhas causadas por informação ausente, errada ou vencida.
2. Dias 5 a 8: preencha o cartão, separe as quatro camadas e reduza cada consulta aos campos necessários.
3. Dias 9 a 12: rode em modo sombra duas políticas: histórico amplo e contexto filtrado. Use os mesmos casos e critérios de aceite.
4. Dias 13 a 16: teste trocas de versão, casos homônimos, resultados volumosos, dados ausentes e retomada após interrupção.
5. Dias 17 a 20: compare resultado aceito, estado vencido, omissões, tempo, custo e carga de revisão; documente a política vencedora antes de ampliar.

Não copie a janela de outro benchmark. Ajuste retenção e resumo ao ciclo real do processo. Uma confirmação de agenda, uma negociação B2B e uma análise de RFI têm estados, riscos e evidências diferentes.

Checklist de 15 perguntas para gestores

• Qual decisão o agente precisa tomar nesta etapa?
• Como ele sabe que terminou?
• A entidade está identificada sem ambiguidade?
• Qual sistema é fonte oficial para cada dado crítico?
• O estado tem data, hora, versão e validade?
• Quais fatos precisam permanecer literais?
• Quais informações podem ser resumidas?
• O que deve ser buscado somente sob demanda?
• O retorno das ferramentas vem paginado e filtrado?
• Existem ferramentas com nomes ou funções sobrepostos?
• Dados pessoais ou sigilosos entram sem necessidade?
• O agente detecta conflito entre histórico e estado atual?
• Ele pergunta ou bloqueia quando falta contexto obrigatório?
• Há teste que compare contexto amplo e contexto curado?
• Quem revisa a política quando processo, fonte ou modelo mudam?

Sinais de alerta

• “conectamos tudo” é apresentado como garantia de qualidade;
• o agente recebe documentos completos quando precisa de dois campos;
• histórico, estado atual e tentativa com erro aparecem no mesmo bloco sem rótulo;
• um resumo pode apagar negação, unidade, condição ou alçada;
• a fonte recuperada não informa versão nem horário;
• o sistema inclui dados de outra empresa, obra, paciente ou imóvel parecido;
• mais ferramentas são adicionadas sem teste de seleção;
• o custo cresce a cada turno, mas ninguém mede resultado aceito;
• a equipe corrige o agente sem registrar se faltou ou sobrou contexto.

O ponto de vista da V7 Agents

Engenharia de contexto não é um truque para economizar tokens. É desenho operacional. Ela obriga a empresa a declarar qual fonte vale, qual estado está vigente, quem responde pela decisão, quando recuperar mais informação e como provar o resultado.

Um agente não precisa “saber tudo sobre a empresa” para começar. Precisa receber o contexto correto para uma rotina delimitada, com dados confiáveis, responsável, critério de aceite e revisão. Quando o fluxo cresce, a política de contexto cresce junto — de forma testada, rastreável e proporcional ao risco.

Na V7 Agents, IA só gera ROI quando existe processo, dados, responsável, rotina de revisão e implantação operacional. O V7 IA Ready transforma essas dependências em um mapa de fontes, decisões, acessos e prioridades; os Agentes Verticais aplicam o recorte ao trabalho real; e a Operação Contínua acompanha qualidade, custo, exceções e mudança.

Fontes consultadas

• Lodha et al. — Less Context, Better Agents, preprint de junho de 2026.
• OpenAI — From model to agent: equipping the Responses API with a computer environment, março de 2026.
• Anthropic — Effective context engineering for AI agents.
• Anthropic — Writing effective tools for AI agents.