How to write good instructions for your AI agent
Learn how to write clear instructions so your AI agent replies with the right tone, limits and actions.
Watch this step in the video · Instructions: the editor
Instructions are the heart of your AI agent: they define how it talks, what it can do and where its limits are. A good instruction turns a generic assistant into one that sounds like your brand and actually solves problems.
Start with role and goal
Before asking for specific behaviors, tell the AI who it is and why it exists.
- Define the role: "You are the sales assistant for Aurora Furniture."
- Define the main goal: book visits, answer product questions, collect payments.
- Set the language and tone: friendly, formal, with or without emojis.
Be specific and structured
The AI follows instructions better when they are concrete and organized.
- Write in short, direct sentences.
- Group by topic with headings (Hours, Prices, Returns).
- Use lists for rules that allow no exception.
- Add examples of replies you like.
Set clear limits
Just as important as what the AI should do is what it should NOT do.
- State forbidden or sensitive topics.
- Mark when it should escalate to a human (see the handoff article).
- Tell it to never invent prices, stock or policies that aren't in the instruction or knowledge base.
Connect to actions and tools
Your agent can run actions: book appointments, tag contacts, create deals. In the instructions explain when to use each one.
- "If the customer wants a visit, offer the available times and book the appointment."
- "If they ask to talk to a person, hand off to a human agent."
Iterate with real data
You won't write the perfect instruction on the first try.
- Review real conversations and spot weak replies.
- Adjust one rule at a time to understand the effect.
- Test every change in the sandbox before publishing.
Final tip: treat instructions like an employee handbook, not a magic spell. The clearer and more specific you are, the more predictable and useful your agent will be.
Related articles
-
Create your first AI agent
Learn what an AI agent does in Omnifox, how to give it instructions, connect it to a channel and test it in the sandbox before it talks to real customers.
-
AI Agents complete guide
AI Agents in depth, in 65 chapters: creating, instructions, tools, knowledge, behavior, tester, inbox, workflows, analytics and usage, with every setting explained.
-
Connect your AI agent to WhatsApp, Instagram, Messenger and web chat
An agent with no channels serves nobody. Connect it to your WhatsApp, Instagram, Messenger or website chat from the Connections section, then switch it on so it starts replying.
-
Start here: AI Agents in 8 minutes
AI Agents essentials in a short video: creating an agent, its instructions, tools, knowledge, channels, the tester, hours and handing over to a person.
-
How to test your agent in the sandbox
Use the sandbox to chat with your AI agent and validate replies, actions and tone before publishing it.