基于GitHub知识库回答质检合规问题并自动分级

原文要点

这是作者Asmita Fahim发布的付费n8n模板：聊天触发器接收QA/QC问题并记录会话元数据，Gemini（文中写models/gemini-3.5-flash-lite）驱动的RAG代理先列出GitHub仓库中的受控质检文档、再检索相关文本，产出结构化评估并归为合规/观察项/轻微/严重；证据不足时向Google Sheets追加“Pending Manual Review”并邮件通知QA团队，否则按分级写入审计日志，需升级CAPA时再发邮件并在表中标记已发送。

这次做成什么

在不购买原模板的前提下，用n8n手工搭一条等效练习流：聊天提问→校验输入→Gemini检索GitHub质检知识库→输出带依据的分级JSON→按证据充足与否分支→写Google Sheets审计日志→按需发Gmail邮件。原模板需付费购买，本页是本站独立设计的复刻练习方案，节点名、参数以原模板为准需自行核对，Gemini与GitHub用量可能产生费用。

准备什么

• 一个可用的n8n实例（自托管或云端）并能打开聊天触发器界面
• Google AI（Gemini）API密钥及可用模型额度
• 可读GitHub仓库的访问令牌或公开仓库地址，内有受控QA/QC文档目录
• Google Sheets凭据及一张已建好表头的审计日志表
• Gmail OAuth凭据，用于发送升级与人工复核通知邮件

具体怎么做

1. 搭建聊天触发与输入校验

   在n8n新建工作流，放一个Chat Trigger节点接收问题，后续接Code节点提取query、sessionId、timestamp、source四个字段；再用IF节点判断query非空且长度大于等于10个字符，不满足就直接在聊天窗口回复“请补充更完整的质检问题描述”并终止。

2. 配置Gemini RAG代理检索GitHub文档

   添加AI Agent节点，聊天模型选Google Gemini并填入你的API凭据；给代理配两个工具：一个HTTP Request调用GitHub API列出仓库/docs目录下的受控文档清单，另一个按文件名取回文档正文（参考结构为owner/repo加路径，原模板示例为fahimjilani/qa-qc-rag-knowledge-base的/docs，练习时请换成你自己的仓库）。把下文artifact中的系统提示词粘进系统消息，要求只依据检索到的文本作答。

3. 规范化分级结果字段

   代理输出后接Structured Output Parser或Code节点，把结果整理成固定字段：classification（Compliant/Observation/Minor/Major）、severity_score（1-10）、requirement_violated、recommended_action、escalation_capa（布尔）、manual_review（布尔）、source_files（数组）。字段缺失时给默认值并把manual_review置为true。

4. 按证据分支写入Sheets并发邮件

   用IF节点判断manual_review或证据不足标志：为真时向Google Sheets追加一行、Classification写“Pending Manual Review”，并用Gmail节点发邮件给QA团队请人工复核；为假时按classification分级写入审计日志，若escalation_capa为真再发升级邮件，随后用Sheets更新节点把该行Escalation_Status改为Sent。收件人qa-team@example.com是占位地址，必须换成你方QA邮箱。

5. 端到端自测

   启用工作流，在聊天窗口分别提交一条证据充分的问题（知识库里确有对应条款）和一条库里没有依据的问题，检查Sheets是否分别出现分级行和Pending Manual Review行、邮件是否按分支触发。

可直接复制的材料

你是QA/QC质检合规评估代理。你只能依据通过工具从GitHub受控知识库检索到的文档文本作答，禁止凭常识编造条款。
工作流程：
1. 先调用文档清单工具列出知识库中的受控质检文档；
2. 针对用户问题，调用文档正文工具取回最相关的1至3份文档；
3. 逐条比对问题描述与文档条款，给出评估。
输出必须是如下JSON，不要输出其他文字：
{"classification":"Compliant|Observation|Minor|Major 四选一","severity_score":1到10的整数,"requirement_violated":"被违反的条款编号与简述，无则填null","recommended_action":"建议纠正措施，一句话","escalation_capa":true或false,"manual_review":true或false,"evidence_summary":"引用依据，须标注来源文件名","source_files":["实际引用的文件名"]}
判定规则：完全符合为Compliant；有改进空间但无违反对Observation；轻微偏离且易纠正为Minor；造成或可能造成产品质量事故、违反强制条款为Major，Major必须escalation_capa为true。若检索不到任何相关文档或证据不足以判断，将manual_review设为true，classification仍给出最接近的一档，并在evidence_summary中写明“知识库证据不足”。

doc_id,file_name,title,version,effective_date,summary
QC-001,iq-oq-pq-protocol.md,设备验证IQ/OQ/PQ执行规程,3.2,2025-03-01,规定安装确认运行确认性能确认的签署与偏差记录要求
QC-002,deviation-handling.md,偏差分级与处理流程,2.1,2025-06-15,定义轻微与重大偏差界限及24小时内上报要求
QC-003,sample-retention.md,留样管理规程,1.4,2024-11-20,规定留样量为全检量两倍且保存期不少于有效期后一年
QC-004,capa-procedure.md,CAPA启动与关闭标准,4.0,2025-08-01,规定重大偏差与重复轻微偏差必须启动CAPA并30天内关闭

表头列：Record_ID | Timestamp | Session_ID | Query | Classification | Severity_Score | Requirement_Violated | Recommended_Action | Escalation_CAPA | Manual_Review | Source_Files | Escalation_Status
测试行：REC-20260919-001 | 2026-09-19T10:30:00Z | sess-demo-001 | 留样只留了一倍全检量是否合规 | Minor | 4 | QC-003 留样量不足两倍 | 补足留样并检查库存留样记录 | false | false | sample-retention.md | Not_Required

输入与输出示例

本站虚构演示，非原作者运行结果；实际输出取决于你的知识库内容与模型表现。

输入

在聊天窗口提交：我们车间一批产品留样只留了一倍全检量，规程好像要求两倍，这样操作合规吗？（sessionId=sess-demo-001）

对应输出

代理返回JSON：{"classification":"Minor","severity_score":4,"requirement_violated":"QC-003 留样量为全检量两倍的要求","recommended_action":"立即补足该批留样并回溯检查近三批留样记录","escalation_capa":false,"manual_review":false,"evidence_summary":"sample-retention.md第2节规定留样量不得少于全检量的两倍","source_files":["sample-retention.md"]}，Sheets新增一行Classification=Minor、Escalation_Status=Not_Required，不发送升级邮件。

做完检查这些

• 提交知识库中确有条款的问题时，Sheets新增行的Classification为四档之一且Source_Files列出真实存在的文件名
• 提交知识库没有依据的问题时，Sheets出现Classification为Pending Manual Review的行且QA邮箱收到人工复核邮件
• escalation_capa为true的记录在邮件发送后，其Escalation_Status被更新为Sent
• query少于10个字符时流程在聊天窗口直接提示补充，不进入检索和写表环节

容易卡住的地方

• 原模板为付费商品，本页不含可导入的工作流文件，节点配置需自行搭建并与原模板核对
• 文中模型标识models/gemini-3.5-flash-lite在你账号中不一定可用，需换成实际可用的Gemini模型
• GitHub私有仓库必须配置有读取权限的令牌，否则检索工具取不到正文会把所有问题都判成证据不足
• Sheets列名与映射字段不一致会写入失败或列错位，建表时严格对照表头
• qa-team@example.com是占位地址，忘记替换会把通知发到不存在的邮箱