Workflow Chat
Chat interface to interact with workflow blocks.
Overview
| Property | Value |
|---|---|
| Key | workflow_chat |
| Category | Utility |
The Workflow Chat widget provides a conversational interface for interacting with workflow blocks. It connects to the active workflow over a live socket, streams responses in real time, and lets you select which block outputs appear in the conversation. Use it to test chat-based triggers, talk to AI agents inside a workflow, or inspect responses during development.
Features
- Live socket connection -- each chat instance opens its own socket to the workflow, so messages and responses stream in real time
- Output selector -- a multi-select dropdown in the header lets you choose which workflow block outputs are included in the chat response; selections are deduplicated and persisted per workflow
- Clear chat -- a header button wipes the current conversation history for the active workflow; the button is disabled when there are no messages
- Workflow selector -- a dropdown in the header center lets you switch between workflows in the workspace; when the widget is paired (non-gray pair color) the dropdown reflects the shared selection and manual changes are ignored
- Automatic workflow resolution -- the widget resolves the active workflow from widget params, pair-color channel, or the workflow registry, and persists the selection across sessions
Usage
Adding the widget
Open the widget picker and select Workflow Chat. The widget requires an active workspace; if none is selected it displays a prompt to choose one. Once a workspace is loaded, it automatically connects to the first available workflow.
Header layout
- Left -- output selector dropdown to pick which block outputs feed into the chat
- Center -- workflow dropdown to switch the target workflow
- Right -- clear chat button (trash icon) to reset the conversation
Key interactions
- Type a message in the input field at the bottom and press Enter to send
- Responses stream into the conversation area as the workflow executes
- Use the output selector to narrow responses to specific blocks
- Click the clear button to start a fresh conversation
Pair color syncing
When assigned a pair color, the widget shares its active workflow with other widgets on the same color channel -- typically the Workflow Editor. Changing the workflow in the editor automatically updates this chat widget. When the pair color is gray, the widget manages its own workflow selection independently.
Pair this widget with the Workflow Editor using a matching pair color so the chat always targets the workflow you are editing.