Audio Agent Configuration Guide
This article walks through each parameter in the order of the panels from top to bottom on the configuration page: what it does, its value range and default, and which engine modes it applies to. While retaining general capabilities such as knowledge, databases, and memory, the Audio Agent adds five groups of voice-related settings: Voice Engine, Input, Output, Welcome Guidance, and Call Control.
If you are not yet familiar with the basic concepts of the Audio Agent and its three engine modes, we recommend reading the Audio Agent Overview first.
Voice Engine
At the top of the Voice Engine panel is the engine mode selector, where you can switch between Real-time model, ASR-LLM-TTS, and LLM+TTS. After switching, the models and parameters shown below change accordingly.
Real-time model (REALTIME)
A single real-time voice large model completes "listen — think — speak" end to end. Audio input and output are handled within the same model in a closed loop, with no separate speech recognition and synthesis in between, so latency is lowest and the tone is most natural.
In general, we recommend the Real-time model mode more: it has the lowest latency and the most natural tone, and suits most real-time voice scenarios. OpenAI's upcoming Live model not only supports full-duplex real-time voice but can also call a more capable text large model in the background for complex tasks, and will become the preferred solution for real-time voice going forward.
graph LR U([User voice]) --> RT[Real-time voice large model end-to-end processing] RT --> A([Voice reply])
The Real-time model consolidates recognition, inference, and synthesis into a single model, so it has the most streamlined configuration:
| Setting | Required | Description |
|---|---|---|
| Audio LLM | Yes | Select the real-time large model that handles voice end to end; it performs recognition, inference, and synthesis. |
| Model parameters | No | Temperature, Top P, maximum response length, timbre, and so on—same as ordinary large model parameters, controlling the randomness, length, and timbre of the reply. |
| Identity prompt | No | Sets the Agent's identity and role, injected into the conversation as a system prompt; common to all three modes. |
The Real-time model has no separate ASR / TTS stages, so it does not provide settings such as transcription instructions, voice language, or TTS symbol cleanup (removal / replacement)—these capabilities are internalized within the model.
ASR-LLM-TTS
A three-stage pipeline: voice is first recognized into text, passed to a text large model for inference, and then the reply is synthesized into voice. A model can be chosen for each of the three stages, making this the mode with the highest controllability.
graph LR U([User voice]) --> ASR[ASR speech recognition] ASR -->|Text| LLM[Text large model inference] LLM -->|Reply text| TTS[TTS speech synthesis] TTS --> A([Voice reply])
The stage-by-stage configuration is as follows:
| Stage | Setting | Description |
|---|---|---|
| ASR | Speech recognition model | Select the recognition model that transcribes the user's voice into text. |
| Transcription instructions | Guide the recognition style, common wording, proper nouns, and so on to improve recognition accuracy in specific domains (such as brand names and industry terminology). | |
| Voice language | Specify the source language, or choose "Auto-detect" to let the model decide; specifying a language is usually more stable. | |
| LLM | Text large model | Select the text large model responsible for inference, which can be combined with knowledge, databases, memory, tools, and other capabilities. |
| Model parameters | Temperature, Top P, maximum response length, and so on—same as an ordinary large model. | |
| Identity prompt | Used to set the Agent's role and code of conduct. | |
| TTS | Speech synthesis model | Select the model and timbre that synthesize the text reply into voice. |
| Remove | Enter the symbols to remove; these symbols are deleted before being submitted to TTS, so they are not read out. | |
| Replace | Enter the symbols to replace with a space; they are replaced before being submitted to TTS, used for sentence segmentation or to eliminate abrupt pauses. |
For both Remove and Replace, separate multiple symbols with commas; paired brackets (such as
(),《》) can be entered as a single unit.
LLM+TTS
A multimodal LLM that supports voice input understands the voice directly, skipping the standalone ASR stage; the model's text reply is then passed to TTS for synthesis into voice.
graph LR U([User voice]) --> LLM[Multimodal large model directly understands voice] LLM -->|Reply text| TTS[TTS speech synthesis] TTS --> A([Voice reply])
The settings are LLM (including model parameters and identity prompt) and TTS (including Remove and Replace), with the same meanings as in ASR-LLM-TTS.
Input
The Input panel controls "how the Agent listens," centered on VAD (Voice Activity Detection) and attachment recognition.
VAD Control
VAD (Voice Activity Detection) determines how the Agent judges when the user has finished speaking and whether it can be interrupted. The adjustable parameters change with the engine mode and recognition mode; after switching, the form changes accordingly:
- Real-time model: uses the model's built-in VAD, and you can choose a recognition mode on the configuration page—Preset mode or Semantic mode, defaulting to Preset mode.
- ASR-LLM-TTS / LLM+TTS: use the platform's built-in VAD, which behaves the same as Preset mode and does not offer recognition-mode switching.
Preset mode
Segments sentences based on the audio signal: it judges whether the user has finished speaking by the volume threshold and silence duration, with intuitive and predictable behavior. Applies to the Real-time model (when Preset mode is selected) as well as ASR-LLM-TTS and LLM+TTS.
| Setting | Value range | Default | Applies to | Description |
|---|---|---|---|---|
| Volume activation | 0 ~ 1 (step 0.1) | 0.5 | Real-time model only | The volume threshold that triggers recognition; the higher it is, the less likely it is to be falsely activated by ambient noise. |
| Pause segmentation | 0 ~ 5000 ms (step 50) | 500 | Common | How many milliseconds of silence after the user stops speaking count as the end of a sentence; the larger it is, the less likely it is to "cut in." |
| Voice interruption | 0 ~ 1 (step 0.1) | 0.5 | Common | The sensitivity to the user speaking up to interrupt (barge-in) while the Agent is talking; the higher it is, the easier it is to interrupt; it can also be turned off entirely. |
Semantic mode
Supported by the Real-time model only. The model judges whether the user has finished speaking by understanding the semantics, no longer relying on fixed volume and silence thresholds, making sentence segmentation more natural—well suited to spoken conversations with many pauses and a loose delivery.
| Setting | Value range | Default | Applies to | Description |
|---|---|---|---|---|
| Response speed | Low / Medium / High | Medium | Common | The response pace after the user is judged to have finished speaking; faster is tighter, slower is more relaxed. |
| Voice interruption | 0 ~ 1 (step 0.1) | 0.5 | Common | The sensitivity to the user speaking up to interrupt (barge-in) while the Agent is talking; the higher it is, the easier it is to interrupt; it can also be turned off entirely. |
Attachments
| Setting | Description |
|---|---|
| Image recognition | Toggle. When enabled, images can be recognized during the conversation. |
| Number of attachments | Fixed at 1. |
| Attachment type | Images only (Image). |
Output
The Output panel controls "how the Agent speaks," including background sound and buffered playback.
Background sound
Overlays ambient sound onto the call to make the voice conversation feel more immersive. We recommend adjusting it to a volume of around 0.2 to avoid drowning out the human voice.
| Setting | Value | Description |
|---|---|---|
| Background sound mode | Disabled / Preset / Custom | Choose whether to enable it and its source. |
| Preset options | Office / Café / Rain / Nature / White noise | Ambient sounds built into the platform. |
| Custom | mp3, ≤ 1 MB | Upload your own background audio; use a seamless audio clip whose start and end join together. |
| Background volume | 1~50% | Default 30% |
Buffered playback
| Setting | Value range | Default | Description |
|---|---|---|---|
| Buffered playback | 0 ~ 1500 ms (step 50) | 200 | Buffers a segment of the reply audio before starting playback, reducing stutter caused by network jitter; the larger the value, the smoother it is, but the first-word latency increases slightly. |
Welcome Guidance
Sets the opening performance at the start of a call, with separate configuration supported for multiple languages.
| Setting | Requirement | Description |
|---|---|---|
| Speaking avatar | mp4, ≤ 5 MB | A looping video of the virtual human "speaking"; its first and last frames must join together to ensure a natural loop transition. |
| Waiting avatar | mp4, ≤ 5 MB | A looping video of the virtual human "listening"; its first and last frames must likewise join together. |
| Welcome message | Text | Serves as the opening line when the conversation starts, read aloud once by the model. |
Call Control
Call control makes calls more natural and prevents idle, empty calls. By setting up a hang-up mechanism, it prevents unlimited occupancy and saves resources and cost.
Quiet-conversation control
When the silence threshold is triggered, it automatically follows up or plays a prompt to bring the user back into the conversation.
| Setting | Value range | Default | Description |
|---|---|---|---|
| Silence timeout | 5 ~ 60 seconds (step 1) | 10 | How long the user must be silent before a quiet-conversation follow-up is triggered. |
| Quiet-conversation prompt | Text | — | The follow-up / prompt text played or sent to the model when triggered. |
Hang up the call
Hang-up is triggered when either the maximum call duration or the maximum number of silences condition is met.
| Setting | Value range | Default | Description |
|---|---|---|---|
| Maximum call duration | 30 ~ 3600 seconds (step 30) | 600 | The maximum length of a single call; it ends automatically when exceeded. |
| Maximum number of silences | 1 ~ 100 (step 1) | 5 | Hangs up automatically after the cumulative number of consecutive quiet stretches reaches this count. |
| Hang-up prompt | Text, ≤ 20 tokens | — | The prompt text informing the user before hanging up. |
| *Actively end the call | Toggle | — | Coming soon. When enabled, the AI Agent is allowed to end the call proactively during the conversation, triggering the hang-up prompt. |
Shared Capability Panels
The Audio Agent also supports general Agent capabilities such as knowledge, databases, and memory, configured the same way as an ordinary Agent; refer to the related Agent documentation. Note the following:
- The Human Service panel currently shows "Coming soon" in the Audio Agent.
- Panels such as Tools and Workflow are not shown in the Audio Agent.
Configuration Comparison Across Modes
The items shown on the configuration page differ slightly across engine modes; compare them in the table below:
| Setting | Real-time model | ASR-LLM-TTS | LLM+TTS |
|---|---|---|---|
| Audio LLM | ✓ | — | — |
| ASR (incl. transcription instructions / voice language) | — | ✓ | — |
| LLM (text large model) | — | ✓ | ✓ |
| TTS (incl. Remove / Replace) | — | ✓ | ✓ |
| Identity prompt | ✓ | ✓ | ✓ |
| Recognition mode (Preset / Semantic) | ✓ | — | — |
| Volume activation | ✓ (Preset) | — | — |
| Pause segmentation | ✓ (Preset) | ✓ | ✓ |
| Response speed | ✓ (Semantic) | — | — |
| Voice interruption | ✓ | ✓ | ✓ |
| Image recognition | ✓ | ✓ | ✓ |
| Background sound | — | ✓ | ✓ |
| Buffered playback | ✓ | ✓ | ✓ |
| Welcome guidance | ✓ | ✓ | ✓ |
| Call control | ✓ | ✓ | ✓ |
For how to set parameter values so they better fit your business, continue reading Best Practices.
