本文将介绍变量的新增、调用以及表达式的配置说明。
功能概述
变量可以十分灵活地用于用户当前对话流中,可以通过服务节点进行赋值,并在其他节点中使用${botVar.全局变量名}进行引用。
功能入口
-
登录云联络中心控制台,在左侧导航栏选择实例管理-V2,单击具体实例的访问地址进入实例控制台。
-
单击页面右上角菜单按钮,选择数字员工进入数字员工业务控制台。在左侧导航栏选择AI平台>多轮对话(对话工厂)>变量管理。
新增全局变量
进入变量管理界面,单击新增全局变量,输入变量信息,单击确定即可完成全局变量创建。在新增全局变量对话框中,需填写变量名称、变量类型及默认值等字段。
变量调用示例
在输入框中输入“$”符号即可出现变量的提示信息,“botVars.”的前置符号即为全局变量。
弹出的下拉菜单包含变量、环境参数、系统参数、服务返回参数、系统函数五个选项,单击变量右侧的选择链接即可引用全局变量。
变量列表中显示可选变量如 botVars['测试变量'],单击即可将其插入回复内容。
在分支配置对话框的变量赋值区域,单击变量搜索下拉框,可选择已有变量(如"测试变量")或单击新建变量创建新变量。
表达式配置说明
在配置变量赋值时,可能需要一些系统设定的参数:环境参数、服务返回参数、系统参数。参数的具体含义如下:
在变量赋值的值输入框中输入 $ 后,系统弹出变量类型选择菜单,包含 botVars(变量)、envVars(环境参数)、sysVars(系统参数)、svcVars(服务返回参数)、sysFuncVars(系统函数)五种类型,单击对应类型右侧的选择链接即可引用该类变量。
环境参数
在分支配置的变量赋值区域,在值输入框中输入 $ 符号,系统将自动弹出环境参数(envVars)提示列表供选择。
-
${envVars['CURRENT_QUERY']}:用户QUERY。
-
${envVars['APP_ID']}:机器ID。
-
${envVars['SENDER_ID']}:C端用户ID。
-
${envVars['SENDER_NICK']}:C端用户名称。
-
${envVars['SESSION_ID']}:会话ID。
-
${envVars['CHAT_ID']}:请求 ID。
-
${envVars['VENDOR_PARAM']}:随路数据。
-
${envVars['EMOTION_POLARITY']}:情绪极性。
-
${envVars['EMOTION_NAME']}:情绪名称。
-
${envVars['CURRENT_DATE']}:当前日期。
-
${envVars['CURRENT_TIME']}:当前时间。
-
${envVars['CURRENT_TURN']}:当前对话轮数。
服务返回参数
在分支配置的变量赋值区域,在值输入框中输入$可触发自动补全下拉菜单,从中选择需要引用的服务返回参数。
${svcVars['functionOutput']}:全局服务返回结果。
系统函数
在分支配置的变量赋值区域,在值输入框中输入$符号即可触发系统函数下拉列表,从中选择需要的系统函数。
-
${sysGetRandom(n)}:返回指定范围[1,n]内的随机数字。
-
${sysFormatDate('format')}:按自定义格式输出时间。
-
${sysAddDate(day)}:基于当前时间增加若干天输出,格式yyyy-MM-dd。
-
${sysAddTime(second)}:基于当前时间增加若干秒输出,格式HH:mm:ss。
-
${sysUnescapeJson('str')}:解码JavaScript中被转义的字符串。
-
${sysIntervalDays('startDate','endDate')}:计算开始与结束时间间隔,格式yyyy-MM-dd。
-
${sysIntervalSeconds('startTime','endTime')}:计算开始与结束时间间隔,格式HH:mm:ss。
-
${sysFormatStrDate('source','format')}:时间格式转换,将原有yyyy-MM-dd HH:mm:ss格式的时间转换成自定义格式。