全部產品
Search
文件中心

Intelligent Media Services:啟動通話及個性參數配置

更新時間:Feb 03, 2026

通過閱讀本文,您可以瞭解如何通過傳入通話參數來啟動智能體通話使本次通話更加符合您的業務情境。

功能描述

智能體在啟動通話時,支援傳入多個參數,以控制其運行狀態及對話響應結果等。您可以根據自身的業務需求,通過傳入特定參數,構建適合您業務的智能體對話。更多業務實現,請參見AI面試口語陪練情感陪伴

目前智能體支援兩種啟動方式,您可以通過選擇不同的啟動方式,來適配您的業務情境:

  • 通過服務端啟動:靈活性強、擴充性強、一致性。

  • 通過用戶端啟動:接通延時低、輕依賴、獨立性強。

說明

您通過控制台配置的問候語、音色、語種等參數,都會在啟動智能體時進行覆蓋。也可以在通話中調用UpdateAIAgentInstance - 更新AI智能體執行個體配置介面修改配置。

服務端啟動智能體

您可以通過調用產生AI智能體通話執行個體介面來發起通話,將發起後的結果下發給用戶端,用戶端再通過返回的資訊進入通話。在啟動通話時,您可以通過配置AIAgentConfig參數發起通話。發起通話詳細流程,請參見如何通過服務端介面發起智能體通話

用戶端啟動智能體

用戶端啟動您需要在建立並初始化引擎後,對ARTCAICallConfig中的ARTCAICallAgentConfig進行配置。各用戶端啟動流程,請參見Android整合概覽iOS整合概覽Web整合概覽

Android

ARTCAICallAgentConfig

通話可配置的參數項

參數

類型

含義

agentGreeting

String

智能體歡迎語,為空白表示使用智能體配置值,最大長度100字元

wakeUpQuery

String

使用者在通話啟動前的指令,用於智能體在通話啟動後立即響應

agentMaxIdleTime

int

智能體閑時的最大等待時間(單位:秒),逾時智能體自動下線,預設值為600s

userOnlineTimeout

int

使用者未入會,智能體逾時關閉任務的時間,預設值為60s

userOfflineTimeout

int

使用者退會後,智能體逾時關閉任務的時間,預設值為5s

enablePushToTalk

boolean

是否開啟對講機模式

agentGracefulShutdown

boolean

是否優雅下線:播報完當前句子再停止

volume

int

智能體說話的音量,範圍為 0~400,預設值為100

workflowOverrideParams

String

工作流程覆蓋參數

enableIntelligentSegment

boolean

智能斷句開關

asrConfig

ARTCAICallAgentAsrConfig

語音辨識配置

ttsConfig

ARTCAICallAgentTtsConfig

語音合成配置

llmConfig

ARTCAICallAgentLlmConfig

大語言模型配置

avatarConfig

ARTCAICallAgentAvatarConfig

數字人配置

interruptConfig

ARTCAICallAgentInterruptConfig

打斷配置

voiceprintConfig

ARTCAICallAgentVoiceprintConfig

聲紋降噪配置

turnDetectionConfig

ARTCAICallAgentTurnDetectionConfig

輪次檢測配置

experimentalConfig

ARTCAICallExperimentalConfig

非產品化定製化配置

ARTCAICallAgentVcrConfig

ARTCAICallAgentVcrConfig

VCR配置

preConnectAudioUrl

String

接通後,播放歡迎語前的音效,支援url傳入;播放完音效之後,歡迎語還是會播放

ambientConfig

ARTCAICallAgentAmbientConfig

環境音配置

backChannelingConfig

List<ARTCAICallAgentBackChanneling>

附和語功能配置模組。配置後,系統會在特定觸發時機隨機播報簡短的附和語

autoSpeechForLlmPendingConfig

ARTCAICallAgentAutoSpeechLlmPending

智能體在LLM 響應延遲時的播報自動講話的配置

autoSpeechForUserIdleConfig

ARTCAICallAgentAutoSpeechUserIdle

智能體在使用者靜默時問詢的配置

iOS

