DESIGNER GUIDE

Publish, approve and deploy solutions

Validate a completed project, preserve a version, publish reusable workers, configure human approval policies and connect workers to customer channels through controlled deployment environments.

Solution designer25–35 minutes

Scope: project, workspace and deployment environment

Version preserves. Publish makes reusable. Deploy makes available.

These are separate actions, and completing one does not complete the others.

Four distinct actions

Save as version
Records a meaningful state of the project before publication or major changes.
Publish
Makes a completed Agentic Worker available for use inside Designer and, where authorised, through the Store.
Deploy
Connects channels, workers and supporting capabilities in an environment and activates that environment.
Human approval
Pauses sensitive flow activity until an authorised person decides what should happen.
Runtime approval is not release approvalThe Approvals and Approval policies areas shown in this guide govern human decisions during flow execution. They should not be described as approval of the project’s publication unless that behaviour is explicitly present elsewhere in the product.

Two related lifecycle tracks

Keep the release track and the human-in-the-loop execution track separate.

Build and release

Draft
  ↓
Test
  ↓
Readiness check
  ↓
Save as version
  ↓
Publish reusable worker where required
  ↓
Configure environment
  ↓
Deploy environment

Human-in-the-loop execution

Flow reaches Human Approval
             ↓
Approval request waits in the inbox
             ↓
Approval policy selects the current level
             ↓
Approve, refuse or receive no response
             ↓
Flow continues along the configured path

On this page

Before you begin

Confirm the project, the people and the target environment before starting a release.

  • Confirm that the correct workspace is active.
  • Complete the Testing and troubleshooting guide.
  • Resolve the visible project issue count.
  • Confirm that all important business routes have been tested.
  • Save the current draft.
  • Decide which state should be recorded as a version.
  • Confirm whether an Agentic Worker must be published for use by a flow.
  • Identify sensitive actions that require human approval.
  • Agree who may approve those actions.
  • Prepare a non-production deployment environment.
  • Confirm that the required channels, workers, providers and capabilities are available.
  • Know who is authorised to approve production deployment.
A clean technical check is not business approvalDesigner can confirm that no blocking configuration issue was found. It cannot determine whether the customer’s business rules, security controls or operating procedures have been accepted.

1. Understand the release lifecycle

Each state or action in the lifecycle has one purpose. Confusing them causes incomplete releases.

Release lifecycle
State or actionPurpose
DraftThe editable project currently being designed
Saved versionA recorded state of the project
Published workerA reusable Agentic Worker available in the selected publication destination
Approval policyRules controlling human decisions during flow execution
Deployment environmentThe wiring between channels, workers and supporting resources
Deployed environmentAn environment activated through the deployment process
  • Saving does not publish.
  • Publishing does not automatically create a live customer channel.
  • Deploying does not replace runtime human approvals.
  • A Human Approval step does not approve the project release.
  • A worker may need to be published before it can be selected by a flow.
  • An environment must contain the required resources and connections before deployment.

2. Validate the project

The readiness check confirms that Designer found no blocking configuration issue.

A successful readiness check confirms that Designer found no blocking project issues.
  • The readiness check runs as the project moves toward publication or deployment.
  • A successful result says that no issues were found.
  • The summary may include the number of cards and process steps.
  • Let’s go continues to the next stage.
  • The figures shown belong only to the ACME demonstration.
  • The dialog uses the word “bot”; this guide refers to the project or solution.
  1. 1Save the current draft.
  2. 2Complete representative Run Demo tests.
  3. 3Resolve the visible issue count.
  4. 4Start the deployment or publication journey.
  5. 5Review the readiness result.
  6. 6Return to the Editor if an issue remains.
  7. 7Continue only when technical validation and business review have both succeeded.
Validation does not test every business outcomeA project may pass the readiness check while still containing an incorrect business rule, misleading customer message or unsuitable approval path.

3. Save and review versions

Record the exact state that passed testing before publishing or making further changes.

Record a project version before publication or significant changes.
Version history
Review the project versions currently available.
Save as version
Record the current state as a meaningful version.
Auto-layout
Rearrange the visual canvas. This changes presentation, not the purpose of versioning.
Import flow
Import supported flow content.
Export flow
Export the flow through the supported Designer format.
Export to GitHub
Send supported project content to a connected GitHub destination.
  1. 1Complete the intended design changes.
  2. 2Save the draft.
  3. 3Run the priority test scenarios.
  4. 4Complete the readiness check.
  5. 5Open the project actions menu.
  6. 6Select Save as version.
  7. 7Add a meaningful version label or description where requested.
  8. 8Review Version history to confirm that the state was recorded.
  9. 9Continue editing in the draft when further changes are required.
