Skip to main content

Studio Canvas

The Studio Canvas is your main workspace for building, connecting, and testing AI agent workflows. You can drag components, wire them together, configure logic, and inspect behavior—all from one interface.

Core Features

FeaturePurpose
Canvas LayoutOverview of interface zones and navigation
Building WorkflowsStep-by-step guide to adding and connecting components
Deploying AgentsMove from draft to production safely
Monitoring and DebuggingReview execution, logs, and performance
Error HandlingCatch, alert, or recover from failures
Mobile Experience WarningUnderstand how mobile device constraints affect the canvas UI

Canvas Layout

When you open an agent in Studio, the screen is divided into three key areas:

  • Left sidebar: Navigate tabs like Components, Agent Settings, Deployment History, Templates, and Vault.
  • Canvas workspace: The visual editor where you arrange and connect components.
  • Right sidebar: Configure individual components, test input/output, and inspect settings.
Auto-Save Enabled

Your work is saved automatically as a draft. Drafts don’t affect production agents until deployed.

Building Workflows

You build workflows by visually connecting components. Here’s how:

  1. Drag components from the component list on the left onto the canvas.
  2. Connect outputs to inputs to pass data between components.
  3. Configure settings using the panel on the right.
  4. Test as you build using the built-in preview and inspect tools.
  5. Adjust the flow as needed—components can reference earlier results in the chain.
  6. Connect to Agent by adding an Agent Skill and connecting it to your workflow.

You have access to 40+ production-ready components including LLMs, APIs, RAG tools, and logic handlers. Learn more in the Components Overview.

Deploying Agents

Once you’re satisfied with your workflow:

  1. Click Deploy in the top-right.
  2. Add release notes to describe the version.
  3. Confirm to push your agent to production.
  4. Use version history to roll back if needed.

Monitoring and Debugging

Inspect lets you preview and debug workflows without deploying.

  • Component preview: Click any component to see inputs and outputs
  • Run history: Review previous executions and filter by success/failure
  • Logs view: Jump directly to detailed logs for each run

Need Production Logs? Visit Agent Logs for deeper visibility into executions.

Error Handling

You can define error handling for any step in your workflow—or globally.

Options include:

  • Retry policies: Retry a component N times on failure
  • Fallback paths: Provide defaults or cached data
  • Notifications: Alert users via email or Slack
  • Global error handler: Catch all uncaught errors at the workflow level
Best Practice

Add fallback logic and alerts to reduce downtime and improve agent resilience.

Mobile Experience

When accessing the SmythOS canvas on devices with screen widths smaller than 1024px, you’ll encounter a Mobile Experience Limited warning modal. This appears because the canvas interface relies on ample screen space for effective workflow building.

Small screens limit usability when:

  • Arranging and wiring components
  • Accessing input/output fields
  • Configuring settings panels

For the best experience, use devices with screen widths of 1024px or larger.

The warning modal offers the following options:

  1. Copy Link to Desktop – Copies the current URL for opening on a desktop.
  2. Email Link to Myself – Sends the current canvas link to your registered email address.
  3. Continue Anyway – Dismisses the modal and allows limited use on mobile.
  4. Do Not Show Again – Hides the modal in future sessions on the same device.

Additional Resources

At the bottom of the modal:

  • Documentation Link – Directs to relevant SmythOS docs.
  • Contact Support Link – Opens an invite to the SmythOS Discord community.

What to Try Next