Desvendando o EVE: o framework de agentes da Vercel

Ver no idioma original →

Autoria: Vini Lana · Assistir no YouTube

Vídeo de autoria do canal indicado, não da IANIA; todos os direitos pertencem ao criador. Transcrição, resumo e tradução gerados automaticamente; o conteúdo no idioma original é preservado na versão em idioma original.

Idioma original: português

Vídeo original: Desvendando o EVE: O Framework de Agentes da Vercel · Canal: Vini Lana · 07:12 · Assistir no YouTube

Tópicos: Agentes de IA, Avaliação e benchmarks de IA, Engenharia de software com IA, Governança e regulação de IA

Resumo

O vídeo apresenta o EVE, framework de agentes da Vercel, e o compara ao Hermes Agent, destacando que eles atendem a necessidades diferentes. O EVE oferece uma estrutura organizada para definir instruções, modelos, skills, tools, sandbox, canais, conexões, subagents e workflows. O apresentador ressalta recursos importantes para sistemas de agentes em produção, como evals, integração com aplicações, self-hosting, autenticação, autorização e governança. A conclusão é que o Hermes continua útil como assistente ou harness pessoal, enquanto frameworks como o EVE são mais adequados para desenvolver sistemas de agentes em produção.

Pontos-chave

• O Hermes Agent é apresentado como um excelente harness para uso pessoal, mas não como a opção ideal para desenvolver sistemas multiagênticos em produção.
• O EVE organiza os componentes do agente em uma estrutura clara, com arquivos e pastas para instruções, definição do agente, skills, tools e sandbox.
• Canais, connections e subagents permitem integrar serviços de comunicação, MCPs e agentes especializados.
• Workflows ajudam a testar mudanças de modelo, ferramentas e system prompt para avaliar a qualidade e a previsibilidade do agente.
• Sistemas em produção exigem autenticação, autorização, observabilidade, logs e controle de acesso.
• O EVE oferece integrações com frameworks de frontend e pode ser usado em configuração self-hosted.
• Uma estrutura compreensível pode facilitar tanto a manutenção por pessoas quanto as alterações feitas pelo agente.
• O apresentador não propõe abandonar o Hermes: ele diferencia o uso pessoal do desenvolvimento de sistemas de agentes.

Capítulos

Início	Capítulo	Resumo
00:00	Hermes Agent e o papel do EVE	O apresentador compara o uso do Hermes como harness pessoal ao desenvolvimento de sistemas multiagênticos.
02:04	Estrutura do framework e validação de workflows	O vídeo percorre conexões, subagents, schedules e workflows, destacando testes para avaliar mudanças e a previsibilidade do agente.
04:07	Integrações, self-hosting e organização do projeto	O apresentador mostra integrações com aplicações e explica como a estrutura de arquivos do EVE facilita entender e manter o projeto.
06:11	Governança e quando usar cada opção	O vídeo destaca autenticação e autorização no EVE e conclui que o Hermes continua tendo seu lugar, mas atende a outro tipo de uso.

Citações

O meu harness é independente de OpenAI e Anthropic. — 00:31

Isso aqui vai te dar uma previsibilidade de comportamento do agente. — 02:35

Se ficar fácil demais para você entender, para o seu agente também fica mais fácil. — 05:40

O Hermes continua tendo o lugar dele, que sempre foi dele. — 06:41

Conceitos e entidades

• EVE (ferramenta): Framework de agentes da Vercel apresentado como opção para desenvolver sistemas de agentes em produção.
• Hermes Agent (ferramenta): Harness descrito como adequado para uso pessoal e como assistente, mas não voltado à construção de sistemas multiagênticos em produção.
• Vercel (empresa): Empresa responsável pelo framework EVE apresentado no vídeo.
• MCP (conceito): Protocolo mencionado como uma das formas de conectar ferramentas e serviços ao agente.
• Agents Factory (conceito): Abordagem descrita pelo apresentador para evoluir e melhorar um sistema de agentes de maneira semiautônoma.
• Agents Builder (conceito): Formação mencionada pelo apresentador, relacionada ao desenvolvimento de sistemas de agentes.
• observabilidade (conceito): Capacidade de acompanhar o comportamento do sistema por meio de logs e registros para entender e aprimorar seu funcionamento.
• Autenticação e autorização (conceito): Controles para verificar a identidade de um usuário e determinar se ele pode acessar recursos ou funcionalidades.

Tradução completa (pt-BR)

