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