Build an agent with eve
In this workshop, we recommend Free Build: create an agent around your own idea, connect it to an external capability, and prepare a focused demo. A guided support-agent build is also available if you prefer to learn each concept in sequence.
Eve is a filesystem-first framework for agents. You describe an agent with files under agent/; eve supplies the durable runtime, streaming sessions, channels, sandboxes, approvals, and eval harness around it.
Redeem AI Gateway credits
Go to credits.vercel.sh and follow the instructions. You will need:
- a Vercel account
- the
team_IDfor the Vercel team that should receive the credits - the workshop redemption code, provided by email or onsite
- after redemption, your credits will appear at
https://vercel.com/TEAM_SLUG/~/ai-gateway. ReplaceTEAM_SLUGwith your Vercel team slug
Choose your path
| Path | Best for | Outcome |
|---|---|---|
| Free Build — Recommended | You want to start from an idea that interests you and learn by building | Build and demo an agent with a clear job and at least one external connection or integration |
| Guided Support Agent | You prefer more structure or want to learn each concept in sequence | Build, deploy, observe, and extend a support-triage agent with Slack, Supabase, and human approval |
Workshop outcomes
| Free Build — recommended | Guided build |
|---|---|
| Define an agent around a problem that interests you | Follow a clear support-triage role defined in Markdown |
| Add at least one external connection or integration | Call a typed tool instead of inventing account data |
| Demonstrate one useful end-to-end behavior and one boundary case | Run locally, respond in Slack, and deploy to Vercel |
| Leave behind local traces and Agent Runs you can inspect | |
| Use eve's native Supabase MCP connection through per-user OAuth | |
| Pause for human approval before a sensitive mutation |
Both paths finish with deterministic evals and an optional model-graded quality check.
Workshop path
| Stage | Free Build path — recommended | Guided path |
|---|---|---|
| Start | Free Build defines your own agent, audience, and job | Setup & Scaffold creates the support agent and connects a model |
| Build | Add an external capability, test three behaviors, and prepare a demo | Add a typed tool, Slack, observability, Supabase, and human approval |
| Validate | Complete Free Build in Evals | Complete Guided Build in Evals |
| Reference | Use the Useful Links, Framework FAQ, and Advanced Runtime when you want more context. | Use the Useful Links, Framework FAQ, and Advanced Runtime when you want more context. |
Before you start
- Install Node.js 24 or newer.
- Create a Vercel account.
- For the guided path, have access to a Slack workspace where you can install an app.
- Use a model, provider, and connected services that meet your data and compliance requirements.
Eve is currently in preview. APIs and behavior may change before general availability, so use the current docs and CLI output as your source of truth.