Documentation
Your first Specialist
How to train, test, and tune an AI Specialist so it sounds like your business — not a call centre.
A Specialist is only as good as what you teach it. The good news: teaching it well takes an afternoon, not a project plan. This guide covers the three things that separate a great Specialist from a mediocre one.
Write knowledge like you'd brief a new hire
The knowledge base isn't a legal document — it's the briefing you'd give a sharp new employee on their first day. Concrete beats comprehensive:
- Good: "Standard bathroom reno runs $12k–$25k depending on size. Never quote a fixed price on the phone — book a site visit."
- Not useful: "We offer competitive pricing on a range of renovation solutions."
The Specialist handles conversation on its own. Your job is the facts and boundaries: what things cost, what's bookable, what's off-limits, what gets escalated.
Set the voice deliberately
Under Specialist → Voice & Tone, you choose how it sounds and how it talks. Three settings matter most:
- Introduction — how it answers. "Thanks for calling Apex Plumbing, this is Ivy" works for most businesses. If you want explicit AI disclosure up front, set it here.
- Register — from "warm and casual" to "polished and formal". Match your counter, not your lawyer.
- Pace rules — short answers by default, detail only when asked. Callers hang up on lectures.
Define the handoff before you need it
Every Specialist needs to know when a human takes over. Set escalation rules under Specialist → Handoffs:
- Always transfer: angry callers, legal or complaint language, anything involving a refund over your threshold.
- Transfer when available: named-person requests, negotiations, VIP accounts.
- Never handle: whatever you decide is human-only — the Specialist will take a message and book a callback instead.
Warm transfers include a spoken summary to the human picking up, so nobody asks the caller to repeat themselves.
Review the first twenty calls
For the first few days, skim every transcript (Calls → Review queue). You're looking for two things: answers you'd phrase differently — fix the knowledge, not the transcript — and questions it couldn't answer, which are missing knowledge entries. Specialists improve in exactly one way: you making the briefing better. Twenty reviewed calls in, most businesses stop finding things to fix.