1. 响应生成阶段为什么总翻车从 Self-RAG 的反思令牌说起RAG 管线跑到响应生成这一步很多人会松一口气检索也做了重排也排了把 Top-K 文档塞进 prompt 让模型写答案不就完了实际跑起来你会发现答案要么把检索到的无关段落也硬编进去要么在检索结果为空时照样一本正经地胡说要么格式一会儿 JSON 一会儿散文下游解析直接崩。问题的根子在于传统 RAG 的生成阶段是“哑巴式”的——模型拿到什么就写什么它不会先想“这个问题我到底需不需要查资料”也不会在写完后回头检查“我这句话有没有检索结果支撑”。Self-RAG 和 RRR 这两套思路本质都是把“反思”和“迭代”塞进生成环节让模型自己决定检索时机、自己校验信息、自己重写不满意的段落。这篇是 RAG 从入门到精通系列的第十三篇聚焦响应生成技术里的提示工程落地。我会用 TaoToken 的统一 Key/API 通道官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end API 入口 https://taotoken.net/api 把 Self-RAG 的反思令牌链路和 RRR 的检索-重排-生成闭环都跑一遍给出可直接复制的提示模板、参数配置和端到端验证动作。适合已经搭过基础 RAG、想在生成质量上再抠一层的人。先说清楚 Self-RAG 的核心机制。它给模型定义了一组特殊的“反思令牌”reflection tokens比如[Retrieve]表示是否需要检索、[IsRel]表示检索段落是否相关、[IsSup]表示生成内容是否有支撑、[IsUse]表示回答是否有用。模型在生成时先输出这些令牌做决策再输出正文。你不需要真的去微调一个带这些令牌的模型用提示工程把令牌语义写进 system prompt让通用模型按这个协议输出就能复现七八成效果。RRR 则是另一条路Retrieve-Refine-Rescore检索补充、迭代优化、多维度重打分。它不要求模型输出特殊令牌而是用一个外层循环控制先生成初稿打分找短板针对短板再检索再优化再打分直到达标或到轮数上限。Self-RAG 偏“单模型内省”RRR 偏“流程外循环”两者可以叠加使用。我试过把两者混着用Self-RAG 负责判断“要不要检索”和“检索结果能不能用”RRR 负责“初稿哪里弱就补哪里”。下面按这个组合来写。2. TaoToken 统一通道前置一个 Key 打通 Self-RAG 与 RRR 的模型调用Self-RAG 和 RRR 对模型能力的要求不太一样。Self-RAG 需要模型有较强的指令跟随和结构化输出能力因为它要按[Retrieve]、[IsRel]这类令牌格式吐决策RRR 的 Refine 环节需要模型有不错的逻辑重构能力能把新检索到的数据自然融进旧稿。如果每个环节都去单独配一家厂商的 Key光是环境变量管理就够烦的。TaoToken 在这里的作用是提供一个 OpenAI 兼容的统一入口。你拿一个 Key改一下base_url就能在 Self-RAG 的决策调用和 RRR 的优化调用之间切换不同模型而不用改代码里的鉴权逻辑。它的 API 地址是 https://taotoken.net/api 兼容/v1/chat/completions这类标准路径。先拿 Key。进控制台 https://taotoken.net/console 在 API Keys 页面创建一个新 Key复制出来存到环境变量里。注意别把 Key 硬编码进代码提交到仓库用.env或者系统环境变量。export TAOTOKEN_API_KEYsk-你的key export TAOTOKEN_BASE_URLhttps://taotoken.net/api模型 ID 怎么填TaoToken 的模型列表在文档 https://taotoken.net/doc 里有常见的有gpt-4o、claude-3-5-sonnet、deepseek-v3这类。Self-RAG 的决策环节我建议用指令跟随强的模型RRR 的 Refine 环节可以用长上下文模型。你可以在一次管线里用两个不同的 Model ID只要都走同一个base_url和同一个 Key。这里有个容易踩的坑有些人把base_url写成https://taotoken.net而漏了/api结果请求打到官网首页返回 HTML解析时报Expecting value: line 1 column 1。记住 API 入口是 https://taotoken.net/api 不带 UTM 参数。如果你是用 Claude Code 做开发它的配置文件和 OpenAI SDK 不太一样。Claude Code 走的是 Anthropic 协议需要在 settings 里配ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY。TaoToken 的 Claude Code 接入文档在 https://taotoken.net/doc 里有专门一节按那个配就行。核心是三件套Base URL 填https://taotoken.net/apiKey 填你创建的Model ID 填claude-3-5-sonnet之类的。对于长期跑 RAG 管线、需要反复调用的场景可以考虑 Coding Plan https://taotoken.net/coding-plan 它在调用配额上更适合这种迭代式的高频请求。不过这篇的重点是提示工程链路配额的事你自己按量评估。3. 可复制配置Self-RAG 反思令牌提示模板与 RRR 循环参数这一节给可直接粘贴的配置。先看 Self-RAG 的 system prompt 模板。核心是把反思令牌的语义定义清楚并强制模型按“先决策、再生成、后校验”的顺序输出。{ model: gpt-4o, temperature: 0.2, messages: [ { role: system, content: 你是一个带自我反思能力的 RAG 生成器。你必须按以下协议输出\n1. 先输出 [Retrieve: yes/no]判断是否需要外部检索。若问题涉及时效性事实、具体数据、专业细节输出 yes若是常识或你确定掌握的内容输出 no。\n2. 若 [Retrieve: yes]输出 [Query: 你的检索指令]包含关键词、时间范围、来源要求。\n3. 收到检索结果后输出 [IsRel: yes/no] 判断每段是否相关输出 [IsSup: yes/no] 判断生成内容是否有检索结果支撑。\n4. 最后输出 [Answer] 正文。若 [IsSup: no]必须在正文中标注“信息待确认”。\n禁止跳过任何令牌。 }, { role: user, content: 问题2025年中国新能源汽车渗透率是多少\n检索结果乘联会2025年1月预测报告显示2025年中国新能源汽车销量预计1300万辆汽车总销量预计3800万辆。 } ] }这个模板的关键在于temperature要压低0.1 到 0.3 之间因为决策令牌需要稳定输出不能让它自由发挥。max_tokens给 1024 够用Self-RAG 的决策部分不长。再看 RRR 的外循环参数。RRR 不是一个 prompt 能搞定的它需要一个 Python 控制循环。下面是一个最小可跑的骨架用 OpenAI SDK 指向 TaoToken。import os from openai import OpenAI client OpenAI( api_keyos.environ[TAOTOKEN_API_KEY], base_urlos.environ[TAOTOKEN_BASE_URL] ) def rrr_generate(question, max_rounds3, threshold85): draft call_llm(f请回答{question}, modelgpt-4o) for round_i in range(max_rounds): score, gaps rescore(draft, question) if score threshold: return draft, score new_info retrieve(gaps) draft call_llm( f原稿{draft}\n补充信息{new_info}\n请融合补充信息优化原稿保持结构清晰。, modelclaude-3-5-sonnet ) return draft, score def call_llm(prompt, model): resp client.chat.completions.create( modelmodel, messages[{role: user, content: prompt}], temperature0.3 ) return resp.choices[0].message.contentrescore和retrieve需要你自己实现。rescore可以用另一个 LLM 调用做打分提示词里给四个维度信息完整性、数据准确性、逻辑连贯性、贴合需求度每项 25 分。retrieve接你现有的检索器把 gaps 转成查询。这里有个配置细节RRR 的 Refine 环节我用了claude-3-5-sonnet因为它在长文本重构上比较稳不会把原稿改得面目全非。Self-RAG 的决策环节用gpt-4o指令跟随更干脆。两个模型都走同一个base_urlKey 也是同一个。如果你用 Cline 或 CC Switch 这类工具做开发配置里同样填三件套Base URLhttps://taotoken.net/api、API Key、Model ID。Cline 的 MCP 配置里如果涉及模型调用也是这个地址。Codex 的auth.json里填base_url和api_key字段值同上。4. 验证请求跑通一次 Self-RAG 决策与 RRR 迭代的端到端结果配置写完先做最小验证。用 curl 打一发 Self-RAG 的决策请求确认 TaoToken 通道通、模型按令牌格式输出。curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: gpt-4o, temperature: 0.2, messages: [ {role: system, content: 你是一个带自我反思能力的 RAG 生成器。先输出 [Retrieve: yes/no]再输出 [Query: ...]收到检索结果后输出 [IsRel: ...] 和 [IsSup: ...]最后输出 [Answer] 正文。}, {role: user, content: 问题2025年中国新能源汽车渗透率是多少\n检索结果乘联会2025年1月预测报告显示2025年中国新能源汽车销量预计1300万辆汽车总销量预计3800万辆。} ] }预期返回的choices[0].message.content里应该能看到类似这样的结构[Retrieve: yes] [Query: 2025年 中国 新能源汽车 渗透率 乘联会 官方数据] [IsRel: yes] [IsSup: yes] [Answer] 根据乘联会2025年1月预测报告2025年中国新能源汽车销量预计1300万辆汽车总销量预计3800万辆计算得渗透率约34.2%。该数据为预测值实际数据以官方发布为准。如果你看到[Retrieve: yes]后面直接跟了正文没有[Query]说明 system prompt 里的顺序约束不够强把“禁止跳过任何令牌”加粗或者用编号列表再强调一遍。如果模型把令牌写成了中文括号或者漏了方括号检查temperature是不是太高了。再验证 RRR 循环。跑上面那段 Python 骨架用一个需要多轮补充的问题比如“撰写2025年中国跨境电商行业报告摘要包含市场规模、核心趋势、关键挑战”。观察日志里rescore的分数变化第一轮通常 60 分左右第二轮补了数据后能到 85 以上。如果分数一直上不去检查retrieve返回的内容是不是和 gaps 对不上——常见情况是 gaps 说“缺市场规模数据”但检索器返回了一堆趋势分析。成功的结果长这样最终输出里每个数据点都有来源标注趋势描述有具体案例支撑挑战部分有量化信息。字数控制在需求范围内没有为了凑字数硬加无关段落。5. 本篇常见错排查401、local proxy failed 与 reading choices 报错对照跑这条链路最容易撞的几个报错我按实际遇到的频率排一下。401 Unauthorized。最常见的原因是 Key 没读到。检查echo $TAOTOKEN_API_KEY有没有输出。如果是 Python 里用os.environ确认你在同一个 shell 会话里 export 了。另一个原因是 Key 复制时带了空格或换行用cat -A看一下。还有一种情况是把 Key 填到了base_url字段里或者反过来这种低级错误在配置文件里很常见。local proxy failed / connection refused。这个报错通常出现在你本地配了某些网络工具但工具没启动或者端口对不上。TaoToken 的 API 地址是 https://taotoken.net/api 直接请求即可不需要额外配置本地转发。如果你在代码里设了http_proxy或https_proxy环境变量先unset掉再试。有些 IDE 插件会自己读系统代理设置检查一下插件配置里有没有代理相关选项清空。reading choices 报错类似KeyError: choices或TypeError: NoneType object is not subscriptable。这说明返回的 JSON 里没有choices字段。先打印完整响应体看结构。常见原因有三个一是base_url写成了https://taotoken.net漏了/api请求打到官网返回 HTML二是 Model ID 填错了比如填了一个不存在的模型名返回错误对象三是请求体里messages格式不对比如 role 写成了system但 content 是列表。用print(resp.json())把原始响应打出来一眼就能定位。OAuth 相关报错。如果你用 Claude Code 或某些 CLI 工具它们可能默认走 OAuth 登录流程而不是 API Key。在配置文件里显式指定ANTHROPIC_API_KEY和ANTHROPIC_BASE_URL关掉 OAuth 自动流程。Claude Code 的配置文档在 https://taotoken.net/doc 里有说明按那个改。Self-RAG 令牌不输出或输出错乱。检查 system prompt 里令牌定义是不是被截断了。有些模型对 system prompt 长度敏感太长会丢尾部指令。把令牌定义放在最前面约束条件放最后。另外temperature超过 0.5 之后令牌稳定性明显下降压到 0.2 以下。RRR 循环不收敛。分数一直在 70 分上下晃说明rescore的维度设计有问题。检查是不是四个维度里有重复计分或者 gaps 提取不准确导致检索方向跑偏。把max_rounds设成 3到轮数上限就强制输出别让它无限循环烧 token。6. 语义一致 CTA把这条链路接进你自己的 RAG 管线上面这套 Self-RAG 加 RRR 的组合核心是把“反思”和“迭代”变成生成阶段的默认动作。你不需要推翻现有的检索和重排模块只需要在生成环节外面套一层控制循环把 TaoToken 的统一通道作为模型调用的底座。具体接入时先拿 Key进 https://taotoken.net/api-keys 创建然后按文档 https://taotoken.net/doc 里的 OpenAI 兼容示例改base_url。Self-RAG 的决策调用和 RRR 的优化调用可以共用同一个 Key模型 ID 按环节选。如果你要验证不同模型在反思令牌上的表现用模型对话入口 https://taotoken.net 快速试几轮比在代码里反复改参数快。长期跑编码类或 Agent 类 RAG 管线的话Coding Plan https://taotoken.net/coding-plan 在调用配额和稳定性上更适合高频迭代场景。Claude Code 用户直接看 https://taotoken.net/claudecode 的接入说明三件套配好就能用。最后留一个实操建议Self-RAG 的反思令牌不要一次定义太多先从[Retrieve]、[IsRel]、[IsSup]三个开始跑稳了再加[IsUse]。RRR 的rescore维度也不要超过四个维度越多打分越容易失真。先把最小闭环跑通再逐步加令牌和维度比一上来就堆全套协议更容易定位问题。