即答客服 · 详细配置指南

本教程将手把手教你如何完成即答客服插件的各项配置。请按照以下步骤，逐项检查并设置，以确保客服功能最佳化。

第一步：签署使用条款

在正式使用插件前，必须先同意使用条款，否则插件的核心功能将无法启动。

1. 进入插件设置页面，首先会看到「使用条款」面板。
2. 仔细阅读面板中的条款内容。
3. 找到底部的 「我已阅读并同意相关条款」 复选框。
4. 单击勾选该选项。
   • 注意：勾选后，插件的其他设置项才会生效。

第二步：基本设置（核心信息）

操作指南：

1. 匿名聊天通讯

   • 启用匿名聊天通讯：访客通过邮箱＋验证码取得通讯

2. 登录聊天通讯

   • 启用登录聊天通讯：网站已注册用户直接获取通讯

3.消息设置

• 欢迎语：访客发起会话时自动发送的欢迎消息
• 离线提示：客服离线时显示的提示消息

第三步：通知设置（防漏单）

为了不错过访客的咨询，请务必配置好通知功能。 操作指南：

1. 邮箱验证

   • 启用：开启后，匿名访客发起会话需要验证邮箱

2. 超时通知

   • 启用：开启后，客服或用户超时未回复会发送邮件通知

3.消息设置

• 客服通知邮箱：通知客服有访客信息;可设置多个邮箱,用英文逗号分隔 4.自动关闭
• 开启:开启后，访客超时未回复将自动关闭会话

第四步：快捷回复（提效神器）

预先设置好常见问题的回答，聊天时点一下就能发送，无需重复打字。

操作指南：

1. 查看现有回复

   • 在「快捷回复」页面，你可以看到当前的回复列表。

2. 添加新回复

   • 点击列表右上角的 「新增」 按钮。
   • 在弹出的输入框中，填写一句常用的回复语。
   • 推荐预设内容：
     • “您好，请问有什么可以帮您？”（开场白）
     • “稍等，我帮您查询一下。”（安抚语）
     • “感谢您的咨询，再见！”（结束语）

第五步：安全设置

频率限制（防刷）

• 消息频率限制：建议设置为 20-30条/分钟。防止有人用脚本一秒钟发几百条消息。
• IP 会话数限制：建议设置为 3-5个。限制同一个 IP 地址同时只能发起几个聊天窗口。

第六步：数据清理（维护）

随着使用时间增加，聊天记录会占用数据库空间，建议定期**「备份」** 后清理

操作指南：

1. 保留天数

   • 根据需要设置保留最近多少天的聊天记录

2. 自动执行

   • 点击下拉菜单选择时间范围
   • 也可以选择只清理已关闭的会话,勾选按钮即可

第七步:图片上传

1. 配置图床服务
   • 选择图片存储服务：
     • ImgBB(推荐,免费5000次每月)
     • SM.MS(国内快,免费5GB)
   • API Key：输入你的 API 密钥
     • SM.MS从 https://sm.ms/home/apitoken 获取
     • ImgBB从 https://api.imgbb.com/keys 获取
   • **图片大小:**限制上传图片的最大大小
   • **允许的图片格式:**根据需要修改

第八步：外观设置（个性化）

给你的客服窗口换个皮肤，让它和你的网站风格更搭。 操作指南：

1. 设置主题色

   • 「主题色」 选项。
   • 方法一：直接在输入框填入颜色的十六进制代码（如 #000000 是黑色，#FF0000 是红色）。
   • 方法二：点击输入框右侧的颜色方块，弹出 调色盘。在调色盘上拖动鼠标，直观地选择你喜欢的颜色。

2. 按钮位置设置

   • 左右下角
   • **横向偏移:**根据需要手动调节按钮位置

3. 检查效果

   • 设置完成后，建议去前台页面刷新一下，看看客服按钮和聊天窗口的颜色是否满意。如果不满意，随时回来调整。

第九步:AI 智能客服配置（🤖 核心功能）

配置 AI 智能客服，让系统自动处理大部分常见问题，大幅提升响应效率

功能概览：

• 支持 OpenAI、DeepSeek、Claude 等所有 OpenAI 兼容 API
• AI 优先响应，自动处理 80%+ 常见问题
• 智能转人工，复杂问题无缝衔接
• 完整保留 AI 和人工的对话历史

