Vercel ha rilasciato eve, un framework open-source per costruire, eseguire e scalare agenti IA. Il progetto, disponibile come pacchetto npm con nome "eve", è rilasciato con licenza Apache-2.0. Come riferisce Vercel, oggi il framework supporta più di cento agenti in produzione.
Che cos'è eve?
eve è un framework "filesystem-first" per agenti backend resilienti. Si crea un agente come una directory nel sistema file. La directory rappresenta il contratto, dove ogni file descrive un componente dell'agente. Al primo sguardo, l'albero mostra cosa l'agente fa e quando agisce autonomamente.
L'agente più semplice che funziona è formato da due file: uno definisce il modello, l'altro le istruzioni.
Un esempio:
// agent/agent.ts
import { defineAgent } from "eve";
export default defineAgent({
model: "anthropic/claude-opus-4.8",
});
In questo esempio, il modello è definito in una singola riga. Sono supportati i fallback tramite AI Gateway. Le istruzioni, definite in un file Markdown, diventano il prompt sistema che eve aggiunge a ogni chiamata modello.
Un agente è una directory
Secondo Vercel, i team hanno bisogno di una struttura standard per agenti che soddisfi gli stessi requisiti. eve trasforma questa struttura in un framework.
L'organizzazione della directory mappa ogni capacità a una cartella:
- agent.ts: definisce il modello e la configurazione runtime (formato TypeScript)
- instructions.md: istruzioni dell'agente (formato Markdown)
- tools/: strumenti che l'agente può eseguire (filename = nome strumento, formato TypeScript)
- skills/: conoscenze dell'agente, caricate solo su richiesta (formato Markdown)
- connections/: collegamenti sicuri a server MCP e API OpenAPI (formato TypeScript)
- sandbox/: opzionale, modifica l'ambiente di sandboxing
- subagents/: agenti specializzati a cui delegare (struttura directory)
- channels/: canali dove vive l'agente (TipoScript)
- schedules/: quando agisce autonomamente (TipoScript)
- lib/: codice condiviso all'interno dell'agente (TipoScript)
Che cosa include il framework
Secondo Vercel, l’eve ha un concept “batterie comprese” (batteries included), offrendo sei caratteristiche principali:
Esecuzione duratura
Ogni conversazione è rappresentata da un workflow duraturo, con ogni passo tracciato. La sessione può sospendere, sopravvivere a un crash o un deploy, e riprendere dove si era interrotta.
Esecuzione in sandbox
Ogni codice generato dagli agenti è considerato non attendibile. Gli agenti ricevono la propria sandbox per comandi del terminale, script e accessi ai file. Il backend è un adattatore, che utilizza Vercel Sandbox in produzione e Docker, microsandbox o just-bash in locale.
Approvazioni umane
Ogni azione può richiedere il consenso umano. L’agente si ferma e aspetta il feedback, senza costi di elaborazione. Dopo l’approvazione, eve prosegue dal punto dove si era fermato.
Connettori sicuri
Una connessione è un file che punta a un server MCP o un'API conforme OpenAPI. eve si occupa dell'autenticazione, nascendo URL e credenziali al modello. Al lancio, gli agenti possono collegarsi a Slack, GitHub, Snowflake, Salesforce, Notion e Linear.
Canali
Lo stesso agente serve diverse superfici. L'API HTTP è attiva di default, con supporto per Slack, Discord, Teams, Telegram, Twilio, GitHub e Linear. Un canale può passare un task a un altro canale.
Tracciatura e valutazioni
Ogni esecuzione genera un tracciato con OpenTelemetry. Questi vengono esportati a Braintrust, Honeycomb, Datadog o Jaeger. Le valutazioni sono insiemi di test eseguibili localmente o integrabili in CI.
Casi d'uso
Vercel ha pubblicato sei agenti implementati internamente utilizzando eve:
- d0 – Analista dati: il loro strumento interno più utilizzato, che gestisce più di 30.000 domande al mese.
- Lead Agent – SDR autonomo: lavora ogni nuovo lead seguendolo autonomamente. Vercel riferisce che costa circa 5.000 dollari all'anno e restituisce 32 volte questa cifra, mantenendosi con mezzo ingegnere.
- Athena – Cockpit vendite: costruito in sei settimane senza ingegneri, risponde a domande sul processo di vendita da Snowflake e Salesforce.
- Vertex – Ingegnere supporto: gestisce ticket nei centri di aiuto, documentazione e Slack. Riesce a risolvere il 92% dei ticket autonomamente.
- draft0 - Agente di contenuti: fa un controllo preliminare automatico individuando problemi evidenti prima che un editore umano lo legga.
- V – Agente di routing: i task vengono inviati inizialmente a V su Slack, che li indirizza all'agente appropriato.
Simulazione interattiva
Contrariamente ad altri framework, eve fornisce la struttura necessaria già definita. Di seguito, una tabella confronta il lavoro tipico per costruire un stack a mano con ciò che eve fornisce:
| Funzionalità | Stack DIY | eve |
|---|---|---|
| Autore | Loop personalizzato, registrazione manuale degli strumenti | File in una directory, rilevati in fase di costruzione |
| Duratura | Gestione personalizzata di stato e retry | Ciclo di tracciamento di workflow per ogni sessione |
| Calcolo in codice | Contenitori o VM gestiti in modo autonomo | Sandbox per agente tramite adattatore commutabile |
| Approvazioni | Logica di sospensione e ripresa personalizzata | Campo needsApproval per qualsiasi azione |
| Superfici | ← Back to news