For the complete documentation index, see llms.txt. This page is also available as Markdown.

Instructions and Memory

Write your agent's instructions in plain language, correct it on a live ticket, and let it review its own work on a schedule. What it remembers and where that lives.

Your AI teammate follows a set of instructions, written in plain language: tone, policy, what to do in specific situations, when to hand over. It is the brief you would give a new hire.

Memory is how those instructions grow. When you correct your agent, it writes the correction into its own instructions, so the fix holds next week and in every app it works in.

The Instructions page open beside the chat, showing a saved rule about tone, sign-off and the support email
A correction made in chat, written out as a rule on the Instructions page.

Quick start

You do not have to write instructions from a blank page. Make your agent do the job, then correct what it gets wrong.

1

Try it on a real question

Open the chat in your dashboard and ask your agent something a customer would ask, or ask it to draft a reply to one of your tickets. It reads your connected knowledge and shows you the answer it would give.

The dashboard chat drafting a reply for a Zendesk ticket, showing the steps it took and the drafted reply
Ask for a draft and your agent writes the reply it would send.
2

Correct it in the chat

Tell it what was wrong, right there. Too formal, missing a step, wrong sign-off, wrong email address. It rewrites the draft and offers to keep the changes.

A dashboard chat where the user asks for no dashes, a different sign-off, the correct support email and a friendlier tone, and the agent returns the rewritten draft
Ask for the changes in plain words and it rewrites the draft, then offers to save them.

Say yes and it writes the corrections into its own instructions. Each correction becomes a rule, so the fix applies to every similar reply.

The agent confirming it has saved the reply style preferences, with a link to the full instructions
It confirms what it saved and links you to the full instructions.
3

Read the rules on your Instructions page

Open Instructions in the left sidebar. The rules are plain sentences you can edit by hand, and edits you make there are live as you type.

The Instructions page open beside the chat, showing the saved rule about tone, sign-off and the support email
The saved rules on your Instructions page, where you can edit them yourself.

Check it worked. The rule is on the Instructions page. From a terminal, eesel instructions prints the same text.

4

Keep correcting as it works

Once your agent is live, you can correct anything you notice in its real work. Open the run on your Activity page and tell it what to change in the chat beside it. It rewrites the draft in that chat.

The Activity page with a Zendesk run open, and the chat beside it where the user asks for a shorter, simpler draft with a different sign-off and the agent returns the rewritten reply
Correct a live run from its Activity page.

Then tell it to keep the change for every future reply. It reads its current instructions first. If a rule already covers the point, it edits that rule instead of adding a new line.

The Instructions page open beside the chat, showing the updated reply style rule, while the agent confirms it read the current instructions and added the shorter, simpler rule
The Instructions page beside the chat, with the reply style rule now covering length too.
5

Let it review itself

Ask your agent to review its own setup and results, and to do it every week. It reads its recent activity, writes a review to its Files, and lists what to improve.

The dashboard chat where the user asks the agent to analyse its setup, review the reports, adjust itself and repeat weekly, and the agent runs the self-review analysis
The self-review asked for in chat, with the analysis running.

The review comes back as a prioritised list: what to switch on, which instructions to add, what is already working. The same message confirms the weekly schedule and that the top recommendations will be emailed to you each week.

The chat where the agent confirms the weekly self-review is live, lists three prioritised actions with their impact, and says a fresh review will run every Monday
Three prioritised actions, and the Monday schedule confirmed.

Open the schedule on your Automations page to change the day, the time or what it checks.

The schedule editor for the Weekly agent self-review, set to every Monday at 8:00 AM UTC, with the instructions below
The schedule editor, set to Monday at 8:00 AM UTC.

Below the day and time are the review's instructions, the steps your agent follows each week, and the model it uses.

The schedule editor scrolled to the review's instructions, listing the steps to pull activity, group knowledge gaps, read the worst conversations, write the report and email the owner, above the Model strength choice
Five steps, from pulling activity to emailing the owner.

Ask for a simulation when you want a score before going live. With a helpdesk connected it replays your real past tickets and compares its answers to what your team sent. Without one it writes realistic test cases. See Skills.

From Claude Code, Cursor or a terminal. eesel instructions prints the current instructions, and eesel chat "..." makes a correction the same way the dashboard chat does. Full command reference: The eesel CLI. From a Model Context Protocol client: Claude Code and MCP clients.

Editing instructions needs edit access. Workspace viewers can chat with an agent but cannot change what it does. See Account.

Instructions, actions and automations

These three do different jobs.

What it decides
Where you set it

Actions

What your agent is allowed to do at all

On each integration's page, once per agent

Instructions

How it behaves, always, everywhere

The Instructions page, or chat

Automations

When it runs, which tickets it takes, and what to do with them

The Automations page, or chat

Actions are a permission list, not a workflow. Turning on Add tags means your agent can tag. Each action runs on its own, asks you first, or stays off. Instructions say when to use those actions, in every app. An automation narrows that to one event, with its own instructions for that job.

All three stack. Say your instructions read "always reply in the customer's language". An automation says "draft a reply as an internal note whenever a customer messages". Leave internal note runs on its own. Then a customer message produces a drafted note in the customer's language, with nobody clicking anything.

When you are deciding where something goes:

  • Should it be possible at all? That is an action.

  • Should it be true everywhere, always? That is an instruction.

  • Should it happen on a particular event, or only for certain tickets? That is an automation.

Skills follow the same pattern. A skill can carry its own instructions that apply only when that skill runs, so a blog style guide does not have to sit in the instructions your support replies read.

Example instructions

The easiest way to add instructions is to ask in the chat: describe what you want and your agent writes the rules. These examples show what good instructions look like.

Set the tone and voice
Tag and route tickets

Tagging only works if the agent knows your exact tags, so give it the full list and what each one means. Assigning needs the identifier your helpdesk uses: a staff ID, team ID or email in a helpdesk, a member ID in Slack. If you only have a name, ask your agent in chat to look the ID up and it writes the rule with the right one.

Set escalation rules
Cover exceptions and edge cases
Support agent (full brief)
Triage agent (no replies)
Internal knowledge agent

FAQ

Do instructions apply in every app?

Yes. Instructions are read on every reply, everywhere: the dashboard chat, helpdesk tickets, Slack, email, scheduled runs. Write rules that should always be true. A rule that should only apply in one app or on one kind of event belongs on the automation that handles it.

How long can instructions get?

Instructions are read on every run, so a focused set of clear rules works better than a long list of edge cases. Once they grow past a few thousand words your agent starts suggesting you tidy them up. Long reference material, like a full returns policy, is better as a file your agent can look up when the topic comes up.

Should I put prices, policies, or product details in instructions?

No. Instructions shape behaviour, not facts. Your agent answers factual questions by searching your connected knowledge, never from its instructions or general knowledge. Put facts in your knowledge sources and let instructions govern tone, policy and escalation. If the search does not cover something, a well-briefed agent escalates rather than guessing.

Last updated