> ## Documentation Index
> Fetch the complete documentation index at: https://docs.threetone.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Creating Voice Agents

> Learn how to create and configure intelligent voice agents with the ThreeTone API

## Prerequisites

* ThreeTone API key ([get one here](https://threetone.in/app/voice-ai))
* Basic understanding of REST APIs
* Optional: Knowledge base documents for context

## Agent Configuration

### Basic Agent Creation

Create a basic voice agent with minimal configuration:

```bash cURL theme={null}
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

Configure advanced agent behavior with custom settings:

```json theme={null}
{
  "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](/guides/voice-agents/managing-conversations)
* [Advanced Configuration](/guides/voice-agents/advanced-configuration)
* [Knowledge Base Integration](/guides/knowledge-base/uploading-documents)