Choose when to use Canvas
Canvas is useful when information is easier to understand or act on visually than in a chat reply. Good starting points include:- a current operations dashboard
- a generated report with filters or links
- a simple review or approval interface
- a focused view of files or data the Agent maintains
Edit and publish
Ask the Computer Agent to make the change, or edit its Canvas source through the workspace APIs. Source lives in theapp directory. Publishing builds that source and replaces the generated Canvas
files. Publishing also prepares dependencies declared by the Canvas project when they changed or
are unavailable. Always open the published Canvas after a change and test the real interaction.
The generated public directory is not the source of truth. A later publish replaces it, so edit
app instead.
Control access
Canvas supports three visibility modes:- Public: Anyone with the stable Canvas URL can open it.
- Private: A viewer needs authorized, time-limited access.
- Off: The Canvas cannot be opened.
Managing Canvas through the API? See Computer Agent Canvas.