操作指南：

1. 配置 AI API 服务

   • API 提供商：选择你使用的 AI 服务（OpenAI、DeepSeek、Claude 等）
   • API 地址：填写对应的 API 端点地址
     • 提示：大多数服务商使用标准地址，如 OpenAI 为 https://api.openai.com/,OpenAI 兼容格式，不需要加 /v1 后缀
   • API Key：输入你的 API 密钥
     • 注意：请妥善保管 API Key，不要泄露给他人
   • 模型选择：选择要使用的 AI 模型
     • 对话模型:例如gpt-4o-mini、deepseek-chat、claude-3-sonnet 等
     • 向量模型:推荐 text-embedding-3-small

2. 优化 AI 回答质量

   • 温度参数：调整 AI 回答的创造性（建议 0.7-0.9）
   • 最大 Token 数：限制单次回答的长度

3. 显示设置

   • **AI用户:**选择一个 Halo 用户作为 AI 客服的身份，将使用该用户的头像和名称
   • **提示词:**可根据实际情况修改

4. 设置 AI 响应策略

   • AI 优先模式：开启后，访客问题将优先由 AI 自动回答
     • 效果：可自动处理 80%+ 的常见问题，大幅减轻人工客服压力
   • 智能转人工：开启后，当用户输入转人工或触发相关操作时，自动转接人工客服
     • 触发条件：用户明确要求转人工,匹配关键字时自动触发转接人工客服
   • 工作时间配置
     • 配置客服工作时间，非工作时间将显示不同的提示消息
     • 工作时间限制开启后，只有在工作时间内才会转接人工客服
   • 对话历史保留：确保 AI 和人工的对话记录完整保存
     • 优势：转人工后，客服可以看到完整的对话历史，无需重复询问

第十步：RAG 知识库系统配置（📚 智能问答）

配置 RAG（检索增强生成）知识库，让 AI 基于你的网站内容自动回答访客问题。

功能概览：

• 支持导入文章、页面、自定义文本
• 基于站点内容自动回答访客问题
• 智能分词和向量检索
• 实时索引，内容更新自动同步

操作指南：

导入知识内容

• 文章导入：选择网站中的文章或页面，批量导入到知识库
• 自定义文本：手动添加常见问题、产品说明等文本内容
• 文件上传：支持上传文档文件（如 Markdown/TXT、HTML 等）
• 批量导入：支持一次性导入多篇文章或页面，提高配置效率

配置搜索引擎（联网搜索）

• 搜索引擎选择：当知识库无匹配结果时，可选择启用联网搜索补充答案
• 推荐选项：
  • Tavily（AI 优化）：AI 优化的搜索引擎，搜索结果更精准，适合追求高质量答案的场景
  • 博查（国内快速）：国内搜索引擎，访问速度快，适合国内用户使用
• 搜索开关：开启后，当知识库无法回答问题时，系统会自动搜索互联网获取最新信息

💡 配置提示：首次配置时建议先测试几个问题，确认 AI 回答质量后再正式启用。搜索引擎建议根据你的用户群体选择：海外用户推荐 Tavily，国内用户推荐博查。

高级 RAG 优化功能：

• HyDE：假设文档嵌入，提升检索准确率
• 混合检索：向量 + 关键词 + RRF 融合
• Reranking：LLM 重排序，优化结果相关性
• 查询分解：开启后，复杂问题会自动拆解为多个子查询
• 查询压缩：开启多轮对话上下文压缩，提升理解能力
• 联网搜索：当知识库无匹配结果时，自动搜索互联网补充答案（需在 AI 智能客服配置中先配置搜索引擎）

测试知识库

• 在测试区域输入问题，查看 AI 是否能基于知识库正确回答
• 检查知识来源标签，确认答案来源的准确性
• 测试图片显示是否正常（如已配置图床服务）
• 验证联网搜索功能是否正常工作（如已启用）

💡 性能提示：启用高级 RAG 优化后，回答准确率提升 25-35%，知识覆盖率提升 40-60%。配置图床服务可以优化图片加载速度，提升用户体验。

💡 提示：此文档适用于 即答AI客服 2.0.0-rc1 版本,若有遗漏或发现未覆盖的功能 / 问题，欢迎通过联系作者或「QQ群」提交内容补充建议