运营一个内容平台或品牌官网，你是否经常被同一类问题反复「轰炸」？用户问地址、问电话、问开放时间，甚至问某篇文章里明明写过的内容……客服人力不堪重负，用户等待体验也大打折扣。

现在，yh-ai-assistant 全站 AI 智能客服插件来了。专为 yh blog 深度定制，一键注入全站悬浮对话窗，让每一个访客都能获得即时、准确、有温度的智能应答。

不止是对话窗，更是一套完整的智能知识服务体系

yh-ai-assistant 不是简单的「套壳聊天机器人」，而是一套打通了大模型对话、知识库检索、FAQ 精确匹配与机构信息结构化回答的完整 AI 客服解决方案。

一、全站悬浮，即开即用

插件通过  注入，无需修改主题核心代码，兼容所有官方主题。访客随时点击悬浮图标，即可唤起对话窗口，咨询任何问题——从「你们营业到几点」到「某篇文章的核心观点是什么」，AI 都能秒级响应。

二、三重问答机制，各司其职

yh-ai-assistant 内置三层智能问答体系，覆盖从高频标准问题到开放域知识查询的全部场景：

  • FAQ 精确/语义匹配：针对高频重复问题（如退换货政策、会员权益），系统优先通过语义匹配快速命中预设答案，毫秒级响应，不消耗大模型 Token。

  • 机构信息结构化回答：名称、地址、电话、开放时间等机构基础信息，后台统一配置，AI 精准提取展示，杜绝「张冠李戴」。

  • 知识库 RAG 检索增强生成：当问题超出 FAQ 和机构信息范围时，系统自动检索知识库中的文章与页面，结合大模型生成有据可依的回答，而非凭空「编造」。

三、知识库自动同步，内容即知识

这是 yh-ai-assistant 最核心的能力之一——知识库与网站内容自动同步。

每当你在后台发布或更新文章、页面，插件会自动捕获 post_saved / page_saved 事件，通过 Celery 异步任务完成内容向量化索引。正文或标题发生变更时会重新索引，内容未变则自动跳过，避免重复计算。

更关键的是，索引过程使用  统一解析富文本与内容块短代码——Markdown、HTML、各类短代码内容块，统统被正确渲染为纯文本后再进行分块与向量化，确保知识检索的完整性与准确性。

后台知识库列表支持分页、关键词与状态筛选，同步操作灵活支持「全部同步」「仅文章」「仅页面」或「指定条目」四种模式，精细化管理随心所欲。

四、AI 模型网关统一调度，Key 灵活配置

yh-ai-assistant 采用「AI 模型网关」统一配置思路，对话大模型（profile: chat）与 Embedding 模型（profile: embedding）可分别指定 API Key 与模型 ID，也可共用同一套 Key。网关未启用时，后台亦可独立配置备用 Key，确保服务高可用。

五、可选转人工，无缝衔接 CRM

当 AI 无法解决用户问题时，插件支持调用 invoke_capability("crm.create_lead") 一键转人工——前提是站点已启用 yh-crm 插件。智能与人工无缝衔接，既不浪费 AI 的效率，也不丢失复杂场景下的人情温度。

六、会话记录与用量统计，数据驱动运营

每一次对话、每一次知识库检索、每一次 Token 消耗，系统均自动记录。后台可查看会话记录与用量统计，为知识库优化、成本控制和运营决策提供真实数据支撑。

AI knowledge base sync with website content

后台配置，三步搞定

插件安装启用后，进入后台「插件 → AI 智能客服」或侧栏「AI 客服」，只需三步即可完成配置：

  1. 填写模型凭证：对话大模型 API Key / 模型 ID，Embedding API Key / 模型 ID（可共用或分开）。

  2. 设置机构信息：机器人身份、机构名称、地址、电话、开放时间等。

  3. 添加 FAQ 与同步知识库：手动添加高频问答，或一键同步已有文章与页面——保存即自动入知识库。

全程可视化操作，无需编写任何代码。

AI model gateway configuration dashboard

时区友好，开箱即适配

考虑到跨国或多时区运营场景，系统数据库统一存储 UTC 时间，API 返回 utc_iso_z 格式，同时提供 *_display 本地展示字段。管理端列表直接使用 *_display 字段展示，开箱即适配本地时区，无需额外转换。

谁适合用？

  • 企业官网：7×24 小时解答产品咨询、售后问题，降低客服人力成本。

  • 内容平台 / 博客：帮助读者快速检索历史文章、获取关键信息，提升阅读体验。

  • 电商站点：解答物流、退换货、优惠活动等高频问题，提升转化率。

  • SaaS 产品官网：作为产品答疑窗口，减少售前咨询阻塞。

写在最后

yh-ai-assistant 的诞生，源于一个朴素的理念：让网站自己「会说话」 ——不是冷冰冰的自动回复，而是真正理解用户问题、从已有内容中精准提取答案的智能助手。

它不改变你原有的内容生产流程，文章照常写、页面照常建，知识库自动跟随更新。你只需要一次配置，剩下的交给 AI。

立即启用 yh-ai-assistant，让你的网站拥有一个 7×24 小时在线的智能客服。