Craft Copilot
Craft Copilot is an admin-facing assistant built into the recipe canvas. It helps you author recipes faster — generate nodes from a natural-language description, diagnose validation issues before you publish, and explain what an unfamiliar node is doing in plain English.
Craft Copilot is admin-only. Supervisors, agents, and read-only users never see the trigger pill on the canvas. The Copilot never participates in a customer conversation — it only talks to the admin authoring the recipe.
Opening the panel
A floating ✦ Craft Copilot pill sits in the bottom-right corner of the canvas. Click it to slide the panel in from the right. The canvas reflows to fit alongside the panel — it does not get covered.
Keyboard shortcut: Ctrl + Shift + C (Cmd + Shift + C on macOS) toggles the panel from anywhere on the canvas.
The pill flips appearance to mark the panel state: dark navy with a gold ✦ icon when the panel is closed, gold with navy text when the panel is open.
Prerequisite — Recipe Copilot must be configured
Craft Copilot is the canvas-side experience; the language model behind it is the Recipe Copilot you register at Settings → AI Agents. If the Recipe Copilot is not configured yet, opening the panel shows a “not configured yet” empty state with a link straight to that settings page. Set it up there once, then come back to the canvas.
The three tabs
The panel has three tabs at the top:
Chat
Describe a flow in natural language and the Copilot streams nodes onto the canvas as it generates them.
- Type into the input box at the bottom of the panel (for example, “Greet the customer, ask for their member ID, then transfer to the Eligibility team”).
- Press Enter. The Copilot replies in the chat above the input and starts placing nodes on the canvas.
- Each generation is atomic. Below the Copilot’s reply for that turn there is an Undo this link that removes every node that single generation placed, in one step.
Press / in the input box to open a 5-row slash command palette:
| Command | What it does |
|---|---|
/generate | Generate nodes from a description (the default behaviour). |
/explain | Explain a selected node in plain English. |
/fix | Apply a Copilot-suggested fix to the current recipe. |
/translate | Produce the Arabic side of an EN-only node, or vice versa. |
/suggest | Suggest a likely next node based on what is already on the canvas. |
Diagnose
Validates the current recipe and lists every issue the Copilot can spot.
- Click Run Diagnose. The Copilot scans the current draft.
- Results are grouped by severity:
- 🔴 Critical — blocks publish.
- 🟡 Warning — does not block publish but is worth fixing.
- 🔵 Info — quality-of-life suggestions.
- Each issue has a Fix it → button. Clicking it jumps back to the Chat tab with a pre-filled fix instruction; press Enter to apply.
Diagnose also runs automatically when you click Publish and the standard validator surfaces blockers — the panel pops open on the Diagnose tab so the issues are in front of you and the Fix it → buttons are one click away. If you turned on Run Diagnose automatically when the Copilot panel opens in the Recipe Copilot settings, Diagnose also runs every time you open the panel manually.
Explain
Streams a role-aware explanation of any single node on the canvas.
- Hover over a node. The hover toolbar reveals a ? button (next to the existing delete button).
- Click ?. The Craft Copilot panel opens to the Explain tab and the Copilot streams an explanation of that node — what it does, what its outputs mean, what variables it reads or writes, and likely pitfalls.
Useful when you inherit a recipe someone else wrote, or when you are reviewing a teammate’s draft and want a quick read-out of an unfamiliar configuration.
Atomic undo
Every Chat generation is a single canvas operation. If the Copilot places six nodes and three edges in one turn, the Undo this link below that turn’s reply removes all nine items together. The browser’s own Cmd / Ctrl + Z still works for node-by-node edits you make yourself between generations.
Behaviour toggles
Three switches live in the Recipe Copilot settings and shape the panel’s behaviour:
- Offer matching templates when generating from a description — the Copilot scans your recipe templates and offers a starting template when it finds a close match to your prompt.
- Show the “Suggest next node” tooltip by default on the canvas — drops a small hint near your most recently placed node, nudging you toward a likely next step.
- Run Diagnose automatically when the Copilot panel opens — kicks off a Diagnose pass as soon as you open the panel.
What Craft Copilot does NOT do
- It does not run during a customer conversation — it is purely an authoring aid. The bot engine never invokes it.
- It does not modify variables, contacts, or any runtime state. It edits the recipe draft only, exactly like you do.
- It does not use the safety pre-filter (that gate is customer-facing; Copilot only talks to admins).
- It does not replace the validator on Publish — it surfaces and helps you fix issues, but the standard validator still gates publish.
Roles
Admin and Super-Admin only. Supervisors, agents, and read-only users do not see the pill button, do not have the keyboard shortcut, and cannot open the panel via any other means.