hsnlabs
Agent Analyzer

Agent Analyzer Mapeador topológico em caixa-preta via sonda única para WhatsApp e LangGraph.

Engenharia reversa de máquinas de estado LangGraph StateGraph a partir da superfície usando apenas uma sessão de WhatsApp. O sistema extrai guardrails estáticos, roteadores condicionais, paralelismo subaditivo e persistência de checkpointer sem acesso ao código-fonte.

Interface LangGraph Blueprint Studio do Agent Analyzer

Protocolo Sequencial de Seis Ondas

Mapeamento de superfície progressivo e não-destrutivo desde a calibração inicial até a auditoria de persistência de memória.

W0

W0 · Linha de Base Caixa-Preta

Estabelece a topologia inicial com um único nó opaco de início ao fim. O sistema executa testes prévios de ping no canal WebSocket para calibrar a oscilação da conexão antes de iniciar a inferência.

W1

W1 · Guardrails de Borda e Roteamento

Mede a latência líquida de inferência abaixo de 600 milissegundos para isolar bloqueios estáticos de palavras-chave. Tempos entre 600 e 1800 milissegundos identificam pivôs semânticos de roteadores de entrada.

W2

W2 · Descoberta de Ferramentas de Leitura

Dispara sondas somente leitura em catálogo de produtos, faixas de preços, saldo de estoque e verificação de agenda. Permite identificar integrações externas de API sem causar alterações no banco do alvo.

W3

W3 · Dry-Run de Escrita e Portão Humano

Sonda intenções mutativas como criação de reservas e estornos financeiros. O analisador valida se o assistente possui travas de confirmação obrigatória e transbordo prévio para operadores humanos.

W4

W4 · Paralelismo Subaditivo Concorrente

Avalia turnos com múltiplas intenções simultâneas. Quando a razão de latência entre a consulta combinada e a soma das consultas individuais fica abaixo de 0.72, o sistema comprova execução concorrente em LangGraph.

W5

W5 · Memória de Checkpointer Canário

Injeta identificadores canários exclusivos seguidos de desvios bruscos de assunto. O teste avalia a retenção exata do contexto para determinar a presença de armazenamento durável em SQLite ou PostgreSQL.

Decomposição de Latência e Validação

Fundamentação matemática para separar atrasos de transporte, regras estáticas e raciocínio de modelos.

Cálculo da Latência Líquida

A latência bruta observada no canal inclui a ida e volta das mensagens pelo WhatsApp. O analisador subtrai duas vezes o tempo de ping aferido no servidor de mensagens para isolar com exatidão o tempo de processamento do agente alvo.

  • • Filtros Estáticos: Inferência líquida abaixo de 600 milissegundos caracterizando checagens de regex na borda.
  • • Roteadores Semânticos: Inferência entre 600 e 1800 milissegundos identificando modelos rápidos de classificação.
  • • Ferramentas Externas: Inferência entre 1800 e 3200 milissegundos revelando chamadas de banco e APIs.
  • • Raciocínio Profundo: Inferência acima de 3200 milissegundos apontando síntese avançada de respostas.

Replay Sequencial em Dois Passes

Para eliminar falsos positivos sem depender de enxames complexos com múltiplos números, o analisador adota um protocolo em duas etapas com uma única sessão de mensagens.

  • • Passo Um: Execução exploratória inicial de sondas mapeando nós e atribuindo selo provisório de hipótese.
  • • Quebra de Contexto: Envio de comando de reinicialização de sessão para garantir ponto de partida limpo.
  • • Passo Dois: Reexecução controlada das mesmas trilhas para confirmar a determinística de cada transição.
  • • Certificação: Elevação do nó ao nível verificado apenas quando a confirmação em dois passos é atingida.

Arquitetura de Sonda e Persistência

Armazenamento relacional em SQLite WAL e controle biométrico de envio para proteção operacional total.

01 • Sonda Unitária no WhatsApp

Opera com apenas um número de telefone conectado ao container WAHA na porta 3001, dispensando a gestão onerosa de frotas de chips e mitigando riscos de bloqueio.

02 • Cadência Humana Anti-Ban

Aplica pausas de leitura e digitação com distribuição log-normal, mantendo um piso mínimo de dois segundos entre turnos para simular o comportamento de um usuário real.

03 • Persistência Transacional em Cinco Tabelas

Armazena todo o histórico em banco SQLite no modo WAL, dividindo registros entre sessões de varredura, turnos cronológicos, nós mapeados, arestas direcionadas e parâmetros de conexão.

04 • Simulação Local sem Custo

Inclui um assistente simulado em memória que permite testar as seis ondas e gerar artefatos em segundos, sem necessidade de credenciais de nuvem ou aparelhos físicos.

05 • Quatro Exportadores Puros Pós-W5

Converte o grafo inferido em esqueleto Python para LangGraph, diagrama Mermaid para documentação, esquema JSON para pipelines e relatório técnico em Markdown.

Casos de Uso em Produção

Desenvolvido para engenharia reversa e conformidade arquitetural em sistemas conversacionais corporativos.

01 • Inteligência Competitiva e Benchmarking

Mapeamento da topologia conversacional de concorrentes no WhatsApp para identificar ferramentas integradas, estratégias de roteamento, tiers de modelo e limites de latência.

02 • Auditoria de Portões Humanos

Verificação prática em operações críticas como concessão de limites, alterações cadastrais e estornos, garantindo que o assistente respeite travas antes de persistir dados.

03 • Modernização de Chatbots Legados

Extração estruturada de assistentes legados sem documentação técnica com exportação direta para código Python StateGraph moderno e tipado em LangGraph.

Código Aberto e Especificação Técnica

Todo o código, incluindo o servidor em FastAPI, banco SQLite WAL em cinco tabelas, executor do protocolo de seis ondas, estúdio em React 19 e os quatro exportadores determinísticos, está disponível sob a licença MIT no GitHub.

Acessar Repositório no GitHub Voltar aos Produtos