00:00 Tem muita gente usando o Hermes Agent. Inclusive, se você for um desses caras, já deixa no comentário: “Eu uso o Hermes Agent, sim.” Eu quero te apresentar outro camarada chamado Ivy, que é um framework agêntico da Vercel e que, provavelmente, a partir de hoje, vai ser o cara que você vai usar no lugar do Hermes para a maioria das tarefas que tem feito com o Hermes Agent. Bora nessa. O Hermes é hoje um dos mais populares entre o pessoal que desenvolve sistemas e agentes de IA. E não deveria ser diferente, afinal de contas, é um excelente harness. Ele traz várias premissas muito legais, como, por

00:31 exemplo, poder aprender com ele mesmo e ir evoluindo as skills conforme você vai usando. Então, se você usa o Hermes hoje, daqui a 30 dias ele terá evoluído e vai estar respondendo melhor para você. Também tem a ideia de eu não depender de um provider específico, ou seja, meu harness é independente da OpenAI e da Anthropic. Sensacional. Agora, quando a gente fala de desenvolvimento de sistemas de agentes, é aí que muita gente está errando hoje. O Hermes não foi feito para você desenvolver um sistema multiagêntico. Pelo contrário, foi feito para você trabalhar com esse cara dentro de um ecossistema seu, específico, como um assistente ou até mesmo

01:03 seu harness do dia a dia. Quando falo de sistema de agentes, estou falando de desenvolvimento de software, e há algumas premissas que não podem ser ignoradas. O que mais me chama a atenção e me faz gostar do Ivy é justamente a estrutura simples que ele apresenta. Se você observar bem a homepage deles, já consegue ler exatamente cada etapa do que um agente vai ter dentro dele. Por exemplo, tenho o arquivo instructions.md, que é o nosso system prompt. Tenho o agent.ts, onde ficam as definições do agente, o modelo e o nível de esforço que ele vai usar. Tenho a

01:34 pasta de skills, naturalmente, para colocar as skills aqui dentro. A pasta de tools, onde você vai definir as tools às quais esse agente terá acesso. A pasta de sandbox, que é exatamente onde vou lidar com a questão da segurança: o que esse agente pode fazer, se pode ou não acessar um site externo e quais sites ele pode acessar. Então, vamos fazer esse filtro no nível do sandbox. A pasta de channels, que é exatamente o que fez o Open Claw e o Hermes fazerem sucesso: a possibilidade de integrar com diversos canais de comunicação, como Slack, Telegram, Discord, WhatsApp e por aí vai.

02:04 Aqui, a pasta de connections, para você se conectar a conectores, MCPs, entre outros. A pasta de subagents, para definir quais são os subagents que o seu agente pode chamar, podendo ser agentes externos ou agentes internos efêmeros dentro do próprio agente. Aqui, schedules, para trabalhar com seus cron jobs ou heartbeats. E aqui, a pasta de workflows, onde você vai fazer a validação da qualidade do workflow do agente que tem. Então, se estou usando o modelo X e troquei pelo

02:35 modelo Y, tenho um mecanismo para validar se o output vai continuar aceitável. Se troquei as ferramentas ou o system prompt, da mesma maneira consigo testar. E isso vai dar previsibilidade ao comportamento do agente. Olha, rodamos esse caso de uso 20 vezes e, nas 20 vezes, ele se comportou bem. Ou rodamos 100 vezes e, em 20 delas, não se comportou bem. A partir disso, vou entender se preciso fazer um ajuste no nível do harness ou no nível do LLM. O Ivy

03:05 não chegou agora ao mercado; já está por aqui há alguns meses e também não é o único framework de agentes que existe. Existem outros, mas é o que estou usando em produção e de que mais gostei até agora. Falando das premissas e boas práticas de software, esta é a nossa arquitetura de agentes hoje. Você vai observar que temos os agentes, com o agente orquestrador e cada agente especialista respondendo a ele. Temos a camada de memória desse agente orquestrador, temos a camada de second brain da empresa, que fica disponível para o nosso agente orquestrador, e temos a camada de backend

03:35 de serviços para cada parte da empresa. Então, temos o serviço de Instagram, o serviço de WhatsApp, o serviço de legal, o serviço de growth, o content engine e por aí vai. Todos conectados a um gateway que vai definir exatamente qual agente pode acessar, de acordo com a pessoa que está usando e se ela está ou não autorizada. Então, preste atenção. Falei de autorização, falei de autenticação e estou falando de sistemas que, aqui dentro, têm observabilidade, logs e registros de tudo. Isso me permite observar, entender o que está acontecendo no sistema e fazê-lo evoluir.