Version before publishingRecord the exact project state that has passed testing and business review. Avoid publishing from an unrecorded draft after unrelated changes have been added.
Only the shown actions are documentedThe current interface does not show comparison, rollback, restoration or branching controls, and it does not specify import or export file formats or GitHub repository behaviour.

4. Publish an Agentic Worker

Publication makes a completed worker selectable by flows and, where authorised, available in the Store.

Publish an Agentic Worker locally for use in Designer or additionally to the Store when authorised.
Local only
Saves the worker to this Designer so it appears in the Agentic Worker flow step. Use this when the worker is intended for solutions in the current Designer context.
Local and publish to Store
Saves the worker locally and also publishes it to the Store. The dialog shows that Store sign-in is required in this state.
  1. 1Open the Agentic Worker in Composer.
  2. 2Complete direct worker testing.
  3. 3Confirm the model, tools, guardrails, memory and limits.
  4. 4Save the accepted project state as a version.
  5. 5Select Publish.
  6. 6Review the version displayed in the dialog.
  7. 7Select Local only when the worker is required inside the current Designer.
  8. 8Select the Store option only when signed in and Store distribution is intended.
  9. 9Select Publish.
  10. 10Confirm that the worker is available to the intended Flow project.
Local publication is not deploymentPublishing locally makes the worker reusable in Designer. It does not connect the worker to a customer-facing channel or activate a deployment environment.
Do not assume the Store workflowThe dialog does not show listing metadata, Store visibility, pricing, commercial terms, review or moderation, publication permissions or version-update behaviour. Confirm those separately before promising them to a customer.

5. Understand runtime human approvals

Approvals pause sensitive flow activity until an authorised person decides what happens next.

The Approvals inbox shows work that is waiting for a human decision.
  • The Approvals page is the operational inbox for work paused while waiting for approval.
  • A request can be created when a flow reaches a configured Human Approval step.
  • The screenshot shows an empty inbox.
  • An empty inbox means no request is currently visible in the shown workspace state.
  • It does not prove that approval policies are absent.
  • It does not prove that no flow contains a Human Approval step.
Flow reaches Human Approval
             ↓
Flow references an Approval Policy
             ↓
Request appears in Approvals
             ↓
Authorised person responds
             ↓
Flow continues
When an expected approval is not in the inboxConfirm that the correct workspace is active, that the flow reached the Human Approval step, that the flow references the intended Policy ID, that the request has not already been answered or exhausted, and that the current user satisfies the policy’s approver rules.

6. Configure an approval policy

A policy defines its identity, its purpose and whether the requester may approve their own request.

An approval policy defines its identity and whether the requester may approve their own request.
  • About this policy
  • Levels
  • If nobody responds
  • Channels
Name
The human-readable name operators see in the list and on paused work.
Policy ID
The identifier a flow uses to reference the policy. The interface states it cannot be changed after the policy is created.
Description
Explains the policy’s business purpose and when it should be used.
Requester cannot self-approve
When enabled, the person who requested the action may not approve it. When disabled, the policy itself does not prohibit self-approval, although the requester must still satisfy any other approver rules.
Summary
The right-hand panel summarises the number of levels, the requester self-approval state, what happens when all levels are exhausted and the configured channels.
Automatic saving
Changes save automatically in the interface shown.
  1. 1Open Approval policies.
  2. 2Create a policy or open the policy to configure.
  3. 3Enter a clear operator-facing name.
  4. 4Choose the Policy ID carefully.
  5. 5Add a description explaining the protected action.
  6. 6Decide whether the requester may approve their own request.
  7. 7Review the Summary panel.
  8. 8Continue to Levels.
Choose the Policy ID before the flow uses itThe interface states that the identifier cannot be changed after creation. If an incorrect ID is created, a new policy and updated flow reference may be required.
Use separation of duties for sensitive actionsFor financial, compliance, security or high-impact actions, consider preventing the person who requested the action from approving it. This is a judgement per workflow, not a universal requirement.

7. Configure approval levels

Levels define who may respond, how many approvals are needed and when the request escalates.

Approval levels define who may respond, how many approvals are needed and when to escalate.
  • Each level is asked in sequence.
  • If a level receives the required approvals, the request can continue.
  • If a level reaches its time limit without an answer, the request moves to the next level.
  • What happens after the final level is controlled by If nobody responds.
