New features: Route Stickness, Handoff, Clarification, Read-Only/Transactional, Long Term Memory

templates/agent_template_backend/config/judges.yaml

@@ -1,20 +1,18 @@
 enabled: true
 fail_closed: true
 profile: judge
-
 judges:
-  - name: response_quality
-    enabled: true
-    threshold: 0.7
-
-  - name: groundedness
-    enabled: true
-    threshold: 0.6
-
-  - name: sentiment
-    enabled: true
-    fail_on_negative: false
-
-  - name: tone
-    enabled: true
-    fail_closed: true
+- name: response_quality
+  enabled: true
+  threshold: 0.7
+- name: groundedness
+  enabled: true
+  threshold: 0.6
+- name: sentiment
+  enabled: true
+  fail_on_negative: false
+- name: tone
+  enabled: true
+  fail_closed: true
+sample_rate: 0.25
+always_run_for_transactional: true

templates/agent_template_backend/config/mcp_parameter_mapping.yaml

@@ -8,18 +8,16 @@ mcp_parameter_mapping:
         contract_key: invoice_id
         interaction_key: ura_call_id
         session_key: session_id
-
       extract:
         mes_referencia:
           from: message
           type: int
           strategy: month_name_pt
-          description: >
-            Extrair mês citado na mensagem.
-            janeiro=1, fevereiro=2, março=3,
-            abril=4, maio=5, junho=6,
-            julho=7, agosto=8, setembro=9,
-            outubro=10, novembro=11, dezembro=12.
+          description: 'Extrair mês citado na mensagem. janeiro=1, fevereiro=2, março=3,
+            abril=4, maio=5, junho=6, julho=7, agosto=8, setembro=9, outubro=10, novembro=11,
+            dezembro=12.
+
+            '
     consultar_pagamentos:
       map:
         customer_key: msisdn
@@ -38,21 +36,57 @@ mcp_parameter_mapping:
     consultar_pedido:
       map:
         customer_key: customer_id
-        contract_key: order_id
         session_key: session_id
