Skip to main content

​
Overview

This guide walks you through creating an agent from scratch or from a template.

​
Option A: Create from Template

Templates are the fastest way to get started. They pre-configure workspace files, model selection, and tool policy.
1

Open Templates

From the dashboard, click + New Agent and select Browse Templates.
2

Choose Template

Select a template that matches your use case:
  • Customer Support — FAQ handling, ticket routing, escalation
  • Sales Agent — Lead qualification, appointment booking
  • Research Agent — Web research, report generation
  • Personal Assistant — Calendar, reminders, task management
3

Customize

Modify the agent name, model, and workspace files as needed.
4

Deploy

Click Deploy. Your agent will be running in seconds.

​
Option B: Create from Scratch

1

New Blank Agent

Click + New Agent and select Blank Agent.
2

Basic Configuration

Set the following:
  • Name — A descriptive name for the agent
  • Model — Select primary model and optional fallbacks
  • Description — Brief description of the agent’s purpose
3

Configure Workspace

Edit the workspace files to define agent behavior:AGENTS.md — Operating instructions and priorities
# Instructions
You are a customer support agent for Acme Corp.
- Be helpful and professional
- Escalate complex issues to human support
SOUL.md — Persona and communication style
# Persona
Friendly, professional, and efficient.
Use simple language. Be empathetic.
4

Tool Policy

Configure which tools the agent can use:
  • Web Search — Enable for agents that need current information
  • Browser — Enable for interactive web research
  • File System — Enable for agents that manage documents
  • Exec — Enable with caution for agents that run commands
5

Deploy

Click Deploy to spin up the agent’s Docker container.

​
Agent Settings

After creation, you can configure additional settings:
SettingDescription
HeartbeatPeriodic check-in interval (default: 30 minutes)
SandboxDocker sandboxing mode (off, non-main, all)
Block StreamingSend responses as streaming blocks
Thinking LevelReasoning depth (off, minimal, low, medium, high)
Session ScopeDM session isolation (main, per-peer, per-channel-peer)

​
API: Create Agent

You can also create agents via the API: 
curl -X POST https://usehavoc.com/api/agents \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Support Agent",
    "model": "anthropic/claude-sonnet-4-5",
    "templateId": "customer-support"
  }'

Next: Connect a Channel

Connect your agent to WhatsApp, Telegram, or Discord.