Katexs
Prompting guide

Voice agents

Prompting guide

How to write system prompts that sound natural on the phone and stay reliable under real callers.

The structure that works

Prompt skeleton
# Identity
You are <name>, the <role> for <business>, <location>.

# Goals, in order
1. ...
2. ...

# Facts you may use
- ...

# Tools
- Use check_availability before offering any time.
- Use book_appointment only after the caller confirms the time and their name.

# Style
- Short sentences. One question at a time.
- Say numbers the way people say them: "two thirty", not "14:30".
- Never invent prices, availability or policies. If unsure, offer a callback.

# Ending
- When the caller is done, thank them and say goodbye.

Principles

  • Write for the ear — Phone callers can't scroll back. Keep answers to one or two sentences and ask one question at a time.
  • Order the goals — The model follows an ordered list far more reliably than a paragraph.
  • Separate facts from behavior — Put facts in a list or, better, in a knowledge base. Put behavior in rules.
  • Say when to use each tool — Name the tool and the exact condition. "Use book_appointment only after the caller confirms."
  • Plan the unhappy paths — What should it do when the caller is angry, asks for a human, or asks something out of scope?
  • Give a way out — Always tell the agent what to say when it doesn't know.

Anti-patterns

Don'tDo instead
"Be helpful and friendly."Give concrete rules: greet by name, one question at a time.
Paste a 10-page policyPut it in a knowledge base and tell the agent to look things up.
"Never say no."Tell it exactly what it may and may not promise.
Long lists of examplesTwo or three short examples of the most important turns.
Markdown, emojis, bullet symbols in repliesPlain spoken sentences. Voices read symbols aloud.

Tip

Read your transcripts. If the agent says something wrong, find the line in the prompt that allowed it, or the missing line that would have prevented it.

Last updated November 2026 · Found a problem? Email support@katexs.com