变量管理

更新时间:
复制为 MD 格式

本文将介绍变量的新增、调用以及表达式的配置说明。

功能概述

变量可以十分灵活地用于用户当前对话流中,可以通过服务节点进行赋值,并在其他节点中使用${botVar.全局变量名}进行引用。

功能入口

  1. 登录云联络中心控制台,在左侧导航栏选择实例管理-V2,单击具体实例的访问地址进入实例控制台。

  2. 单击页面右上角菜单按钮,选择数字员工进入数字员工业务控制台。在左侧导航栏选择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格式的时间转换成自定义格式。