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: 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: 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: 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 - 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: 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 - 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: 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. mcp_server: contas enabled: true tool_type: action confirmation_required: true requires: - subject - valor 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. 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 - 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: 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 termino_desconto: description: Trata término de desconto identificado na 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. 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: []