first_contas/config/tools.yaml

tools:
  consultar_fatura:
    description: Consulta dados de fatura, valores, vencimento, itens, status e linha digitável.
    mcp_server: legacy_tim
    enabled: true
    tool_type: query
    cache: { enabled: true, ttl_seconds: 300 }
    args_schema:
      msisdn: string
      invoice_id: string
      customer_id: string

  consultar_pagamentos:
    description: Consulta histórico/status de pagamentos do cliente.
    mcp_server: legacy_tim
    enabled: true
    tool_type: query
    cache: { enabled: true, ttl_seconds: 300 }
    args_schema:
      msisdn: string
      customer_id: string

  consultar_plano:
    description: Consulta contrato/plano ativo e atributos comerciais.
    mcp_server: legacy_tim
    enabled: true
    tool_type: query
    cache: { enabled: true, ttl_seconds: 600 }
    args_schema:
      msisdn: string
      asset_id: string
      customer_id: string

  listar_servicos:
    description: Lista serviços ativos, VAS, SVA, bundles e benefícios da linha.
    mcp_server: legacy_tim
    enabled: true
    tool_type: query
    cache: { enabled: true, ttl_seconds: 600 }
    args_schema:
      msisdn: string
      asset_id: string

  recuperar_pdf_fatura:
    description: Recupera PDF/segunda via da fatura quando disponível.
    mcp_server: legacy_tim
    enabled: true
    tool_type: query
    cache: { enabled: true, ttl_seconds: 300 }
    args_schema:
      msisdn: string
      invoice_id: string
      customer_id: string
      output: string

  registrar_protocolo:
    description: Registra protocolo de atendimento nos serviços legados/Siebel quando aplicável.
    mcp_server: legacy_tim
    enabled: true
    tool_type: action
    confirmation_required: true
    requires: [msisdn]
    cache: { enabled: false }
    args_schema:
      msisdn: string
      protocol_number: string
      interaction_call_id: string
      reason: string
      channel: string

  abrir_contestacao:
    description: Abre contestação de cobrança/SR para itens de fatura após confirmação.
    mcp_server: legacy_tim
    enabled: true
    tool_type: action
    confirmation_required: true
    requires: [msisdn, invoice_id]
    cache: { enabled: false }
    args_schema:
      msisdn: string
      invoice_id: string
      customer_id: string
      sr: string
      items: list
      reason: string
      amount: number

  consultar_status_sr:
    description: Consulta status de SR/protocolo de contestação ou atendimento.
    mcp_server: legacy_tim
    enabled: true
    tool_type: query
    cache: { enabled: true, ttl_seconds: 180 }
    args_schema:
      msisdn: string
      sr: string
      protocol_number: string

  atualizar_status_sr:
    description: Atualiza status de SR/protocolo nos serviços externos.
    mcp_server: legacy_tim
    enabled: true
    tool_type: action
    confirmation_required: true
    requires: [msisdn, protocol_number]
    cache: { enabled: false }
    args_schema:
      msisdn: string
      protocol_number: string
      status: string
      notes: string

  cancelar_vas:
    description: Solicita cancelamento de VAS/SVA/serviço adicional após confirmação explícita.
    mcp_server: legacy_tim
    enabled: true
    tool_type: action
    confirmation_required: true
    requires: [msisdn]
    cache: { enabled: false }
    args_schema:
      msisdn: string
      app_id: string
      service_id: string
      csp_id: string

  bloquear_vas:
    description: Solicita bloqueio de VAS/SVA/serviço adicional após confirmação explícita.
    mcp_server: legacy_tim
    enabled: true
    tool_type: action
    confirmation_required: true
    requires: [msisdn]
    cache: { enabled: false }
    args_schema:
      msisdn: string
      app_id: string
      service_id: string
      csp_id: string

  enviar_sms:
    description: Envia SMS ao cliente com link/informação quando o fluxo exigir.
    mcp_server: legacy_tim
    enabled: true
    tool_type: action
    confirmation_required: true
    requires: [msisdn]
    cache: { enabled: false }
    args_schema:
      msisdn: string
      message: string
      long_url: string
      notify_url: string

  registrar_tracking:
    description: Registra tracking/activity de atendimento ou fatura nos serviços externos.
    mcp_server: legacy_tim
    enabled: true
    tool_type: action
    confirmation_required: false
    cache: { enabled: false }
    args_schema:
      msisdn: string
      protocol_number: string
      invoice_id: string
      activity_type: string
      activity_status: string