元数据与属性

本章节将讲解：什么是元数据、属性，以及对话平台如何利用元数据和属性来实现个性化的回复和响应

元数据定义

在与用户的每一次对话交互过程中，机器人除了能够通过NLP识别对话内容的关键信息外，会话所携带的一些原生信息如时间戳、情绪、用户属性等，能够更好的帮助机器人去做出更恰当的响应。我们将这类原生信息统一称作元数据(metadata)。

元数据(metadata)包含以下几个常见的类型：

1. 由外部创建并和消息一同通过对话接口传入的参数名称与参数值，譬如时间戳、用户ID等信息。
2. 通过用户ID查询到的，能够描述该用户画像的属性名称与属性值，如用户职位、会员等级等。
3. 模型基于消息进行计算，生成额外描述信息的参数名称与参数值，如情绪分类等。

预设元数据

预设元数据是调用对话接口时，平台自动生成的信息。目前平台提供的预设元数据如下：

元数据名	说明	示例
timezone	会话所在时区，详情见机器人管理	Asia/Shanghai
agent_id	回复的机器人id，详情见机器人管理	8016
environment	回复的环境，详情见训练发布与测试	SKETCH

属性定义

属性是元数据中最常被使用的一类，通过属性往往能够实现绝大多数业务相关的个性化需求，譬如：

• 针对不同业务属性或属性组的用户，回复不同的内容
• 在回复内容中，拼接用户的属性值，使得机器人的话术更加准确且个性化
• 将用户属性传递给第三方接口服务，为用户提供对话以外的更多能力

平台上提供了用户的属性管理能力，在平台上可以维护用户的属性和属性类型，并使用这些属性搭建对话流程。

属性分为“单值”和“多值”两种类型，他们在更新的策略上有所不同。

• 单值属性只有一个值，被更新时，会将原属性值替换。
• 多值属性可以有多个值，类似标签。可以在保留已有属性值的基础上，追加更多值。

预设属性

预设属性是创建用户时，平台自动为用户生成的信息，所有预设属性可以在属性管理界面看到。目前平台提供的预设属性如下：

属性名	说明
channel	用户所在的渠道id

用户属性的创建和管理

1. 点击机器人菜单“搭建-自定义设置-属性”，就可以进入到属性管理页面，展示属性ID、属性名称、属性类型、及操作按钮：

2. 点击“新建属性”按钮，设置属性名称及属性类型即可创建一个新的属性。

• 单值类型一般为属性值之间互斥的属性。如会员与非会员、最高学历、性别等
• 多值类型一般为可以同时标记多个的用户标签。如特长、偏好等

更改渠道用户的属性值

1. 在创建用户后，可以调用接口来操作指定用户的属性值，调用可能用到的接口如下：
   1. 创建渠道用户：操作多个渠道用户接口/chatbot/v1alpha1/agents/{agentId}/channels/{channelId}/users/mutate
   2. 获取渠道用户属性值：获取用户的属性值接口/chatbot/v1alpha1/agents/{agentId}/channels/{channelId}/users/{username}/attribute-value
   3. 更改渠道用户的属性值：更改用户的属性值接口/chatbot/v1alpha1/agents/{agentId}/channels/{channelId}/users/{username}/attribute-value/mutate

通过元数据实现个性化回复

元数据通用的引用格式和渲染效果

引用格式：{metadata=元数据名称}

渲染效果：如果元数据为空则渲染为空；如果元数据是多值，目前会将所有值用“，”拼接成一个字符串整体渲染。

在机器人回复内容中引用元数据值

在FAQ答案、对话树的机器人问和机器人回、以及对话流程中的消息发送、询问填槽等单元均可生效。

在机器人发送消息的答案文本编辑区域中，用元数据值来渲染答案。

机器人会将对应引用文本直接用元数据值替换：

note

• 如果测试时机器人无法发送消息，请复核metadata的引用格式是否错误。
• 常见的错误类型是括号{}不成对导致的解析JSON报错，因此机器人无法发送消息。

运算赋值单元中将元数据值赋给词槽

在赋值运算单元-复制模式的“将词槽赋值为”的编辑区域中，用元数据值来赋值。

机器人会将对应元数据值赋给对应词槽：

将元数据值作为多槽单元的接口请求参数

在多槽接口单元的请求地址编辑区域中，用元数据值来渲染请求参数。

机器人会将请求参数中的引用直接用元数据值替换：

在对话流程策略中使用元数据值

1. 单元的分支跳转配置中，根据元数据值进行跳转
2. 将属性值用于询问填槽单元超过询问次数后的兜底值