Skip to content

Publish and Share Agents

Publish the tested draft, then choose its audience in Share settings. Publication creates a version holding the agent’s name, instructions, tools, approval policies, and Reference files. Sharing grants use, not editing. Publishing preserves enabled state, visibility, and individual grants. A paused agent stays paused, and an already-shared audience receives the update immediately. Review existing access before publishing.

Release the intended workflow dependencies

Section titled “Release the intended workflow dependencies”

An attached Support desk flow must exist in a published workflow release. Workflow-scoped tool calls carry an explicit workflowId.

With an assistant: find the exact Support helper match with agent_list:

{ "search": "Support helper", "ownership": "mine" }

Note its id in data.agents as <agentId>, then list its tools with agent_tool_list:

{ "agentId": "<agentId>" }

If Support desk is attached, note its workflowId and flowId in data.tools as <workflowId> and <flowId>. Read that workflow’s release state, validity, and triggers with workflow_status, workflow_validate, and trigger_list, each called with:

{ "workflowId": "<workflowId>" }

If the intended live release already exists, skip workflow publication. Otherwise reuse the run inputs from Attach Agent Tools, with ticket T-104 and summary Account-specific policy review requested. Exercise every relevant subflow path, and verify terminal results and promised return values. A development call has real provider effects and consumes usage, so use the approved test destination. Run it with run_flow:

{ "workflowId": "<workflowId>", "flowId": "<flowId>", "target": "dev", "inputs": { "<ticketInputId>": "T-104", "<summaryInputId>": "Account-specific policy review requested" } }

Review every enabled trigger, because publishing activates Live dispatch. Armed Test events let one real event run in both development and Live. Disarm them, or approve dual dispatch explicitly. Recovery with acknowledgeDualDispatch and acknowledgeValidationErrors is explained in workflow publication.

In the app: open Workflows → Support desk → Dev → Publish. The assistant equivalent is workflow_publish, followed by workflow_status:

{ "workflowId": "<workflowId>", "name": "Support desk release" }

If browser-approval polling is interrupted, note the reported approvalId and resume polling with approval_resume. Do not publish again.

{ "approvalId": "<approvalId>" }

Publishing updates every Live agent following that workflow, without another agent publish. An idle session refreshes immediately. A turn in flight or a pending approval can finish on the previous release. If you see agent_session_refresh_failed, verify in a fresh Live conversation.

In the app: open Agents → Support helper → Test → Publish. For an unchanged draft, Publish is disabled and reads No unpublished changes. The dialog’s publish button stays disabled while checks are loading, unavailable, or blocked.

With an assistant: read the agent with agent_get, then run the same checks with agent_publish_preflight, each called with:

{ "agentId": "<agentId>" }

Check data.hasUnpublishedChanges from agent_get. If it is false, stop. Otherwise publishing through the assistant tools creates an identical version and repeats the Live cutover.

Blocker Correction
Workflow missing or unpublished Remove the unintended tool, or publish the dependency.
Published workflow malformed, attached flow absent, or no starting action Fix the flow and publish its workflow.
Direct action unavailable Attach an available integration action.
Connection missing, inactive, mismatched, or not owner-owned Select an active matching owner connection.

Preflight checks attached actions and workflow entry flows. It does not validate subflows recursively, and it does not prove returned values. Unpublished workflow changes alone do not block it. Compare Live’s release with Test evidence. A nonblocking schema_tier_changed diagnostic means configurable inputs changed, so recheck the arguments. Publishing refreshes the cached schema tier.

Publication moves existing Live conversations to the new version. It expires their pending requests and requests approved but not yet run, and it stops active Live runtimes. Test conversations and approvals are untouched. Resolve Live approvals first, because expiry does not authorize repeating an action.

In the app: enter an optional Publish note, then select Publish agent. A note allows 280 characters. Whitespace-only input becomes no note.

With an assistant: publish with agent_publish, then list the versions with agent_version_list and { "agentId": "<agentId>" }:

{ "agentId": "<agentId>", "name": "Support helper launch" }

If the result is uncertain, reread the agent and its versions before retrying. A cleanup failure does not undo the committed release.

History and conversation models are preserved. Reference content is frozen, and Runtime files remain mutable. A direct action’s identity and approval policy are versioned, but its connection and authorization stay live. Rebinding redirects calls immediately. Revocation or detachment can block Live without publication.

Shared users use the owner’s connected accounts and the organization’s usage pool. They cannot edit the agent or start owner-only Test.

In the app: open Live → Access → People & sharing → Share settings. Choose Anyone in the organization or Only me and people invited, then Save settings. Under the second option, where Specific people is available, Add teammate grants access immediately and attempts an email. A failed email does not undo the access. Organization visibility sends no broadcast email. An individual removal applies immediately.

With an assistant: open the agent to the organization with agent_visibility_set, then reread it with agent_get:

{ "agentId": "<agentId>", "value": "organization" }

Individual grants are app-only. Organization visibility requires publication. Switching to private preserves explicit grants and stops every active Live and Test runtime. Removing someone’s last access source stops everyone’s runtimes too, and expires requests not yet run, so finish turns and approvals first. When sharing and organization collaboration are both enabled, organization administrators keep use access. Review the listed people separately.

In the app: start fresh Live conversations using the model recorded in Test. Repeat the policy question and authorized safe tool request below. Have an intended teammate check access from their account.

With an assistant: reuse Test’s claude-sonnet-5 model. For an attached notification action, use the selected safe channel ID as <channelId>. Approving authorizes a real provider call and consumes usage, so verify its result and destination. Call agent_test once for each message:

{ "agentId": "<agentId>", "rail": "live", "model": "claude-sonnet-5", "message": "What should I include when escalating ticket T-104?" }
{ "agentId": "<agentId>", "rail": "live", "model": "claude-sonnet-5", "message": "Send exactly this to channel <channelId>: Test escalation T-104: account-specific policy review requested" }

If the attached capability is Support desk, replace the second message with the tested request: Escalate ticket T-104 with summary: Account-specific policy review requested. Use only the safe destination configured for that test.

Note data.conversation.id. When approval or a timeout interrupts the wait, the result reports that status instead of a finished reply; keep the conversation ID it names. Then follow the history and approval procedure. Check the returned model against Test. After approval, wait for a terminal result without resending. Verify the policy answer, the adopted version, the tool result, the external effect, and any expected Live record. Test and Live use different workflow releases and stores.

To stop Live, choose Edit → name menu → Pause agent and confirm, or call agent_set_enabled with { "agentId": "<agentId>", "enabled": false }. Pausing stops active Live and Test runtimes, auto-denies pending approvals, and expires requests approved but not yet run. The owner can start another Test turn afterward. Resume agent, or agent_set_enabled with enabled: true, restores the same version and audience. There is no public rollback to an earlier agent version. Fix the draft, test it, and publish again. The in-product builder hands agent testing, publishing, and sharing to the owner in the app.

To have the published agent run by itself at set times, add a schedule.