Rastreie e depure sessões de agentes eve com Vercel Observability
Aprofundamento CEVIU
Aprofundamento
A Vercel lançou em 25 de junho de 2026 um visualizador de rastros redesenhado para Workflows e Agent Runs, incluindo sessões de agentes construídos com o framework eve, anunciado em prévia pública em 26 de junho de 2026. O novo visualizador traz pesquisa por nome de etapa, conteúdo de entrada ou saída, zoom milissegundo a milissegundo e navegação via teclado. Ele está disponível localmente com npx workflow@beta web, sem exigir deploy. Cada sessão de agente eve é automaticamente instrumentada com OpenTelemetry: cada 'turn' gera um span pai, e chamadas de modelo, ferramentas e sandbox viram spans filhos com tags estruturais (gatilho, modelo usado, contagem de tokens, número de ferramentas invocadas).
O painel de Agent Runs aparece automaticamente em projetos eve no dashboard da Vercel. Oferece duas visualizações: Developer mode, com nomes brutos de ferramentas, JSON completo de entrada/saída e contagem de tokens por passo, e Business mode, com nomes humanizados, resumos em português e sem dados técnicos sensíveis. Todos os dados são criptografados por padrão, e a retenção vai até 30 dias com Observability Plus (planos Pro e Enterprise). Quem usa OpenTelemetry personalizado pode exportar spans diretamente do agent/instrumentation.ts para plataformas como Braintrust ou Datadog.
Por que isso importa
Antes, erros em execuções de agentes desapareciam nos logs de funções, sem ligação clara com o passo que falhou. Agora, cada falha é correlacionada ao 'turn' e à chamada específica, modelo, ferramenta ou sandbox, permitindo depuração precisa em minutos, não horas. A disponibilidade local do visualizador elimina o ciclo de 'desenvolver → deploy → testar → descobrir erro', acelerando iterações. Para equipes que operam múltiplos agentes em produção, a capacidade de auditar ações em modo Business (sem código) abre espaço para revisão por produtores, compliance ou stakeholders não técnicos, algo raro em soluções de observabilidade voltadas só para devs.
Impacto para desenvolvedores
Desenvolvedores de agentes com eve agora têm acesso imediato a uma stack de observabilidade integrada: instrumentação automática, visualização granular e exportação flexível, tudo sem configurar exporters ou SDKs adicionais. O suporte nativo a OpenTelemetry significa compatibilidade com ferramentas já usadas na empresa, como Datadog. A separação entre Developer e Business mode reduz ruído durante investigações, pois o engenheiro vê exatamente o que precisa (JSON, tokens, latência), enquanto o time de produto vê apenas o que foi feito e por quê. Não há necessidade de integrar bibliotecas externas de tracing: a instrumentação vem embutida no Eve e no AI SDK da Vercel.
Perguntas frequentes
O que é o Eve e como ele se relaciona com a Vercel Observability?
Eve é um framework open-source da Vercel para construção e operação de agentes de IA em produção, lançado em prévia pública em 26 de junho de 2026. Ele é nativamente instrumentado com OpenTelemetry, gerando rastros detalhados de cada sessão ('turn'), chamada de modelo e invocação de ferramenta, todos visíveis no painel de Agent Runs da Vercel Observability.
Como funciona a depuração local de sessões de agentes eve?
A partir de 25 de junho de 2026, é possível inspecionar execuções de agentes eve localmente usando npx workflow@beta web. O visualizador de rastros funciona offline, com pesquisa, zoom e navegação por teclado, sem precisar fazer deploy em produção para depurar.
Qual é a diferença entre Developer mode e Business mode no painel de Agent Runs?
Developer mode mostra nomes brutos de ferramentas, JSON completo de entradas e saídas, e contagem de tokens por passo. Business mode exibe nomes humanizados, oculta JSON e gera resumos em português, ideal para revisão por não desenvolvedores. Ambos leem os mesmos dados de rastro, mas com camadas distintas de abstração.
Quanto tempo os dados de sessões de agentes eve ficam armazenados?
Por padrão, os dados são criptografados e retidos conforme o plano do projeto. Com Observability Plus (disponível para planos Pro e Enterprise), a retenção pode ser estendida para até 30 dias. Equipes com backends OpenTelemetry personalizados mantêm controle total sobre duração e destino dos dados.
Fontes
- vercel.comfonte original
- Categoria
- CEVIU DevOps
- Publicado
- 29 de junho de 2026
- Editoria
- CEVIU DevOps

