← Voltar

Auditar uma pasta inteira de gravações

Sem servidor externo: o cliente MCP lê a pasta local, envia cada arquivo para a transcrição e audita o risco. No fim você tem uma tabela para decidir.

FalaAI MCPEsforço: 2 minutos

Pré-requisitos

  • Cliente MCP com acesso ao sistema de arquivos (Claude Code, Cursor, VS Code ou Gemini CLI).
  • Chave FalaAI (fai_...) criada no dashboard.
  • Pasta com os áudios (mp3, wav, m4a, ogg, opus, webm ou aac).
  • Créditos disponíveis: cada arquivo é cobrado.

Configuração

FalaAI · .mcp.json

{
  "mcpServers": {
    "falaai": {
      "type": "http",
      "url": "https://mcp-falaai.action.tec.br/mcp",
      "headers": { "Authorization": "Bearer fai_..." }
    }
  }
}

Segundo servidor

# Nenhum. Este fluxo usa só a FalaAI MCP:
# quem lê a pasta é o seu cliente (filesystem local).

Teste sem custo: peça “teste o health do FalaAI”. Se responder, a conexão está ok.

O pedido

"Audite todos os áudios da pasta ./gravacoes e me entregue uma tabela com arquivo, nota de risco e veredito."

O que o agente faz

  1. Listar a pastaArquivos locais

    O agente lista os arquivos e escolhe a ordem (nome ou data).

    Entrada

    Caminho da pasta

    Saída

    Lista de arquivos de áudio

  2. Transcrever cada arquivo · transcribe_audioFalaAI MCP

    Um arquivo por chamada: leitura, base64 e envio.

    Entrada

    file_base64, filename, language

    Saída

    text e dialog diarizado, com eventos sonoros

  3. Auditar o risco · risk_auditFalaAI MCP

    O diálogo do passo anterior vai direto para a auditoria.

    Entrada

    dialog, duration_seconds, language; opcional response_language

    Saída

    Nota de risco, veredito, detecções e HTML

  4. Consolidar a tabelaArquivos locais

    O agente junta os resultados em uma tabela e destaca os piores casos.

    Entrada

    Retornos de cada arquivo

    Saída

    Tabela: arquivo · nota de risco · veredito

Resultado

  • Uma linha por arquivo, com nota de risco e veredito.
  • As detecções de cada chamada ficam no JSON devolvido.
  • O relatório HTML de cada auditoria vem na própria resposta.

A pasta não é enviada de uma vez: cada arquivo é uma chamada e uma cobrança.

Limitações

  • N arquivos = N chamadas: o custo cresce com o volume.
  • O resultado não é recuperável depois: salve o JSON de cada arquivo se precisar.
  • Sem agendamento nativo: rodar todo dia exige um agente ou cron no seu lado.
  • Pastas muito grandes dependem dos limites do seu cliente MCP.

Variações

  • Filtrar por duração mínima antes de auditar (evita gastar com áudio curto).
  • Só diagnosticar (0,03/caractere) e auditar apenas os casos negativos.
  • Comparar duas pastas (antes e depois de um treinamento).

Build × buy

Prefere não montar? A Action implementa este fluxo no seu ambiente, com a sua conta e os seus acessos, e valida junto com você.

Abrir o quickstart Falar com a Action
Auditar uma pasta de gravações com MCP | FalaAI