Seu agente sabe demais.

Toda vez que um agente erra, o reflexo é o mesmo: dar mais contexto.

Mais documentos. Mais histórico. Mais ferramentas. Mais instruções. E o resultado quase nunca é o esperado, porque contexto não é conhecimento — é superfície de ambiguidade.

Um agente com acesso a tudo não sabe mais. Ele apenas hesita melhor.

O que geralmente está acontecendo

Quando um agente responde mal com pouco contexto, o problema é de recuperação. Quando ele responde mal com muito contexto, o problema é de decisão. São dois times diferentes resolvendo dois bugs diferentes, e quase sempre só um deles é chamado.

• Se a resposta muda a cada execução, você tem um problema de escopo.
• Se a resposta é sempre confiante e sempre errada, você tem um problema de fonte.
• Se a resposta é boa e ninguém consegue explicar por quê, você tem um problema de arquitetura.

A pergunta melhor

Em vez de "o que mais o agente precisa saber?", tente: o que ele precisa deixar de acessar para tomar essa decisão sozinho?

Restrição é a única forma de comportamento previsível que a gente conhece. Vale para software, vale para pessoas, vale para modelos.

Amanhã tem outra.