Creating Handlers

Handlers are AI agents on Handle — built by your team, for your team. Each Handler can be given a distinct role, persona, skills, and permissions, so you can create capable, secure, and user-friendly agents that your people can interact with directly in Slack.

Ready to build one? Here's how.

Step 1: Choose a Template

When you click Create Handler, you'll first be asked to pick a template. Templates give you a head start with pre-configured settings tailored to common use cases. Pick the one that's closest to what you need — you can always customise from there.

Step 2: The Basics

This is where your Handler gets its identity. You'll fill in:

• Name — What your Handler is called (choose wisely, first impressions matter)
• Email — A dedicated email address for the Handler
• Job title — The Handler's role (e.g. "Project Manager", "Support Agent")
• Purpose — A description of what this Handler is for and what it should do. This is the core prompt that shapes your Handler's behaviour, so be as clear and specific as you can.

Step 3: Tone of Voice

This is where you shape how your Handler communicates — because what you say matters, but so does how you say it.

You'll configure two settings:

• Speaking with others — How the Handler talks to users and colleagues
• Speaking with me — How the Handler talks to you, its creator (toggle "Same as above" if you'd like it to be consistent, or set a different tone for your private conversations)