Setup Guide

AI 客服安装与使用教程

按步骤完成安装、后台配置、嵌入网站和上线前检查。不会写代码也可以照着操作。

进入后台 查看前台

Step 1

宝塔面板安装并启动服务

  1. 把项目文件夹放到服务器或本机，例如 `aikefu`。
  2. 点击左侧【网站】选择node项目，安装 Node.js 20 或更高版本。
  3. 项目目录选择上传路径，包管理器选择npm，项目端口设置3000
  4. 后台管理网站配置：切换PHP项目，添加站点，PHP可设置静态，域名随意，添加后进入网站设置选择反向代理
  5. 目标url设置http://127.0.0.1:3000
  6. 发送域名设置前面添加的域名，如abc.com，添加完成后网站添加ssl认证
  7. 测试地址：
https://测试域名/api/health
https://测试域名/widget.js
https://测试域名/admin.html

Step 2

后台基础配置

登录后台默认密码是 `admin123456`，上线前到「系统配置 -> 后台安全」修改。
站点设置填写站点名称、主题色和浮窗按钮文字。点错颜色可一键恢复默认色。
公司与联系方式填写公司名称、电话、微信、邮箱、地址、营业时间。客户问联系方式时会自动调用。
域名白名单公网部署时填写允许嵌入客服的网站域名，每行一个，例如 `https://www.example.com`。

Step 3

录入产品资料和知识库

  1. 进入「产品资料」，录入产品名称、型号、分类、关键词和说明。
  2. 关键词里写客户常用叫法，例如简称、别名、型号、行业词。
  3. 进入「知识库」，录入售后说明、资料下载、服务流程、常见问题。
  4. 资料多时先导出现有表格，按同样列名整理 `.csv` 或 `.tsv` 后再导入。
  5. 录入后到前台聊天窗提问，确认回答能命中资料。

Step 4

配置 AI 接口

  1. 进入「系统配置 -> AI 接口」。
  2. 选择供应商，例如 SiliconFlow、DeepSeek、MiMo 或自定义 OpenAI 兼容接口。
  3. 填写 Base URL、模型名称和 API Key。
  4. 点击「测试 AI 连接」，看到成功提示后再保存。
  5. 没有 API Key 时，系统仍会用本地资料和规则兜底回答。

Step 5

嵌入到你的网站

  1. 在前台首页点击「复制嵌入代码」。
  2. 把代码粘贴到目标网站页面的 `` 前。
  3. 把 `apiBase` 改成你的 AI 客服服务域名。
  4. 如果设置了域名白名单，确保目标网站域名已经填入后台。
  5. 刷新目标网站，右下角出现客服按钮即完成。
<script>
  window.SITE_AI_WIDGET = {
    apiBase: "https://你的AI客服服务域名"
  };
</script>
<script src="https://你的AI客服服务域名/widget.js" defer></script>

Step 6

上线前检查

Troubleshooting

常见问题排查

页面还是旧样式先重启服务，再按 `Ctrl + F5` 强制刷新浏览器。
公司信息不生效确认后台保存成功，并重启旧服务。前台问“你们电话和地址是多少？”测试。
AI 没有回答检查 API Key、Base URL、模型名称，再点「测试 AI 连接」。
嵌入网站不能访问检查 `apiBase`、目标域名白名单、服务域名和 HTTPS。