首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >小店最小可用客服知识库:SQLite 建表 + 匹配代码全实现

小店最小可用客服知识库:SQLite 建表 + 匹配代码全实现

原创
作者头像
三合卓学
发布于 2026-11-16 10:31:14
发布于 2026-11-16 10:31:14
170
举报

小店接智能客服,第一步不是选系统,而是把最近一个月的对话按问题类型数一遍,再把答案写清楚。这篇给出一个不依赖任何外部服务的最小实现:SQLite 存知识条目,纯 Python 做匹配,一台最普通的云服务器就能跑。

表结构:每条答案都要带边界

代码语言:javascript
复制
CREATE TABLE kb_entry (
    id            INTEGER PRIMARY KEY AUTOINCREMENT,
    intent        TEXT NOT NULL,          -- 意图,如 refund / shipping
    question_keys TEXT NOT NULL,          -- 触发关键词,竖线分隔
    answer        TEXT NOT NULL,          -- 一句能直接发出去的话:结论+条件+下一步
    effective_date TEXT NOT NULL,         -- 生效日期
    expire_trigger TEXT,                  -- 失效触发条件,如活动结束日期
    owner         TEXT NOT NULL,          -- 谁负责维护这条
    version       INTEGER NOT NULL DEFAULT 1,
    status        TEXT NOT NULL DEFAULT 'active'  -- active / expired
);

CREATE TABLE kb_change_log (              -- 变更记录只追加,不覆盖,便于倒查
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    entry_id INTEGER NOT NULL,
    changed_by TEXT NOT NULL,
    change_note TEXT NOT NULL,
    changed_at TEXT NOT NULL DEFAULT (datetime('now', 'localtime'))
);

匹配与查询

代码语言:javascript
复制
import sqlite3
from datetime import date

class MiniKB:
    def __init__(self, db_path: str = "kb.sqlite3"):
        self.conn = sqlite3.connect(db_path)

    def add(self, intent, keys, answer, effective_date, expire_trigger, owner):
        self.conn.execute(
            "INSERT INTO kb_entry(intent, question_keys, answer, effective_date,"
            " expire_trigger, owner) VALUES (?,?,?,?,?,?)",
            (intent, "|".join(keys), answer, effective_date, expire_trigger, owner))
        self.conn.commit()

    def match(self, user_text: str) -> str | None:
        """关键词匹配。只返回生效中且未过期的条目;涉金额类不在这里,直接走人工。"""
        today = date.today().isoformat()
        cur = self.conn.execute(
            "SELECT answer, question_keys FROM kb_entry"
            " WHERE status='active' AND effective_date<=?"
            " AND (expire_trigger IS NULL OR expire_trigger>=?)", (today, today))
        for answer, keys in cur.fetchall():
            if any(k in user_text for k in keys.split("|")):
                return answer
        return None

    def expire_outdated(self):
        """活动结束就下架旧口径,避免拿过期承诺回复"""
        self.conn.execute(
            "UPDATE kb_entry SET status='expired'"
            " WHERE expire_trigger IS NOT NULL AND expire_trigger<?",
            (date.today().isoformat(),))
        self.conn.commit()

答案写法比技术更影响效果:可复用的答案要短、带条件、有明确下一步——能不能退、几天到账、需要提供什么、找谁处理。涉及费用和售后的表述尤其要谨慎,答错了不是体验问题,是履约争议。上线后先只开放「答案固定」这一类意图,观察两周,看两个数字:重复提问率和转人工率。前者高说明答案写得含糊,后者高说明分流条件划太宽,数字稳定了再逐步放开。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档