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