🛠️

Canvas Builder Guide

Everything you need to know to build, configure, and publish your first swarm. No coding required.

01

What is a swarm?

A swarm is a chain of AI agents working together in sequence. Each agent handles one specific task and passes its output to the next agent — like an assembly line for AI.

Researcher

Finds info

Analyst

Processes it

Writer

Creates output

Verifier

Checks quality

Each agent runs a different AI model, has its own instructions, and builds on what came before it. The final agent delivers the completed output to the user.

02

The six agent types

SwarmSeller has six agent types. Each has a different default role and works best in a specific position in your swarm.

🎯

Orchestrator

Start of swarm

Plans the task, reads user input, and directs other agents. Always use this as your first node. Think of it as the project manager.

🔍

Researcher

Early in swarm

Searches the live web using Perplexity. Use this whenever your swarm needs current information, news, job listings, market data, or anything that changes frequently.

📊

Analyst

Middle of swarm

Processes, scores, and evaluates information. Use this to rank options, score opportunities, build frameworks, or make structured decisions from raw data.

✍️

Writer

Middle to late

Creates written content — articles, emails, reports, cover letters, social posts. You can use multiple Writers in one swarm for different types of content.

Executor

Middle of swarm

Takes action or builds structured outputs — schedules, plans, step-by-step processes, and organised deliverables. Think of it as the doer.

Verifier

End of swarm

Reviews, fact-checks, and quality-controls the output from all previous agents. Always use this as your last node. It catches errors and ensures the final output is ready to use.

03

Building on the canvas

The canvas is your workspace. Here is how to use it step by step.

1

Add nodes from the left panel

Click any agent type in the left sidebar to add it to the canvas. Each click adds one node. Add them in the order you want them to run — top to bottom works best for readability.

Tip: Start with an Orchestrator. End with a Verifier. Fill the middle with whatever your swarm needs.

2

Connect your nodes

Hover over a node until you see a small circle appear on its edge. Click and drag from that circle to another node to create a connection. Connections show the flow of information between agents.

Tip: You can branch — one node can connect to two nodes running in parallel. Both will receive the same input and run simultaneously.

3

Configure each node

Click any node to open its configuration panel on the right. Here you can change the name, select the AI model, write the system prompt, set temperature, enable memory, and turn on the human approval gate.

Tip: The system prompt is the most important setting. Write it in plain English — tell the agent exactly what it is, what it receives, and what it should produce.

4

Delete a node

Click any node to select it (it will highlight), then press the Delete or Backspace key on your keyboard to remove it.

Tip: Connections attached to a deleted node are also removed automatically.

5

Save your swarm

Click the Save Swarm button in the top right. A modal will appear asking for a name, description, and emoji. Fill these in carefully — they appear on your marketplace listing.

Tip: You can save and come back to edit at any time. Your swarm is saved as a draft until you publish it.

04

Choosing the right AI model

Each node can use a different AI model. Choose based on what that agent needs to do.

ModelBest forAvoid for
Claude SonnetWriting, reasoning, long documents, following complex instructionsLive web data
GPT-4oData analysis, structured outputs, scoring, fast processingVery long outputs
Perplexity SonarLive web search, current news, job listings, market dataCreative writing, reasoning
GeminiVery long documents, multimodal tasks, large contextNuanced writing
GrokCurrent events, social media trends, cultural contextPrecision tasks
EnsembleWhen you want the best of multiple models combinedSpeed-critical tasks
05

Advanced settings

Temperature

Controls how creative or predictable the AI is. Lower temperature (0.1-0.3) = more focused and consistent output, great for analysis and factual tasks. Higher temperature (0.7-1.0) = more creative and varied output, great for writing and brainstorming. Default is 0.7 which works well for most tasks.

Persistent memory

When enabled, the agent remembers context from previous runs with the same user. Use this on the Orchestrator node when your swarm benefits from knowing the user's history — for example a Life Admin swarm that learns your preferences over time. Only enable on one node per swarm, usually the Orchestrator.

Human approval gate

When enabled, the swarm pauses at that node and asks the user to review and approve the output before continuing. Use this on the Verifier node for high-stakes swarms — financial analysis, medical information, or anything where a human check is important. The user sees the output and clicks Approve or Reject.

06

Writing great system prompts

The system prompt is the most important part of your swarm. It tells each agent who it is, what it receives, and what it should produce. Here is the formula that works.

The formula

Who you are

You are a senior career coach specialising in tech industry applications.

What you receive

You will receive a candidate's CV and a job description.

What you produce

Produce a tailored CV rewrite and a cover letter.

How to do it

Mirror language from the job description. Quantify achievements. Keep to two pages.

What not to do

Do not use phrases like I am passionate about or I am a team player.

Common mistakes

  • Being too vague — 'Analyse the data' tells the agent nothing. Be specific about what data and what analysis.
  • Forgetting to tell the agent what format to use — should it use bullet points, paragraphs, tables, headers?
  • Not telling the agent what input to expect — mention that it receives output from the previous agent.
  • Making the system prompt too long — keep it focused. One clear job per agent.
07

Publishing your swarm

Once your swarm is saved and tested, you can publish it to the marketplace. Here is what you need to prepare.

Swarm nameClear and descriptive. Users should know what it does from the name alone. E.g. Job Hunter, Business Plan Creator, Finance Scout.
Short descriptionOne to two sentences. What does it do and who is it for? Include what the user needs to provide for best results.
EmojiPick an emoji that represents what your swarm does. It appears on your marketplace card and makes your listing stand out.
Example promptWrite a realistic example of what a user should type when running your swarm. Be specific. This appears on the run page to guide users.
Usage instructionsExplain how to get the best results. What information should the user provide? What format works best? What should they expect as output?
Sample outputRun your swarm with the example prompt and paste the real output here. Users can see a preview before purchasing. This is one of the most important conversion factors.
PricingSet prices for Try It Once (1-run trial), 5-Pack, 15-Pack, and 30-Pack bundles. The system enforces minimum prices based on your swarm's complexity to protect your margins. Public creators keep 65% after Stripe fees; Founding Creators keep 75%.
08

Tips from the SwarmSeller team

Start simple

Your first swarm should be 3-4 nodes maximum. Get it working perfectly before adding complexity. A great 3-node swarm beats a broken 7-node swarm every time.

Test before publishing

Run your swarm at least 5 times with different inputs before publishing. Edge cases will surprise you. Fix them before your users find them.

Specialise your agents

Each agent should do one thing really well. If you find yourself writing a system prompt that does three different things, split it into three separate nodes.

Match models to tasks

Use Perplexity for anything that needs live web data. Use Claude for writing and reasoning. Use GPT-4o for analysis and structured outputs. Mixing models strategically makes swarms dramatically more powerful than using one model for everything.

Write for your user

When writing your example prompt and usage instructions, imagine your least technical user. Make it impossible to get wrong. The more specific your guidance the better your reviews will be.

Price for value not cost

Price based on the value your swarm delivers, not just the token cost. A swarm that saves a user 4 hours of research is worth $20 per run even if it costs you $0.50 to run.

Ready to build?

Open the Canvas Studio and build your first swarm in minutes.