Skip to main content
An agent in Sniko is a fully managed ElevenLabs Conversational AI agent. Every agent lives in your ElevenLabs account and is surfaced through the Sniko dashboard with multi-tenant isolation — each user only sees and operates on their own agents. Agents handle real-time voice conversations over the web widget or a Twilio phone number, using a system prompt, an optional knowledge base, a chosen voice, and an LLM backend (Gemini 2.0 Flash by default).
Each agent counts against your subscription quota. Your plan determines how many agents you can create simultaneously.

​
Creating an agent

Creation is a two-step wizard.
1

Name and template

Navigate to Agents → New Agent.Fill in:
FieldDescription
NameDisplay name for the agent. Internally prefixed with your account UUID for isolation.
TypeStart from a blank agent or choose a workflow template as a starting point.
Workflow templateOptional. Pre-built node/edge conversation flow to attach immediately.
First messageThe opening phrase the agent speaks when a call begins. Defaults to “Hello! How can I help you today?”
System promptInstructions that define the agent’s persona, goals, tone, and constraints.
LanguagePrimary language for speech recognition and synthesis. Non-English agents automatically use the eleven_turbo_v2_5 TTS model.
Additional languagesSecondary languages the agent can switch to mid-conversation.
2

Configure

The second step exposes all advanced settings before the agent is created in ElevenLabs.Voice & TTS
SettingDefault
VoiceBella (EXAVITQu4vr4xnSDxMaL)
Output audio formatulaw_8000 (optimized for Twilio telephony)
Stability0.5
Similarity boost0.75
Style0
Speaker boostEnabled
ASR (Speech Recognition)
SettingDefault
Input audio formatulaw_8000
Qualityhigh
Providerelevenlabs
Turn detection
SettingDefault
Turn timeout7 seconds
Modesilence
Conversation limits
SettingDefault
Max duration600 seconds (10 min)
Store call audioEnabled
Knowledge bases — attach one or more RAG-indexed document collections. See Knowledge Base.Tools — attach custom ElevenLabs tool definitions and MCP server integrations.Workflow — attach or design a visual conversation flow. See Workflows.Avatar image — optional JPEG/PNG (max 2 MB) shown in the web widget.
After you click Create, Sniko posts the agent to the ElevenLabs API, then polls to verify creation before redirecting you to the agent’s configuration page.

​
Agent configuration page

After creation (or when you open an existing agent) you land on the Configure view. It is divided into tabs:

Agent

Edit name, first message, system prompt, language, and additional languages.

Voice

Choose or change the ElevenLabs voice and fine-tune TTS parameters (stability, similarity, style, speaker boost).

Knowledge Base

Add or remove knowledge base documents that ground the agent’s responses.

Tools

Enable built-in system tools (end call, transfer call, etc.) and attach custom tools or MCP servers.

Workflow

Assign a workflow template or open the visual builder to design conversation branching logic.

Embed

Generate an embeddable widget snippet for your website.

​
Agent actions

From the agent list or the configuration page you can:
Creates a full copy of the agent (name, conversation config, workflow, and knowledge base assignments) in ElevenLabs under a new agent ID. The copy appears in your agent list with (Copy) appended to the name.
Generates an HTML snippet you paste into any webpage to embed the conversational AI widget.
<conversational-ai agent-id="YOUR_AGENT_ID" variant="full"></conversational-ai>
<script src="https://your-sniko-domain.com/js/elevenlabs-convai-widget.js?v=2" async type="text/javascript"></script>
You can customise the HTML tag name (defaults to conversational-ai) from the Embed tab.
Opens the conversation history for the agent — a log of every session, its transcript, and audio playback (when call audio storage is enabled).
Permanently removes the agent from ElevenLabs. If the agent is assigned to one or more Twilio phone numbers, deletion is blocked until you unassign it first.

​
Simulating a conversation

The Test button on the configuration page opens the built-in simulation modal. Sniko sends a POST to /v1/convai/agents/{id}/simulate-conversation (or the streaming variant) on the ElevenLabs API. You can configure:
  • Simulated user persona — a natural-language description of the user the simulation should impersonate.
  • First message — what the simulated user says to open the conversation.
  • Language — language the simulated user speaks.
  • Conversation history — optional prior turns to inject as context.
Results stream back in real time and are displayed turn-by-turn in the modal.
Use simulation to validate your system prompt and knowledge base before assigning the agent to a live phone number.

​
Quota

Your subscription plan defines how many agents you may have active at one time. Sniko enforces this quota before the creation request is sent to ElevenLabs. If you are at your limit, you must delete an existing agent or upgrade your plan before creating a new one.

Build docs developers (and LLMs) love

Get started for freeTalk to us