Why drafts matter
Without drafts, every keystroke in the agent builder would change a live phone line. With them, you can:- Rewrite an agent’s instructions over several sittings and publish once, deliberately
- Test the draft by voice before anyone else hears it
- Change your mind and throw the draft away without touching production
Testing uses the draft; live calls use the published version. That is the point of the split —
Test Call lets you hear your changes before you commit to them.
Editing and publishing
1
Make your changes
Edit the agent, its functions, its knowledge base attachments, or its workflow. The status chip switches to Draft.
2
Test it
Use Test Call to speak to the draft exactly as a caller would. Adjust and repeat until it sounds right.
3
Review what changed
Before publishing you can review the differences between your draft and the live version, including changes to what the agent has attached.
4
Publish
Click Publish. You can give the version a label and a change summary so the history reads well later. The new version goes live for new calls immediately.
What gets versioned
Attachments are versioned with the agent, so you can see when a function, MCP server, or document was added to or removed from an agent as part of a publish.
Version history and diffs
Every publish creates a version. Open View version history on a resource to see the list, newest first, each with its label, change summary, author, and date. From the history you can:- View a version to see the configuration as it was
- View diff between any two versions to see exactly which fields changed
- Roll back to an earlier version
Rolling back
Roll back restores an earlier version’s configuration. It does not rewrite history — the restored state is published as a new version, so you can see that a rollback happened and roll forward again if needed.Discarding a draft
If you decide against your changes, discard the draft to throw them away and return the resource to its last published state. The forms on the page are re-filled from the restored version, so what you see matches what is live.Publishing resources that depend on each other
Agents depend on other resources: a workflow node can call a function, and an agent can have functions and MCP servers attached. Publishing checks those dependencies, because publishing an agent that points at an unreleased function would put something live that you have never tested end to end. Before an agent can be published, every function and MCP server it depends on must be:- Published — it has a live version, not just a draft, and
- Free of pending changes — it has nothing unpublished sitting on top of that version
Frequently asked questions
Do I have to publish to test?
Do I have to publish to test?
No. Testing always uses the draft, so you can hear your changes before publishing. Live callers are unaffected until you publish.
Does publishing interrupt calls in progress?
Does publishing interrupt calls in progress?
No. Calls already connected finish on the version they started on. New calls get the new version.
Can I edit something after publishing it?
Can I edit something after publishing it?
Yes. Any edit puts the resource back into Draft. Publish again when you are happy, and the change becomes the next version.
What happens to my changes if I roll back?
What happens to my changes if I roll back?
Rollback replaces the current configuration with the version you chose. If you had unpublished changes, they are replaced too. Rolling back is itself a new version, so you can roll forward again.
How many versions are kept?
How many versions are kept?
Every published version is kept in the history.
Why can't I publish my agent?
Why can't I publish my agent?
Almost always a dependency: a function or MCP server the agent uses is unpublished, or has unpublished changes of its own. The message names the resource. Publish it first, then publish the agent.