为智能小Q接入知识文档与第三方知识库-智能商业分析Quick BI-阿里云

使用场景

不同垂直行业的企业在日常分析看数时，常常会使用具有行业和企业特色的业务逻辑、分析思路等，并将这部分知识内容系统性地沉淀为企业专属的知识体系。而通用AI大模型往往会依赖通用语义理解分析需求，生成的是具有普适性而非贴合企业专属业务语境与分析习惯的分析结果。

您可以在Quick BI中接入企业已有知识库，并在发起指令时开启企业知识库搜索、指定分析思路，使小Q在思考过程中能够调用知识库内所包含的业务逻辑、分析思路等相关业务知识，输出更贴合企业自身业务语言与管理逻辑的思考结果。本文将为您介绍如何在Quick BI中接入企业知识库。

限制说明

高级版及专业版购买智能小Q功能后即可使用企业知识库。
仅支持组织管理员在组织管理后台进行知识库配置。

目前支持接入的知识库类型如下：

知识库类型	名称
知识文档	本地文件、飞书文档。说明仅支持上传格式为doc、pdf、xls、xlsx、csv的本地文件，且大小需控制在10M以内。
第三方知识库	阿里云百炼、通义点金、Dify。

功能入口

登录Quick BI的组织管理页面，在左侧导航栏中依次选择智能小Q > 通用配置 > 知识库管理，进入企业知识库页面。

您可以在此以添加知识文档或直连三方知识库的形式连接企业知识内容，连接成功后即可使用AI召回业务知识，解析并学习重点内容（例如：分析思路、内容模板等），帮助您在后续使用智能小Q能力时，能通过调用企业知识库，获取更精准、更符合企业实际业务情况的专属分析结果。

操作步骤

您可以在Quick BI中接入知识文档及第三方知识库。

添加知识文档

如果您所在的企业以本地文件或在线文档的形式存储业务知识，那么您需要选择添加知识文档，具体接入说明如下：

在企业知识库页面中，通过连接入口进入配置页面。不同情况下的入口不同：
- 如果您从未接入过知识库，此时企业知识库页面为空态，您需要将鼠标悬浮至添加知识文档按钮，并在下拉列表中选择文档来源。
- 如果您已经接入过知识库，此时企业知识库页面中将展示当前组织内已接入的所有知识库及文档，您需要点击添加知识文档按钮，在添加知识文档弹窗中选择文档来源。

在选择文档环节中选择上传的知识文档类型，并进行相关配置操作。

当知识文档类型为本地文件时，您可以点击或将文件拖拽到区域 ① 上传。
说明
- 仅支持上传格式为doc、pdf、xls、xlsx、csv的本地文件，且大小需控制在10M以内。
- 建议上传结构化数据，避免合并单元格，以便于提升识别准确性。
- 如果您上传的表格有多个sheet，我们将默认采用第一个sheet解析业务定义。
- 建议使用Chrome浏览器上传。

当知识文档类型为飞书文档时，您需要配置以下信息：

配置内容

说明

飞书应用信息

填入飞书应用的AppKey、AppSecret。

系统将自动为您读取办公软件接入中已授权的飞书应用，您可以在下拉列表中直接选择，无需再次输入应用授权信息。

若您需要添加新的授权应用，可点击添加新授权，并输入待授权应用的AppKey、AppSecret。

请登录飞书开放平台，在已创建的企业自建应用的基础信息 > 凭证与基础信息页面中获取AppKey、AppSecret。

说明

请确保授权的飞书应用具备docx:document、docx:document:readonly权限，您可以联系您的飞书组织管理员，在飞书企业自建应用的开发配置 > 权限管理中添加。

飞书文档链接

填入飞书文档的URL链接。

请登录飞书云文档，找到需要接入Quick BI的目标文档，复制并保存分享链接。

说明

请确保目标文档在获取分享链接时，开启了组织内获取链接的人可阅读权限。

完成文档配置后点击连接测试，提示连接测试成功即可继续选择确定连接。

连接成功后，您可以在内容预览环节查看到以下信息并进行相关操作。

