The AI Assistant

The AI Assistant is a floating chat button available on most pages: the dashboard, a workspace, the editor, and run pages. Wherever you open it, it knows what page you're on, so you don't have to explain what you're looking at.

Asking questions

Type a question and it answers using the current page as context. You can ask about the template you're editing, a run's results, what a piece of YAML does, or how Puffin Ship works in general. It's a fast way to check what a processor's parameter does, or why a run turned out the way it did, without leaving the page.

Editing your template with it

In the editor, ask for a change in plain language: "add captions," "make the b-roll longer," "use a different voice for the narration." The assistant proposes a config change and shows it to you as a diff before anything happens.

Review the diff, and if it looks right, click Apply to editor. The change lands in your template the same way a manual edit would, so you can still adjust it by hand afterward. Nothing is saved until you save the template yourself.

Taking actions

Beyond editing the open template, the assistant can act on your workspace when you ask it to: create or duplicate templates, start runs, manage files and folders, and manage run groups and variables.

Destructive actions, such as deleting something or clearing saved work, always ask for an in-chat confirmation before they happen. It won't do those silently.

What it will not do

It never shows or sets secret values. Custom secrets and service API keys are write-only by design; the assistant can't read them back to you or fill them in on your behalf. Set those yourself in the editor's Settings slide-over or in Workspace Settings.
It's rate-limited. It can start at most 5 runs per workspace per hour. If you need more, start them from the Runs panel instead.

Clearing saved work

There's no clear-cache button in a template's settings. Instead, ask the assistant to clear a template's saved step output, either the whole template or from a chosen step onward. It will confirm before clearing anything.