# Agent Settings Reference

> Complete reference for all agent configuration options

Source: https://edesy.in/docs/voice-agent/agent-setup/settings-reference

Complete reference for all agent configuration options.

## Basic Settings

| Setting | Type | Description |
|---------|------|-------------|
| `name` | string | Agent display name |
| `description` | string | Internal description |
| `language` | string | Primary language code (e.g., "en-IN") |
| `isActive` | boolean | Whether agent accepts calls |

## Provider Settings

### STT Configuration

```json
{
  "sttProvider": "deepgram",
  "sttConfig": {
    "deepgram": {
      "model": "nova-2",
      "language": "en-IN"
    }
  }
}
```

### TTS Configuration

```json
{
  "ttsProvider": "elevenlabs",
  "ttsConfig": {
    "elevenlabs": {
      "voice_id": "21m00Tcm4TlvDq8ikWAM",
      "stability": 0.5,
      "similarity_boost": 0.75
    }
  }
}
```

### LLM Configuration

```json
{
  "llmProvider": "gemini-2.5",
  "llmConfig": {
    "gemini-2.5": {
      "temperature": 0.7,
      "maxTokens": 256
    }
  }
}
```

## Advanced Settings

### Greeting Message

First message when call connects:

```json
{
  "greetingMessage": "Hello! This is Priya from TechCorp. How can I help you today?"
}
```

Supports variables:
```
"greetingMessage": "Hi {{customer_name}}, calling about your order {{order_id}}."
```

### Call Behavior

| Setting | Type | Default | Description |
|---------|------|---------|-------------|
| `endCallOnGoodbye` | boolean | true | Auto-end on goodbye phrases |
| `maxCallDuration` | number | 600 | Max call length in seconds |
| `silenceTimeout` | number | 10 | End call after N seconds silence |
| `interruptible` | boolean | true | Allow caller to interrupt agent |

### Voicemail Detection

For outbound calls:

```json
{
  "llmConfig": {
    "voicemailDetection": {
      "enabled": true,
      "action": "hangup"
    }
  }
}
```

Actions: `hangup`, `leave_message`, `callback`

### VAD (Voice Activity Detection)

For Gemini Live:

```json
{
  "llmConfig": {
    "gemini-live": {
      "vadProfile": "balanced"
    }
  }
}
```

| Profile | Silence Duration | Use Case |
|---------|-----------------|----------|
| `low_latency` | 100ms | Fast-paced conversations |
| `balanced` | 200ms | Most use cases |
| `conservative` | 350ms | Slower languages, elderly users |

## Function Settings

```json
{
  "functions": ["end_call", "transfer_call", "check_order"],
  "functionConfig": {
    "transfer_call": {
      "destination": "+919876543210"
    }
  }
}
```

## Knowledge Base

```json
{
  "knowledgeBaseId": "kb_abc123",
  "ragConfig": {
    "topK": 5,
    "minScore": 0.7
  }
}
```