Docs / Automations

Build automations by talking

Studio Builder turns a request in ordinary language into a working Studio automation. You describe the outcome; Builder asks for the decisions it cannot safely make, creates a plan, builds the required pieces, tests them, and shows you what needs approval.

Open Builder from the floating sparkle button. The window follows you around Studio, so you can inspect content, agents, automations and run history without losing the conversation.

The Studio Builder window floating over the Automations list, showing recent conversations
Builder floats over whatever you are looking at — here the Automations list — and keeps your earlier conversations.

Start with the outcome

Describe what should happen, what data it concerns, and where a person must decide. You do not need to know function schemas or flow YAML.

When an article is saved, check whether its title starts with an emoji. If it does not, ask an agent for a suitable emoji, update the title, and let an editor review the change before it becomes live.

Builder may ask which article type, workspace, folder or owner you mean. When a safe default exists, you can tell it to use the default.

It then says what it intends to create, in the vocabulary of the thing rather than the schema, and waits.

Builder listing a function and an agent it proposes to create, and asking for approval
Builder names the pieces it wants to create — one function, one agent — and asks before creating either.

The plan appears in the conversation as tasks, each with its own state. Nothing runs until you approve it.

A five-task plan marked Awaiting Approval, with Reject and Approve buttons
Five tasks, none started. Awaiting Approval is a stop, not a status message.

Once approved, the tasks tick over one at a time. The tool it is running is named as it runs, and each call can be expanded to its arguments and result.

The plan mid-run: two tasks completed and struck through, one In Progress, and a running tool call
Completed tasks are struck through, the current one says In Progress, and the tool being called is visible while it runs.

At the end Builder summarises what exists now and what it did not do — here the automation is compiled but left disabled, which is the state every new automation starts in.

Builder reporting all tasks complete, a disabled automation proposed, and the next decision
It finishes with the next decision to make, not with a claim that the work is live.

What Builder can make

  • Functions for deterministic work such as finding nodes, checking fields or updating content.
  • Agents when a reusable role needs judgement, instructions and a controlled set of tools.
  • Automations that connect an event, schedule or manual start to functions, agents and people.
  • Skills that teach one agent step a procedure only this automation needs.
  • Tests and trial runs so the result is exercised before Builder calls it finished.

Builder reuses existing functions and agents when they fit. It creates another durable agent only when you ask for a reusable role, not simply because one task needs doing.

What it makes is ordinary Studio content. The automation appears in the Automations list beside the ones you wrote by hand:

The Automations list now showing an Emoji Suggestion and Editorial Review automation among the others
The generated automation is a normal document in the list — nothing about it is special-cased.

…and opens in the same editor, with the same problem checks. Here the flow runs start → agent → editor task → end, and the editor points out that the agent step has no agent chosen yet:

The generated flow open in the automation editor, with a Problems panel showing one warning
The same editor, the same warnings. A generated flow is reviewed exactly like a hand-drawn one.

An agent Builder creates is a real agent: it has a prompt, a model, schemas and a test chat you can use straight away.

The created Emoji suggester agent open in the agent editor, answering a test chat with a single emoji
The Emoji suggester Builder created, answering a test message with one emoji.

Review, stop and redirect

Builder asks you to approve the exact change it is about to make. If it revises that change, for example after you ask for something extra, it asks again. An earlier approval never covers a later version.

While it works you can Stop it, Pause and Resume it, or send a direction. The direction is shown as queued until Builder reads it at the next safe point. A panel beside the conversation lists each piece it built, where that piece lives, and the proof that it works. Build apps and automations with Builder covers these controls in detail, as well as building whole apps.

When it cannot do something

Builder reports what happened rather than what you hoped for. Asked directly whether an automation exists, it answers from the tool result — including when the answer is no, and why:

Builder answering that the automation was not created, naming the failed tool call and the compilation error
No automation, no invented path. It names the call that failed and the reason.

This matters more than it sounds. A tool that returns a proposal and a tool that writes a node look alike in a transcript, and an assistant that confuses them will report a path that does not exist.

Errors and retries

Builder retries temporary failures. When a piece still fails its checks, Builder gets the exact problem and a limited number of attempts to fix it. If the same problem comes back, it stops and shows the error. It does not spin forever or claim success. If it catches itself repeating a call without progressing, it stops and says so, naming the tool:

Builder explaining that it stopped because it kept calling propose-automation without getting anywhere
Stopping with an explanation beats looping quietly, or answering as if it had succeeded.

Ask Builder to inspect the failure, change the objective, or revise the generated function and run its test again.

A good request

The most useful request contains four things:

Tell BuilderExample
WhenWhen a standard article is saved.
CheckIts title does not already start with an emoji.
DoChoose an emoji and prepend it to the existing title.
Ask firstLet the article owner review the proposed content change.

You can refine the plan in the conversation before approving it. The result is still a normal Studio function, agent or automation: it appears in the same editors, has the same history, and can be maintained without Builder.

Where to go next

Pilot documentation. Studio is in a partner pilot. Screens and YAML shown here are current as of the version noted on each page; tell your Maravilla contact when something does not match what you see.