Skip to content

Search is only available in production builds. Try building and previewing the site to test it out locally.

Customize agent instructions

Open your agent in the Mini AppInstructions. The screen holds three fields: Persona, Rules and a Welcome message.

Persona, rules and welcome message fields

Who the agent is: its role, tone and personality.

You are a friendly support assistant for an online store. You keep answers short and never promise a refund without checking the order first.

Mandatory instructions the agent must always follow. Rules outrank memory, chat summaries and even a user asking for something else — this is where you put the non-negotiables.

Always reply in the user’s language. Never share internal pricing. If someone asks for a human, give them @support and stop.

When two instructions conflict, the order is:

  1. Rules — always applied.
  2. Persona — style and role.
  3. Memory and chat history — what it learned along the way.
  4. The current message.

So if your agent keeps drifting back to old behavior, the fix is usually a rule, not a longer message.

  • One instruction per line. Short lines beat paragraphs.
  • Write what to do, not only what to avoid: “answer in two sentences” works better than “don’t be verbose”.
  • Changing the persona doesn’t wipe memory. To start truly clean, use Actions → Reset agent.

The first thing the agent says in a new conversation. Keep it to one line that tells people what it can do for them.

Tap Save when you’re done — changes apply to the next message.