Create the agent
1
Select + Create
The Agent Builder page opens with an Agent credits card, your existing agents, and a gallery of one-select templates. If a template already does roughly what you want, choose it — it lands on the canvas fully wired and you edit from there.
2
Name it
The Create a workflow dialog says “Name your agent. You can design it on the canvas next.” Give it a name that says what it does — the placeholder suggests “Agent name (e.g. Appointment reminder)”. A Description (optional) helps whoever inherits it.
3
Select Create
You land on the canvas. The top bar shows a Draft · v1 badge, your credit balance, and a save indicator that reads Saved once your work is stored. Drafts save themselves as you work.
Build it on the canvas
The palette on the left is grouped into four sets. A Start node is always present; you drag in the rest.
Select a node to configure it in the panel on the right. See Agent tools and knowledge for what each tool node needs.
Choose what starts it
Select the Start node and pick a trigger.There is no “when an invoice becomes overdue” trigger, because that is not an event — it is the passage of time. For anything time-based (overdue invoices, following up submitted claims, expiring memberships) use a Schedule trigger with a worklist tool, and let the agent find the records that now qualify.
Preview it
Select Preview in the top bar and talk to the agent in a sandbox before anyone else can. Use Playbooks to hand it reusable instructions and Evals to check it still answers correctly after you change something. Preview runs are real runs and spend credits.Deploy it
This is the step everyone misses. A saved draft with a schedule trigger does absolutely nothing — the canvas only becomes live when you deploy it.1
Select Deploy
The button sits at the top right and reads Deploy the first time, Redeploy afterwards.
2
Confirm it went live
You get “Deployed — v1 is now live” and a green ● Live · v1 badge appears next to the agent’s name. A fresh Draft version opens so you can keep editing without disturbing the live one.
3
Redeploy after every change
Editing a deployed agent edits the draft, not the live version. Your change reaches the running agent only when you select Redeploy.
Check it worked
- The agent shows a green ● Live badge on the canvas and a published badge on the Agent Builder page.
- The Runs page lists a run after the trigger has fired once. A manual agent will not appear there until you run it.
- Your credit balance drops after a run that contains an Agent or Classify step.
If something goes wrong
My scheduled agent never runs
My scheduled agent never runs
It is almost certainly still a draft. Open it and check for the green ● Live badge — if you only see Draft, select Deploy. Editing a live agent also needs a Redeploy before the change takes effect.
Nothing arrives at my webhook trigger
Nothing arrives at my webhook trigger
The endpoint is off by default. Turn on Webhook / API trigger under , then confirm you are sending a signed
POST to the endpoint shown there. If you rotated the signing secret, update whatever is calling you.Deploy failed and mentions a limit
Deploy failed and mentions a limit
Your plan caps how many agents can be published at once. Free publishes 1, Starter 5, and Essential and Team are unlimited. Take another agent offline or see Publish an agent.
The agent runs but produces nothing useful
The agent runs but produces nothing useful
Open Preview and step through it there. Most empty results come from a step whose output the next step never reads, or an Agent node with no instructions. Evals will tell you whether a change made it better or worse.
Runs stop and the balance is zero
Runs stop and the balance is zero
You are out of credits. Top up from the Agent credits card — see How agent credits are used.
Related
Agent tools and knowledge
Knowledge bases, guardrails, outside tools and human approval.
Publish an agent
The difference between deploying and putting a chat assistant on the web.
Agent credits
What a run costs and how a schedule multiplies it.
AI safety and patient data
What an agent may touch, and what you must review.