本文将介绍如何使用 Qwen/DeepSeek 快速构建您的企业知识库。知识库能力包括:Chat 会话、知识库管理、文档管理、流量统计、会话统计等。
操作实录:五分钟打造企业级 AI 知识库
上面的视频演示了如何使用魔笔快速搭建开箱即用的企业级 AI 知识库(新版本流程大大简化,创建步骤以下面文档为准)。以下是具体的操作说明:
一、创建阿里云百炼应用
1、登录 阿里云百炼控制台 ,并新建阿里云百炼应用
2、在应用管理页,创建智能体应用
3、选择通义千问-Max模型(你也可以选择 DeepSeek 模型),此处可能会需要开通模型服务:
4、点击检索配置,开启展示回答来源
5、发布阿里云百炼应用(知识库将在后面步骤创建)
6、在 API key 管理页面创建 API-KEY
二、创建魔笔应用
1、登录多端低代码开发平台魔笔,在控制台点击创建应用
2、选择企业 AI 知识库(知识问答)模板
三、应用参数配置
配置1:内置数据库
模板中使用了内置数据库,您可以根据需要填写期望对应表的期望数据库表名称,如果空间中的内置数据库已有该名称的库表,会使用该库表作为模板中的库表(如果该库表与模板中预期使用的库表结构不一致,可能会导致报错),如果空间中的内置数据库没有该名称的库表,则会以该名称创建符合模板需求结构的数据库表。
可点击红圈处查看对应表结构。
表用途说明:
配置2:阿里云API集成资源
配置的集成资源将在应用中用于知识库管理和文档管理。
模板使用的OpenAPI集成需要您配置选择产品为大模型服务平台百炼
(支持输入搜索),版本选择2023-12-29
,地域选择华北2(北京)
(系统会自动带出以上信息,如有需要可手动调整)。
访问密钥请填写阿里云的AccessKey ID
和 AccessKey Secret
。关于如何获取阿里云 OpenAPI 访问密钥,请参考创建AccessKey。
配置3:内置百炼应用集成
输入有效的百炼空间 ID,待百炼空间有效性校验成功之后,页面会出现 API-KEY 和 应用 ID 的选项,选择会话功能需要用到的API-KEY及百炼应用即可。
四、配置知识库与文档
1、发布魔笔应用
看到下面的界面,您已经成功创建了魔笔应用。当以管理员身份访问时,应用将透出知识库与文档管理、流量与会话统计等能力。作为普通用户访问时,应用将作为 RAG 应用在会话页解答企业相关知识。首先我们将应用发布到开发环境。
2、上传企业知识文档
在上一步点击访问应用,在看到下面的页面时,代表当前为管理员身份登录。
进入文档管理,在默认类目上传文档
上传了 4 个魔笔相关说明,可以替换为您的企业知识。等待一会,文档的状态将变为“解析完成”(刷新页面以确认状态)。
3、创建知识库并导入文档
进入知识库,创建魔笔知识库
在知识库详情中,勾选默认类目,导入之前上传的文档
等待文档导入成功(刷新页面以确认状态)
4、知识库命中测试 & 添加检索
回到知识库列表,对新创建的知识库尝试“命中测试”。输入与文档有关的关键词,查看匹配结果。
添加检索,设定要检索的知识库范围。在会话页将以检索的知识库作为上下文。
五、会话测试(PC & 移动)
1、PC 会话页:点击会话,进入 PC 会话页
会话页基于知识库信息所构建的 RAG 应用提供对话交互,不包含知识库、文档等管理入口。输入“什么是魔笔”,Rag 将基于知识库回答相关信息。
由于当前默认为管理员身份登录,会话页左上角有“返回管理页”入口,在左下角有用户昵称与退出登录的入口。
查看引用文档
支持下载在知识库管理上传的文档,在阿里云百炼控制台上传的文档暂不支持下载
2、移动端会话页
将 URL 路径从 /chat 改为 /m-chat,可以查看移动端 H5 的会话页展示。在普通用户访问应用时,将自动按浏览器 UA 展示 PC 端或移动端的会话页面。
六、设置匿名访问权限
新的企业 AI 知识库,包含会话页与后台管理。我们可以设置匿名访问权限,让匿名用户可以在会话进行知识问答,但限制其访问管理后台。
1、开启应用匿名访问权限
回到魔笔应用编辑器,在应用设置面板,开启允许匿名访问,并点击前往匿名用户权限组配置。
2、设置匿名可访问的页面
对新创建的魔笔应用点击权限设置。
勾选中转页、会话移动端、会话 PC 端,并保存设置。
在集成访问权限中,勾选系统内置数据库集成,以及与应用相关联的阿里云百炼智能体集成资源,并保存设置。
在会话页 Chat 组件的 AI 集成操作属性上,可以确定所绑定的集成资源。
3、退出管理员登录态,使用匿名态访问会话页
回到已发布到开发环境的页面,在应用左下角点击退出登录,退出管理员登录态。
退出后,进入匿名访问的会话状态,不再展示返回管理员入口(1)、不再展示退出登录入口(2)
4、验证权限管控能力
以匿名用户访问管理员后台,将 url 路径从 /chat 改为 /home,将提示无权访问后台首页,设置生效。在这里可以“登录”,以管理员身份进入后台管理。或“返回首页”将返回会话。
如果您需要用户登录态,并限制访问权限在会话页。你可以设置其他权限组(如 END_USER)与匿名权限组相同的设置,并为该权限组添加用户,请参考账号与权限。
七、应用定制与权限逻辑说明
1、定制 Chat 助手头像与名称
对于头像资源链接,您可以使用魔笔的内置文件存储上传头像,设置为公开可见再获取其 URL,请参考文件管理。
2、首页跳转说明
应用使用中转页 /redirect 作为默认首页,进入该页面将触发函数 onRedirct。在应用编辑器内,进入中转页也将触发跳转,导致无法编辑中转页。在页面列表切换页面时,你可按下 ⌘(Mac) 或 Ctrl(Windows),将不触发挂载事件。
onRedirct 说明:1、判断浏览器 UA,若为移动端访问,跳转到移动端会话页;2、若为管理员登录态,跳转到管理页;3、跳转到 PC 端会话页。
3、isAdmin 逻辑说明
通过 计算属性 isAdmin 来判断用户是否有管理员权限:1、在应用搭建阶段,默认为管理员;2、匿名登录为非管理员;3、OWNER 与 ADMIN 角色为管理员。
下图为成员设置界面
您可以设置其他权限组为管理员,以 END_USER 为例:
// 设计时默认为管理员
if(mobi.appInfo.mode === 'edit') {
return true;
}
// 匿名用户默认非管理员
if(mobi.currentUser.isAnonymous) {
return false;
}
// 运行时权限组为 OWNER、ADMIN、END_USER 权限为管理员
return mobi.currentUser.groups.some(group => group.name === 'OWNER' || group.name === 'ADMIN' || group.name === 'END_USER');
同时对 END_USER 权限组赋予全部应用和集成的访问权限:
八、将应用发布到生产环境
在完成开发环境的测试和发布后,我们可以将应用绑定环境和域名并提交和发布:
1、添加域名
您可以将已备案的域名添加到魔笔平台中,应用发布后即可以使用自己的域名通过 HTTPS 协议访问。
魔笔平台支持两种方式添加域名和设置 SSL 证书:
使用阿里云 Web 应用防火墙,将域名接入到 Web 应用防火墙之后再添加到魔笔平台。
使用魔笔平台免费提供的测试证书和内置 WAF 服务(仅用于测试场景,如做大规模生产发布请自行配置 WAF 防火墙及 HTTPS 证书)
详细的配置步骤,请参考 环境和域名。
在完成生产环境域名配置后,就可以将应用发布到生产环境,获得持续稳定的服务。
附录:能力效果概览
1、DeepSeek 效果预览
在阿里云百炼应用中,我们默认使用了通义千问系列模型,同时也可以选择 DeepSeek 模型:
DeepSeek 回答示例:
2、数据分析
统计概览:
站点统计:
会话统计:
知识库统计: