本文将介绍如何使用 Qwen/DeepSeek 快速构建您的企业知识库。知识库能力包括：Chat 会话、知识库管理、文档管理、流量统计、会话统计等。
操作实录：五分钟打造企业级 AI 知识库
上面的视频演示了如何使用魔笔快速搭建开箱即用的企业级 AI 知识库，下面是具体的操作说明：
一、创建阿里云百炼应用
1、登录 阿里云百炼控制台 ，并新建阿里云百炼应用
2、在应用管理页，创建智能体应用
3、选择通义千问-Max模型（你也可以选择 DeepSeek 模型），此处可能会需要开通模型服务：
4、点击检索配置，开启展示回答来源
5、发布阿里云百炼应用（知识库将在后面步骤创建）
二、获取必要配置内容
配置项 | 内容说明 | 参考值 |
阿里云百炼空间 ID （WORKSPACE_ID） |
| llm-**************** |
阿里云百炼 API-KEY | 在智能体应用发布渠道获取
| sk-******************************** |
阿里云百炼应用 ID | 在阿里云百炼控制台－应用管理获取
| |
Open API 基本信息 |
| |
阿里云 AK/SK | 用于访问阿里云 OpenAPI 的凭证，关于如何获取阿里云 OpenAPI 访问密钥，请参考 创建 AccessKey | |
三、创建魔笔应用
1、访问阿里云百炼应用，选择发布渠道，选择魔笔分享渠道：
2、选择新企业 AI 知识库，点击下一步
3、填写应用名称后，将上一章的必要资源配置内容按下图填入后发布：
四、配置知识库与文档
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、数据分析
统计概览：
站点统计：
会话统计：
知识库统计：