+      extract:
+        order_id:
+          from: message
+          type: string
+          strategy: hybrid
+          description: Extraia somente o identificador do pedido informado explicitamente
+            pelo usuário. Retorne null quando não houver identificador de pedido na
+            mensagem.
+          pattern: (?i)\\b(?:pedido|order)\\s*[:#-]?\\s*([A-Z0-9-]+)\\b
+          group: 1
     consultar_entrega:
       map:
-        contract_key: order_id
         session_key: session_id
+      extract:
+        order_id:
+          from: message
+          type: string
+          strategy: hybrid
+          description: Extraia somente o identificador do pedido informado explicitamente
+            pelo usuário. Retorne null quando não houver identificador de pedido na
+            mensagem.
+          pattern: (?i)\\b(?:pedido|order)\\s*[:#-]?\\s*([A-Z0-9-]+)\\b
+          group: 1
     solicitar_troca:
       map:
-        contract_key: order_id
         session_key: session_id
       defaults:
         reason: Solicitação aberta pelo atendimento conversacional.
+      extract:
+        order_id:
+          from: message
+          type: string
+          strategy: hybrid
+          description: Extraia somente o identificador do pedido informado explicitamente
+            pelo usuário. Retorne null quando não houver identificador de pedido na
+            mensagem.
+          pattern: (?i)\\b(?:pedido|order)\\s*[:#-]?\\s*([A-Z0-9-]+)\\b
+          group: 1
     solicitar_devolucao:
       map:
-        contract_key: order_id
         session_key: session_id
       defaults:
         reason: Solicitação aberta pelo atendimento conversacional.
+      extract:
+        order_id:
+          from: message
+          type: string
+          strategy: hybrid
+          description: Extraia somente o identificador do pedido informado explicitamente
+            pelo usuário. Retorne null quando não houver identificador de pedido na
+            mensagem.
+          pattern: (?i)\\b(?:pedido|order)\\s*[:#-]?\\s*([A-Z0-9-]+)\\b
+          group: 1

templates/agent_template_backend/config/routing.yaml

@@ -20,6 +20,18 @@ state_policies:
   - state: WAITING_SUPPORT_CONFIRMATION
     agent: support_agent
     description: Mantém confirmações no fluxo de suporte retail.
+  - state: COLLECTING_BILLING_PARAMETERS
+    agent: billing_agent
+    description: Mantém a coleta de parâmetros no fluxo de faturamento.
+  - state: COLLECTING_PRODUCT_PARAMETERS
+    agent: product_agent
+    description: Mantém a coleta de parâmetros no fluxo de produtos e serviços.
+  - state: COLLECTING_ORDER_PARAMETERS
+    agent: orders_agent
+    description: Mantém a coleta de parâmetros no fluxo de pedidos.
+  - state: COLLECTING_SUPPORT_PARAMETERS
+    agent: support_agent
+    description: Mantém a coleta de parâmetros no fluxo transacional de suporte retail.
 
 intents:
   - name: billing_invoice_explanation
@@ -55,7 +67,6 @@ intents:
       - listar_servicos
     keywords:
       - plano
-      - produto
       - serviço
       - pacote
       - internet
@@ -94,12 +105,15 @@ intents:
     domain: retail
     agent: support_agent
     description: Suporte, troca, devolução, garantia e problema com produto.
-    priority: 40
+    priority: 25
     mcp_tools:
       - consultar_pedido
       - solicitar_troca
       - solicitar_devolucao
     keywords:
+      - solicitar devolução
+      - devolver pedido
+      - solicitar troca
       - troca
       - devolução
       - devolver

templates/agent_template_backend/config/tool_policies.yaml

@@ -0,0 +1,21 @@
+version: 1
+
+# Arquivo opcional da aplicação. A ausência mantém o comportamento dos
+# templates anteriores e as políticas legadas declaradas em tools.yaml.
+defaults:
+  operation_type: read_only
+  require_confirmation: false
+
+tool_policies:
+  solicitar_troca:
+    operation_type: transactional
+    require_confirmation: true
+
+  solicitar_devolucao:
+    operation_type: transactional
+    require_confirmation: true
+
+# Exemplo para uma operação real que só pode executar após confirmação:
+#  cancelar_servico:
+#    operation_type: transactional
+#    require_confirmation: true

templates/agent_template_backend/config/tools.yaml

@@ -6,14 +6,19 @@ tools:
     args_schema:
       msisdn: string
       invoice_id: string
-
+    selection_keywords:
+    - fatura
+    - conta
+    - boleto
   consultar_pagamentos:
     description: Consulta histórico de pagamentos do cliente.
     mcp_server: telecom
     enabled: true
     args_schema:
       msisdn: string
-
+    selection_keywords:
+    - pagamento
+    - pagamentos
   consultar_plano:
     description: Consulta plano ativo e atributos comerciais.
     mcp_server: telecom
@@ -21,14 +26,18 @@ tools:
     args_schema:
       msisdn: string
       asset_id: string
-
+    selection_keywords:
+    - plano
   listar_servicos:
     description: Lista serviços ativos e adicionais VAS.
     mcp_server: telecom
     enabled: true
     args_schema:
       msisdn: string
-
+    selection_keywords:
+    - serviços
+    - servicos
+    - vas
   consultar_pedido:
     description: Consulta pedido de varejo por order_id/customer_id.
     mcp_server: retail
@@ -36,33 +45,57 @@ tools:
     args_schema:
       order_id: string
       customer_id: string
-
+    selection_keywords:
+    - consultar pedido
+    - status do pedido
+    - pedido
   consultar_entrega:
     description: Consulta entrega e rastreamento do pedido.
     mcp_server: retail
     enabled: true
     args_schema:
       order_id: string
-
+    selection_keywords:
+    - entrega
+    - rastreio
+    - rastreamento
+    - transportadora
+    - previsão
   solicitar_troca:
     description: Simula abertura de solicitação de troca.
     mcp_server: retail
     enabled: true
     tool_type: action
-    requires: [order_id, reason]
-    confirmation_required: false
+    requires:
+    - order_id
+    - reason
+    confirmation_required: true
     args_schema:
       order_id: string
       reason: string
-
+    selection_keywords:
+    - solicitar troca
+    - trocar
+    - troca
+    - defeito
+    - quebrado
   solicitar_devolucao:
     description: Simula abertura de solicitação de devolução.
     mcp_server: retail
     enabled: true
     tool_type: action
-    requires: [order_id, reason]
-    confirmation_required: false
+    requires:
+    - order_id
+    - reason
+    confirmation_required: true
     args_schema:
       order_id: string
       reason: string
-
+    selection_keywords:
+    - solicitar devolução
+    - solicitar devolucao
+    - devolver pedido
+    - devolver
+    - devolução
+    - devolucao
+    - arrependimento