Introduction

This article explains how to write clear, effective instructions for BlueCloud AI Agents. Well-written instructions define how your agent behaves, what it can handle, and when it should escalate—much like onboarding a new employee who answers your phones.

Strong instructions are the single most important factor in predictable, high-quality agent behavior.

 

What the Instructions Tool Does

The Instructions tool defines:

  • Who the agent is
  • What it supports
  • How it should communicate
  • What actions it should and should not take

Think of this as the internal playbook your agent follows on every interaction.

 

How to Think About Agent Instructions

When writing instructions, imagine training a new hire who will answer calls without supervision.

Ask yourself:

  • What questions will callers ask repeatedly?
  • What decisions should the agent be allowed to make?
  • Where should the agent stop and escalate?

Clarity here prevents improvisation and inconsistent outcomes.

 

While instructions can be written freely, the following structure produces the most reliable results:

1. Personality

Define tone, demeanor, and speaking style.

Example:

  • Friendly but professional
  • Calm and concise
  • Conversational, not scripted

 

2. Greeting

Specify exactly how the agent should answer calls.

Include:

  • Business name
  • Agent name (if applicable)
  • An open-ended offer of help

 

3. Information Handling

Define how the agent should provide common information such as:

  • Hours of operation
  • Location
  • Services or offerings

Keep responses factual and concise.

 

4. Special Conditions or Promotions

If applicable, outline how the agent should mention:

  • Daily specials
  • Limited-time offers
  • Policies or restrictions

Avoid unnecessary detail unless the caller asks for it.

 

5. Availability, Wait Times, or Scheduling

If the agent handles reservations or scheduling, define:

  • Accepted time windows
  • Party size limits
  • Required caller information
  • Confirmation and repetition rules

Be explicit about what the agent cannot accept.

 

6. Escalation and Closing

Define:

  • When to transfer or hand off
  • How to gracefully close the conversation if no action is taken

 

Example: Restaurant AI Agent Instructions

Below is a structured example of instructions for a restaurant AI Agent:

Personality
You are a friendly and energetic hostess. Speak naturally and remain professional.

Greeting
"Hello! Thank you for calling Ginko Sushi. My name is Jillian. How can I help you today?"

Hours of Operation
"We are open Monday through Friday from 12 PM to 9 PM, and Saturday and Sunday from 12 PM to 10 PM."

Daily Specials
"Today’s specials include a Spicy Rainbow Roll for $18 and a Lobster Roll paired with a Filet Roll for $29. Would you like more details on either option?"

Wait Time Handling
"Current wait times are approximately 30 to 45 minutes. Ask if the caller would like to add their name for call-ahead seating."

Location
"We are located at 12160 West Parmer Lane, Cedar Park, Texas."

Reservations

  • Accept reservations between 6:45 PM and 8:30 PM today
  • Future dates are available during all operating hours
  • Ask for party size, seating preference, preferred time, name, and phone number
  • Do not accept reservations for parties over 8
  • Repeat reservation details before confirming

Closing (No Reservation)
"Thank you for calling Ginko Sushi. We hope to serve you soon. Have a great day!"

 

Best Practices

  • Be specific: Vague instructions lead to unpredictable behavior
  • Reflect your brand: Tone and wording should match how your business communicates
  • Update regularly: Keep hours, pricing, and policies current
  • Test often: Call your agent and listen critically

 

Common Mistakes to Avoid

  • Overloading instructions with unnecessary detail
  • Leaving escalation behavior undefined
  • Allowing the agent to make assumptions
  • Forgetting to update instructions after business changes

 

Conclusion

Clear instructions are the foundation of a reliable AI Agent. When written thoughtfully, they ensure consistent interactions, reduce errors, and create a better experience for both callers and staff.

 

FAQ

Q: How detailed should instructions be?
A: Detailed enough to remove ambiguity, but not so verbose that responses feel robotic.

Q: Can instructions be changed after deployment?
A: Yes. Instructions can be updated at any time and should evolve with your business.

Q: Do instructions control escalation behavior?
A: Yes. Clear escalation guidance should always be included.