U8 · Secundários

AgentLab — laboratório de arquitetura de agentes

Laboratório de estudos onde testo arquiteturas de agentes. Cada usuário cria agentes com a própria chave (Anthropic ou OpenAI) e pode ligar um modo que roda um grafo LangGraph de 5 nós com cada passo visível em tempo real e trace no Langfuse.

Telas

AgentLab — laboratório de arquitetura de agentes: telas 1
AgentLab — laboratório de arquitetura de agentes: telas 2
AgentLab — laboratório de arquitetura de agentes: telas 3

Decisões técnicas

  • Grafo LangGraph com roteamento condicional: classifica a intenção e decide entre usar ferramentas, buscar contexto ou responder direto. Um nó de validação pede nova resposta até 2 vezes se a primeira não passar.
  • Painel de laboratório no chat: log de execução por nó com tempo, diagrama do grafo com o nó ativo destacado e link para o trace no Langfuse, tudo via SSE.
  • BYOK multi-provider: chaves da Anthropic e da OpenAI cifradas com AES-256-GCM antes de ir ao banco. A lista de modelos vem da API de cada provider.
  • Dois caminhos de execução: chat comum direto pelo Vercel AI SDK no Next.js; modo laboratório num serviço Python (FastAPI) separado. A chave do usuário nunca chega ao navegador.
  • Sanitização de entrada em 4 camadas contra prompt injection (normalização Unicode, regex, detecção de payload em base64 e proporção de caracteres especiais).
  • Desenvolvido a partir de 12 specs escritas por funcionalidade (Spec-Driven Development), com Claude Code.

Resultados

  • Código público com licença MIT, specs e documentação de arquitetura, BYOK, auth e banco no próprio repositório.

Stack

Next.js 15TypeScriptPythonFastAPILangGraphVercel AI SDKPrismaPostgreSQLLangfuseDocker

O que mostra

Serve para eu testar padrões de agente (roteamento, uso de ferramentas, autovalidação, observabilidade) num app completo, antes de levá-los para projetos de cliente.