Docs · Overview

What Suede Agent Studio is

A visual builder and launcher for agent workflows. You wire nodes on a canvas; the studio publishes the service, its HTTP route, and its current preview, payment-enabled, or unavailable state. Payment is enabled separately after readiness checks.

The idea in ninety seconds

Flows in, endpoints out

A flow is a graph: a trigger node starts it, LLM and tool nodes do the work, logic nodes route and reshape data, and an output node defines the result. You test the flow in the studio (dry-run by default, so nothing costs money and nothing external is called) until it produces the output you want.

Launching publishes that flow as an agent: a public page, a directory listing, and a run endpoint at POST /api/agents/<id>/run. For an ordinary standalone service, publication may expose a dry-run preview. Company or otherwise unready services may be unavailable. A price is an intended rate, not payment enablement; after deployment, payout, platform, and company checks pass and payment is enabled, the endpoint issues x402 challenges. Every settled call routes to your payout address. Details live in Payments.

Architecture

Four parts around one contract

The canvas

A visual editor where you drag nodes from a palette and wire them with edges. Nodes are typed (triggers, AI, logic, I/O, documents, comms, finance, dev tools) and each shows its per-call price on the card if it has one. The canvas edits a plain data structure, not code.

The flow contract

Every flow is a FlowGraph: a list of nodes with typed params and a list of edges connecting outputs to inputs. Because the contract is plain data, the same flow can be edited on the canvas, exported as a template, validated before launch, and executed by the engine.

The engine

Runs a graph in topological order: each node executes when its inputs are ready. The engine keeps a per-node USDC cost ledger, halts downstream work when a node on the main path errors, guards subflow depth, and enforces a per-run spend ceiling before every cost-bearing node.

The runtime

The hosted API around the engine: flow CRUD, streamed runs, cron triggers, signed webhooks, and public call-state discovery. Ordinary standalone services may preview; payment-enabled services expose x402 terms; others may be unavailable.

Ways to build

Canvas, code, or templates

The canvas is the primary setting, and 88 templates cover common business workflows (lead scoring, invoice chasing, contract review, support triage, PR digests) so most flows start from a working example rather than a blank page. The @suedeai/agents SDK is the code setting: define an agent in TypeScript and push it live from the terminal, or run it on your own server and let the platform relay preview calls and, when enabled, settled paid calls.

The current public Suede gateway inventory has 3 pay-per-call routes: music, video, and image generation. Each public route carries a fixed USDC price listed on Pricing.

Scope, honestly

What it is not

It is not autonomous by default. Flows run when triggered: by you, a schedule, a webhook, or a paying caller. Nothing self-modifies, and every cost-bearing step is bounded by a per-run ceiling and daily budgets.

It does not move real money until you say so. Settlement starts off by default. For an ordinary service that can yield a preview; a company or payment-only service may instead be unavailable. No USDC moves until the service passes deployment, payout, and platform checks and payment is explicitly enabled. Missing payment readiness never creates a paid service.

Publishing is not demand. Launching makes an agent discoverable in the directory, JSON catalog, AgentCard, and A2A interface. The x402 index keeps every published service crawlable and marks preview, payment-enabled, or unavailable; only payment-enabled entries include active acceptance terms. Discoverability is not a promise of callers or revenue.

Some surfaces are prototypes and say so. The Connector Lab's API Operation node is simulation-only and cannot be launched into a live agent; the launch API rejects graphs that contain it.

Next

Where to go from here

Building flows covers nodes, edges, and testing, and the node reference lists the full catalog. Launching covers going live, Architecture what runs underneath. API for callers documents the endpoint from the buyer's side. Prefer prose? Start with the introduction to agentic workflows.

Three connected Agent Studio views showing one agent as an org-chart seat, a workflow, and a paid service endpoint.
Seat, flow, serviceThe same agent as a seat, a flow, and a service.