Skip to main content

​
Prerequisites

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

​
Agent Configuration

​
Basic Agent Creation

Create a basic voice agent with minimal configuration:
cURL
curl --request POST \
  --url https://api.threetone.com/v1/voiceai/agents \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Customer Support Agent",
    "agent_type": "business",
    "system_prompt": "You are a helpful customer support representative.",
    "temperature": 0.7
  }'

​
Advanced Configuration

Configure advanced agent behavior with custom settings: 
{
  "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