Skip to main content
Workflows are named app surfaces for guided work. Use a workflow when a user should start a specific flow from the sidebar, optionally fill out a launcher form, then continue in a session-backed chat.

Create a workflow

Workflows appear in the hosted app sidebar.

Start without a custom UI

If the workflow has no @wf.ui() launcher, Capsule opens a simple workflow chat composer.

Add a launcher UI

The submitted fields are delivered as WorkflowInput.

Add actions

Actions are structured follow-up handlers for workflow UI submits.

Scope

Workflow scope controls how runs are grouped:
  • user: runs belong to the signed-in app user
  • owner: runs belong to the owner identity
  • app: runs are app-level