04:07 Aqui dentro, temos um conceito de Agents Factory: quero continuar evoluindo e melhorando esse sistema de maneira semiautônoma. É exatamente isso que vou ensinar na formação Agents Builder, cuja lista de espera já está aberta. Se quiser garantir um desconto grande, é só entrar no link que está aparecendo aqui para você agora; ele também está na descrição e no primeiro comentário fixado. Outro ponto muito legal é a facilidade de integrar seu agente com um código. Por exemplo, se você está usando React, Next JS, Vue, Nuxt ou Svelte, ele

04:38 tem integração nativa na documentação. Então, você não precisa fazer uma gambiarra para que seu agente funcione no seu sistema atual. Isso é muito bom. Outro ponto legal: ele também pode ser usado para self-host. Talvez você nunca tenha mexido no EVE, tudo bem? Este aqui é um agente EVE feito aqui; está no site de templates da Vercel. Quando você olhar a pasta, veja: tem a pasta channels, a pasta connections, a pasta lib, skills, subagents, tools, o arquivo agent.ts, o arquivo instructions.md e o arquivo sandbox.ts.

05:09 Só de olhar para isso, tenho certeza de que, mesmo que você não seja dev ou nunca tenha usado esse framework, já sabe o que está acontecendo aqui dentro. Você já sabe o que provavelmente vai ter na pasta de connections? Os MCPs? Acertou, está aqui: Notion. E nas pastas de subagents, o que provavelmente vai ter? Os subagents? Acertou, está aqui a definição de subagents. Pasta de skills, naturalmente, skills. Pasta de channels, naturalmente, os canais, como a conexão com o Slack. Então, fica muito fácil entender o que está acontecendo aqui dentro. E, se fica muito fácil para você entender, para o seu agente também

05:40 fica mais fácil. No fim das contas, isso significa que seu agente vai gastar menos tokens para fazer alterações aqui dentro. Se fosse só isso, já seria legal. Mas, quando estou desenvolvendo um sistema de software, tenho algumas regras específicas que nem sempre são tão fáceis de tratar com skills. Por exemplo, se preciso exigir a autenticação do usuário que está entrando em contato comigo, ou se quero saber não só se ele foi autenticado, mas também se está autorizado a usar aquele caminho. Estamos falando de governança de dados. E aí, você consegue fazer isso facilmente no Hermes?

06:11 Poxa, não, porque o Hermes não foi feito para isso. Mas, quando trazemos para um framework como o Ivy, aí sim fica mais fácil. No nível do código, consigo definir autorização e autenticação. Ou seja, autentiquei: verifico se aquele usuário é quem diz ser. Autorizei: aquele usuário tem permissão para acessar, usar esse recurso, chamar esse MCP, fazer isso, usar esse subagent. Então, vamos para a camada de software de fato. Entendi, então, Vini: acabou para o Hermes Agent, agora o negócio é o Ivy. Calma, calma lá, não falei isso. Eu

06:41 falei que você consegue usar o Ivy para desenvolver sistemas de agentes sem produção. Ponto. O Hermes continua tendo o lugar dele, que sempre foi dele. Só que, talvez por falta de entender que existiam outras possibilidades, as pessoas estavam usando o Hermes para criar sistemas de agentes sem produção e esbarrando em um monte de problemas, do tipo: “Ah, tá, cara, como é que eu sei se quebrou ou não? Como consigo melhorar, colocar uma feature flag, fazer o rollout, autenticar o usuário e garantir que somente quem eu quero tenha acesso às informações específicas no momento certo?” Isso você não faz com o Hermes, mas faz com o

07:12 framework de agente. Existem vários. Inclusive, se você quiser ver mais vídeos nesse formato, falando sobre ferramentas para agentes, deixe aqui nos comentários se foi legal ou não, inscreva-se no canal, deixe seu like e compartilhe este vídeo. Eu sou o Vini. Este é o canal da AI Builders Academy. Estamos juntos, aquele abraço e valeu.

Transcrição original