ARTCAICallAgentConfig

通話智能體啟動與回合組態

屬性名稱

類型

描述

agentGreeting

String?

智能體歡迎語,為空白表示使用智能體配置值

wakeUpQuery

String?

使用者在通話啟動前的指令,用於智能體在通話啟動後立即響應

agentMaxIdleTime

Int32

智能體閑時的最大等待時間(單位:秒),逾時智能體自動下線,預設值為600s

userOnlineTimeout

Int32

使用者未入會,智能體逾時關閉任務的時間,預設值為60s

userOfflineTimeout

Int32

使用者退會後,智能體逾時關閉任務的時間,預設值為5s

enablePushToTalk

Bool

是否開啟對講機模式

agentGracefulShutdown

Bool

是否優雅下線

volume

Int32

智能體說話的音量,範圍為 0~400,預設值為100

workflowOverrideParams

[String: Any]?

工作流程覆蓋參數

enableIntelligentSegment

Bool

智能斷句開關

asrConfig

ARTCAICallAgentAsrConfig

語音辨識配置

ttsConfig

ARTCAICallAgentTtsConfig

語音合成配置

llmConfig

ARTCAICallAgentLlmConfig

大語言模型配置

avatarConfig

ARTCAICallAgentAvatarConfig

數字人配置

interruptConfig

ARTCAICallAgentInterruptConfig

打斷配置

voiceprintConfig

ARTCAICallAgentVoiceprintConfig

聲紋降噪配置

turnDetectionConfig

ARTCAICallAgentTurnDetectionConfig

輪次檢測配置

experimentalConfig

ARTCAICallExperimentalConfig

非產品化定製化配置

vcrConfig

ARTCAICallAgentVcrConfig

VCR配置

preConnectAudioUrl

String?

接通後,播放歡迎語前的音效,支援url傳入;播放完音效之後,歡迎語還是會播放

ambientConfig

ARTCAICallAgentAmbientConfig

環境配置

backChannelingConfig

ARTCAICallAgentBackChanneling

附和語功能配置模組。配置後,系統會在特定觸發時機隨機播報簡短的附和語

autoSpeechForLlmPendingConfig

ARTCAICallAgentAutoSpeechLlmPending

智能體在LLM 響應延遲時的播報自動講話的配置

autoSpeechForUserIdleConfig

ARTCAICallAgentAutoSpeechUserIdle

智能體在使用者靜默時問詢的配置

Web

AICallAgentConfig

通話智能體啟動與回合組態

屬性名稱

類型

描述

agentGreeting(可選)

string

智能體歡迎語,為空白表示使用智能體配置值,最大長度100字元

wakeUpQuery(可選)

string

使用者在通話啟動前的指令,用於智能體在通話啟動後立即響應

agentMaxIdleTime

number

智能體閑時的最大等待時間(單位:秒),逾時智能體自動下線,預設值為600s

userOnlineTimeout

number

使用者未入會,智能體逾時關閉任務的時間,預設值為60s

userOfflineTimeout

number

使用者退會後,智能體逾時關閉任務的時間,預設值為5s

enablePushToTalk

boolean

是否開啟對講機模式

agentGracefulShutdown

boolean

是否優雅下線:播報完當前句子再停止

volume

number

智能體說話的音量,範圍為 0~400,預設值為100

workflowOverrideParams

JSONObject

工作流程覆蓋參數

enableIntelligentSegment

boolean

智能斷句開關

asrConfig

AICallAgentAsrConfig

語音辨識配置

ttsConfig

AICallAgentTtsConfig

語音合成配置

llmConfig

AICallAgentLlmConfig

大語言模型配置

avatarConfig

AICallAgentAvatarConfig

數字人配置

interruptConfig

AICallAgentInterruptConfig

打斷配置

voiceprintConfig

AICallAgentVoiceprintConfig

聲紋降噪配置

turnDetectionConfig

AICallAgentTurnDetectionConfig

輪次檢測配置

experimentalConfig

JSONObject

非產品化定製化配置

vcrConfig

AICallAgentVcrConfig

VCR配置