Creating Agents

Agents are the core of Vocobase — they define how your voice AI behaves, what it sounds like, and how it responds to users.

What is an Agent?

An agent is a configured voice AI persona. Each agent has:

• Name — Unique identifier used in your code
• System Prompt — Instructions that define personality and behavior
• Voice — The synthesized voice used for responses
• Language — Primary language for speech recognition
• Greeting — Optional opening message when a session starts

Creating a New Agent

1. Navigate to Agents in the dashboard sidebar
2. Click Create Agent
3. Fill in the configuration form
4. Click Save

Configuration Fields

Name

The unique identifier for your agent. This is what you’ll use in your code:

<VoiceAgent agentName="customer-support" />

Requirements:

• 1-50 characters
• Lowercase letters, numbers, and hyphens only
• Must be unique within your account
• Cannot be changed after creation

System Prompt

The instructions that define your agent’s behavior. This is the most important configuration — it shapes how your agent responds to users.

Best Practices:

You are a friendly customer support agent for Acme Inc.
 
Your responsibilities:
- Answer questions about our products and services
- Help users troubleshoot common issues
- Escalate complex problems to human support
 
Tone and style:
- Be warm and conversational
- Keep responses concise (2-3 sentences when possible)
- Use simple language, avoid jargon

Limit: 120,000 characters

Voice

Select from available voice options. Each voice has different characteristics:

Language

The primary language for speech recognition.

Supported Languages:

• English (en)
• Spanish (es)
• French (fr)
• Hindi (hi)
• Marathi (mr)
• Bengali (bn)
• Kannada (kn)

Greeting (Optional)

An optional message the agent speaks immediately when a session starts.

Examples:

• “Hello! How can I help you today?”
• “Welcome to Acme support. What can I assist you with?”

Limit: 500 characters

Example: Customer Support Agent

# Role
You are a customer support agent for TechCorp, a software company.
 
# Capabilities
- Answer questions about our products: CloudSync, DataVault, and SecureShare
- Help with account issues: password resets, billing inquiries, plan changes
- Troubleshoot common technical problems
- Collect feedback and feature requests
 
# Guidelines
- Be helpful, patient, and empathetic
- Keep responses under 3 sentences when possible
- If you can't help, offer to escalate to a human agent
- Never share internal processes or confidential information