AI Builder
In the app: AI → Advanced → Builder
Needs the 'Edit AI Config' permission.
The AI Builder sets up or changes your AI agent through a chat. You describe how your support works and the Builder writes the configuration. This page starts a new Builder session and lists the sessions you already have.
What the Builder is
A Builder session is a conversation with the Builder plus the draft it produced. The draft is a proposed state of a configuration set: the main prompt of the agent, its specialists, its variables and its tool settings. The (i) next to the page title explains these four parts.
A session edits one configuration set at a time. It can start from an existing set or a new draft. Saving a new draft creates a set or reuses an empty starter set. You can also ask the Builder inside the session to create or copy a set before saving. Nothing in a session reaches customers until you choose "Save changes" or "Go live…" inside the session.
Opening this page and everything on it needs the 'Edit AI Config' permission.
New Session
The config set list chooses what the session starts from:
- "New config set (created when you go live)": start from nothing. The first save creates the set or reuses an empty starter set, unless you have already asked the Builder to create or copy a set in the session.
- An existing configuration set: the session starts from that set as it is saved now. Each set is listed with its mode, "Multi store" or "Single store".
"New Session" starts the session and opens it.
For a new configuration set, the "Choose a mode" dialog opens first:
- "Multi store": a configuration set used by several stores. Stores are assigned when you go live, or on the configuration set's page. While you build, the Builder does not check any store's integrations.
- "Single store": a configuration set made for one store. You must pick the store under "Store". The Builder plans around the integrations that store has connected.
"Start session" stays disabled until a mode is chosen and, for "Single store", a store is picked. The mode of an existing configuration set cannot be changed here; the line under the list says which mode it has. An existing single-store set that has no store yet opens the same dialog, locked to "Single store", to pick one.
If the list of configuration sets cannot be loaded, or your role may not see it, a note says so. You can still start a session for a new configuration set.
When you have no sessions and no configuration sets yet, the "Choose a mode" dialog opens by itself.
Your Sessions
The list shows the Builder sessions you started yourself, most recently changed first. Sessions of teammates are not shown, and at most 50 are listed.
Each row shows:
- the session name, or "Untitled builder session";
- a status: "Active" while you are still talking, "Generating" while the Builder writes the draft, "Ready" when a draft is waiting, "Failed" when writing the draft failed, "Committed" once it was saved into a configuration set, and "Discarded";
- the mode, with the store's name for a single-store session or the number of stores for a multi-store one;
- the configuration set the session edits, when it has one;
- the number of messages, the number of attached files, and when it was last updated.
While a session is generating, the list refreshes every few seconds. You can leave the page; generation continues in the background.
"Open", or a click on the name, opens the session.
"Delete" removes the session after you confirm: its conversation, its attached files, the website pages read in it and any draft that was not saved. It does not undo anything that was already saved into a configuration set or put live, and it does not delete the configuration set.
With no sessions, the list shows "No builder sessions yet".