Loading pattern preview
BlocksAgent Patterns
Eve Simple Tool Agent
Eve Simple Tool Agent
Build and verify a filesystem-first Eve agent with a typed weather tool and deterministic eval suite. Runs without provider credentials.
Use this when you are starting your first Eve agent and want one typed tool plus deterministic evals that run without any provider API keys.
Loading pattern preview
Problems solved
Technical challenges this implementation handles out of the box.
- Scaffold a durable Eve agent from a complete filesystem artifact
- Define a typed tool with validated input and output
- Verify agent discovery, tool calls, output, and replies before shipping
- Run the full test loop without API keys or provider credentials
Use cases
Products and workflows this pattern is designed to support.
- Learning Eve project conventions
- Starting a tool-using backend agent
- Building deterministic smoke tests for an agent
- Validating an Eve Pattern before publishing it
Compare with
Similar patterns, and when each one is the better fit.
Eve Scheduled Digest AgentUse this when you need to test cron and dynamic schedule dispatch for an Eve agent deterministically, without provider credentials.
Eve Long-Term Memory AgentUse this when your Eve agent needs per-user memory it can save, list, and forget, injected as context before every turn and isolated by tenant.
Eve Triage Orchestrator AgentUse this when one support message mixes intents and an Eve coordinator should split it across declared specialist subagents running in parallel.
Eve Approval-Gated Operations AgentUse this when an Eve agent must pause sensitive operations like refunds or deploys until a person approves, then resume the same durable turn.
Setup
Requirements, wiring steps, and what this pattern adds to your project.
Getting started
Pick how you want to pull this pattern in. Then wire env vars and routes the same way.
- 1
Download → Eve agent
Use Download → Eve agent in the preview toolbar. The zip is the standalone project artifact, without a Next.js wrapper.
- 2
Extract the zip and install dependencies
Use Node.js 24 or newer, then run `pnpm install`.
- 3
Verify the Pattern before editing it
Run `pnpm verify:discovery`, `pnpm typecheck`, `pnpm build`, and `pnpm eval`.
- 4
Run the Eve development server
Run `pnpm dev` after the verification suite passes.
Files added
10 files
package.jsontsconfig.jsonREADME.md.gitignore.node-versionagent/agent.tsagent/instructions.mdagent/tools/get_weather.tsevals/evals.config.tsevals/weather.eval.ts
Dependencies
3 total
npm packages
3AISDKeveZod
Requirements
- Complexity
- Beginner
- Setup time
- ~5 minutes
- Node
- 24+
- Memory
- 256MB
