Agent

DocsAgent

Presets — Saved Prompt Configurations

Presets let you save your current chat configuration as reusable templates. Instead of typing the same prompt patterns repeatedly, create a preset once and apply it with a single click. Presets work at both team and project scope.


What a Preset Stores

Each preset captures the full chat-composer state:

FieldDescription
NameHuman-readable label, e.g. "Fix TypeScript errors"
PromptThe system prompt text sent to the Agent
ScopeTEAM — visible to everyone on the team, or PROJECT — only visible within a specific Studio project
Loop enabledWhether the Agent should run in a goal-driven loop
Max iterationsHow many loop cycles the Agent attempts before stopping (1–100)
GoalThe natural-language objective the Agent works toward in loop mode
IntervalOptional re-run schedule in minutes (1–1440). The prompt fires automatically every N minutes, with or without the Agent loop.

Scopes

Presets operate at two visibility levels:

  • Team — every member in the team sees the preset in their dropdown. Good for shared workflows like code-review prompts, test-generation templates, or team conventions.
  • Project — only members with access to a specific Studio project see the preset. Requires a bound project. Use this for project-specific workflows, build scripts, or deployment checklists.

When no project is bound to the machine, the PROJECT option is disabled in the create/edit dialog.


Agent Loop Integration

When you enable loop mode in a preset, applying it also configures the Agent loop settings automatically:

Max iterations: 10
Goal: "Refactor all API routes to use the new error-handling middleware"

The Agent then runs in a cycle — generating, testing, and refining — until it reaches the goal or exhausts iterations. The loop badge (![loop]) appears next to the preset name in the dropdown.


Interval Scheduling

Set an interval (in minutes) to make the preset fire on a timer. The prompt is re-sent to the Agent automatically every N minutes:

  • Works independently of loop mode — you can schedule a single-turn prompt or a loop-driven goal.
  • Useful for periodic checks: "Run npm test and fix any failing tests" every 30 minutes, or "Check for new dependency vulnerabilities" every 120 minutes.
  • A clock badge (![interval]) shows the configured interval next to the preset name.

Managing Presets

The Presets dropdown (![bookmark icon]) lives in the Agent chat toolbar. It supports full CRUD:

ActionDescription
ApplyClick a preset row to load its prompt, loop settings, and interval into the current composer.
CreateClick the + button. The dialog pre-fills the current composer text as the prompt, so you can save what's already typed.
EditHover a preset row → click Edit. Change any field.
DeleteHover a preset row → click Delete. Removes the preset permanently.
RefreshClick the refresh icon to re-fetch the preset list from the server.

Presets are saved to your team account and sync across all your machines. When you apply a preset, the composer loads its prompt, loop settings, and interval automatically.