Academy/Writing Brain Instructions
    Advanced6 min read

    Lesson 8

    Lesson 8: Writing Brain Instructions That Make Your Superagent Actually Work


    You've built your first Superagent. Congrats. Now the real work starts: making it do exactly what you want.

    Most people fill in the name, hit save, and wonder why their Superagent sounds robotic or misses instructions. The secret is the Soul section of the Brain. That's where your Superagent learns how to think, what to care about, and what lines never to cross.

    This guide teaches you the PACE Framework. It's a simple way to structure your Soul instructions so your Superagent actually works the way you need it to.

    The Three Parts of the Brain

    Before we talk about PACE, let's map out where everything lives in Base44.

    Open your Superagent and click the Brain tab. You'll see three sections:

    Identity: Name, personality vibe, avatar. This is your Superagent's face.

    Soul: The behavioral rules, constraints, and tone. This is the magic section most people skip. It's where you tell your Superagent how to act, what to care about, and what it absolutely cannot do.

    Knowledge: Files, FAQs, documents, context. Upload your pricing doc, FAQ, product specs, or customer handbook here. Your Superagent reads it instantly. No training needed.

    The Identity gets seen. The Soul makes it work. The Knowledge makes it powerful.

    The PACE Framework: Build Your Soul Section

    PACE is four simple parts. Write them in order. Your Superagent becomes more aligned with every sentence.

    P: Purpose

    One sentence. What is this Superagent's core job?

    Examples:

    • "You are a customer support agent that handles product questions via email and WhatsApp."
    • "You are a lead qualification agent that screens inbound sales inquiries and schedules calls for qualified leads."
    • "You are a social media manager that responds to comments and DMs on Instagram within 2 hours."

    Write it as a direct statement. Your Superagent will live this sentence.

    A: Audience

    Who will interact with this agent? What do they want? What's their mood?

    Examples:

    • "You talk to customers who are frustrated or confused. They're not reading 500-word answers. Be concise, empathetic, and solve their problem in 2-3 sentences."
    • "You interact with potential clients who are evaluating whether to hire us. They want proof we're competent and that we understand their specific situation. Be warm but professional."
    • "You engage with social media followers during working hours. They're scrolling quickly. Your tone should be casual, friendly, and witty without trying too hard."

    This section keeps your Superagent from sounding like a bot to the wrong audience.

    C: Constraints

    What must your Superagent absolutely never do? This is your safety net.

    Write 3-4 hard rules. Be specific.

    Examples:

    • "Never discuss pricing without my explicit approval first. If someone asks for a quote, say you need to check with the team and you'll get back to them."
    • "Keep every response under 100 words. Err on the side of short."
    • "If you're unsure about something, never guess. Say 'I'll check with the team and get back to you.' Do not make up information."
    • "Always use the person's first name when you have it. It makes interactions feel personal, not automated."
    • "Never promise a deadline I haven't confirmed. If you don't know when something ships, say 'I'll check our roadmap.'"

    These constraints keep your Superagent from breaking things while you sleep.

    E: Examples

    Show, don't tell. Give your Superagent 2-3 examples of exactly how you want it to respond.

    Format:

    User says: [realistic input] You respond: [the response you want — exact tone, length, content]

    Example:

    User says: "I've been waiting 2 weeks for my order and it's not here." You respond: "I'm really sorry — that's frustrating. Let me look into this right now. Can you give me your order number? I'll find exactly where it is and let you know what's next." User says: "Do you have a free trial?" You respond: "We do — 5 messages per day to test it out. That's usually enough to see if it works for you. Want me to set one up?" User says: "What's your secret sauce?" You respond: "We connect to your real tools (Gmail, Slack, Calendar, etc.) so your agent isn't just a chatbot — it works like a team member. Most agents sit in a chat box. Ours integrates everywhere you already work."

    Examples are powerful because your Superagent learns your voice, your length, your priorities from real interactions, not abstract rules.

    Building along? Sign up free and follow the steps live.

    Create Free Account

    Copy-Paste Soul Template

    Open your Superagent. Click BrainSoul. Delete the default text and paste this:

    Purpose: [One sentence — what is this Superagent's job?] Audience: [Who will interact with it? What do they care about? What's their mood?] Constraints: - [Rule 1: e.g., Never discuss pricing without my approval first] - [Rule 2: e.g., Keep every reply under 100 words] - [Rule 3: e.g., If unsure, say "I'll check and get back to you" — never guess] - [Rule 4: e.g., Always use the person's first name] Examples: User says: "[example input]" You respond: "[example of ideal response — show tone, length, content]" User says: "[example 2]" You respond: "[example 2 ideal response]"

    Fill in your specifics. Click save. Test immediately by asking your Superagent a question in the chat. You'll feel the difference.

    The Knowledge Hack: Let Your Superagent Read Your Docs

    This is subtle but powerful. Upload your FAQ, pricing sheet, product overview, or customer handbook into the Knowledge section.

    How to do it:

    1. In the Brain tab, click Knowledge
    2. Click "Upload file" and pick a text file (.txt, .md, .pdf work great)
    3. Base44 ingests it instantly

    Now when a customer asks "What's included in the Starter plan?" your Superagent doesn't guess. It reads the answer from your actual pricing doc. No retraining. No version conflicts. Just knowledge.

    Pro tip: If you update your pricing or FAQ, replace the file in Knowledge. Your Superagent learns the new version immediately.

    Walk-Through: Upgrade Your Soul Right Now

    You have a Superagent. It works. But let's make it work better.

    1. Go to base44.com
    2. Click the Superagents tab
    3. Click your Superagent
    4. Click the Brain tab on the left
    5. Click Soul
    6. Delete whatever's there and paste your PACE framework
    7. Click Save
    8. Go back to the chat with your Superagent and ask it a question. Notice the difference.

    Test it with a real scenario. If you have a lead follow-up agent, ask it: "I got an email from someone interested but unsure about price. Draft a reply." See if the response matches your constraints. If not, refine your Soul and try again.

    Why This Matters

    The difference between a mediocre Superagent and a great one isn't luck. It's clarity. Clear Soul instructions make your Superagent consistent, aligned with your brand, and actually useful.

    You didn't build this agent just to have it chat with people. You built it to get your time back and sound like you (or better). PACE makes that happen.

    Next step: Open your Superagent on base44.com right now. Click Brain, click Soul, upgrade it with your PACE framework, and test it immediately. You'll see the improvement.

    Ready to build this Superagent?

    Free to start. Takes 2 minutes. No credit card.

    More lessons in the Academy