bugfix

2026-07-09 22:04:20 +00:00 · 2026-06-15 07:51:07 -03:00
parent 1f1188dd4e
commit 9af4e10a92
10 changed files with 1057 additions and 534 deletions
--- a/config/agents/backoffice_anatel/guardrails.yaml
+++ b/config/agents/backoffice_anatel/guardrails.yaml
@@ -1,54 +1,34 @@
+# Source of truth for global/default guardrails in Compass Backoffice.
+# This file is intentionally aligned with config/agents/backoffice_anatel/guardrails.yaml
+# so framework stages that read the global path and stages that read the agent profile
+# apply the same policy set.
 agent_id: backoffice_anatel
-profile: backoffice_anatel_enterprise
+profile: backoffice_anatel
+
 input:
  - code: INPUT_SIZE
    enabled: true
-    action: block
-    max_chars: 12000
  - code: MSK
    enabled: true
-    action: sanitize
  - code: PINJ
    enabled: true
-    action: block
  - code: TOX
    enabled: true
-    action: block
  - code: DLEX_IN
    enabled: true
-    action: block
  - code: RAGSEC
    enabled: true
-    action: block
  - code: VLOOP
    enabled: true
-    action: block
+
 output:
  - code: REVPREC
    enabled: true
-    action: sanitize
  - code: DLEX_OUT
    enabled: true
-    action: sanitize
  - code: OOS
    enabled: true
-    action: review
  - code: CMP
    enabled: true
-    action: review
  - code: AOFERTA
    enabled: true
-    action: block
-business_rules:
-  require_evidence_for:
-    - protocolo
-    - cliente
-    - contrato
-    - status_siebel
-    - acao_operacional
-  forbid_without_tool_ok:
-    - registrar_acao_backoffice
-    - registrar_acao_siebel
-  domain_workflows:
-    checklist: src.agent.graphs.main_graph.create_main_agent_graph
-    response_emulator: src.agent.graphs.emulator_graph.create_emulator_graph
--- a/config/agents/backoffice_anatel/judges.yaml
+++ b/config/agents/backoffice_anatel/judges.yaml
@@ -1,4 +1,9 @@
+# Source of truth for global/default judges in Compass Backoffice.
+# Aligned with config/agents/backoffice_anatel/judges.yaml to avoid running a
+# weaker judge set when the framework is configured with the global path.
 agent_id: backoffice_anatel
+profile: judge
+fail_closed: true
 judges:
  - name: response_quality
    enabled: true
@@ -8,13 +13,21 @@ judges:
    threshold: 0.80
  - name: backoffice_no_fabricated_protocol
    enabled: true
+    type: llm
+    threshold: 0.80
    description: Verifica se a resposta não inventa protocolo, cliente, contrato, SLA ou status operacional.
  - name: siebel_action_requires_tool_ok
    enabled: true
+    type: llm
+    threshold: 0.85
    description: Bloqueia confirmação de registro/fechamento Siebel sem evidência ok/registered.
  - name: anatel_domain_traceability
    enabled: true
+    type: llm
+    threshold: 0.80
    description: Exige rastreabilidade para decisão de cancelamento, reclassificação, tratamento ou encaminhamento.
  - name: response_emulator_policy
    enabled: true
+    type: llm
+    threshold: 0.80
    description: Valida resposta formal ANATEL gerada pelo emulador antes de persistir/aprovar/fechar.
--- a/config/guardrails.yaml
+++ b/config/guardrails.yaml
@@ -1,8 +1,34 @@
+# Source of truth for global/default guardrails in Compass Backoffice.
+# This file is intentionally aligned with config/agents/backoffice_anatel/guardrails.yaml
+# so framework stages that read the global path and stages that read the agent profile
+# apply the same policy set.
+agent_id: backoffice_anatel
+profile: backoffice_anatel
+
 input:
+  - code: INPUT_SIZE
+    enabled: true
  - code: MSK
    enabled: true
+  - code: PINJ
+    enabled: true
+  - code: TOX
+    enabled: true
+  - code: DLEX_IN
+    enabled: true
+  - code: RAGSEC
+    enabled: true
  - code: VLOOP
    enabled: true
+
 output:
  - code: REVPREC
    enabled: true
+  - code: DLEX_OUT
+    enabled: true
+  - code: OOS
+    enabled: true
+  - code: CMP
+    enabled: true
+  - code: AOFERTA
+    enabled: true
--- a/config/judges.yaml
+++ b/config/judges.yaml
@@ -1,7 +1,33 @@
+# Source of truth for global/default judges in Compass Backoffice.
+# Aligned with config/agents/backoffice_anatel/judges.yaml to avoid running a
+# weaker judge set when the framework is configured with the global path.
+agent_id: backoffice_anatel
+profile: judge
+fail_closed: true
 judges:
  - name: response_quality
    enabled: true
