Blog · Step-by-step guide
My AI agent got worse after I changed its instructions: how to see what changed and roll back
Short answer: in Super Agent, every time you save a change to your agent’s instructions, the previous version is kept in “History”. Open the agent, go to the “How it talks” step, press “History” and pick the change you suspect: the instructions box shows what was added and removed, in green and red. “Restore this version” puts the old text back in the editor, and nothing changes until you press “Save changes”.
Why it happens
The instructions are the text that tells the agent how to greet people, what to ask first, what it must never promise and when to hand the chat to you. They tend to be long, and a small edit can change a lot: you delete a line while reordering a paragraph, adjust a shipping rule, and two days later the agent is sending payment links without asking for the size. By then you no longer remember what the text used to say.
And you are not always the one typing. The text is also rewritten when:
- You run quick setup again. It writes the instructions from your website again, in full, on top of whatever you tuned by hand.
- You ask the agent in a chat to change something. With that tool switched on, the agent edits its own instructions when you ask from your owner number.
- You use the deep read of your site. It proposes new instructions after reading your store.
Every one of those paths leaves its version in the history, with a label saying who wrote it.
What the history keeps
- Every real change to the text. If you save the agent to rename it or tick a channel and the instructions are unchanged, no duplicate version is stored.
- The last 50 changes, newest first. When change 51 comes in, the oldest one drops off.
- On each row: when it happened, how many lines were added and removed (say
+3 −5) and where it came from: “Edited here”, “Edited by the agent”, “Written by quick setup”, “Restored by undoing quick setup”, “Written from a deep read of your site” or “When the agent was created”. - If your agent is older than the history, the first time you change its instructions the text it had before is kept too, labelled “Before history was kept”. Until that first change the list is empty.
Rolling back, step by step
- Open the agent. On the Agents page, open the agent’s menu and choose “Edit”.
- Go to the “How it talks” step. The “History” button sits above “System prompt”. It only appears when you edit an agent that already exists.
- Find the change you suspect. Think about when the replies got worse and look for that day’s row. The
+N −Mand the source label help: a “Written by quick setup” row with many lines removed is a usual suspect. - Choose what to compare it against. Clicking the row turns the instructions box into a read-only comparison, with two options at the top (the table below says when to use each).
- Restore the version, or fix just the line. “Restore this version” puts that text in the editor and tells you “Loaded into the editor. Press Save to apply it — nothing has changed yet.” If only one line was wrong, press “Back to editing” and type it back in by hand, so you keep the good part of the change.
- Save. Press “Save changes”. Until then the agent keeps using the old instructions.
- Test it. Message the agent the way a customer would, or use “Voice tester” in the agent’s menu. Tests run on what is saved, which is why you save first.
The two comparisons
| Option | What it answers | When to use it |
|---|---|---|
| “vs. the editor now” | How that version differs from what is in the editor right now, including anything you typed and have not saved | Before restoring, to see what you will lose and what you will get back |
| “vs. the version before it” | Exactly what that one save changed | To find the line that was deleted or changed that day |
The oldest version in the list has nothing before it, so the second option is disabled on that row.
An example: the agent stopped asking for the size
The store and the text are made up. A clothing store edits its instructions one evening to raise the free-shipping threshold. While reordering the paragraph, it deletes the size line without noticing. Two days later, two orders arrive in the wrong size.
The owner opens “History” and sees a row from two days ago at the top, labelled “Edited here”. She compares it “vs. the version before it”:
| Before the change | After the change |
|---|---|
| Shipping is free on orders over $150,000. | Shipping is free on orders over $200,000. |
| Before sending the payment link, ask for the size and confirm the colour. | (the line is gone) |
She did want the new threshold, so she does not restore the whole version: she types the size line back in, presses “Save changes” and tests with “I want the black dress”. The agent asks for the size again, and that save becomes one more row in the history.
Common mistakes
- Restoring and closing without saving. Restoring only fills the editor. Close without pressing “Save changes” and the agent keeps the text it had.
- Changing many things in one save. Change one thing, save and test, and each row in the history explains one change, which makes the one that hurt easy to find.
- Running quick setup again after tuning the instructions by hand. It rewrites the whole text. Your version is not lost, since it stays in the history, but you will have to restore it.
- Looking there for other settings. The history keeps only the instructions. Tools, channels, the first message and the business profile have no history.
Frequently asked questions
Does restoring a version delete the newer changes?
No. Restoring and saving adds a new version at the top of the list, and the newer ones stay where they are. If you change your mind, you can go back to any of them.
How many versions does it keep?
The last 50 changes to each agent’s instructions. Saving without changing the text does not count.
Can I undo a change the agent made when I asked it to in a chat?
Yes. Those changes show in the history as “Edited by the agent” and you restore them from the console just like your own.
Keeping your instructions from getting worse
Before you rewrite anything, have clear answers to the questions customers ask most. The store FAQ generator helps you write them, and the missed replies calculator puts a figure on what a slow or wrong answer costs. If you are just starting, read how to train your agent with your store’s information, and for the cases the agent should not handle alone, how to hand a chat from the bot to a person.
Tune your agent without worrying about breaking it
Every change to the instructions is kept, and going back to the version that worked is two clicks and a Save.
Start freeFree plan, no card required.