Files
agent_contas/config/tools.yaml

257 lines
6.7 KiB
YAML

tools:
consultar_faturas:
description: Consulta faturas atuais/anteriores, status, vencimento, valor e existência de fatura aberta sem iniciar o
workflow de explicação.
mcp_server: contas
enabled: true
args_schema:
msisdn: string
selection_keywords:
- quero minha fatura
- consultar fatura
- ver fatura
- segunda via
- minhas faturas
- fatura atual
- fatura em aberto
- conta em aberto
consultar_plano:
description: Consulta exclusivamente o nome e valor do plano ou planos contratados a partir da evidência de billing analysis;
não retorna VAS como plano.
mcp_server: contas
enabled: true
args_schema:
msisdn: string
selection_keywords:
- qual é meu plano
- qual e meu plano
- plano contratado
- nome do meu plano
- que plano eu tenho
- quais são meus planos
response:
mode: renderer
renderer: contas.plan
invoice_explanation:
description: Explica composição, diferença ou variação de valores de uma fatura; não deve ser usada apenas para consultar/obter
a fatura.
mcp_server: contas
enabled: true
args_schema:
msisdn: string
selection_keywords:
- explicar fatura
- entender fatura
- fatura veio alta
- conta veio alta
- valor aumentou
- diferença de valor
- 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
consultar_vas:
description: Consulta serviços VAS ativos.
mcp_server: contas
enabled: true
args_schema:
msisdn: string
response:
mode: renderer
renderer: contas.vas
selection_keywords:
- vas
- serviço adicional
- servico adicional
- assinatura
- aplicativo
- serviços ativos
- servicos ativos
consultar_historico_vas:
description: Consulta histórico de serviços VAS.
mcp_server: contas
enabled: true
args_schema:
msisdn: string
selection_keywords:
- histórico de vas
- historico de vas
- histórico de serviços
- historico de servicos
- serviços anteriores
- servicos anteriores
cancelar_vas_avulso:
description: Executa cancelamento de VAS avulso no novo domínio Contas; confirmação e estado são do framework.
mcp_server: contas
enabled: true
tool_type: action
confirmation_required: true
requires:
- subject
args_schema:
subject: string
selection_keywords:
- cancelar serviço
- cancelar servico
- cancelar assinatura
- retirar serviço
- retirar servico
- desativar serviço
- desativar servico
tratar_vas_estrategico:
description: Trata VAS estratégico/bundle no novo domínio Contas; diálogo e estado são do framework.
mcp_server: contas
enabled: true
tool_type: conversational
confirmation_required: false
requires:
- subject
args_schema:
subject: string
selection_keywords:
- serviço estratégico
- servico estrategico
- benefício incluso
- beneficio incluso
- apple music
- deezer
- disney
- netflix
- globoplay
- amazon prime
validar_contestacao:
description: Pre-valida elegibilidade de uma contestação sem executar qualquer efeito transacional.
mcp_server: contas
enabled: true
tool_type: internal
confirmation_required: false
requires:
- subject
- valor
args_schema:
subject: string
valor: number
motivo: string
target_tool: string
selection_keywords: []
contestar_cobranca:
description: Executa contestação no novo domínio Contas após confirmação transacional do framework.
mcp_server: contas
enabled: true
tool_type: action
confirmation_required: true
requires:
- subject
- valor
args_schema:
subject: string
valor: number
motivo: string
selection_keywords:
- contestar
- contestação
- contestacao
- cobrança indevida
- cobranca indevida
- valor indevido
- ajuste na fatura
- estorno
finalizar_atendimento:
description: Executa apenas efeitos de domínio da finalização; encerramento, memória e telemetria ficam no framework.
mcp_server: contas
enabled: true
tool_type: action
confirmation_required: false
args_schema:
status: string
summary: string
selection_keywords:
- encerrar atendimento
- finalizar atendimento
- era só isso
- obrigado era isso
consultar_status_solicitacao:
description: Consulta status de solicitação/protocolo TIM.
mcp_server: contas
enabled: true
args_schema:
msisdn: string
protocol: string
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
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
pro_rata:
description: Explica cobrança proporcional e conduz pause/resume pelo WorkflowRuntime.
mcp_server: contas
enabled: true
tool_type: conversational
confirmation_required: false
args_schema:
msisdn: string
planos: array
has_plano_controle: boolean
selection_keywords:
- pró-rata
- pro rata
- pro-rata
- cobrança proporcional
- cobranca proporcional
- troca de plano
termino_desconto:
description: Trata término de desconto identificado na fatura.
mcp_server: contas
enabled: true
args_schema:
msisdn: string
nome_plano: string
selection_keywords:
- término de desconto
- termino de desconto
- desconto acabou
- fim do desconto
valor_divergente:
description: Trata variação/divergência de valor conforme workflow do Contas.
mcp_server: contas
enabled: true
args_schema:
msisdn: string
selection_keywords:
- valor divergente
- divergência de valor
- divergencia de valor
retomar_workflow:
description: Tool interna usada pelo framework para retomar workflow pausado.
mcp_server: contas
enabled: true
tool_type: internal
confirmation_required: false
args_schema:
workflow_name: string
execution_id: string
resposta_usuario: string
selection_keywords: []