预览内容		说明
区域 ①	文档展示名称	默认读取原始文档名作为展示名称，您也可以根据实际需求自定义修改。该名称将展示在企业知识库页面下的知识文档列表中。
区域 ②	文档链接	当知识文档类型为飞书文档时，在此处将显示飞书文档的URL链接。点击链接旁边的图标，即可在跳转新窗口中查看当前文档在飞书端的源文档。
区域 ③	文档学习	本地文档或飞书文档连接后，系统将会对初始文档内容进行解析，以识别出文档本身包含的业务知识类型。可识别的类型包括：业务逻辑、分析思路以及内容模板。解析完成后，您可以在文档解析页签下，让系统针对某一知识类型进行学习，以将文档内容进一步提炼成企业内通用的业务规则。业务逻辑：点击业务逻辑卡片中的去学习，将基于当前文档为您学习业务定义知识，完成后可于业务逻辑页签下查看详情。关于业务逻辑各配置项的具体说明，请参见业务逻辑配置。分析思路：点击分析思路卡片中的去学习，将基于当前文档学习企业分析思路，完成后可于分析思路页签下查看详情。关于分析思路各配置项的具体说明，请参见分析思路配置。内容模板：点击内容模板卡片中的去学习，将基于当前文档学习内容输出模板，完成后可于内容模板页签下查看详情。关于内容模板各配置项的具体说明，请参见内容模板配置。说明您也可以点击智能学习，由Quick BI根据文档内容自动完成学习并提炼出相应类型的知识；若您不需要学习只需保存文档内容，直接点击完成即可。目前仅支持对3万字符以内的内容进行知识类型学习。学习完成后，需要选中知识类型前的复选框才表示启用该知识，且文档添加成功后，此处启用的业务知识将会自动同步保存至知识库管理的相应模块下。

点击完成，添加成功后即可在企业知识库页面中查看到该知识文档，您可以在此进行以下管理操作：

区域	可进行的操作
① 切换文档类型	切换查看当前组织下已接入的本地文件、飞书文档。
② 搜索文档	在列表右上方的搜索框中输入文档名称关键字，即可快速筛选、定位包含特定关键字的文档。
③ 查看业务知识	若当前文档已进行了相关知识类型的学习，文档标题旁即会显示对应图标。您可以将鼠标悬浮至图标上，在弹窗中查看学习详情。支持在此：点击知识名称（a），即可跳转至对应的知识管理页面下，查看具体的知识内容、按需进行管理操作。点击重新学习（b），即可跳转至编辑知识文档弹窗的对应知识页签下，系统将自动发起重新学习。
④ 编辑知识文档	点击文档名称，即可在编辑知识文档弹窗中查看该文档的解析内容及各类型业务知识的学习、启用情况。支持在此： ① 修改文档展示名称。 ② 调整业务知识启用状态及内容：通过选中或取消勾选业务知识前的复选框，修改其启用状态。业务知识内容将展示于对应页签下，您可以按需调整。关于各类型业务知识配置项的说明，请参见业务逻辑配置、分析思路配置、内容模板配置。 ③ 调整业务知识学习情况：当您在接入文档时，未对某一知识类型发起过学习操作，点击去学习，系统将对该类业务知识进行学习。当您在接入文档时，已对某一知识类型发起过学习操作，但遇到知识内容需要更新的情况，例如：因在线文档内容更新，同步后需要重新读取，此时即可点击重新学习，系统将对该类业务知识重新发起学习。说明您也可以使用智能学习功能，由Quick BI根据文档内容自动完成学习。
⑤ 飞书文档同步	当您的飞书文档在飞书端进行了内容更新，需要同步至Quick BI时，您可以在此进行同步操作：点击图标，即可手动触发同步任务，同步飞书文档中的最新内容。点击图标，在查看同步记录弹窗中，查看当前文档的同步日志。
⑥ 更多操作	点击图标，在下拉列表中进行更多操作： a：基于当前文档内容，发起相关知识类型的学习。 b：当您不再需要使用该文档时请点击删除，二次确认后即可移除该文档。
⑦ 批量删除	支持同时选中多个文档，并进行批量删除的操作。

连接第三方知识库

如果您所在的企业以单独采买并本地部署知识库的形式储存业务知识，那么您需要选择添加第三方知识库，具体接入说明如下：

在企业知识库页面中，通过连接入口进入配置页面。不同情况下的入口不同：
- 如果您从未接入过知识库，此时企业知识库页面为空态，您需要将鼠标悬浮至连接第三方知识库按钮，并在下拉列表中选择需要接入的知识库类型。
- 如果您已经接入过知识库，此时企业知识库页面中将展示当前组织内已接入的所有知识库及文档，您需要点击连接知识库按钮，在连接三方知识库弹窗右侧的知识库列表中选择需要接入的知识库类型。

在连接知识库环节中配置知识库基础信息。不同知识库所需填入的配置信息不同：

阿里云百炼

