Agents & knowledge
Writing effective agent instructions
Instructions are the highest-leverage part of an agent. What works:
- State the role in one line. "You are the front desk for Northside Plumbing in Leeds."
- List the tasks explicitly. Booking a visit, answering what the call-out costs, taking a message — name each one and what information to collect.
- Set boundaries. What the agent must never do. For a trade that means: never quote a price or an arrival time that isn't written down for it, and never talk a caller through a repair — it cannot see what they are looking at, and that is how somebody gets hurt.
- Define the handoff. When to take a message, and what to do with anyone who asks to speak to a person. They get one; the agent takes the name, the number and one line about the problem, and says when somebody will ring back.
- Keep answers short. Phone conversations are turn-based; tell the agent to answer in one or two sentences and let the caller steer. Long monologues make callers hang up.
Avoid contradictory rules and huge pasted documents — put your price list, your service area and your hours in the knowledge base instead, and keep instructions about behavior.