eve Slack Agent

The eve Slack Agent is a Vercel-deployable template for building Slack agents on the Eve framework, bundling webhook handling, Vercel Connect credential management, a starter agent, and an example tool.

What is the eve Slack Agent?

The eve Slack Agent is an example template from the Vercel eve-examples repository that gives you a working Slack agent powered by the Eve framework. It accepts Slack events through a webhook at /eve/v1/slack, processes them with an agent defined in agent/agent.ts, and returns responses through Slack. It runs on Vercel, uses Vercel Connect to manage Slack credentials, and deploys with a one-click Vercel button.

Key Features

• One-click Vercel deployment — Deploy directly using the Vercel Deploy button, which clones the repository, connects the Slack app, and sets the SLACK_CONNECTOR environment variable.
• Webhook handling — Includes a preconfigured trigger path /eve/v1/slack for receiving Slack events.
• Vercel Connect integration — Vercel Connect manages the Slack channel's credentials, so you don't need to configure tokens manually.
• Starter agent file — Modify agent/agent.ts to define your agent's logic.
• Instructions-driven behavior — Agent behavior is documented in agent/instructions.md and auto-updates as you edit the files.
• Example tool included — The template ships with one example tool in agent/tools/ to show how tools are structured.
• Local development with pnpm — Run vercel link, vercel env pull, then pnpm dev to start a dev server.
• Bundled Eve guides — After installing dependencies, the Eve framework's documentation is available locally in node_modules/eve/dist/docs/public/.

Who is it for?

• Developers building Slack bots — Use the starter agent and example tool to create custom Slack responses without setting up webhook plumbing.
• Vercel users — Leverage Vercel Connect to manage Slack credentials across environments.
• Eve framework learners — Explore a real Eve project structure, including instructions, tools, and local docs.

What can you do with the eve Slack Agent?

• Slack team members: message the agent in Slack and receive responses generated by the Eve-driven agent.
• Developers: extend the agent by adding new tools in agent/tools/ and updating instructions in agent/instructions.md.
• Prototypers: quickly deploy a working Slack agent to test a product idea before building more integrations.

How does the template work?

• Deploy via the Vercel Deploy button or clone the eve-slack-agent-template directory from the eve-examples repository.
• Link the project locally with vercel link, pull environment variables with vercel env pull, then start the development server with pnpm dev.
• Edit agent/agent.ts, agent/instructions.md, and agent/tools/ — the agent updates automatically as files change.

FAQ

How do I deploy the eve Slack Agent?

Click the Deploy with Vercel button, which creates a new Vercel project, connects your Slack app, and sets up the SLACK_CONNECTOR environment variable through Vercel Connect. Alternatively, clone the template from the eve-examples GitHub repository and deploy it manually.

Where do I edit the agent's behavior?

Agent behavior is defined in agent/instructions.md, and the logic is in agent/agent.ts. Tools are stored in agent/tools/. Edits to any of these files auto-update the running agent.

How do I run the project locally?

Run vercel link to link the project, vercel env pull to pull environment variables, and pnpm dev to start the development server. The local Eve guides are available at node_modules/eve/dist/docs/public/ after installing dependencies.

What does Vercel Connect do in this template?

Vercel Connect manages the Slack channel's credentials, as described in the template's Vercel deployment setup. It sets the SLACK_CONNECTOR environment variable, so you don't handle Slack tokens directly.