【技术文档AI落地】从0到1教你打造知识问答AI助手

背景

作为一个技术产品，团队一直面临技术支持的挑战。由于用户数量庞大，难以提供充分支持。自AI技术问世以来，我们希望搭建一个AI客服系统，直接根据技术文档回复用户，从而减轻技术支持的负担。
然而，现有AI解决方案在格式转换、图片支持和准确性方面表现不佳，导致我们不得不选择自主研发

敲敲云AI客服

最近，敲敲云推出的AI应用大模型受到了广泛好评。今天，我们将以“积木报表文档助手”为例，探索如何利用敲敲云AI大模型，从零搭建一个专属的知识问答AI客服。

特性亮点

精准回答：能够匹配多处文档，快速统计并回复用户问题。
图文并茂：支持图片、代码，确保回复内容格式完美。
智能代码生成：可为用户编写相关组件的示例代码。
智能理解图片：用户发送错误截图，AI也能Get到并提供有效解答。
一键导入：支持将整个Markdown文档库一键导入，快速构建AI知识库。

成功案例

目前，积木报表和JeecgBoot这两个国内知名的开源项目，已经通过敲敲云实现了在线AI客服能力。大家可以先体验一下效果。

用户可以通过AI助手快速查阅文档内容，无需再费力寻找。

JeecgBoot文档：https://help.jeecg.com
积木报表文档：https://help.jimureport.com

手把手教你搭建AI客服

敲敲云介绍

敲敲云是一个创新的 APaaS（应用平台即服务）零代码平台，结合了 AI 应用开发和知识库管理，旨在帮助企业快速构建个性化的业务应用。
敲敲云的 AIGC（生成式 AI 内容）功能模块允许用户创建复杂的 AI 工作流，支持 AI 智能问答，管理知识库和模型。用户可以通过可视化界面轻松设计和测试 AI 工作流程，快速将原型应用到生产环境中。

网址：https://www.qiaoqiaoyun.com

一、准备工作

1. 准备Markdown文档库

积木报表的文档为markdown格式，将积木报表docs目录下的markdown文件和static目录下的图片打成压缩包。

docs目录下存放了积木报表、大屏设计器和仪表盘设计器的所有文档，文档格式为markdown格式，并且文档中也包含图片。

图片路径：![](/static/jimuImages/screenshot_1608001770261.png)

static图片

static目录下存放了积木报表文档中所有的图片。在AI助手中也需要将图片展示出来。

需要注意确保自己的图片路径与静态文件存放的目录一致。

比如示例中图片路径为![](/static/jimuImages/ccc.png)

对应的压缩包路径为根目录/static/jimuImages/ccc.png

二、创建AI模型

登录进入敲敲云后，点击"AI应用"进入AI功能管理界面，咱们会用到"AI模型管理"、"AI知识库"、"AI应用管理"这三大模块。

AI模型是知识库、流程设计、AI应用等模块的核心组件，这些模块依赖于AI模型提供智能化能力。此处需要创建一个向量模型和一个语言模型。

1. 创建向量模型

向量模型用于AI知识库中；在"AI模型管理"中，点击"添加模型"，选择所需要的供应商

如需申请API Key或了解更多信息，可访问以下供应商官网：

2. 添加向量模型

填写以下信息：

模型名称 ：例如 敲敲云向量模型。
模型类型 ：此处选择 向量模型，AI知识库关联的模型必须为向量模型。
基础模型 ：如 text-embedding-ada-002。
API 域名：供应商提供的 API 地址。
API Key：供应商提供的访问密钥。

3. 创建语言模型

语言模型用于AI应用管理中，在“AI模型管理”中，点击“添加模型”，选择所需要的供应商

4. 添加语言模型

填写以下信息：

模型名称：例如 敲敲云小助手。
模型类型：此处选择 语言模型，AI应用管理中的AI模型必须为语言模型。
基础模型：如 gpt-4o。
API 域名：供应商提供的 API 地址。
API Key：供应商提供的访问密钥。

三、知识库创建

1.创建知识库

进入"AI知识库"，点击"创建知识库" ，输入信息即可创建知识库

填写基础信息：

知识库名称 ：自定义，例如 积木报表官方知识库。
知识库描述：简要介绍知识库内容。
向量模型：选择上一节创建的向量模型"敲敲云向量模型"。

2. 上传积木报表文档zip文件

点击创建的知识库，在"文档"中，点击"文档库上传"

选择积木报表文档zip文件，上传即可

文档上传完成，并向量化成功

3. 命中测试

在"命中测试"中，输入问题，可查看命中率及命中片段

至此知识库就创建好了。

四、创建应用

1. 创建应用

进入"AI应用创建"，点击创建应用，填写应用信息即可创建应用

2. 应用配置

点击创建的应用即可进入应用配置界面

提示词：用于引导 AI 生成符合预期的回答，可通过生成来生成提示词。
开场白：当用户开启新话题时，AI 主动发送的欢迎语。
预设问题：预设问题是新对话的初始引导，用户可以快速发起预设对话。
快捷指令：是对话输入框上方的按钮，配置完成后，用户可以快速发起预设对话。

AI模型：选择第三步创建的AI语言模型"敲敲云小助手"
知识库：添加知识库后，用户发送消息时，智能体能够引用文档知识中的内容回答用户问题。例如选则为第四部创建的知识库"积木报表官方知识库"
历史聊天记录：AI 记住的历史对话数量，影响上下文关联能力。

五、AI客服使用

1. 演示

在"AI应用创建"中，找到添加好的积木报表AI应用，点击演示即可进入AI客服演示界面

输入想问的问题，AI客服即可回答

2. 部署

可使用"iframe"方式嵌入到你的网站中，也可使用"script" 方式添加到网页的body区域中

示例，在html中嵌入

<!DOCTYPE html>
<html lang="zh_CN" id="htmlRoot">
  <head>
    <meta charset="UTF-8" />
    <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1" />
    <meta name="renderer" content="webkit" />
    <meta
      name="viewport"
      content="width=device-width,initial-scale=1.0,minimum-scale=1.0,maximum-scale=1.0,user-scalable=0"
    />

    <title><%= title %></title>
    <link rel="icon" href="<%= basePublicPath %>/logo.png" />
  </head>
<body>
 <!--此处id和appId 需要替换成你自己的 -->
 <script src=https://app.qiaoqiaoyun.com/chat/chat.js id="e7e007dd52f67fe36365eff636"></script>
 <script>
    createAiChat({
       appId:"1916758220211224888",
       // 支持top-left左上, top-right右上, bottom-left左下, bottom-right右下
       iconPosition:"bottom-right"
    })
 </script> 
  </body>
</html>

效果

在页面右下角展示AI客服

点击AI客服即可提问了

也可以将AI客服嵌入到你自己的项目中，快来试试吧！