配置项	说明	获取方式
API Key	输入阿里云百炼账号所对应的AccessKey ID。	您可以按照下图指引，通过阿里云百炼平台进入阿里云用户信息页面，获取AccessKey ID。
Secret Key	输入阿里云百炼账号所对应的AccessKey Secret。	在阿里云用户信息页面点击创建AccessKey，确认信息后即可于弹窗中获取AccessKey Secret。说明当前窗口关闭后，无法再次查询Secret，请妥善保管。若丢失AccessKey Secret，需创建新的AccessKey。
业务空间ID	输入知识库所在业务空间的ID。	在阿里云百炼平台，点击业务空间旁的图标，选择业务空间详情，即可于弹窗中获取当前业务空间的ID。
三方知识库ID	输入待连接知识库的ID。	在阿里云百炼平台，左侧导航栏选择知识库，在右侧知识库页面中找到需接入Quick BI的目标知识库，鼠标悬浮至该知识库并点击ID旁的图标即可复制知识库ID。

通义点金

配置项	说明	获取方式
API Key	输入通义点金账号所对应的AccessKey ID。	在阿里云用户信息页面获取当前账号的AccessKey ID。
Secret Key	输入通义点金账号所对应的AccessKey Secret。	在阿里云用户信息页面点击创建AccessKey，确认信息后即可于弹窗中获取AccessKey Secret。说明当前窗口关闭后，无法再次查询Secret，请妥善保管。若丢失AccessKey Secret，需创建新的AccessKey。
业务空间ID	输入知识库所在业务空间的ID。	通义点金控制台中暂不支持直接查看并获取当前业务空间的ID。但同一业务空间，在通义点金的ID与阿里云百炼相同，因此您可以通过阿里云百炼获取业务空间ID。也可以通过浏览器自带的开发者工具查询到当前业务空间ID。
三方知识库ID	输入待连接知识库的ID。	在通义点金平台，左侧导航栏选择资料中心 > 文档库，在右侧文档库列表中找到待接入Quick BI的目标文档库，点击其ID栏左侧图标即可复制文档库ID。

Dify

配置项

说明

获取方式

API Key

输入Dify账号所对应的API Key。

在Dify平台的知识库页面中，左侧导航切换至API页面。在该页面中您可以查看到Dify提供的知识库API文档，并在API密钥中管理可访问知识库API的凭据。

三方知识库ID

输入待连接知识库的ID。

进入Dify平台的知识库页面，在当前页面的URL地址中获取知识库ID。

完成信息填写后点击连接测试，提示连接测试成功即可继续选择确定连接。

连接成功后，您可以在召回测试环节进行以下配置。

配置内容		说明
区域 ①	知识库展示名称	自定义输入当前知识库的展示名称。该名称后续将展示于小Q对话框中的知识库选择列表，您可以根据知识库的归属部门或实际业务意义命名，帮助用户快速识别和选择知识库。
区域 ②	召回设置	设置召回的Top K及自定义Score阈值，以控制从知识库中检索内容的数量和质量。 Top K：用于筛选与用户问题相似度较高的文本片段的数量。数值越高，召回存在相关性的文本分段也就越多。该参数默认值为3，上限值为10。自定义Score阈值：用于设置文本片段筛选的相似度阈值。数值越高，说明对文本与问题要求的相似度要求越高，预期被召回的文本数量越少，结果也会相对更精准。该参数默认为关闭状态，开启后可手动调整阈值，上限值为1。
区域 ③	测试文本	输入测试文本以验证知识库的召回效果。
区域 ④	召回结果	在区域 ③ 中输入测试文本并点击测试后，即可在区域 ④ 中查看到召回结果。若结果不符合预期，您可以重新调整Top K及自定义Score阈值。点击某个召回结果卡片，可以查看该切片详情。

点击完成，添加成功后即可在企业知识库页面中查看到该知识库，您可以在此进行以下操作：
- ① 停用知识库：知识库添加成功后默认为开启状态，点击图标即可转为停用。
  说明
  仅支持同时启用10个知识库。
- ② 编辑知识库：点击图标，即可在连接三方知识库弹窗中修改知识库信息。
- ③ 删除知识库：点击图标，二次确认后即可删除不再需要使用的知识库。

后续操作

完成知识文档/第三方知识库接入及业务知识学习后，您可以在智能小Q对话框、小Q报告对话框中，设置开启企业知识库搜索、指定分析思路，以获取符合企业实际业务情况的专属分析结果，具体说明请参见Quick BI 智能小Q操作指南、小Q报告创建。
您可以在知识库管理中对已有的各类型业务知识进行管理操作，或按需手动添加新的业务知识。具体说明请参见业务逻辑、分析思路、内容模板。