Guided, Studio and Code: three views of one agent

What is the difference between Guided, Studio and Code?#

They are three levels of hand-holding on one agent. Guided walks you through software setup. Studio and Code are the expert tools: the canvas and TypeScript. All three read and write the same saved workflow.

import { defineAgent, schedule, suede } from "@suedeai/agents";

export default defineAgent({
  name: "weekly-brief",
  description: "Turns notes into a one-page brief every weekday morning.",
  triggers: [schedule("0 13 * * 1-5")],
  async run({ input }) {
    const out = await suede.llm({
      system: "Write a one-page brief with clear next steps.",
      prompt: String(input ?? ""),
    });
    return { brief: out.text };
  },
});

How do I switch between views?#

Use the view switch at the top of the canvas and the Code page. It always opens the same agent, so you can draft in Guided, fine-tune in Studio and hand the source to a developer in one sitting.

Do changes in one view show up in the others?#

Yes, instantly. Guided, Studio and Code are three windows onto one persisted workflow, not three copies. Change a prompt in Studio and the Code source shows it. Answer a new question in Guided and the canvas shows the new step. When you want a fixed point to return to, press Save version and that checkpoint stays frozen while you keep editing. See Versions.

Which view should I start in?#

• You run the business and want the work off your plate: start in Guided.
• You like to see exactly how it works, or you came from GoHighLevel, Zapier or Make: start in Studio. The canvas reads like the workflow builders you know, with AI steps built in.
• You ship software: start in Code, or build on the canvas and pull the source into your repo.

How do developers build agents in Code?#

Install the SDK, scaffold an agent and push it. The CLI handles login, local serving and publishing, so an agent fits into the same review and deploy habits as the rest of your code.

npm install @suedeai/agents
suede init              # scaffold agent.ts + .suede/config.json
suede login <key>       # save your workspace key
suede dev               # serve locally on :3001
suede push              # publish agent.ts
suede pull <slug>       # write agent.ts from an agent on the platform