Agent Templates

Templates provide pre-configured agent setups for common use cases.

Available Templates

Template	Description	Tools
customer-support	Customer service chatbot	llm/chat, retrieval/search
research-assistant	Research and analysis	llm/chat, retrieval/search, retrieval/rerank
voice-agent	Voice-based assistant	voice/*, llm/chat
document-processor	Document analysis	document/*, llm/chat
rag-agent	Retrieval-augmented generation	llm/, retrieval/

Using Templates

Create Agent from Template

curl -X POST https://api.gateflow.ai/v1/mcp/agents \
  -H "Authorization: Bearer gw_prod_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Support Bot",
    "template": "customer-support"
  }'

Customize Template

Override specific settings:

curl -X POST https://api.gateflow.ai/v1/mcp/agents \
  -H "Authorization: Bearer gw_prod_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Premium Support",
    "template": "customer-support",
    "permissions": {
      "models": ["gpt-4o"]
    },
    "config": {
      "system_prompt": "You are a premium support agent for VIP customers."
    }
  }'

Template Details

customer-support

template: customer-support
permissions:
  tools:
    - llm/chat
    - retrieval/search
  models:
    - gpt-4o-mini
  data_classification:
    - public
  rate_limits:
    requests_per_minute: 60
    cost_per_session: 1.00
config:
  system_prompt: |
    You are a helpful customer support agent.
    Be friendly, professional, and concise.
    If you don't know the answer, say so.

research-assistant

template: research-assistant
permissions:
  tools:
    - llm/chat
    - llm/embed
    - retrieval/search
    - retrieval/rerank
  models:
    - gpt-4o
  data_classification:
    - public
    - internal
  rate_limits:
    requests_per_minute: 30
    cost_per_session: 5.00
config:
  system_prompt: |
    You are a research assistant. Help users find and
    analyze information. Cite sources when possible.

voice-agent

template: voice-agent
permissions:
  tools:
    - voice/transcribe
    - voice/synthesize
    - voice/pipeline
    - llm/chat
  models:
    - whisper-1
    - gpt-4o-mini
    - tts-1
  rate_limits:
    audio_minutes_per_day: 30
    cost_per_session: 2.00
config:
  voice: friendly
  pipeline: voice-agent-fast

Creating Custom Templates

Define your own templates:

curl -X POST https://api.gateflow.ai/v1/mcp/templates \
  -H "Authorization: Bearer gw_prod_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "legal-assistant",
    "description": "Legal document analysis agent",
    "permissions": {
      "tools": ["llm/chat", "document/ocr", "retrieval/search"],
      "models": ["gpt-4o"],
      "data_classification": ["confidential"]
    },
    "config": {
      "system_prompt": "You are a legal assistant...",
      "ocr_provider": "mistral"
    },
    "rate_limits": {
      "cost_per_session": 10.00
    }
  }'

Next Steps

• Connecting Clients - Connect your code
• Tool Catalog - Explore all tools