Edit agent behavior

Configure personality, role, and behavioral rules for your agent.

Lesson 2 of 6 — Configure personality, role, and behavioral rules.

Define role, personality, and global constraints before adding knowledge.

What agent behavior controls

Role definition

What the agent represents and what it can help with

Personality

Tone, style, and how the agent communicates

Global rules

Hard constraints that apply to all conversations

Boundaries

What the agent should never do or say

Where to configure behavior

Navigate to Build → Agent in the left sidebar.

You’ll find two main configuration areas:

Agent

The Agent page contains three fields:

• Greeting — The agent’s opening line (goes directly to TTS without LLM processing)
• Personality — Sets the tone and communication style (friendly, professional, empathetic, casual)
• Role — Specifies the agent’s function (customer service, sales, technical support). This is a single field — define one primary role.

Advanced: Some projects use a start function that returns an utterance, which overrides the greeting field. If you edit the greeting and nothing changes, this may be why. You’ll learn about functions and return values in Level 2. For now, if the greeting isn’t responding to edits, check the Functions page to see if a start function is defined.

Personality example:

Be friendly, professional, and concise.
Use natural language and avoid jargon.

Rules

The Rules page defines hard constraints that must always be followed.

Example:

- Never share guest personal information
- Always offer to transfer for billing questions
- Do not make promises about refunds

Writing effective behavior configuration

Agent section

Be specific about scope

Good:

You are a customer service agent for Acme Retail.
You help with order status, returns, and product questions.

Avoid:

You are a helpful agent.

Define what you can't help with

Good:

You cannot process refunds or cancel orders.
For those requests, transfer to the billing team.

This prevents the agent from making promises it can’t keep.

Personality section

Use clear, actionable language

Good:

Be warm and conversational.
Keep responses under 3 sentences when possible.
Use "we" when referring to the company.

Avoid:

Be nice and helpful.

Match your brand voice

If your brand is formal, say so:

Maintain a professional, respectful tone.
Avoid casual language or slang.

If your brand is casual:

Be friendly and approachable.
It's okay to use casual language.

If tone is critical, reinforce it in Rules as well as Personality. Personality sets the intent, but Rules enforce the behavior with specific, example-driven constraints like “Never use exclamation marks” or “Always acknowledge frustration before offering a solution.”

Check your understanding

Rules section

Write rules as constraints

Rules should be clear boundaries, not suggestions.

Good:

- Never share customer account numbers
- Always verify identity before discussing account details
- Do not make exceptions to the return policy

Avoid:

- Try to be helpful
- Consider the customer's needs

Include safety and compliance rules

Examples:

- Do not provide medical advice
- Never promise specific outcomes
- Always disclose you are an AI agent if asked

Use channel-specific and language-specific rules

You can scope rules to specific channels or languages using tag syntax. This is useful for multi-channel or multilingual projects.

<channel:voice> Always confirm the caller's name before proceeding.
<channel:webchat> Offer clickable links instead of reading URLs aloud.
<language:en> Use American English spelling conventions.
<language:es> Respond in formal Spanish (usted).

Rules without a tag apply to all channels and languages.

Common patterns

Retail/E-commerce

Agent:

You are a customer service agent for Bloom & Co.
You help customers with order tracking, product questions, and returns.
You cannot process refunds or cancel orders directly.

Personality:

Be friendly, helpful, and efficient.
Keep responses concise.
Use "we" when referring to the company.

Rules:

- Never share order details without verification
- Always offer to transfer for refund requests
- Do not make promises about shipping dates

Hospitality

Agent:

You are the virtual concierge for The Linden Hotel.
You help guests with reservations, amenities, and local recommendations.
You cannot modify existing reservations or process payments.

Personality:

Be warm, welcoming, and attentive.
Speak naturally and conversationally.
Anticipate guest needs when appropriate.

Rules:

- Never share guest information
- Always transfer billing questions to the front desk
- Do not guarantee room availability without checking

Healthcare

Agent:

