cristiano.hoshikawa/agent_contas
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

new feature: Integration with kbdb Autonomous

Browse Source
This commit is contained in:
T3782834
2026-08-26 10:15:59 -03:00
parent d7f270f52a
commit fc64c6ddd7
514 changed files with 3006 additions and 168 deletions
Download Patch File Download Diff File Expand all files Collapse all files

7
config/prompts/billing.yaml
View File

@@ -17,4 +17,9 @@ system: |
Não use informações de uma cobrança antiga para completar a pergunta atual.
Quando houver resultado de tool, não extrapole procedimentos ou políticas
que não estejam nesse resultado.
que não estejam nesse resultado.
Em fluxos informativos de explicação de fatura, não ofereça espontaneamente ações
transacionais como cancelar, contestar, ajustar, creditar, ressarcir ou devolver.
Se o workflow retornar uma mensagem de pausa/pergunta ao cliente, preserve essa
mensagem sem acrescentar chamadas para ação transacionais. Limite-se a explicar
os dados retornados e à pergunta prevista pelo workflow.

24
config/routing.yaml
View File

@@ -25,7 +25,7 @@ intents:
domain: telecom_contas
agent: faturas_agent
priority: 142
description: Consulta do nome, identificação ou valor do plano principal ou dos planos contratados da linha. Não se aplica a VAS, serviços adicionais, aplicativos, assinaturas, parceiros ou benefícios incluídos.
description: Consulta do plano principal ou dos planos efetivamente contratados na linha, incluindo nome, identificação, valor e dados contratuais do plano atual. Use somente quando a pergunta exigir dados do cliente. Não use para perguntas gerais sobre funcionamento, tarifação, regras, condições ou características de um plano/produto, ainda que o usuário cite o nome de um plano específico.
mcp_tools:
- consultar_plano
keywords:
@@ -45,6 +45,7 @@ intents:
- Que plano eu tenho?
- Qual o nome do meu plano?
- Quais são os planos da minha linha?
- Quanto custa o meu plano atual?
- name: contas_invoice_query
domain: telecom_contas
agent: faturas_agent
@@ -200,7 +201,7 @@ intents:
nome, identificação ou valor do plano principal/plano contratado da linha.
mcp_tools:
- consultar_vas
- buscar_informacao
# - buscar_informacao
keywords:
- vas
- serviço adicional
@@ -246,21 +247,28 @@ intents:
- name: contas_knowledge
domain: telecom_contas
agent: suporte_contas_agent
priority: 80
description: Perguntas conceituais ou de procedimento sobre produtos, fatura, serviços
e regras que não exigem consultar dados do cliente.
mcp_tools:
- buscar_informacao
priority: 120
description: Perguntas gerais, conceituais, explicativas ou de procedimento sobre funcionamento, tarifação, regras, condições e características de planos, produtos, faturas e serviços que não exigem consultar dados específicos do cliente. Use esta intent quando o usuário perguntar como um plano/produto funciona, mesmo citando seu nome. Não use para descobrir qual plano está contratado na linha nem para consultar valor/dados contratuais do plano atual.
mcp_tools: []
keywords:
- o que é
- o que significa
- como funciona
- como é a tarifação
- como funciona a tarifação
- tarifação do plano
- tarifacao do plano
- qual a regra
- quais são as regras
- quais sao as regras
- como faço
- onde encontro
- qual a regra
- informação sobre
- informacao sobre
examples:
- Como funciona o Infinity Pós?
- Como funciona a tarifação do Infinity Pós?
- Quais são as regras do Infinity Pós?
- O que significa cobrança proporcional?
- Como funciona o vencimento da fatura?
- name: contas_service_status

165
config/tools.yaml
View File

@@ -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: []