Agent Templates

Agent templates are pre-built configurations that let you quickly create specialized AI agents. Each template defines a model, identity, rules, tools, and capabilities so you can deploy production-ready agents in seconds.

Listing templates

curl https://api.orkosi.com/api/agent-templates \
  -H "Authorization: Bearer TOKEN"

Query parameters

Parameter	Type	Description
category	string	Filter by category (e.g. development, integration)
featured	boolean	Only show featured templates
search	string	Search in name and description
limit	integer	Max results (default 50)
offset	integer	Pagination offset (default 0)

Response

{
  "data": [
    {
      "id": 1,
      "slug": "full-stack-dev",
      "name": "Full-Stack Dev",
      "description": "React, Node.js, and SQL development agent",
      "icon": "Code2",
      "category": "development",
      "model": "claude-sonnet-4-6",
      "is_featured": true,
      "capabilities": ["code-generation", "debugging", "testing"],
      "tools": ["read-file", "write-file", "run-command", "git"]
    }
  ],
  "meta": { "total": 5, "limit": 50, "offset": 0 }
}

Getting a template

Fetch by ID or slug:

curl https://api.orkosi.com/api/agent-templates/full-stack-dev \
  -H "Authorization: Bearer TOKEN"

Built-in templates

Assimetria OS ships with five production-ready templates:

Full-Stack Dev

• Slug: full-stack-dev
• Category: Development
• Model: claude-sonnet-4-6
• Capabilities: Code generation, debugging, testing, refactoring
• Tools: File read/write, git, command execution
• Best for: Building features, fixing bugs, code reviews

API Integrator

• Slug: api-integrator
• Category: Integration
• Model: claude-sonnet-4-6
• Capabilities: OAuth flows, webhook setup, API consumption
• Tools: HTTP requests, credential management, file operations
• Best for: Connecting third-party services (Stripe, Slack, Intercom)

QA Tester

• Slug: qa-tester
• Category: Quality
• Model: claude-haiku-4-5
• Capabilities: Test writing, regression detection, bug reporting
• Tools: Test runners, browser automation, file operations
• Best for: Automated testing, smoke tests, coverage analysis

Web Scraper

• Slug: web-scraper
• Category: Data
• Model: claude-haiku-4-5
• Capabilities: Data extraction, rate-limited crawling, content parsing
• Tools: HTTP requests, file write, data transformation
• Best for: Competitive analysis, content aggregation, monitoring

DevOps

• Slug: devops
• Category: Infrastructure
• Model: claude-sonnet-4-6
• Capabilities: CI/CD, Docker, monitoring, incident response
• Tools: Command execution, file operations, deployment APIs
• Best for: Deployment automation, infrastructure management, alerting

Applying a template

Apply a template to get a pre-populated agent configuration:

curl -X POST https://api.orkosi.com/api/agent-templates/full-stack-dev/apply \
  -H "Authorization: Bearer TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "frontend-dev",
    "display_name": "Frontend Dev"
  }'

Request body

Field	Type	Required	Description
name	string	Yes	Agent slug (lowercase, hyphens)
display_name	string	Yes	Human-readable name

Response

The response contains a fully populated agent configuration derived from the template:

{
  "data": {
    "name": "frontend-dev",
    "display_name": "Frontend Dev",
    "model": "claude-sonnet-4-6",
    "interval_sec": 30,
    "identity": "You are a full-stack developer...",
    "soul_content": "## Rules and Scope\n...",
    "core_rules": "1. Write clean, tested code...",
    "tools": ["read-file", "write-file", "run-command", "git"],
    "capabilities": ["code-generation", "debugging", "testing"],
    "config": {},
    "template_slug": "full-stack-dev",
    "template_name": "Full-Stack Dev"
  }
}

You can then pass this configuration to POST /api/agents to create the agent.

Template anatomy

Each template defines these fields:

Field	Description
slug	Unique identifier (e.g. full-stack-dev)
name	Display name
description	What the agent does
icon	Lucide React icon name
category	Grouping: development, integration, quality, data, infrastructure
model	LLM model identifier
interval_sec	How often the agent runs (in seconds)
identity	System prompt / personality
soul_content	Markdown rules and operational scope
core_rules	Hard constraints the agent must follow
tools	JSON array of available tool names
capabilities	JSON array of capability tags
config	JSON object for extra settings
is_featured	Whether to highlight in the UI
sort_order	Display ordering

Creating agents from templates

The full workflow to create an agent from a template:

# 1. Browse templates
curl https://api.orkosi.com/api/agent-templates?featured=true \
  -H "Authorization: Bearer TOKEN"

# 2. Apply the template
curl -X POST https://api.orkosi.com/api/agent-templates/qa-tester/apply \
  -H "Authorization: Bearer TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "my-qa-bot", "display_name": "My QA Bot"}'

# 3. Create the agent (using the config from step 2)
curl -X POST https://api.orkosi.com/api/agents \
  -H "Authorization: Bearer TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-qa-bot",
    "display_name": "My QA Bot",
    "model": "claude-haiku-4-5",
    "identity": "You are a QA testing specialist...",
    "soul_content": "...",
    "core_rules": "...",
    "tools": ["test-runner", "browser", "file-ops"]
  }'

API reference

Method	Path	Description
GET	/agent-templates	List all templates
GET	/agent-templates/:idOrSlug	Get template details
POST	/agent-templates/:idOrSlug/apply	Apply template to get agent config