-    threshold: 0.7
+    threshold: 0.75
  - name: groundedness
    enabled: true
-    threshold: 0.6
+    threshold: 0.80
+  - name: backoffice_no_fabricated_protocol
+    enabled: true
+    type: llm
+    threshold: 0.80
+    description: Verifica se a resposta não inventa protocolo, cliente, contrato, SLA ou status operacional.
+  - name: siebel_action_requires_tool_ok
+    enabled: true
+    type: llm
+    threshold: 0.85
+    description: Bloqueia confirmação de registro/fechamento Siebel sem evidência ok/registered.
+  - name: anatel_domain_traceability
+    enabled: true
+    type: llm
+    threshold: 0.80
+    description: Exige rastreabilidade para decisão de cancelamento, reclassificação, tratamento ou encaminhamento.
+  - name: response_emulator_policy
+    enabled: true
+    type: llm
+    threshold: 0.80
+    description: Valida resposta formal ANATEL gerada pelo emulador antes de persistir/aprovar/fechar.
--- a/config/tools.yaml
+++ b/config/tools.yaml
@@ -3,60 +3,110 @@ tools:
    description: Consulta reclamação/protocolo de backoffice/ANATEL.
    mcp_server: backoffice
    enabled: true
+    tool_type: read
+    cache:
+      enabled: true
+      ttl_seconds: 300
    args_schema: { protocol_id: string, customer_key: string, interaction_key: string }
  consultar_cliente_backoffice:
    description: Consulta contexto operacional do cliente para backoffice.
    mcp_server: backoffice
    enabled: true
+    tool_type: read
+    cache:
+      enabled: true
+      ttl_seconds: 600
    args_schema: { customer_key: string, contract_key: string, session_key: string }
  registrar_acao_backoffice:
    description: Registra ação operacional, parecer ou encaminhamento no sistema de backoffice.
    mcp_server: backoffice
    enabled: true
+    tool_type: action
+    requires: [protocol_id, action_text, operator_session]
+    confirmation_required: false
+    cache:
+      enabled: false
    args_schema: { protocol_id: string, action_text: string, operator_session: string }

  consultar_siebel_caso:
    description: Consulta caso/SR no Siebel.
    mcp_server: backoffice
    enabled: true
+    tool_type: read
+    cache:
+      enabled: true
+      ttl_seconds: 300
    args_schema: { protocol_id: string, interaction_key: string, customer_key: string }
  registrar_acao_siebel:
    description: Registra ação, reclassificação ou fechamento no Siebel.
    mcp_server: backoffice
    enabled: true
+    tool_type: action
+    requires: [protocol_id, action_text, operator_session]
+    confirmation_required: false
+    cache:
+      enabled: false
    args_schema: { protocol_id: string, action_text: string, operator_session: string }
  consultar_imdb_cliente:
    description: Consulta enriquecimento IMDB/PMID do cliente.
    mcp_server: backoffice
    enabled: true
+    tool_type: read
+    cache:
+      enabled: true
+      ttl_seconds: 600
    args_schema: { customer_key: string, contract_key: string, session_key: string }
  consultar_speech_analytics:
    description: Consulta histórico/resumo do Speech Analytics.
    mcp_server: backoffice
    enabled: true
+    tool_type: read
+    cache:
+      enabled: true
+      ttl_seconds: 600
    args_schema: { protocol_id: string, customer_key: string, interaction_key: string }
  consultar_tais_kb:
    description: Consulta TAIS Knowledge Base/RAG e templates.
    mcp_server: backoffice
    enabled: true
+    tool_type: read
+    cache:
+      enabled: true
+      ttl_seconds: 900
    args_schema: { query: string, protocol_id: string, customer_key: string }
  consultar_abrt:
    description: Consulta ABRT associado ao cliente/caso.
    mcp_server: backoffice
    enabled: true
+    tool_type: read
+    cache:
+      enabled: true
+      ttl_seconds: 600
    args_schema: { customer_key: string, protocol_id: string }
  consultar_portabilidade:
    description: Consulta status de portabilidade.
    mcp_server: backoffice
    enabled: true
+    tool_type: read
+    cache:
+      enabled: true
+      ttl_seconds: 600
    args_schema: { customer_key: string, contract_key: string }
  buscar_templates_emulador:
    description: Busca templates/documentos para Response Emulator.
    mcp_server: backoffice
    enabled: true
+    tool_type: read
+    cache:
+      enabled: true
+      ttl_seconds: 900
    args_schema: { protocol_id: string, query: string }
  gerar_rascunho_emulador:
    description: Gera rascunho de resposta do Response Emulator.
    mcp_server: backoffice
    enabled: true
+    tool_type: action
+    requires: [protocol_id]
+    cache:
+      enabled: false
    args_schema: { protocol_id: string, selected_actions: array, operator_instructions: string }