通过阅读本文,您可以了解如何通过传入通话参数来启动智能体通话使本次通话更加符合您的业务场景。
功能描述
智能体在启动通话时,支持传入多个参数,以控制其运行状态及对话响应结果等。您可以根据自身的业务需求,通过传入特定参数,构建适合您业务的智能体对话。更多业务实现,请参见AI面试、口语陪练、情感陪伴。
目前智能体支持两种启动方式,您可以通过选择不同的启动方式,来适配您的业务场景:
通过服务端启动:灵活性强、扩展性强、一致性。
通过客户端启动:接通延时低、轻依赖、独立性强。
您通过控制台配置的问候语、音色、语种等参数,都会在启动智能体时进行覆盖。也可以在通话中调用UpdateAIAgentInstance - 更新AI智能体实例配置接口修改配置。
服务端启动智能体
您可以通过调用GenerateAIAgentCall - 生成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配置 |
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配置 |
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配置 |