自然语言配置地址：http://xxxx/smartbi/vision/index.jsp

2.1 自然语言分析的登录地址

自然语言分析的登录地址，通常是一个特定的URL，用于访问Smartbi平台上的自然语言分析功能。
在自然语言分析登录地址中输入NLA地址（图一）后点击测试连接，会弹出测试通过（图二），则表示能够正常连通。如果测试不通，经常是2.2 系统选项配置中的smartbi地址忘记填了。

图一

2.2 图谱管理

图谱管理是用于管理基于数据模型或业务主题构建的知识图谱的功能。通过图谱管理，用户可以直观地看到数据之间的关系和层次结构，从而更深入地理解数据。在此界面中可选择 Smartbi 系统内的任意数据模型来构建知识图谱。
功能入口：运维设置->自然语言配置->图谱管理

2.2.1 关键字搜索

在已构建好的模型图谱列表中搜索所输入的关键词，快速找到相关的图谱。如输入经营，则在列表中只显示带有经营的图谱名称出来。

2.2.2 刷新

对构建好的模型图谱进行刷新

2.2.3 设置模型顺序

对构建好的模型图谱进行排序展示。

对已经构建的模型图谱进行排序，排序后进行保存，如果不进行排序的话可点击取消。

2.2.4 构建模型图谱

构建模型图谱：用户可以选择需要构建知识图谱的数据模型或业务主题，然后选择需要训练的维度来构建图谱。构建过程中，可以排除对模型训练和查询毫无意义的字段，以提高查询的准确率和模型训练效率。

2.2.4.1 点击构建模型图谱

点击   按钮，选择需要构建知识图谱的数据模型或业务主题（例如给数据模型"订单模型"构建模型图谱。），接着点击下一步。

选择需要训练的维度，点击训练 开始构建知识图谱。
某些毫无意义的维度字段（例如ID、描述、详情等长字符串并且对模型训练和查询毫无意义的字段），会严重影响查询的准确率和模型训练效率，需要手动将其在训练维度中排除掉。

上一步：如果选择错误的数据模型或业务主题，可点上一步进行重新选择；
知识图谱构建成功后会提示显示"操作成功"，并且能在模型管理的列表内查看到新增的模型知识图谱。
取消：取消构建模型图谱

2.2.4.2 更新

通过  可以重新构建已有的模型图谱，重新选择需要训练的维度。维度选择完毕后，点击   按钮重新构建图谱。

2.2.4.3 编辑

2.2.4.3.1 配置

对已构建的知识图谱进行编辑，包括设置默认查询指标、默认时间范围、配置推荐问句以及切换大模型等。

• 默认查询指标

点击设置：会弹出一个页面，在这边设置一个默认的指标值

• 默认时间范围

点击设置：会弹出一个页面，在这边配置一个默认的时间

• 配置推荐问句

点击设置：会弹出一个页面，可以添加5条推荐问句，用于给模型配置推荐问句在展示界面中可以看到，添加完后点击保存。
如果对之前添加的推荐问句进行修改，那么再点击设置对之前配置的推荐问句进行删除或修改，之后点击保存。

• 配置大模型

点击可以切换大模型，默认是使用的系统设置中的，在这边可切换大模型（注：此处切换的大模型是需要在大模型配置中已有的）

2.2.4.3.2  同义词（废弃）

由于模型自带语料库有限，用户可根据用户的用词习惯和行业领域添加同义词，以提升语义分析的精准度，从而实现更精准的查询效果。

• 导入

同义词词条支持通过"csv文件"的形式批量导入，点击"导入"按钮，在弹出页面中点击上传，选择对应的csv文件，等待加载出来，加载后点击批量加载，这时就会将文件列表中的都导入进来。

• 导出

点击导出会将页面上的配置的同义词导出到本地上，导出的资源会进行加密处理，导出的csv文件名为download_synonyms.csv；

CSV文件的数据格式如下：

• 关键词搜索

在已创建的同义词列表中搜索所输入的关键词；如业绩，则在列表中只显示业绩的这个同义词

• 简易配置

在简易配置中是没有新建按钮的；
在简易配置中需要依次将度量和维度展开后找到具体的指标后才能设置，如：商机预计合同额对应的是商机预计确认合同额，这个时候在对应的指标后面按钮点一下，然后在输入框中填写对应的文字，之后点击，在设置完成后需要点击立即生效按钮

• 高级配置

点击高级设置会进入高级设置页面中；

• 新建

点击新建会弹出页面：

按照需求创建同义词，在用户输入内填写的词语都会用户模型维度指标中
多个同义词采用英文逗号 ';' 隔开，例如：同义词1;同义词2;同义词3...
新建的关键词"合同金额;确认合同额;营业收入"的同义词词条如下：

• 高级配置功能

【编辑】按钮，对创建的同义词进行修改
【停用】按钮，对创建好的同义词进行停用，停用后就不会生效，并且会将这条数据背景填充为红色，当点击停用后，原停用的按钮会变成启用，如果想要重新将这个同义词进行生效，再点击就可以了；
【删除】按钮，对创建好的同义词进行删除

• 立即生效

