Ajustes conforme relatorio de testes 2026-08-27

config/tools.yaml

@@ -55,21 +55,17 @@ tools:
     - divergência
     - cobrança diferente
     - por que esse valor
-#  buscar_informacao:
-#    description: Conhecimento do Contas é atendido pelo RagService do agent_framework_oci, não pelo MCP.
-#    mcp_server: contas
-#    enabled: false
-#    args_schema:
-#      query:
-#        type: string
-#        description: Pergunta ou termo de busca em linguagem natural informado pelo cliente.
-#    selection_keywords:
-#    - o que é
-#    - o que significa
-#    - como funciona
-#    - como faço
-#    - informação
-#    - explique o conceito
+  buscar_informacao:
+    description: Preserva a capability de conhecimento do Contas e delega a recuperação ao RAG do framework.
+    mcp_server: contas
+    enabled: true
+    tool_type: internal
+    confirmation_required: false
+    args_schema:
+      queries:
+        type: array
+        description: Perguntas de conhecimento que devem ser recuperadas pelo RAG do framework.
+    selection_keywords: []
   consultar_vas:
     description: Consulta serviços VAS ativos.
     mcp_server: contas
@@ -115,8 +111,10 @@ tools:
     args_schema:
       subject:
         type: string
-        description: Nome do serviço, produto, item, cobrança ou benefício que é o objeto principal da operação solicitada
-          pelo cliente.
+        description: Referência a um serviço, produto ou benefício concreto e identificável nas evidências VAS/fatura do cliente.
+          Categorias ou referências genéricas não identificam uma entidade por si só; se o texto não permitir resolver univocamente
+          para um item real, mantenha subject ausente/null.
+        user_prompt: Qual serviço você deseja cancelar?
     selection_keywords:
     - cancelar serviço
     - cancelar servico
@@ -136,8 +134,10 @@ tools:
     args_schema:
       subject:
         type: string
-        description: Nome do serviço, produto, item, cobrança ou benefício que é o objeto principal da operação solicitada
-          pelo cliente.
+        description: Referência a um serviço, produto ou benefício concreto e identificável nas evidências VAS/fatura do cliente.
+          Categorias ou referências genéricas não identificam uma entidade por si só; se o texto não permitir resolver univocamente
+          para um item real, mantenha subject ausente/null.
+        user_prompt: Qual serviço ou benefício você deseja tratar?
     selection_keywords:
     - serviço estratégico
     - servico estrategico
@@ -149,6 +149,25 @@ tools:
     - netflix
     - globoplay
     - amazon prime
+  validar_vas_subject:
+    description: Pré-valida de forma side-effect-free se subject resolve para uma entidade VAS concreta antes de confirmação/execução.
+    mcp_server: contas
+    enabled: true
+    tool_type: internal
+    confirmation_required: false
+    requires:
+    - subject
+    args_schema:
+      subject:
+        type: string
+        description: Referência de entidade VAS a resolver contra evidência autorizada.
+      target_tool:
+        type: string
+        description: Tool de domínio que solicitou a pré-validação.
+      msisdn:
+        type: string
+        description: Linha autenticada do contexto operacional.
+    selection_keywords: []
   validar_contestacao:
     description: Pre-valida elegibilidade de uma contestação sem executar qualquer efeito transacional.
     mcp_server: contas
@@ -161,12 +180,15 @@ tools:
     args_schema:
       subject:
         type: string
-        description: Nome do serviço, produto, item, cobrança ou benefício que é o objeto principal da operação solicitada
-          pelo cliente.
+        description: Referência a um item concreto e identificável da fatura (serviço, produto, plano, cobrança específica
+          ou benefício). Uma referência genérica ao documento ou à cobrança como um todo não identifica o subject; quando
+          não houver entidade concreta suficiente para resolução contra a evidência da fatura, mantenha subject ausente/null.
+        user_prompt: Qual cobrança ou item você não reconhece?
       valor:
         type: number
         description: Valor monetário explicitamente associado pelo cliente ao item, cobrança ou operação. Se não houver valor
           explícito ou houver dúvida razoável, manter ausente/null.
+        user_prompt: Qual é o valor da cobrança?
       motivo:
         type: string
         description: Motivo informado pelo cliente para a solicitação ou contestação. Não inventar motivo quando não estiver
@@ -187,12 +209,15 @@ tools:
     args_schema:
       subject:
         type: string
-        description: Nome do serviço, produto, item, cobrança ou benefício que é o objeto principal da operação solicitada
-          pelo cliente.
+        description: Referência a um item concreto e identificável da fatura (serviço, produto, plano, cobrança específica
+          ou benefício). Uma referência genérica ao documento ou à cobrança como um todo não identifica o subject; quando
+          não houver entidade concreta suficiente para resolução contra a evidência da fatura, mantenha subject ausente/null.
+        user_prompt: Qual cobrança ou item você deseja contestar?
       valor:
         type: number
         description: Valor monetário explicitamente associado pelo cliente ao item, cobrança ou operação. Se não houver valor
           explícito ou houver dúvida razoável, manter ausente/null.
+        user_prompt: Qual é o valor da cobrança que você deseja contestar?
       motivo:
         type: string
         description: Motivo informado pelo cliente para a solicitação ou contestação. Não inventar motivo quando não estiver
@@ -212,6 +237,8 @@ tools:
     enabled: true
     tool_type: action
     confirmation_required: false
+    requires:
+    - status
     args_schema:
       status:
         type: string
@@ -284,8 +311,22 @@ tools:
     - cobrança proporcional
     - cobranca proporcional
     - troca de plano
+  consultar_historico_descontos:
+    description: Consulta histórico autoritativo de descontos com status, valores, datas e motivo explícito de término quando fornecido pelo sistema de origem.
+    mcp_server: contas
+    enabled: true
+    tool_type: internal
+    confirmation_required: false
+    args_schema:
+      msisdn:
+        type: string
+        description: Número da linha autenticada usada para consultar o histórico de descontos.
+      nome_plano:
+        type: string
+        description: Filtro opcional pelo nome do plano.
+
   termino_desconto:
-    description: Trata término de desconto identificado na fatura.
+    description: Analisa término/retirada de desconto somente com causa suportada por evidência autoritativa.
     mcp_server: contas
     enabled: true
     args_schema: