---
title: "eve Slack Starter"
description: "Build a Slack agent with eve using an example tool and skill. Customize its behavior, test locally, and deploy on Vercel."
url: "https://vercel.com/templates/eve/eve-slack-agent"
links:
  repository: "https://github.com/vercel/eve/tree/main/apps/templates/eve-slack-agent-template"
  deploy: "https://vercel.com/new/clone?demo-title=eve+Slack+Agent&demo-description=An+eve+template+for+Slack+agents+with+webhook+handling%2C+Vercel+Connect%2C+a+starter+agent%2C+and+an+example+tool+ready+to+deploy+on+Vercel.&project-name=eve+Slack+Agent&repository-name=eve-slack-agent&repository-url=https%3A%2F%2Fgithub.com%2Fvercel%2Feve%2Ftree%2Fmain%2Fapps%2Ftemplates%2Feve-slack-agent-template&connect=%5B%7B%22type%22%3A%22slack%22%2C%22env%22%3A%22SLACK_CONNECTOR%22%2C%22triggers%22%3Atrue%2C%22triggerPath%22%3A%22%2Feve%2Fv1%2Fslack%22%7D%5D&demo-image=%2F%2Fimages.ctfassets.net%2Fe5382hct74si%2F44UAmDfYVY2HnD7eadzkKB%2Fafd723b9b8b898ea022335366872d2ab%2Feve-slack-conversation-3x.png&demo-url=https%3A%2F%2Fvercel.com%2Fkb%2Fguide%2Feve-slack-agent-starter"
---

# eve Slack Starter

Build a Slack agent with eve using an example tool and skill. Customize its behavior, test locally, and deploy on Vercel.

# eve Slack Starter

[eve Slack Starter](https://vercel.com/templates/eve/eve-slack-agent) is a minimal template for developers building a Slack AI agent. It includes an agent with model configuration and instructions, a Slack channel, and examples of a tool and a skill. Deploy it to Vercel, mention the bot in a channel, and it replies in a thread.

## What can you build with this template?

The included weather tool returns sample data, and the trip-planning skill demonstrates how the agent follows a procedure. Together, they show how artificial intelligence agents combine callable tools with task-specific instructions.

The agent's files separate the parts you can customize:

| File | Purpose |
| --- | --- |
| `agent/agent.ts` | Select the model |
| `agent/instructions.md` | Define the agent's behavior |
| `agent/channels/slack.ts` | Configure the Slack connection |
| `agent/tools/get_weather.ts` | Demonstrate a tool with a validated input and sample result |
| `agent/skills/plan_a_trip.md` | Provide instructions for trip-planning requests |

eve discovers tool and skill files, so you can build AI agents by adding files for your workflow.

## Why use this template?

When defining your own Slack workflow, the best AI agent starter is one whose behavior you can inspect and change. This template lets you trace a request through the Slack channel, then see how the agent calls its sample tool or follows its skill. You can replace those examples file by file while keeping the channel connection, learning the framework as you turn the starter into your own agent.

## Why use eve on Vercel?

eve is an [AI agent framework that runs conversations as durable workflows](https://vercel.com/docs/frameworks/agents/eve). A Slack thread maps to an agent session, so follow-up requests in that thread continue its conversation.

The starter uses [Vercel Connect for Slack credentials and request verification](https://vercel.com/docs/connect). Model calls go through [AI Gateway](https://vercel.com/docs/ai-gateway) with the linked Vercel project's credentials. This setup handles the Slack bot token and model authentication while you work on the agent's behavior.

## What should you know before deploying?

Follow the [Slack starter setup guide](https://vercel.com/kb/guide/eve-slack-agent-starter) to deploy and install the bot, then invite it to a channel. Its default behavior requires another mention for each follow-up in a thread. Automatic thread following needs changes to the Slack channel configuration.

Install dependencies, link the Vercel project, and pull its environment before running `pnpm dev` locally. Use the terminal UI to test the agent and its examples. Test Slack delivery against a preview or production deployment because Vercel Connect sends events to deployed projects.

Replace the sample weather result before using the tool for real forecasts. Third-party APIs you add may need credentials beyond the starter's Vercel-managed Slack and model authentication.

## Frequently asked questions

### Does the included weather tool return live forecasts?

No. The get_weather example returns sample weather data to demonstrate a tool call. The plan_a_trip skill uses that example as part of a trip-planning procedure and instructs the agent not to describe it as current weather.

### Do I need to mention the bot again in a Slack thread?

Yes. The starter answers channel mentions and direct messages, and each channel-thread reply needs a mention. You can customize its Slack channel to follow replies without a mention.

### Do I need Slack secrets or a model provider API key?

Vercel Connect manages the Slack bot token and verifies incoming requests. AI Gateway authenticates model calls through your linked Vercel project, so this starter does not require a separate model provider key. Tools you add for other services may require additional credentials.

### Can I test the starter without sending Slack messages?

Yes. Run pnpm dev to chat with the agent in eve's terminal UI and try its tool and skill. To verify the Slack connection itself, use a preview or production deployment.

### How do I add my own tools and skills?

Place TypeScript tools in agent/tools/ and Markdown skills in agent/skills/. eve discovers them from the filesystem without a separate registration step. Edit agent/instructions.md for general behavior and agent/agent.ts to change the model.

## Related resources

- [Customize Slack reply behavior](https://eve.dev/docs/channels/slack)
- [Add tools to an eve agent](https://vercel.com/kb/guide/how-to-add-eve-tools)
- [Slack Starter source and setup](https://github.com/vercel/eve/tree/main/apps/templates/eve-slack-agent-template)

## Related Templates

### [eve Contentful Agent](https://vercel.com/templates/eve/eve-contentful-agent)

Manage Contentful from Slack with eve. Query synced content, edit drafts, upload assets, and review publication requests.

### [eve Marketing Team](https://vercel.com/templates/eve/eve-marketing-team)

Coordinate a marketing lead and five specialist agents in Slack, with Notion drafts, Typefully posts, and Resend email campaigns.

### [eve Personal Agent](https://vercel.com/templates/nuxt/eve-personal-agent)

Build a personal eve assistant with persistent web chat, linked Slack identity, optional iMessage, and per-user memory.

---

## Additional documentation

The [Vercel Knowledge Base](https://vercel.com/kb) contains guides and answers to common questions about Vercel, including deployment, framework configuration, domains, caching, and troubleshooting.
