Agent states in Agent Builder
Learn more about the states an agent moves through in Agent Builder, from draft to published.
Agent Builder tracks the state of each agent throughout its lifecycle. The state determines what actions are available to the author, reviewer, and admin at any point.
States in Your Drafts and Requests
The following states appear in the Your Drafts & Requests tab.
| State | Description |
|---|---|
| Draft | The agent is being created or edited. The author can update the system prompt, tool configuration, and test the agent. Each save increments the minor version number. The agent is not yet available to end users. |
| Scanning | The author submitted the agent for review and the system prompt security scan is in progress. The draft cannot be edited while the scan runs. This state is brief and resolves automatically within seconds. |
| Pending review | The scan completed with no violations. The publish request is now in the reviewer's queue. The draft cannot be edited until the reviewer acts or the author withdraws the request. |
| Auto blocked | The scan detected a security violation in the system prompt. The publish request did not reach the reviewer's queue. The author can revise the prompt and resubmit. Saving any edit returns the agent to Draft state. |
| Rejected | The reviewer rejected the publish request with a reason. The author can view the rejection reason, modify the agent, and resubmit. Saving any edit returns the agent to Draft state. |
States in All Agents
The following states appear in the All Agents tab and are visible to all Agent Builder users.
| State | Description |
|---|---|
| Published | The agent was approved by a reviewer and is available to end users in Discover Agents. Published versions are immutable. If the author makes further changes, a new draft version is created while the current published version remains live. |
| Archived | The agent is no longer available in Discover Agents or usable in conversations. Archiving is an admin action. The agent is retained for audit purposes. |
How states change
- When an author submits for review, the agent moves from Draft → Scanning → Pending review (if the scan passes) or Draft → Scanning → Auto blocked (if a violation is detected).
- When a reviewer approves, the agent moves from Pending review → Published and appears in the All Agents tab.
- When a reviewer rejects, the agent moves from Pending review → Rejected.
- When an author edits a rejected or auto-blocked agent, the agent returns to Draft.
- When an author withdraws a pending request, the agent returns to Draft.
- When an admin archives an agent, it moves to Archived.
Version continuity during review
If an agent already has a published version when a new publish request is submitted, the existing published version remains live throughout the review process. End users continue to interact with the current published version. The new version becomes live only when the reviewer approves the request.