The assistant turns a description into a working flow. It plans the conversation, builds the steps, tests them and tells you when the agent is ready to publish. You can also ask it to change an agent you already have.
Availability
The assistant is switched on per workspace. When it is off, Build with AI is not available and New agent opens a plain blank-agent dialog instead. You also need builder.bots:write.
Build a new agent
Open Agent Builder. The landing page is Build with AI.
Describe the agent in the message box, or pick one of the templates under the headline, such as Order desk or Lead scorer.
Select Build it and follow along. The progress card moves through Understanding the request, Building, Testing and Ready.
When it is ready, select Open in builder to inspect the flow, or Publish to go live. Publish asks the assistant to publish, and it shows a publish card headed Ready to go live (unless Auto is on). Approve the card to go live.
Be specific about what the agent should know, what it should check and who it hands over to. The assistant will ask a short question when it needs a detail, and you can answer with a choice or type your own answer.
What it will ask you to approve
The assistant stops for your approval on actions that matter. Most cards are headed Needs your approval; the publish card is headed Ready to go live (or Ready to publish for an agent that isn't switched on yet). You'll see one for things like:
- 1Prompt
- 2Approval card
- Publish — the card names the agent, how many channels point at it and any warnings. Choose Publish or Not now.
- Run a test that calls live integrations? — Run test makes real calls, which may write data or cost money. Use stand-ins tests without them.
- Replace the flow — when a rebuild would replace the current flow, the card lists what would be reset. Choose Replace the flow or Keep the current flow. What is live keeps running until you publish.
It may also ask you to connect an app account it needs. Connect it from the card; never paste keys or tokens into the chat. Natiq will not send a message that looks like a key.
Control how it works
Beside the message box:
- Attach a file gives the assistant material to read, for example a brief or an API description.
- A mode selector offers Fast (quick replies for simple tasks), Expert (best for everyday use) and Heavy (highest quality, a bit slower). Heavier modes use more of your AI budget.
- Auto approves rebuilds, live tests and publishing for you. Questions and account choices still ask, and each automatic approval is listed as a receipt.
Change an existing agent
There are two ways in:
- 1Assistant
- 2Panel
- Reopen its chat with Open chat on the Agents page, or from the chat history in the Build sidebar (grouped Today, Yesterday, Older). History lets you rename or delete a chat; deleting a chat does not delete the agent it built.
- In the flow editor, select Assistant in the top bar. A panel opens beside the canvas titled Change this agent with words. Type what you want, for example Add a question about the order number before the handover.
The assistant and the editor share one draft. After the assistant changes the flow, the editor shows an Updated by the assistant notice, and the canvas reloads to the new version. If you had unsaved edits of your own, you choose Restore my version or Keep the assistant's version.
Check its work
Open the flow and read it, and use Preview to try a conversation. The assistant tests the agent, but you know your customers best.
When it will not build
You may see a message that you have used today's AI allowance (it resets the next day, and you can keep editing agents by hand), that the assistant is busy, or that a chat is full. Start a New chat if one is full.