Who may approve
The current interface supports choices such as administrators only or any member of the workspace. Treat these as examples from the current interface.
Approvals needed
The number of approvals required at that level.
Named approvers
Optionally limit the level to specified people. Naming people narrows the level to exactly those approvers.
Escalate after
The number of minutes the level waits before moving to the next level. Left blank, the level waits indefinitely instead of escalating automatically.
Add level
Adds another approval level for escalation or additional review.
Ordering
Use Move up and Move down where available to control the level sequence.
Zero approvals creates an open gateThe interface states that a level requiring zero approvals is an open gate. Use zero only when that behaviour is explicitly intended and approved.
  1. 1Open the Levels tab.
  2. 2Choose who may approve Level 1.
  3. 3Set the number of approvals required.
  4. 4Add named approvers only when the level must be limited to specific people.
  5. 5Enter an escalation time where automatic movement to the next level is required.
  6. 6Leave the escalation field blank only when indefinite waiting is intentional.
  7. 7Select Add level when another approval stage is required.
  8. 8Order the levels from first response group to final escalation group.
  9. 9Review the Summary panel.
Start with the simplest policy that meets the controlUse one level where one level is enough. Add escalation levels only when the business process requires them.
Two notes on the shown stateThe lower part of the screen includes an incomplete “Only when” control whose full configuration is not shown, so its behaviour is not documented here. The note that the member directory is unavailable and names must be typed is the state of this demonstration, not a permanent platform limitation.

8. Decide what happens when nobody responds

An exhausted request is either refused or treated as timed out. Neither outcome approves it.

Choose whether an exhausted approval request is refused or treated as timed out.
Deny
The request is turned down and the flow continues along its refused path. The interface states that every flow has a refused path.
Time out
The request expires and continues along the flow’s timed out path. The interface states that only some flows have a timed-out path.
A missed deadline is not consentNeither option approves the request.
  1. 1Open If nobody responds.
  2. 2Review the process risk.
  3. 3Choose Deny when the safe fallback is to refuse the action.
  4. 4Choose Time out only when the flow has a defined timed-out path.
  5. 5Confirm that the receiving flow handles the selected outcome.
  6. 6Review the Summary panel.
Confirm the flow path before choosing Time outDo not select Time out unless the flow has a controlled destination for the timed-out result.
Do not auto-approve by inactionAn unanswered approval must not be interpreted as permission to continue a sensitive action.

9. Review approval channels

Channel preferences are recorded with the policy, but approvals are answered from the inbox today.

Channel preferences are stored with the policy, but the current interface says approvals are answered from the inbox.
  • The Channels tab records a preferred delivery order.
  • No channels are configured in the state shown.
  • A channel name can be entered and added.
  • The interface states that preferences are saved but not yet acted on.
  • Approvals are currently answered from the Approvals inbox.
Use the Approvals inbox todayDo not tell users that adding a channel name will send an operational notification. The current interface explicitly says that these preferences are not yet acted on, so no notification behaviour should be promised.
Recording a preference is future readinessRecording preferences can prepare a policy for future supported notification behaviour, but it does not replace the current inbox workflow.

10. Configure a deployment environment

An environment connects the places customers reach you to the workers and capabilities that answer them.

A deployment environment connects customer channels to the workers and capabilities that answer them.
Environment
The screenshot shows an example environment name. Treat it as demonstration data, not as a default environment.
Add a channel
Adds the place through which users or systems reach the solution.
Add a worker
Adds the worker intended to respond through the environment.
Additional resources
The top Add controls show resources such as Provider, Agentic Worker and Capability.
Wiring assistant
A control offered by the environment. Its internal workflow is not shown, so it is not documented here.
Deploy environment
Starts the environment deployment process after the required resources and connections have been prepared.
Channel
   ↓
Worker
   ↓
Provider and approved capabilities
   ↓
Deployed environment
  1. 1Open Deploy.
  2. 2Open the intended non-production environment.
  3. 3Review the environment name.
  4. 4Select Add a channel.
  5. 5Add the worker intended to handle that channel.
  6. 6Add any required provider or capability resources.
  7. 7Connect the resources according to the environment design.
  8. 8Review the wiring.
  9. 9Use the Wiring assistant where appropriate.
  10. 10Select Deploy environment.
  11. 11Complete the deployment prompts presented by the product.
  12. 12Perform a controlled test after deployment.
An empty environment cannot serve requestsThe environment must contain the required channel, worker and supporting resources before it can provide a complete solution.
Deploy to a safe environment firstValidate new workers, capabilities and channels in a non-production environment before making them available to real users. The channel selector, resource configuration, wiring result, deployment prompts and deployed status are not shown here, so confirm them in the product rather than assuming their fields.

11. Recommended deployment sequence

