客服机器人

业务和功能介绍

这个产品解决什么问题

中小商家每天要重复回答大量相同的问题——「怎么收费」「能退款吗」「支持什么系统」。一个人应付不过来，但雇专职客服成本太高
。

这个 AI 客服机器人把常见问答做成知识库，客户问问题自动匹配回复，直接把重复工作干掉。

核心功能

自动问答 — 客户输入问题，系统智能匹配知识库，秒回答案

多商家管理 — 一个系统同时跑多个商家的客服，各自独立，互不干扰

可视化配置 — 商家老板自己打开网页就能改问答内容，不需要找技术人员

三种对话风格 — 友好亲切 / 专业正式 / 轻松随意，餐馆和律所用不同语气

会话记录 — 每个客户聊了什么全程记录，方便复盘和优化话术

零成本运行 — 不需要买 API Key，不需要云服务，纯本地就能跑

适用哪些行业

电商：商品咨询、退换货政策、尺码推荐

餐饮：菜单查询、订座预约、营业时间

本地服务（理发店/维修店/诊所）：预约咨询、服务报价

公司内部：HR 政策问答、IT 帮助台

整体框架和设计思路

整个系统采用前后端分离架构，后端提供 RESTful API，前端作为 SPA
单页应用调用接口。核心思路是轻量化——商家不需要装数据库、不需要配服务器，一个 Python 文件启动就能用。

设计上分三层：API 层负责接收请求和返回响应，业务层做 FAQ 匹配和会话管理，数据层用 JSON 文件持久化。FAQ
匹配采用词重叠相似度算法，不依赖外部 AI API，零成本运行。长远的扩展性也考虑了——预留了 LLM 接口，需要时可以接入 Claude
或 GPT 实现更复杂的语义理解。

不同模块使用的技术栈

后端服务：Python 3.13 + FastAPI + Uvicorn。FastAPI 选它是因为自带 Swagger 文档和请求校验，开发效率高。Uvicorn 做 ASGI
服务器跑在生产环境也够用。

前端界面：原生 HTML + CSS + JavaScript，单文件 index.html。不引入框架是为了降低部署门槛——不需要 npm
install、不需要打包，直接放到 static 目录就能跑。界面适配桌面和移动端。

数据存储：JSON 文件。knowledge_base.json 存知识库，sessions.json 存会话记录。轻量场景下 JSON
完全够用，读写毫秒级。如果并发量和数据量上来，可以替换为 SQLite 或 PostgreSQL，数据模型是现成的。

FAQ 匹配引擎：自研词重叠相似度算法。把用户输入和知识库问题都做分词、小写化、集合化，算交集除以并集。阈值
0.3，既保证精确匹配能命中，也避免胡乱对号。整个算法 12 行代码，时间复杂度 O(n)，过万条 FAQ 也能秒出结果。

我的负责模块和解决结果

我一个人负责整个项目从零到交付，包括需求分析、技术选型、后端开发、前端开发、测试和文档。

后端部分完成了 7 个 API 端点的开发和联调。FAQ 匹配算法在 12 条测试数据上准确率达到 83%，置信度大于 0.5
的高质量命中占比 75%。会话追踪功能完整实现了创建、追加、查询全流程。

前端部分完成了聊天界面和配置面板。配置面板支持无代码修改知识库——商家老板打开网页就能改问答内容，不需要叫技术人员。响应
式布局做了移动端适配。

演示数据在系统首次启动时自动注入，包含一个完整可用的商家案例和 8 条 FAQ。客户拿到代码启动就能看到效果，不是空壳。

交付产出：完整源码 + README 使用文档 + 部署指导。从写第一行代码到可演示版本耗时约 2 天。

测试验证：用三个真实场景测试——费用咨询（匹配度 100%）、服务范围咨询（匹配度 100%）、陌生问题兜底回复——全部通过。