[00:00] Tem muita gente usando o Hermes Agent. Inclusive, se você for um desses caras, já deixa no comentário que eu uso o Hermes Agent sim. Eu quero te apresentar um outro camarada chamado Ivy, que é um framework agêntico da Vercel, que provavelmente, a partir de hoje, vai ser o cara que você vai utilizar no lugar do Hermes para a maioria das tarefas que você tem feito com o Hermes Agent. Bora nessa. O Hermes é hoje um dos caras mais populares entre o pessoal que desenvolve sistemas e agentes de IA. E não deveria ser diferente, afinal de contas, é um excelente harness. Ele traz várias premissas super legais, como por

[00:31] exemplo, poder aprender com ele mesmo e ir evoluindo as skills conforme você vai utilizando. Então, se você usa o Hermes hoje, daqui 30 dias, ele evoluiu, ele vai estar respondendo melhor para você. Também a ideia de eu não depender de um provider específico, ou seja, meu harness, ele é independente de OpenAI e Anthropic. Sensacional. Agora, quando a gente fala de desenvolvimento de sistemas de agentes, é onde muita gente está errando hoje. O Hermes, ele não foi feito para você desenvolver um sistema multiagêntico. Pelo contrário, ele foi feito para você trabalhar com esse cara dentro de um ecossistema seu, específico, um assistente ou até mesmo

[01:03] seu harness do dia a dia. Quando eu falo de sistema de agentes, eu estou falando de um desenvolvimento de software e tem algumas premissas que não podem ser ignoradas aqui. O que mais me chama atenção e faz gostar do Ivy é justamente a estrutura simples que ele apresenta. Se você observar bem aqui na homepage deles, você já consegue ler exatamente cada etapa do que que um agente vai ter dentro dele. Por exemplo, eu tenho o arquivo de instructions.md, que é ali o nosso system prompt. Eu tenho o agent.ts, que é onde vão estar as definições do agente, modelo e nível de esforço que ele vai utilizar. Eu tenho a

[01:34] pasta de skills, naturalmente, é para colocar as skills aqui dentro. A pasta de tools, que é onde você vai definir as tools que esse agente vai ter acesso. A pasta de sandbox, que é exatamente onde eu vou trabalhar com a questão de segurança, o que que esse agente pode fazer, ele pode acessar um site externo, não pode, quais ele ele pode. Então, a gente vai fazer esse filtro a nível de sandbox. A pasta de channels, que é exatamente o que fez o Open Claw e o Hermes fazerem sucesso, que é a possibilidade de você integrar com diversos canais de comunicação, Slack, Telegram, Discord, WhatsApp, por aí vai.

[02:04] Aqui, a pasta de connections para você conectar com conectores, MCPs, entre outros. A pasta de subagents para você definir quais são os subagents que o seu agente pode chamar, sendo esses subagents podendo ser agentes externos ou agentes internos efêmeros dentro do próprio agente. Aqui, schedules para você trabalhar com os seus cron jobs ou seus heartbeats. E aqui a pasta de workflows, que é exatamente aonde você vai trazer a validação da qualidade do workflow agente que você tem. Então, se eu tô usando o modelo X e eu troquei por

[02:35] o modelo Y, eu tenho um mecanismo para validar se o output vai continuar aceitável. Se eu troquei as ferramentas, troquei o system prompt, da mesma maneira eu consigo testar. E isso aqui vai te dar uma previsibilidade de comportamento do agente. Olha, a gente rodou 20 vezes esse caso de uso, nas 20 vezes ele comportou bem. Ou a gente rodou 100 vezes e teve ali 20 vezes dentro dessas 100 vezes que não comportou bem. Eu vou entender dali se eu vou precisar de fazer um ajuste a nível de harness, se eu vou precisar de fazer um ajuste a nível de LLM. O Ivy

[03:05] não chegou agora no mercado, já tem alguns meses que ele tá aqui e também não é o único framework de agentes que existe. Existem outros, mas é o que eu tô usando em produção e o que eu mais gostei até agora. Falando sobre as premissas e boas práticas de software, aqui tá a nossa arquitetura hoje de agentes. Você vai observar que nós temos os agentes, tem o agente orquestrador e cada agente especialista aqui responde a ele. Nós temos a camada de memória para esse agente orquestrador, temos a camada de second brain da empresa que fica disponível para o nosso agente orquestrador, temos a camada de backend

[03:35] de serviços para cada parte da empresa. Então, o serviço de Instagram, o serviço de WhatsApp, serviço de legal, serviço de growth, content engine e por aí vai. Todos conectados a um gateway que vai fazer exatamente a definição de qual agente pode acessar de acordo com a pessoa que que consumindo, se aquela pessoa que está usando a gente está ou não autorizada. Então presta atenção. Eu falei de autorização, falei de autenticação, tô falando de sistemas aqui internamente tem observabilidade, tem logs e registros de tudo que me permite observar, entender o que tá acontecendo no sistema e evoluir ele.

