Ir para o conteúdo
IAMV Consulting

Da Clínica à Sala de Aula: Assessment, Segurança e Roadmap de Agente de IA

Agentes de IA

Três entregáveis de consultoria que destravaram a expansão de uma plataforma conversacional de saúde para uma nova vertical de educação.

Stack

  • n8n
  • Supabase
  • OpenAI
  • Infisical
  • Chatwoot
  • Evolution API
  • Next.js

Escopo da entrega

  1. 1Assessment técnico-produto

    5 achados críticos, maturidade em 6 dimensões, priorização MoSCoW

  2. 2Plano de segurança de credenciais

    Infisical, rotação dual-key, gate Gitleaks — 5 fases em até 15 dias úteis

  3. 3Roadmap do agente de captação

    4 módulos + 4 incrementos pós-MVP

Três entregas de consultoria, cada uma respondendo a uma decisão específica do cliente, do assessment ao roadmap do agente.

O desafio

Uma startup healthtech brasileira que opera uma plataforma conversacional para clínicas odontológicas (construída sobre n8n, Supabase e LLMs) chegou a um ponto de inflexão em 2026: expandir a mesma base tecnológica para uma nova vertical, a captação de alunos para instituições de ensino em odontologia, começando por uma faculdade que é cliente final da empresa.

A pergunta que a liderança precisava responder não era "conseguimos construir?", e sim "a base aguenta a expansão?". Havia sinais de fragilidade acumulada: credenciais hardcoded em workflows, dados pessoais persistidos em artefatos de debug, isolamento multi-tenant frágil em pontos críticos e controle operacional dependente de planilha. Escalar sobre essa base significaria amplificar cada um desses riscos, incluindo exposição à LGPD e bloqueio em vendas enterprise.

A solução

O engajamento foi estruturado em três entregas pontuais, cada uma respondendo a uma decisão específica do cliente.

1. Assessment técnico-produto. Auditoria estática dos workflows do n8n cobrindo arquitetura, dependências externas, padrões de segurança, isolamento multi-tenant e prontidão de domínio para a nova vertical. O veredito: avançar com condições — gate técnico obrigatório de hardening antes da expansão. Foram identificados 5 achados críticos, classificados por impacto e urgência, com maturidade avaliada em 6 dimensões e priorização em matriz MoSCoW.

2. Plano de solução de segurança de credenciais. O achado de maior risco residual do assessment virou um plano de execução próprio: centralizar 100% das credenciais em um secrets manager (Infisical, escolhido após comparação fundamentada entre três caminhos — credenciais nativas do n8n, Infisical e cloud secrets manager), rotacionar todas as chaves expostas com padrão dual-key para zero downtime, e implantar gate de CI bloqueante com Gitleaks para prevenir reincidência. Plano de 5 fases em até 15 dias úteis, com gates de aprovação explícitos e executável pelo time atual do cliente.

3. Plano de entrega do agente de IA. Roadmap técnico do MVP de um agente conversacional de captação para a instituição de ensino: orquestrador com subagentes de graduação e pós-graduação, camada agnóstica de canal, follow-up automatizado e painel administrativo em Next.js. Escopo em 4 módulos, com 4 incrementos pós-MVP priorizados por impacto operacional (handoff humano via Chatwoot, painel de métricas, knowledge base com RAG e WhatsApp via Evolution API).

Como funciona

O fio condutor das três entregas é o mesmo: decisão executiva precisa de visibilidade técnica fim a fim. Cada documento segue a estrutura sumário executivo → contexto → diagnóstico com evidências → recomendações priorizadas (alta/média/baixa) → plano de ação com responsável, janela e esforço.

No plano de segurança, cada credencial mapeada ganhou provedor, criticidade e ação requerida; a rotação foi desenhada com janela aprovada pela liderança executiva e rollback pronto antes de revogar qualquer chave antiga. No roadmap do agente, toda mensagem de qualquer canal é normalizada em um objeto único antes de entrar na lógica dos agentes — adicionar um canal novo exige apenas um conector, sem tocar no core. O desenho reaproveita a infraestrutura que o cliente já opera (Supabase, n8n self-hosted, Chatwoot), reduzindo a fundação do projeto a schema, seed de dados e configuração.

O fluxo conversacional completo do agente foi mapeado em diagrama de decisão: formas de ingresso da graduação (vestibular, ENEM, transferência, novo título), inscrição em pós-graduação, tratamento de prazos encerrados, handoff humano estruturado e follow-ups agendados.

Arquitetura da solução

Mensagem do candidato
Agente de captação
Resposta
Recursos · Agente de captação
Subagentes
Graduação
Vestibular, ENEM, transferência e novo título
Pós-graduação
Inscrição e prazos encerrados
Canal (agnóstico)
Normalização de mensagem
Objeto único antes da lógica dos agentes
WhatsApp via Evolution API
Incremento pós-MVP
Handoff humano via Chatwoot
Incremento pós-MVP
Operação
Follow-up automatizado
Agendado no fluxo conversacional
Painel administrativo Next.js
Base reaproveitada
Supabase
n8n self-hosted
Chatwoot
Infra já operada pelo cliente
O agente de captação escopado no roadmap: orquestração multi-agente, camada agnóstica de canal e base de infraestrutura reaproveitada do cliente.

Resultados

  • Decisão de expansão tomada com base em evidência: veredito "avançar com condições", com janela de hardening de 6 semanas e piloto controlado antes do rollout comercial
  • Categoria de risco mais grave da operação encerrada em plano executável: 100% das credenciais migradas para cofre central e rotacionadas sem downtime, com prevenção de reincidência via CI
  • MVP do agente de captação escopado e destravado: 4 módulos com critérios de aceite, dependências e único bloqueador externo identificado antes do início do desenvolvimento
  • Time do cliente autossuficiente por desenho: runbook de operação do cofre, walkthrough com o time e cadência de rotação de 90 dias transferem a operação sem dependência da consultoria

O aprendizado que fica: expansão de produto raramente falha na feature nova — falha na base que ninguém auditou. Um assessment honesto antes do roadmap custa uma fração do retrabalho que evita, e transforma "vamos escalar" de aposta em decisão.

Métricas

5 (3 com impacto e urgência altos)
Achados críticos identificados no assessment
3 (com recomendação fundamentada)
Caminhos de secrets management avaliados e comparados
até 15 dias úteis, zero downtime (padrão dual-key)
Plano de rotação de credenciais expostas
4 módulos + 4 incrementos pós-MVP
MVP do agente de captação escopado