Build and customize

Teach the agent about your business

Use the Knowledge page to add notes the agent always keeps in mind, review what it remembers, and archive or delete anything it should stop using.

Knowledge is what the agent carries into every run on your project. It includes notes you write, facts the agent chose to remember, and details from your conversations and uploads. You can read all of it, add to it, and remove what you do not want.

Use it to stop repeating yourself. Write "We never discount below list price" once, and the agent keeps it in mind from then on.

Where to find Knowledge

  1. Open your project in the editor.
  2. Open More actions, then Project settings.
  3. In the left menu under This Project, choose Knowledge.

Knowledge is open to every workspace. There is no plan lock on it.

What the page shows

At the top are three totals.

Total Meaning
Active chunks How many pieces of knowledge are switched on.
Active tokens The combined size of those pieces.
Eco per run, up to An estimate of the eco the knowledge adds to each run. A run carries at most about 2,500 tokens of knowledge, picked by how relevant it is to your request.

More active knowledge costs more eco per run, so keep it focused. See Eco: what it is and how it is used.

Below the totals is a short box called "How the agent sees your code". It tells you how many source files are indexed. Before your first run it says "No files indexed yet; the first run indexes the project." After each run that changes files, the agent rebuilds a Codebase map (routes, pages, components, functions and tables) and keeps it as one piece of knowledge.

Where knowledge comes from

Each row shows its source on the left.

Source What it is
Note Something you wrote.
Agent A fact the agent decided to remember.
Chat Something from your conversation.
Change A record of a change made to the project.
Upload Something from a file you attached.
Codebase The Codebase map described above.

Each row also shows the heading, its size and eco cost, and how long ago it was added. Select a row to open it and read the full text.

Add a note

Notes are the best way to give the agent permanent instructions.

  1. Select Add note.
  2. In the first box, type a short heading, for example "Brand rules".
  3. In the second box, write what the agent should always keep in mind for this project.
  4. Check the counter under the box. It shows how many characters you used and the eco per run the note adds.
  5. Select Save note.

A note needs both a heading and content. If one is empty you see "Give the note a heading and some content". The heading holds up to 160 characters and the content up to 4,000.

A project can keep 100 active notes. When you reach that, you see "A project can keep 100 notes. Archive an old note to add a new one." Archive a note you no longer need, then add the new one.

What makes a good note

  • Write facts and rules, not stories. "Opening hours: Monday to Saturday, 10:00 to 20:00. Closed on public holidays."
  • Keep each note on one subject so you can archive it on its own.
  • Say what you never want. "Never use stock photos of people in suits."
  • Do not paste passwords or API keys. Use Secrets for those. See Store keys and secrets safely.

Examples of notes that work well:

Heading Content
Brand rules Colors, fonts, tone of voice, words to avoid.
Products Names, sizes and what each one is for.
Customers Who you serve and how they like to be spoken to.
Legal Wording you must show, such as a refund policy line.

Archive, restore or delete

Every row has two icons on the right.

Icon What it does
Archive icon "Archive: keep it, but stop sending it to runs." The row moves to Archived.
Restore icon (on archived rows) "Restore: the agent will use this again."
Bin icon "Delete permanently." You are asked to confirm: the agent will no longer know this.

Use the Active and Archived buttons above the list to switch between the two views. Each shows its count, for example Active (7).

Archive the Codebase map?

You can archive the Codebase map if you want runs to work from the files alone. Most projects are better with it left on.

What to expect after you save

Knowledge is used from the next run. Nothing else changes on your site. The agent does not repeat your note back to you. It simply follows it, the same way it follows your Skills. See Skills.

If the agent still does something your note forbids:

  1. Open the note and check the wording is clear and specific.
  2. Say it again in the chat, and mention the note by heading.
  3. Check the note is under Active, not Archived.

If something goes wrong

What you see What to do
"A project can keep 100 notes." Archive or delete an old note.
"Give the note a heading and some content" Fill in both boxes.
"Not authenticated" Sign in again.
"Request failed" Check your connection, wait a moment and try again.
The list is empty Add a note, or run the agent. Each conversation, change and upload is kept here.