Creating Voice Agents

​

Prerequisites

• ThreeTone API key (get one here)
• Basic understanding of REST APIs
• Optional: Knowledge base documents for context

​

Agent Configuration

​

Basic Agent Creation

curl --request POST \
  --url https://api.threetone.in/v1/convai/agents/create \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Customer Support Agent",
    "system_prompt": "You are a helpful customer support representative."
  }'

​

Advanced Configuration

{
  "name": "Sales Assistant",
  "agent_type": "business",
  "system_prompt": "You are a knowledgeable sales assistant helping customers find the right products.",
  "temperature": 0.6,
  "voice_settings": {
    "voice_id": "professional_female",
    "speed": 1.0,
    "pitch": 0.0
  },
  "conversation_config": {
    "max_turns": 50,
    "timeout_seconds": 300,
    "escalation_keywords": ["human", "manager", "supervisor"]
  }
}

​

Agent Types

​

Personal Agents

• Designed for individual use cases
• Casual conversation style
• Personal assistant capabilities

​

Business Agents

• Professional communication style
• Business process integration
• Customer service optimization

​

Specialized Agents

• Domain-specific knowledge
• Custom training data
• Industry-specific workflows

​

Best Practices

​

System Prompt Design

• Be specific about the agent’s role and capabilities
• Include conversation guidelines and boundaries
• Define escalation scenarios clearly

​

Temperature Settings

• Lower values (0.1-0.4): More consistent, predictable responses
• Medium values (0.5-0.7): Balanced creativity and consistency
• Higher values (0.8-1.0): More creative but less predictable

​

Voice Configuration

• Choose appropriate voice characteristics for your use case
• Test different speed and pitch settings
• Consider your target audience preferences

​

Next Steps

• Managing Conversations
• Advanced Configuration
• Knowledge Base Integration