U
UseBelha/Guide
API ReferenceDashboard

Agent Templates

UseBelha includes 13 pre-built agent templates across 6 categories. Use them directly or as starting points for custom agents.

Categories

GeneralProductivitySupportCommerceIntegrationVoice

All Templates

Basic Assistant

General

Simple conversational assistant

tpl_basic

Web Search Agent

Productivity

Research with web search

tpl_search
googleSearch

Code Executor

Productivity

Write and run Python code

tpl_coder
codeExecution

Deep Researcher

Productivity

Research with search + URL reading

tpl_researcher
googleSearchurlContext

Data Analyst

Productivity

Data analysis and visualization

tpl_analyst
codeExecution

Full-Stack Assistant

Productivity

Web search + URL reading

tpl_fullstack
googleSearchurlContext

Support Agent

Support

Customer support assistant

tpl_support

Support Agent (Search)

Support

Support with web search fallback

tpl_support_search
googleSearch

Onboarding Guide

Support

Help new users get started

tpl_onboarding

Sales Agent

Commerce

Product recommendations

tpl_sales
googleSearch

API Integration Agent

Integration

Custom HTTP API calls

tpl_api_agent
httpActions

Voice Assistant

Voice

Real-time voice conversations

tpl_voice

Voice Support Agent

Voice

Voice-enabled support

tpl_voice_support

Using Templates

List all templates

bash
curl https://dev.usebelha.com/api/agents/templates

Get a single template

bash
curl "https://dev.usebelha.com/api/agents/templates?id=tpl_search"

Filter by category

bash
curl "https://dev.usebelha.com/api/agents/templates?category=voice"

Chat directly with a template (no agent creation)

bash
curl -X POST "https://dev.usebelha.com/api/agents?template=tpl_search&action=chat" \
  -H "Content-Type: application/json" \
  -H "x-tenant-id: tenant_demo" \
  -d '{"sessionId": "test", "message": "Latest AI news?"}'

Create an agent from a template

bash
curl -X POST "https://dev.usebelha.com/api/agents?template=tpl_search" \
  -H "Content-Type: application/json" \
  -H "x-api-key: your-api-key" \
  -d '{"name": "My Research Bot"}'

Template Structure

json
{
  "id": "tpl_search",
  "name": "Web Search Agent",
  "description": "Research assistant with web search",
  "category": "productivity",
  "icon": "search",
  "systemPrompt": "You are a research assistant...",
  "testPrompt": "What are the latest developments in AI?",
  "model": "default",
  "temperature": 0.5,
  "tools": {
    "googleSearch": { "enabled": true }
  },
  "channels": {
    "api": true,
    "widget": { "enabled": true, "greeting": "..." }
  }
}

Test Prompts

Each template includes a testPrompt that auto-populates in the dashboard. Use these for quick testing:

TemplateTest Prompt
Basic Assistant"Hello! What can you help me with?"
Web Search Agent"What are the latest developments in AI this week?"
Code Executor"Calculate the first 10 Fibonacci numbers"
Deep Researcher"Research the pros and cons of remote work in 2024"
API Integration"What's the weather in Nairobi?"
AuthenticationTools