Skip to main content
The agent template gallery provides curated, deployable agent configurations. A template bundles a base agent definition with pre-configured skills, tools, model bindings, prompt templates, and governance constraints into a single reusable blueprint.
Templates are versioned and tagged for discoverability. Each template is independent of the agents deployed from it — changes to a template do not affect existing deployments.

​
Template Structure

FieldDescription
nameHuman-readable template name
descriptionWhat this template produces and its intended use case
baseAgentBase agent definition: purpose, identity, execution model
skillsPre-attached skill IDs with configuration
modelDefault model binding and override constraints
promptCore identity prompt and extension prompt
constraintsTimeout, max tool calls, token limits, sandbox mode
tagsDiscovery tags: code-review, data-analysis, devops, etc.

​
Deploy Flow

The createFromTemplate flow takes a template from gallery to live agent:
  1. Browse gallery — filter by category, search by tag. Templates display usage counts showing adoption.
  2. Select template — review the bundled definition: purpose, skills, model config, governance defaults.
  3. Customize (optional) — override the extension prompt, swap the model (within constraints), toggle optional tools, tighten governance limits.
  4. Deploy to gateway — Convex creates a new agent definition from the template contents and binds it to the selected gateway.
The resulting agent definition is fully independent. It has its own lifecycle and can be modified without affecting the source template.

​
Template Sources

Templates can be community-sourced (shared via marketplace), organization-specific (authored internally and scoped to an org), or exported from existing agents (capture a running agent’s config as a reusable blueprint). In Burgundy: Browse and deploy templates from the agent gallery. →