[04:07] Aqui dentro a gente tem um conceito de Agents Factory, que é: eu quero continuar evoluindo e melhorando esse sistema de uma maneira semi autônoma. Exatamente isso que eu vou te ensinar na formação Agents Builder, que já tá com a lista de espera aqui aberta. Se você quiser garantir um desconto bravo, é só entrar nesse link que tá aparecendo aqui para você agora, também tá na descrição e no primeiro comentário fixado. Outro ponto muito legal é a facilidade de você conseguir integrar o seu agente com um código. Por exemplo, se você tá usando React, Next JS, Vue, Nuxt ou Svelte, ele

[04:38] tem integração nativa na documentação. Então você não precisa de fazer uma gambiarra para que seu agente funcione dentro do seu sistema atual. Isso é muito bom. Outro ponto legal, ele também pode ser usado para self host. Você talvez nunca tenha mexido no Eve, ok? Esse aqui é um agente Eve feito aqui, tá lá na nas no site de templates da Vercel. Quando você bater o olho na pasta, olha aqui, tem a pasta canais, a pasta connections, a pasta lib, skills, subagents, tools, o arquivo agent.ts, o arquivo instructions.md, o arquivo sandbox.ts.

[05:09] Só de você olhar para isso, eu tenho certeza, mesmo que você não seja dev ou nunca tenha usado esse framework, que você já sabe o que é que tá acontecendo aqui dentro. Você já sabe que na pasta de connections provavelmente vai ter o quê? Os MCPs? Acertou, tá aqui ó, Notion. Nas pastas de subagents provavelmente vai tá o quê? Os subagents? Acertou, tá aqui a definição de subagents. Pasta skills, naturalmente skills. Pasta canais, naturalmente os canais, conexão Slack. Então fica fácil demais de você entender o que tá acontecendo aqui dentro. E se ficar fácil demais para você entender, para o seu agente também

[05:40] fica mais fácil. Isso no final do dia significa que o seu agente vai gastar menos tokens para fazer alterações aqui dentro. Se fosse só isso, tava legal. Mas quando eu tô desenvolvendo um sistema de software, eu tenho algumas regras específicas que nem sempre vão ser tão fáceis de se tratar com skills. Por exemplo, se eu preciso de exigir a autenticação do usuário que tá entrando em contato comigo, ou se eu quero saber não só a autenticação, mas se aquele usuário está autorizado a usar aquele aquele caminho. A gente tá falando de governança de dados. E aí, você consegue fazer isso facilmente lá no Hermes?

[06:11] Poxa, não, porque o Hermes não foi feito pra isso. Mas quando a gente traz pro framework a gente como o IV, aí sim fica mais fácil. A nível de código, eu consigo setar autorização, eu consigo setar autenticação. Ou seja, autentiquei, vejo se aquele usuário é quem ele tá dizendo que é. Autorizei, aquele usuário tem permissão de acessar, de usar essa feature, de chamar esse MCP, de fazer, de usar esse subagente. Então, a gente vai pra camada de fato de software. Entendi então, Vini, acabou pro Hermes agent, o negócio agora é IV. Calma, calma lá, não falei isso. Eu

[06:41] falei que o IV, você consegue usar ele pra desenvolver sistema de agente sem produção. Ponto. O Hermes, ele continua tendo o lugar dele, que sempre foi dele. Só que por uma falta talvez de entender que existiam outras possibilidades, as pessoas estavam utilizando ele pra criar sistemas de agente sem produção, esbarrando com um monte de problema, do tipo, ah, tá, cara, como é que eu sei se quebrou ou não quebrou? Como é que eu consigo melhorar, colocar uma feature flag, fazer o rollout, autenticar o usuário, garantir que somente quem eu quero tenha acesso às informações específicas no momento certo. Isso você não faz com Hermes, mas você faz com o

[07:12] framework de agente. Existem vários, inclusive, se você quiser ver mais vídeos nesse formato, falando sobre ferramentas pra agentes, deixa aqui nos comentários se foi massa ou não, se inscreve no canal, deixa seu like, compartilha esse vídeo. E eu sou o Vini. Esse aqui é o canal da AI Builders Academy. Tamo junto, aquele abraço e valeu.