← Back to learning path

This chapter has not been reviewed in English; the original Simplified Chinese is shown.

Case · Published

实战:带权限过滤的本地 RAG 服务 (original language)

用 SQLite FTS 验证角色过滤、来源引用、无结果和删除语义。

Source: knowledge/p24-c/collection_0587a2bfc47ea3584d1b1c59/cases/permission-aware-rag-service.mdAI application development
Chapter progress 0%Learning path progress 0% · 0/10 chapters completedContinue learning path →

问题与边界

客服和财务共享一个知识库,但角色只能看到各自政策。案例使用内存 SQLite 和固定文档,验证检索边界,不接入外部模型。

方案

文档表保存 id、role 和 body,查询使用参数化 FTS。生成层只接收已授权的片段,答案必须带来源 id;删除文档后不应再命中。

最小实现

import sqlite3

db = sqlite3.connect(':memory:')
db.executescript('CREATE VIRTUAL TABLE docs USING fts5(document_id, role, body);')
db.executemany('INSERT INTO docs VALUES (?, ?, ?)', [('refund-1', 'support', '退款需要订单号'), ('payroll-1', 'finance', '工资单仅限财务查看')])
rows = db.execute('SELECT document_id, body FROM docs WHERE docs MATCH ? AND role = ?', ('退款', 'support')).fetchall()
assert rows == [('refund-1', '退款需要订单号')]
assert not db.execute('SELECT * FROM docs WHERE docs MATCH ? AND role = ?', ('工资单', 'support')).fetchall()

复现步骤

  1. 运行 Python 脚本,确认 support 只命中退款政策。
  2. 用 finance 角色查询工资单,再用 support 查询验证为空。
  3. 删除一个文档并重复查询,确认删除语义生效。
  4. 把 document_id 和版本作为引用返回,不把全文日志写入生产。

验证清单

验证参数化查询、角色隔离、空结果提示、删除后不可检索、引用 id 与正文一致。

常见问题

SQLite FTS 是生产向量库吗? 不是,本案例只验证流程和权限。

无结果时能让模型猜吗? 不应,返回明确无结果并转人工或请求补充范围。

官方参考

SQLite FTS5;OWASP LLM Top 10。

最后核对日期:2026-11-16。版本、接口和安全边界以链接的官方资料为准;本文不虚构性能或费用结论。

Prerequisite tutorials

Knowledge安全与隐私:输入过滤、最小权限与审计 (original language)
Product Hub Demo · V0.3