Files
compass_backoffice/docs/RELATORIO_PARIDADE_BACKOFFICE_100.md
2026-06-13 08:23:21 -03:00

2.3 KiB

Relatório de paridade — Backoffice convertido 100%

Resultado

Esta versão deixa de ser apenas um agente genérico com ferramentas MCP e passa a hospedar a implementação original da branch develop dentro da aplicação do Agent Framework.

Paridade implementada

Item Status
Grafo checklist original Implementado
Grafo response emulator original Implementado
Rotas REST originais Implementadas
Schemas originais Implementados
Clients TIM originais Implementados
Prompts originais Implementados
Nós de negócio originais Implementados
Testes originais Copiados em tests_original_develop/
Gateway novo do framework Mantido
Guardrails do framework Mantidos e reforçados
Judges do framework Mantidos e reforçados
Supervisor do framework Mantido
MCP Tool Router Mantido
IC/NOC/AGA original Preservado via src/utils/ics_collector.py e observer original
IC/NOC/GRL framework Mantido via AgentObserver

Decisão de arquitetura

A lógica original de domínio foi mantida em src/ para garantir paridade. O framework hospeda essa lógica e a envolve com as capacidades enterprise novas.

Isso evita perder comportamento dos nós originais como validação ANATEL, IMDB, Speech Analytics, TAIS KB, cancelamento, reclassificação, tratamento, Siebel SR e Response Emulator.

Arquivos centrais alterados

  • app/main.py: registra workflows e rotas originais dentro do app do framework.
  • app/agents/backoffice_agent.py: quando recebe ticket ANATEL completo pelo gateway, executa o workflow checklist original como workflow de domínio.
  • config/agents/backoffice_anatel/guardrails.yaml: reforço dos rails de domínio.
  • config/agents/backoffice_anatel/judges.yaml: judges específicos para protocolo, Siebel, rastreabilidade e emulator.
  • .env.example: substitui .env com segredos reais.

Limites conhecidos

  • A execução real dos serviços TIM depende das variáveis de ambiente e conectividade corporativa.
  • Em ambiente local sem VPN/credenciais, os clients originais podem falhar ou usar fallback/mock conforme o código original.
  • Os testes copiados de tests_original_develop/ ainda devem ser executados no ambiente com dependências completas do projeto original.