new feature: Integration with kbdb Autonomous

2026-08-26 10:15:59 -03:00
parent d7f270f52a
commit fc64c6ddd7
514 changed files with 3006 additions and 168 deletions
--- a/config/tools.yaml
+++ b/config/tools.yaml
@@ -5,7 +5,9 @@ tools:
    mcp_server: contas
    enabled: true
    args_schema:
-      msisdn: string
+      msisdn:
+        type: string
+        description: Número da linha do cliente (MSISDN) usado para consultar dados associados ao atendimento.
    selection_keywords:
    - quero minha fatura
    - consultar fatura
@@ -21,7 +23,9 @@ tools:
    mcp_server: contas
    enabled: true
    args_schema:
-      msisdn: string
+      msisdn:
+        type: string
+        description: Número da linha do cliente (MSISDN) usado para consultar dados associados ao atendimento.
    selection_keywords:
    - qual é meu plano
    - qual e meu plano
@@ -38,7 +42,9 @@ tools:
    mcp_server: contas
    enabled: true
    args_schema:
-      msisdn: string
+      msisdn:
+        type: string
+        description: Número da linha do cliente (MSISDN) usado para consultar dados associados ao atendimento.
    selection_keywords:
    - explicar fatura
    - entender fatura
@@ -49,25 +55,29 @@ 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: string
-    selection_keywords:
-    - o que é
-    - o que significa
-    - como funciona
-    - como faço
-    - informação
-    - explique o conceito
+#  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
  consultar_vas:
    description: Consulta serviços VAS ativos.
    mcp_server: contas
    enabled: true
    args_schema:
-      msisdn: string
+      msisdn:
+        type: string
+        description: Número da linha do cliente (MSISDN) usado para consultar dados associados ao atendimento.
    response:
      mode: renderer
      renderer: contas.vas
@@ -84,7 +94,9 @@ tools:
    mcp_server: contas
    enabled: true
    args_schema:
-      msisdn: string
+      msisdn:
+        type: string
+        description: Número da linha do cliente (MSISDN) usado para consultar dados associados ao atendimento.
    selection_keywords:
    - histórico de vas
    - historico de vas
@@ -101,7 +113,10 @@ tools:
    requires:
    - subject
    args_schema:
-      subject: string
+      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.
    selection_keywords:
    - cancelar serviço
    - cancelar servico
@@ -119,7 +134,10 @@ tools:
    requires:
    - subject
    args_schema:
-      subject: string
+      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.
    selection_keywords:
    - serviço estratégico
    - servico estrategico
@@ -141,10 +159,21 @@ tools:
    - subject
    - valor
    args_schema:
-      subject: string
-      valor: number
-      motivo: string
-      target_tool: string
+      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.
+      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.
+      motivo:
+        type: string
+        description: Motivo informado pelo cliente para a solicitação ou contestação. Não inventar motivo quando não estiver
+          explícito.
+      target_tool:
+        type: string
+        description: Nome técnico da tool transacional que será alvo da pré-validação.
    selection_keywords: []
  contestar_cobranca:
    description: Executa contestação no novo domínio Contas após confirmação transacional do framework.
@@ -156,9 +185,18 @@ tools:
    - subject
    - valor
    args_schema:
-      subject: string
-      valor: number
-      motivo: string
+      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.
+      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.
+      motivo:
+        type: string
+        description: Motivo informado pelo cliente para a solicitação ou contestação. Não inventar motivo quando não estiver
+          explícito.
    selection_keywords:
    - contestar
    - contestação
@@ -175,8 +213,13 @@ tools:
    tool_type: action
    confirmation_required: false
    args_schema:
-      status: string
-      summary: string
+      status:
+        type: string
+        description: Status final do atendimento ou da operação, conforme definido pelo fluxo de domínio.
+      summary:
+        type: string
+        description: Resumo objetivo do atendimento, contendo somente informações suportadas pelo contexto da conversa e resultados
+          das tools.
    selection_keywords:
    - encerrar atendimento
    - finalizar atendimento
@@ -187,23 +230,37 @@ tools:
    mcp_server: contas
    enabled: true
    args_schema:
-      msisdn: string
-      protocol: string
+      msisdn:
+        type: string
+        description: Número da linha do cliente (MSISDN) usado para consultar dados associados ao atendimento.
+      protocol:
+        type: string
+        description: Número ou identificador de protocolo/solicitação informado pelo cliente ou retornado por sistema.
  enviar_sms:
    description: Envia SMS via integração TIM; use apenas quando um fluxo de domínio exigir.
    mcp_server: contas
    enabled: true
    args_schema:
-      msisdn: string
-      message: string
+      msisdn:
+        type: string
+        description: Número da linha do cliente (MSISDN) usado para consultar dados associados ao atendimento.
+      message:
+        type: string
+        description: Texto da mensagem SMS a ser enviada ao cliente, conforme definido pelo fluxo.
  recuperar_fatura_pdf:
    description: Recupera o PDF seguro de uma fatura.
    mcp_server: contas
    enabled: true
    args_schema:
-      msisdn: string
-      invoice_id: string
-      customer_id: string
+      msisdn:
+        type: string
+        description: Número da linha do cliente (MSISDN) usado para consultar dados associados ao atendimento.
+      invoice_id:
+        type: string
+        description: Identificador da fatura a ser consultada ou recuperada.
+      customer_id:
+        type: string
+        description: Identificador do cliente associado à fatura.
  pro_rata:
    description: Explica cobrança proporcional e conduz pause/resume pelo WorkflowRuntime.
    mcp_server: contas
@@ -211,9 +268,15 @@ tools:
    tool_type: conversational
    confirmation_required: false
    args_schema:
-      msisdn: string
-      planos: array
-      has_plano_controle: boolean
+      msisdn:
+        type: string
+        description: Número da linha do cliente (MSISDN) usado para consultar dados associados ao atendimento.
+      planos:
+        type: array
+        description: Lista de planos identificados no contexto ou retornados por sistemas para análise de pró-rata.
+      has_plano_controle:
+        type: boolean
+        description: Indicador booleano que informa se há plano Controle entre os planos considerados no fluxo.
    selection_keywords:
    - pró-rata
    - pro rata
@@ -226,8 +289,12 @@ tools:
    mcp_server: contas
    enabled: true
    args_schema:
-      msisdn: string
-      nome_plano: string
+      msisdn:
+        type: string
+        description: Número da linha do cliente (MSISDN) usado para consultar dados associados ao atendimento.
+      nome_plano:
+        type: string
+        description: Nome do plano ao qual a informação ou tratamento se refere.
    selection_keywords:
    - término de desconto
    - termino de desconto
@@ -238,7 +305,9 @@ tools:
    mcp_server: contas
    enabled: true
    args_schema:
-      msisdn: string
+      msisdn:
+        type: string
+        description: Número da linha do cliente (MSISDN) usado para consultar dados associados ao atendimento.
    selection_keywords:
    - valor divergente
    - divergência de valor
@@ -250,7 +319,13 @@ tools:
    tool_type: internal
    confirmation_required: false
    args_schema:
-      workflow_name: string
-      execution_id: string
-      resposta_usuario: string
+      workflow_name:
+        type: string
+        description: Nome técnico do workflow que deverá ser retomado.
+      execution_id:
+        type: string
+        description: Identificador da execução pausada do workflow que deverá ser retomada.
+      resposta_usuario:
+        type: string
+        description: Resposta do usuário usada para continuar o workflow pausado.
    selection_keywords: []