Official Templates

Templates are ready-made agents: a system prompt, a default model and a set of tools, packaged on top of the platform's agent runtime. Deploy one from Agents → New Agent in the console, or with its image name:

Template	Image	Default model
Customer Support	agntspark/template-customer-support:latest	gpt-4o
Code Reviewer	agntspark/template-code-reviewer:latest	claude-sonnet-4-5

Any model works. Choose one when you deploy and pass that provider's key as api_key. The provider is worked out from the model name: claude-* is Anthropic, gemini-* is Google, anything else is OpenAI.

Every template serves the runtime contract: POST /invoke, GET /health, and GET /, which lists the agent's tools.

New agents are private: the response to creating one includes access_key, the agent's first key. Send it as Authorization: Bearer agk_… when calling the agent.

Customer Support

Answers from a knowledge base, notices when a customer is upset, and opens tickets for what it can't resolve.

Tools: search_knowledge_base, analyze_sentiment, create_ticket.

Optional environment variables:

Variable	What it does
KNOWLEDGE_BASE_URL	Your search endpoint. The agent POSTs {"query", "max_results"} to <url>/search and expects {"results": [{"article_id", "title", "content"}]}. Without it, a small built-in sample knowledge base is used.
KNOWLEDGE_BASE_API_KEY	Bearer token sent to KNOWLEDGE_BASE_URL. Mark it secret.
TICKET_WEBHOOK_URL	Receives each new ticket as a JSON POST, e.g. a helpdesk, Slack or Zapier webhook. Without it, tickets are only reported in the conversation. Mark it secret.

curl -X POST https://agntapi.agntspark.com/v1/agents \
  -H "Authorization: Bearer $AGNTSPARK_API_KEY" -H 'content-type: application/json' \
  -d '{
    "name": "support",
    "model": "gpt-4o",
    "api_key": "'"$OPENAI_API_KEY"'",
    "deploy": {
      "image": "agntspark/template-customer-support:latest",
      "env": [
        {"key": "TICKET_WEBHOOK_URL", "value": "https://hooks.example.com/…", "secret": true}
      ]
    }
  }'

Code Reviewer

Reviews GitHub pull requests: reads the diff, runs quick security and bug checks, and writes a prioritized review. Paste code instead of a pull request and it reviews that.

Try: Review https://github.com/owner/repo/pull/42.

Set GITHUB_TOKEN (secret) to review private repositories or to avoid GitHub's low anonymous rate limit.

Change a template's prompt

Pass system_prompt when you create the agent to replace the template's prompt. The tools stay available.

Build your own template

Templates live in AgntSpark1/agntspark-templates: an agent.yaml manifest, a tools.py with plain Python functions, and a README. Until custom templates can be uploaded, package yours as an image built on the runtime image; see Deploy Your Own Image.