A repeatable order that keeps technical validation, publication and business authorisation distinct.

  1. 1Complete worker and flow design.
  2. 2Run direct worker tests.
  3. 3Run end-to-end Flow tests.
  4. 4Resolve the project issue count.
  5. 5Complete the readiness check.
  6. 6Save the accepted project state as a version.
  7. 7Publish Agentic Workers locally where a Flow must select them.
  8. 8Confirm approval policies and Policy IDs.
  9. 9Test Human Approval paths using safe data.
  10. 10Open the target non-production environment.
  11. 11Add channels, workers and supporting resources.
  12. 12Review environment wiring.
  13. 13Deploy the environment.
  14. 14Complete a post-deployment test.
  15. 15Obtain the required business approval before production use.
  16. 16Repeat the controlled process for the production environment where available.
Change one layer at a timeWhen possible, avoid changing the worker, flow, approval policy and deployment environment simultaneously. Smaller releases are easier to test and diagnose.

12. Update a published or deployed solution

Repeat the controlled cycle rather than editing a live solution informally.

Edit draft
   ↓
Test changed behaviour
   ↓
Run nearby regression tests
   ↓
Complete readiness check
   ↓
Save as a new version
   ↓
Republish affected worker where required
   ↓
Review environment wiring
   ↓
Redeploy
   ↓
Complete a post-deployment test
  1. 1Make the change in the editable draft.
  2. 2Test the changed scenario.
  3. 3Retest related paths.
  4. 4Run the readiness check.
  5. 5Record a new version.
  6. 6Republish any Agentic Worker whose published configuration changed.
  7. 7Review approval policies when the change affects a sensitive action.
  8. 8Review the target environment.
  9. 9Redeploy using the supported deployment process.
  10. 10Confirm the solution still behaves correctly.
Only documented controlsRollback, promotion, environment copying and version comparison are not shown in the current interface, so do not plan a release around them.

Review before going live

Confirm this list before a solution is made available to real users.

  • The correct workspace is active.
  • Priority worker tests pass.
  • Important Flow branches pass.
  • Missing and invalid inputs are controlled.
  • The project issue count is resolved.
  • The readiness check succeeds.
  • The accepted state is saved as a version.
  • Required Agentic Workers are published locally.
  • Store publication is used only when intentionally required.
  • Approval policies use the correct immutable Policy IDs.
  • Requester self-approval matches the business control.
  • Approval levels contain the correct roles and approvers.
  • No level accidentally requires zero approvals.
  • Escalation timing is intentional.
  • The no-response outcome matches a valid flow path.
  • Operators know to use the Approvals inbox.
  • The deployment environment contains the required channel and worker.
  • Required providers and capabilities are present.
  • The environment wiring has been reviewed.
  • A non-production deployment was tested.
  • Production authorisation has been obtained separately.
  • No real customer data was used in unsafe testing.

Troubleshooting at a glance

Frequent release problems and the practical action that resolves them.

Publishing and deployment troubleshooting
ProblemLikely causeAction
The readiness check does not passA blocking project setting or connection remains incompleteReturn to the Editor, resolve the issue and run the check again
The readiness check passes but the process is wrongTechnical validation does not verify every business ruleExpand business testing and correct the process
The accepted project state cannot be identifiedThe draft was not recorded as a versionSave the accepted state using Save as version
A worker does not appear in an Agentic Worker Flow stepIt has not been published locally or the wrong workspace is activePublish it locally and confirm the workspace
Store publication is unavailableThe user is not signed in to the StoreSign in only when Store publication is genuinely required
Publishing locally did not create a live customer experiencePublication and deployment are separateConfigure and deploy an environment
The Approvals inbox is emptyNo request is pending, the Flow did not reach approval or the wrong workspace is activeCheck the Flow path, Policy ID and workspace
The requester can approve their own actionRequester cannot self-approve is disabledEnable the setting when separation of duties is required
The wrong people may approveThe role or named-approver settings are too broadReview the policy level and narrow the approvers
An approval level requires no decisionApprovals needed is set to zeroSet the intended positive approval count unless an open gate is deliberate
A request never escalatesEscalate after is blankAdd an approved time limit or accept indefinite waiting
A request is refused after all levelsIf nobody responds is set to DenyConfirm that the Flow handles the refused path
A timed-out request has nowhere to goTime out was selected but the Flow lacks a timed-out pathAdd a controlled path or select Deny
Approval notifications do not arrive in another channelChannel preferences are not yet acted on in the shown interfaceUse the Approvals inbox
The deployment environment is emptyNo channel or worker has been addedAdd and connect the required resources
Deploy environment cannot produce a complete solutionA worker, provider, capability or connection is missingReview all environment resources and wiring
A deployment change breaks another routeSeveral layers changed at the same timeIsolate the change and retest related paths
A sensitive change went live without business approvalTechnical deployment was confused with organisational approvalReinstate the required change-control process
Back to Designer Guides