374 lines
14 KiB
YAML
374 lines
14 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:
|
|
type: string
|
|
description: Número da linha do cliente (MSISDN) usado para consultar dados associados ao atendimento.
|
|
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:
|
|
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
|
|
- 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:
|
|
type: string
|
|
description: Número da linha do cliente (MSISDN) usado para consultar dados associados ao atendimento.
|
|
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: 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
|
|
enabled: true
|
|
args_schema:
|
|
msisdn:
|
|
type: string
|
|
description: Número da linha do cliente (MSISDN) usado para consultar dados associados ao atendimento.
|
|
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:
|
|
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
|
|
- 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:
|
|
type: string
|
|
description: Referência a um ou mais serviços, produtos ou benefícios concretos e identificáveis nas evidências VAS/fatura do cliente.
|
|
Preserve referências múltiplas e anafóricas quando o contexto imediato as resolver (por exemplo, "os dois", "ambos",
|
|
"Netflix e HBO", "todos os VAS avulsos"). Categorias genéricas sem foco conversacional não identificam entidade; se o texto
|
|
e o contexto não permitirem resolução segura para um item real nas evidências autorizadas, mantenha subject ausente/null.
|
|
user_prompt: Qual serviço você deseja cancelar?
|
|
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:
|
|
type: string
|
|
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
|
|
- benefício incluso
|
|
- beneficio incluso
|
|
- apple music
|
|
- deezer
|
|
- disney
|
|
- 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
|
|
enabled: true
|
|
tool_type: internal
|
|
confirmation_required: false
|
|
requires:
|
|
- subject
|
|
- valor
|
|
args_schema:
|
|
subject:
|
|
type: string
|
|
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
|
|
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.
|
|
mcp_server: contas
|
|
enabled: true
|
|
tool_type: action
|
|
confirmation_required: true
|
|
requires:
|
|
- subject
|
|
- valor
|
|
args_schema:
|
|
subject:
|
|
type: string
|
|
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
|
|
explícito.
|
|
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
|
|
requires:
|
|
- status
|
|
args_schema:
|
|
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
|
|
- 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:
|
|
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:
|
|
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:
|
|
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
|
|
enabled: true
|
|
tool_type: conversational
|
|
confirmation_required: false
|
|
args_schema:
|
|
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
|
|
- pro-rata
|
|
- 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: Analisa término/retirada de desconto somente com causa suportada por evidência autoritativa.
|
|
mcp_server: contas
|
|
enabled: true
|
|
args_schema:
|
|
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
|
|
- 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:
|
|
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
|
|
- 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:
|
|
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: []
|