通過閱讀本文,您可以瞭解如何通過傳入通話參數來啟動智能體通話使本次通話更加符合您的業務情境。
功能描述
智能體在啟動通話時,支援傳入多個參數,以控制其運行狀態及對話響應結果等。您可以根據自身的業務需求,通過傳入特定參數,構建適合您業務的智能體對話。更多業務實現,請參見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 | 語音辨識配置 | |
ttsConfig | 語音合成配置 | |
llmConfig | 大語言模型配置 | |
avatarConfig | 數字人配置 | |
interruptConfig | 打斷配置 | |
voiceprintConfig | 聲紋降噪配置 | |
turnDetectionConfig | 輪次檢測配置 | |
experimentalConfig | 非產品化定製化配置 | |
ARTCAICallAgentVcrConfig | VCR配置 | |
preConnectAudioUrl | String | 接通後,播放歡迎語前的音效,支援url傳入;播放完音效之後,歡迎語還是會播放 |
ambientConfig | 環境音配置 | |
backChannelingConfig | 附和語功能配置模組。配置後,系統會在特定觸發時機隨機播報簡短的附和語 | |
autoSpeechForLlmPendingConfig | 智能體在LLM 響應延遲時的播報自動講話的配置 | |
autoSpeechForUserIdleConfig | 智能體在使用者靜默時問詢的配置 |
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 | 語音辨識配置 | |
ttsConfig | 語音合成配置 | |
llmConfig | 大語言模型配置 | |
avatarConfig | 數字人配置 | |
interruptConfig | 打斷配置 | |
voiceprintConfig | 聲紋降噪配置 | |
turnDetectionConfig | 輪次檢測配置 | |
experimentalConfig | 非產品化定製化配置 | |
vcrConfig | VCR配置 | |
preConnectAudioUrl | String? | 接通後,播放歡迎語前的音效,支援url傳入;播放完音效之後,歡迎語還是會播放 |
ambientConfig | 環境配置 | |
backChannelingConfig | 附和語功能配置模組。配置後,系統會在特定觸發時機隨機播報簡短的附和語 | |
autoSpeechForLlmPendingConfig | 智能體在LLM 響應延遲時的播報自動講話的配置 | |
autoSpeechForUserIdleConfig | 智能體在使用者靜默時問詢的配置 |
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 | 語音辨識配置 | |
ttsConfig | 語音合成配置 | |
llmConfig | 大語言模型配置 | |
avatarConfig | 數字人配置 | |
interruptConfig | 打斷配置 | |
voiceprintConfig | 聲紋降噪配置 | |
turnDetectionConfig | 輪次檢測配置 | |
experimentalConfig | JSONObject | 非產品化定製化配置 |
vcrConfig | VCR配置 |