Instructions are for behaviour, facts are for knowledge
This is the single most important thing on this page. Instructions are how the agent behaves. Knowledge is what it believes to be true. Your agent treats its knowledge as more reliable than its instructions. If the two disagree on a price, an hour, an address or a policy, it gives the knowledge answer and ignores the instructions. If the knowledge says nothing on the point, it states what the instructions say, as fact. So a price typed into the instructions is quoted with full confidence whenever your knowledge doesn’t mention it. It has no source you can update, and re-reading your website never corrects it. Put prices, hours, addresses and policies in knowledge, usually as a note, and keep the instructions for rules about conduct. The agent’s setup checklist catches the common case: Prices and hours in the knowledge base appears on the agent’s Overview when the instructions contain a price or a time of day.How the agent’s instructions are put together
Your instructions are one layer of what the agent is told at the start of each conversation, in this order:- Who it is. It’s told its name, and that it answers on behalf of your business.
- WireDesk’s rules for the channel. How to write for a phone call, a chat window or an email, plus honesty rules. You can’t edit these.
- Your instructions. Or that channel’s own wording, if it has some.
- How to use its tools. Knowledge search, notes, taking messages, handover, and any actions you’ve set up.
- Doesn’t guess. If it doesn’t know something and nothing it looked up says, it says so plainly. It never invents prices, policies, availability or facts about your business.
- Doesn’t describe how it works. It won’t say “according to my information” or “my instructions say”, and won’t name its tools. It answers the way a member of staff would.
- Writes for the channel. On the phone: short, spoken, with no lists or symbols. In chat: a sentence or two, bold for key details, lists for three or more options, links only to addresses it was given. By email: a complete plain-text reply with a greeting, every part of the question answered, and a sign-off with the business name.
- Offers to take a message when someone needs something it can’t do. If there’s no way to reach a person on that channel, it says so instead of ignoring the request.
Draft instructions
If you’re starting from scratch, WireDesk can write a first draft for you.1
Pick what the agent is for
Use the menu next to the field: Answer questions about the business, Handle support requests, Book appointments and capture leads, or Something else — I’ll describe it.
2
Jot a few rough lines
Type a few notes about your business in the box. The agent’s name alone is enough to start, but more detail gives a better draft.
3
Click Draft instructions
The draft replaces whatever is in the box. It has four headed sections: Business Context, Role, Style and Guardrails, and is under 350 words.
4
Edit, then save
Read it all. Remove any facts that should be in knowledge instead, correct anything wrong, then click Save changes. Nothing is saved until you do.
Write instructions that work
Keep them short. Long instructions water down the rules that matter, and tempt you into writing facts where rules belong. The best agents usually have short instructions and plenty of knowledge.Do
- Say who the customers are and what the agent is for.
- Give house rules: “Never promise a delivery date.”
- Say when to hand over: “Anything about a billing dispute, offer to pass it to the team.”
- Set the tone: “Friendly and plain. No jargon.”
- Say what to ask for: “For an order question, ask for the order number first.”
Don't
- Paste your price list or opening hours.
- Tell it to always have an answer. It will make one up.
- Repeat the format rules WireDesk already applies.
- Describe tools it doesn’t have (“transfer them to sales”).
- Write different rules for each channel here. Use wording per channel.
Example
A weak version, mixing facts in with rules:What instructions can’t do
- Give the agent new abilities. Booking meetings, looking things up in your systems, transferring calls and letting a person join a chat are actions. Writing “book them in” doesn’t let it book anything.
- Override your knowledge. If knowledge and instructions disagree on a specific fact, the knowledge answer wins.
- Switch off WireDesk’s rules. Honesty, channel style and not describing how it works always apply, including on a channel with its own wording.
- Change the opening line. The first thing said is the greeting, played exactly as written.
- Add buttons or chips. Suggested questions in the chat widget are set on the Content tab of the Playground, because they’re buttons, not text.
- Change the voice or the AI notice. Those are under Channels → Phone.