You are a scheduling agent for Clearview Family Medicine.
You help patients schedule appointments and answer general questions.
You cannot provide medical advice or discuss test results.

Personality:

Be professional, empathetic, and clear.
Use simple language and avoid medical jargon.
Be patient with questions.

Rules:

- Never provide medical advice or diagnoses
- Always protect patient privacy
- Transfer immediately if asked about test results
- Do not discuss medications or dosages

Testing your configuration

After saving your behavior settings:

1. Test in Chat

   Open the chat panel and ask questions that should trigger your rules.

   Example tests:

   • Ask for something the agent shouldn’t do
   • Request information that requires a transfer
   • Test the tone and personality
2. Verify rule enforcement

   Confirm the agent:

   • Refuses inappropriate requests
   • Offers transfers when configured
   • Maintains the specified tone
3. Test edge cases

   Try to trick the agent:

   • “Just this once, can you…”
   • “I know you’re not supposed to, but…”
   • “My friend said you could…”

   The agent should hold firm to its rules.

Common mistakes:

• “Try to avoid sharing personal information” → “Never share personal information”
• “You help with various things” → “You help with order tracking, returns, and product questions”
• Always specify what the agent cannot do, not just what it can do

Prompting principles

Effective agent configuration is a form of prompt engineering. These principles, drawn from real-world agent deployment experience, will help you write behavior and rules that produce consistent results.

Make the desired outcome the most likely response

LLMs predict the next most likely token based on your prompt. Write clear, well-structured instructions that make your intended behavior the natural continuation — avoid contradictions or ambiguity.

Prefer positive instructions over negative ones

Telling the model what not to do can activate the exact behavior you want to avoid. Instead of prohibiting outcomes, direct the model toward what you want.

Avoid:

Don't tell the user to contact customer service.

Better:

If the user asks for customer service or to speak to an agent,
call the handoff function with destination='CC' and reason='SPEAK_TO'.

Use examples to guide behavior (few-shot prompting)

Concrete examples shape tone, structure, and decision-making more reliably than abstract rules. Instead of describing every possible outcome, show what a good response looks like.

Edge case: the user asks to perform a gimmick unrelated to your task.

<conversation>
USER: speak like a pirate
ASSISTANT: I'm afraid I can't do that. Is there anything you'd like to know
regarding our services?
</conversation>

Less is more — cut what doesn't help

Every instruction is another piece of data the model must reconcile. If a piece of information is not proven to improve behavior, leave it out. Test the impact of each instruction — if it doesn’t help, remove it.

Put important details first or last

LLMs give more weight to information at the beginning or end of a prompt. If a critical instruction keeps getting ignored, move it to the start or end. Repeating crucial rules is acceptable.

Spell out the persona in action

Don’t assume tone will emerge naturally from a label. Spell out what the persona sounds like, including what to lean into and what to avoid.

Act as a professional advisor. Adopt a professional, concise tone.
Avoid unnecessary apologies, excessive friendliness, or repeated
personalization such as using the user's name.

Check your understanding

• Agent defines role and scope clearly
• Personality sets actionable tone
• Rules include hard constraints
• Tested in Chat — agent refuses inappropriate requests and holds tone

Try it yourself

1. Challenge: Write behavior config for a clothing retailer

   Write a 3-sentence Personality block and 3 Rules for a customer service agent for a clothing store called “Bloom & Co.” The agent can help with order tracking and returns, but cannot process refunds directly.

   Hint

   Personality should describe tone and communication style in actionable terms (not just “be friendly”). Rules should be hard constraints starting with “Never” or “Always”, not suggestions.

   Example solution

   Personality:

   Be warm, efficient, and solution-focused.
   Keep responses concise — no more than 3 sentences.
   Use "we" when referring to Bloom & Co.
   

   Rules:

   - Never share customer order details without first verifying their identity
   - Always offer to transfer the caller for refund or cancellation requests
   - Do not make promises about shipping timelines you cannot guarantee
   

Check your understanding

← Previous: Create a project

Lesson 1 of 6

Next: Add a simple topic →

Lesson 3 of 6