Back to the blog

Write instructions your AI phone agent will follow

A simple structure for agent instructions: role, tone, what to do, what never to do, and when to hand over. With before and after examples and a way to test them.

By Robofono team

5 min read

The difference between an AI phone agent that sounds helpful and one that frustrates callers is mostly the instructions. The agent does what you tell it, using the facts you gave it. If the instructions are vague, the calls will be too.

Good instructions are not clever. They are short, specific and ordered. This guide gives you a structure, examples of weak and strong wording, and a way to test.

Instructions and knowledge are different jobs

Keep these apart:

  • Knowledge holds facts: opening hours, prices, addresses, services, answers to common questions. It comes from your website pages, files, text and question-and-answer pairs.
  • Instructions hold behavior: how to greet, how to speak, what to ask, what to do when the answer is unknown, when to hand over.

Mixing them makes both worse. A price buried in the instructions is easy to forget when it changes. A rule about tone buried in a pile of facts is easy to miss. Facts go in knowledge, and you republish when they change. Behavior goes in instructions.

A structure that works

Write in 6 short sections. Plain sentences are enough.

1. Role

Say who the agent is and who it works for.

You answer the phone for Bright Smile Dental, a dental practice. You help callers book appointments, answer questions about the practice, and take messages for the team.

2. Tone

Describe how it should sound, with 3 or 4 traits and one example.

Be warm, calm and brief. Use short sentences. Do not use slang. Address callers by name once you know it.

3. What to do on the common calls

List the calls you get most, each with the steps.

Booking: ask what the visit is for, whether the caller has visited before, and which day suits them. Offer 2 times. Collect name and phone number. Confirm the booking back.

Opening hours and location: answer from the knowledge. Offer to book if the caller sounds interested.

4. What never to do

Write down your limits as direct statements.

Never give medical advice. Never quote a price that is not in the knowledge. Never promise a callback time. Never say you are a person.

5. What to do when you do not know

This one section prevents most bad calls.

If you do not know the answer, say so plainly and offer to take a message or to transfer the call. Do not guess.

6. When to hand over

Say which calls go to a human, and what to do when nobody is there. See transfer the call or take a message for how to choose.

Transfer the call if the caller says it is urgent, asks for a named person or says they are in pain. If nobody answers the transfer, take a message with the caller's name, number and reason, and tell them someone will respond. Do not state when.

Weak and strong wording

The same idea, written two ways.

Weak Strong
"Be helpful and professional." "Be warm and brief. Answer in 1 or 2 sentences, then ask 1 question."
"Handle bookings." "For a booking, ask the service, then the day, then offer 2 times, then collect name and number."
"Don't say anything wrong." "If the answer is not in your knowledge, say you do not know and offer a message."
"Be careful with emergencies." "If the caller describes an emergency, tell them to contact emergency services now, then offer to transfer."
"Make the caller happy." "If the caller is upset, apologize once, restate the problem in 1 sentence, and offer a message or a transfer."

Strong instructions use verbs, numbers and order. Weak ones use adjectives.

Keep it short enough to follow

Long instructions do not make the agent smarter. They bury the rules that matter. If your list of rules passes a page, split the content: facts go to knowledge, and you keep only behavior in the instructions. Check each sentence with one question: if I removed it, would a call go worse? If not, delete it.

Write the rule once. Contradictions are the usual reason an agent does something odd. If one line says "always offer a booking" and another says "do not push sales", the agent has to choose, and the call will show it.

Plan for the awkward calls

Add a line for each of these you expect:

  • A caller who will not give a name. "Book without a name only if the caller refuses twice, and mark the booking as 'name not given'." Or just take a message.
  • A caller who asks for something you do not offer. "Say we do not offer that, and name what we do offer."
  • A caller who asks for a price that varies. "Give the starting price from the knowledge and say the exact price depends on the job."
  • A caller who asks if it is a robot. The agent will say it is an AI. Do not instruct otherwise.
  • A caller who wants a different language. The agent speaks English, Dutch and German. Say what to do for anything else, such as taking a message with the caller's number.

Test, read, adjust

Instructions are a draft until you have heard them used. Use the browser test call before going live. It lasts up to 3 minutes and counts toward your minutes, so go in with a script:

  1. A normal call on your busiest topic.
  2. A question you did not teach.
  3. A caller who interrupts or changes their mind.
  4. An upset caller.
  5. A request that should end in a transfer.

After each call, read the transcript. Find the exact moment it went wrong, and change the one line responsible. Republish, then call again. Change one thing at a time, so you know what fixed it.

When you are live, the call list shows the summary, the outcome and the transcript of every call. Read 10 calls a week at the start and fix one thing each time. The rate of change drops fast.

Where to start

If you have not set up an agent yet, the afternoon plan shows the order. The agent from your website gives you a first draft of the instructions, and you can edit it with the structure above.

To try it, start a 7-day FREE trial: you get 10 minutes and pay nothing up front. See the pricing page for the plans that follow.

More from the blog

Let Robofono answer your next call

Set up an AI phone agent in minutes. 7-day FREE trial, no credit card required.

7-day FREE trial, no credit card required. Nothing is charged unless you add a card.