logo
Development
Search
Audio Agent Configuration Guide

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.

loading...
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.

loading...
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.

loading...
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.