Ajustes no agente de contas

docs/FIX_SCENARIO_23_LIVE_INTERNET_BALANCE_20260831.md

@@ -0,0 +1,29 @@
+# Correção do cenário 23 — saldo de internet em tempo real
+
+## Problema
+
+O FaturasAgent respondia que não havia informação nos "dados consultados" sobre o saldo de internet restante mesmo quando nenhuma tool de consumo em tempo real havia sido executada. Isso criava uma alegação de consulta sem evidência funcional.
+
+## Solução
+
+A correção foi mantida no agente, sem alteração do framework. Para perguntas explícitas de saldo/franquia restante em tempo real, o FaturasAgent:
+
+1. verifica se alguma tool bem-sucedida trouxe evidência de saldo/consumo atual;
+2. se houver evidência, deixa o fluxo normal responder com os dados reais;
+3. se não houver evidência, não afirma que consultou dados e orienta o cliente ao Meu TIM.
+
+Resposta de fallback:
+
+> Não consigo consultar o saldo de internet em tempo real por aqui. Para ver quanto ainda resta neste mês, consulte o app Meu TIM, onde você acompanha o consumo atual da sua franquia.
+
+A regra não intercepta perguntas genéricas sobre internet/plano e não bloqueia uma integração futura que passe a devolver saldo real.
+
+## Arquivo alterado
+
+- `app/agents/faturas_agent.py`
+
+## Testes
+
+- `tests/migration/test_scenario_23_live_internet_balance_guidance.py`
+- 3/3 testes novos PASS
+- regressão `tests/migration`: 821 PASS / 2 FAIL preexistentes