衡石科技chatbot分析手册--钉钉数据问答机器人配置

钉钉数据问答机器人配置​

先决条件​

需要在衡石系统认证方式中配置好钉钉认证方式，具体步骤详见认证方式中关于钉钉的部分。先完成这部分配置后，再进行以下步骤。需要特别注意的是， 在启用钉钉数据问答机器人的场景，在衡石系统配置钉钉认证方式中，CorpId 字段是必须要填的。 另外如果钉钉用户还没登陆过衡石系统，跳转登陆应用时需要用到衡石系统的地址，所以需要配置衡石系统 Base URL，

钉钉中创建机器人应用​

1. 创建钉钉应用​

在钉钉开放平台后台管理下，在应用开发下的企业内部应用的钉钉应用管理中创建应用，设置logo，名称，描述等信息，点击“保存”完成创建。

2. 获取钉钉 Client ID，Client Secret 等信息​

在刚创建的钉钉应用设置页面“凭证与基础信息”部分，复制 Client ID，Client Secret 信息并保存起来，后续需要在衡石系统中设置问答机器人中用到。

3. 添加钉钉应用机器人能力​

在刚创建的钉钉应用设置页面“添加应用能力”部分，添加“机器人”能力。

4. 配置钉钉应用机器人​

上一步添加的机器人能力需要配置，请打开“机器人配置”开关并按要求配置，其中“消息接收模式”选择“Stream模式”，填写好后点击“发布”来发布机器人。

5. 发布应用​

钉钉应用需要发布后才能使用，并且需要审核通过。

衡石系统中配置机器人​

1. 配置数据包和机器人信息​

上面我们已经获取了 Client ID，Client Secret 等信息，这些信息需要配置到衡石系统中，并绑定到衡石的数据包。在数据包的设置页面的机器人设置中,勾选 钉钉，填上 Client ID，Client Secret 信息到相应字段中并保存。

选定数据包后，数据包下所有数据集都被绑定，回答用户问题所需的数据就是在这些数据集中查询的。 注意，需要根据衡石 ChatBI中的关于“提升大模型的理解能力”的步骤对数据包进行预处理，包括“数据向量化”等。

2. 配置数据权限​

钉钉登陆衡石的用户默认只有查看权限，而且对数据包默认是不可读的，可以把数据包的“查看者”权限授权给 ALL_USERS 用户组，这个方式比较快捷，控制的粒度比较粗。也可以针对每个已经通过钉钉登陆过衡石的用户单独设置数据权限。还可以通过用户属性设置权限。更多信息请参考衡石数据权限相关的文档。

钉钉聊天窗口中和机器人对话​

在钉钉中按刚才创建的钉钉应用的名称搜索，可以搜到机器人，选择机器人即可开始对话。

对话效果如下：