Creating Canvases
New Canvas Modal
Open the Canvas list page and click New Canvas.
Required Fields
| Field | Description |
|---|---|
| Name | Display name for the canvas |
| Canvas Agent | Required. Select a canvas-kind agent that will generate charts. |
| Workflow Sources | Optional at creation. Link up to 3 workflows to pull execution data from. |
Description
A description is optional but helps teams understand the canvas purpose.
Linking Workflow Sources
Each workflow source links a canvas to a workflow's execution output data:
- Latest run — use data from the most recent execution only
- Last N runs — aggregate across the last N runs (1–500)
- Date range — aggregate executions between two dates
- All runs — aggregate all available executions
You can add up to 3 sources per canvas. The first source is used by default for chart generation; you can switch sources from the prompt bar's source dropdown when multiple are linked.
Aggregate from Output
Each workflow exposes its data to Canvas through its Output node(s). When a source's workflow has more than one Output node, an Aggregate from output dropdown appears under that source:
- Auto (default) — Canvas reads the workflow's top-level output (the last Output node reached during a run).
- A specific output — pick a named Output node to aggregate only that branch's data. Output nodes appear by their
label(or "Output 1 / Output 2…" if unlabeled).
This makes Canvas deterministic for branching workflows — e.g. a Switch that routes to Output "path_a" vs Output "path_b", where each Output feeds a different chart. When a workflow has a single Output node, it's selected automatically and the picker is hidden.
Canvas Agent Is Required
The creation modal disables the Create Canvas button until you select a canvas agent. If no canvas agents exist, a warning prompts you to create one in the Agents page first.
Auto-Generate Flow
The auto-generate feature creates an entire multi-tab canvas automatically from your workflow data.
Step 1: Enable Auto-Generate
Toggle Auto-generate charts in the creation modal. Additional options appear:
- Purpose — describe what you want to understand from the data
- Max tabs — number of tabs to generate (1–6)
- Charts per tab — charts per tab (2–12)
- Use tabs — if disabled, all charts go in a single tab
Step 2: Plan Preview
After canvas creation, the canvas editor first calls your canvas agent to generate a plan — a proposed tab structure and chart ideas based on your data schema and purpose. The plan is shown to you before any charts are generated.
You can review and approve the plan. Charts are only generated after you confirm.
Step 3: Generation Progress
The editor shows a progress bar as charts generate in parallel. Failed charts appear as placeholder cards with an error message — they can be regenerated individually.
Manual Chart Creation
Once a canvas has workflow data:
- Type a prompt in the bottom prompt bar (e.g., "Show distribution of status codes as a pie chart")
- Press Enter or click the send button
- The canvas agent generates the chart and it appears in the current tab
The prompt bar is disabled if no canvas agent is configured.
Managing Sources After Creation
Click Manage sources in the canvas editor top bar to add, remove, or reconfigure workflow sources without leaving the editor. Changes take effect on the next chart generation or data refresh.