立即生效按钮（ ）：在配置完同义词后只有点击立即生效后才会生效，否则是不会生效。

2.2.4.3.3 示例（废弃）

• 新增示例
• 关键词搜索
• 立即生效

2.2.4.3.4 知识

• 导入

点击导入按钮后会弹出本地的文件，选择对应的csv文件，选择后点击打开，这个时候会提示是否覆盖原数据，点击是就会将原有的覆盖，否就是不覆盖，会再增加csv文件的所有知识。

• 导出

点击导出按钮会将页面上的配置的知识导出到本地上，导出的资源会进行加密处理，cav文件名为download_knowledges.csv。

• 新增知识

点击新增知识，会弹出页面，在页面中配置对应的知识，如：合同情况，那么就是在标题中填写"合同情况"，在知识中填写"合同情况指的是：合同名称，销售人员，合同金额，签约日期"，配置完后点击保存。

• 关键词搜索

在已创建的知识列表中搜索所输入的关键词；如北上，则在列表中只显示北上广深的这个知识。

• 状态

状态分为：禁用、启用（自动）、必选三种
禁用：表示不会生效
启用（自动）：表示匹配后才会生效
必选：表示在知识中必会生效

• 操作

编辑按钮：对创建的知识进行修改；
删除按钮：对创建的知识进行删除；

• 立即生效

立即生效按钮：在配置完知识后只有点击立即生效按钮后才会生效，否则是不会生效的。

2.2.4.3.5 动态知识

由于问句中的一些词的展示不确定性，用户可根据动态知识灵活的匹配，动态知识有更强的适应性、灵活性，能够应对复杂、多变的问题。
不过在配置动态知识前，需要先配置用户属性；

• 用户属性

若无法直接根据当前用户的信息获取到机构信息，则需要用户和机构的映射表，然后创建用户属性从映射表中根据不同的用户获取机构信息。
配置入口：在"系统导航栏"选择 公共设置，展开资源目录区，在"全局资源定义"左侧节点下文件夹的选择 用户属性 新建 > 用户属性，选择数据源之后，进入"新建用户属性"界面。

• 导入

点击导入按钮后会弹出本地的文件，选择对应的csv文件，选择后点击打开，这个时候会提示是否覆盖原数据，点击是就会将原有的覆盖，会再增加csv文件的所有知识。

• 导出

点击导出按钮会将页面上的配置的动态知识导出到本地上，导出的资源会进行加密处理，cav文件名为download_dyn_knowledges.csv。

• 新增动态知识

点击新增知识，会弹出页面，在页面中配置对应的动态知识，比如：获取本省的数据，这个时候每个人的省份可能都是不一样的，这个时候就需要动态获取，动态获取的这个需要先在用户属性那边来查每个人的省份，然后根据动态知识的示例中中表达式的本省就是用户属性那边的名称，配置完后点击保存。

• 状态

状态分为：禁用、启用（自动）、必选三种
禁用：表示不会生效
启用（自动）：表示匹配后才会生效
必选：表示在动态知识中必会生效

• 操作

编辑按钮：对创建的动态知识进行修改；
删除按钮：对创建的动态知识进行删除；

2.2.4.3.6 向量库检索

通过输入问句、类型和检索类型来进行检索和管理知识图谱中的向量库，以确保数据的准确性和高效性。

如问句是：2020年各车企销量，类型为成员，检索类型为向量库检索，在点击检索后就可以查出对应的成员，在匹配度那边有对应的百分比值显示。
如果是类型查询是成员和维度指标的时候，就会将问句中使用的维度、指标和成员都展示出来，通过看类型就可以看出问句列的值对应的类型。

2.2.4.3.7 预处理代码

针对指定数据模型，通过自定义的 python 代码逻辑来预处理（比如时间处理、大小写转换、移除多余空格、去除标点符号、添加知识等）用户输入的问句。


使用示例

• 编写新的处理逻辑

• 保存

• 对话发现新写的问句处理逻辑生效了

2.2.5 删除

删除按钮：删除已经创建好的模型图谱，在弹出框中点击确定就会删除已创建的模型图谱。

2.2.6 训练计划

训练计划是一种自动调度机制，通过设置训练计划，可以完成定时执行训练。

2.3 大模型配置

大模型配置是Smartbi AIChat中实现自然语言理解和对话的关键步骤。通过配置大模型，系统能够更准确地理解用户的意图和需求，从而提供更精准的查询结果和数据分析服务。
功能入口：运维设置->自然语言配置->大模型配置

2.3.1 新增

点击新增，会弹出一个大模型配置的页面，然后选择大模型，根据选择的大模型进行配置，配置完后点击确定。Smartbi AIChat支持多种大模型，用户可以根据实际需求进行选择。

新建后会保存在列表中。

2.3.2 关键词搜索

对新增好的大模型进行搜索。

2.3.3 是否默认

是否默认 ：设置默认的大模型。

2.3.4 测试连接

测试连接 ：对已配置的大模型进行验证是否能测试通过。

2.3.5 编辑

编辑按钮 ：对已配置的大模型进行修改。

2.3.6 删除

删除按钮 ：对已配置的大模型进行删除。