e-pigeon 后端 · LLM 调用场景索引

下列「system / 提示」摘录自仓库源码;人设全文见 persona/MATCHMAKER.md(或 MATCHMAKER_SOUL_FALLBACK_INLINE)。首页主体按主对话 system 物理注入先后顺序排列;侧边为按主题的章节索引。文档可能滞后于代码。修改建议定稿:docs/llm-call-catalog/modification-notes.json;请通过 uvicorn 打开 /llm-call-catalog/(端口与启动命令一致)后点「保存此条」写回,或在编辑器中直接改 JSON。

主对话 · system 注入顺序

主路径:app/routers/matches.py · chat()_assemble_chat_system_final。**下表仅含最终拼进主对话这一条 system 的正文段落**(含前缀、摘要、system_body…)。在它之前之后另有一些 独立请求 的 LLM(如 idle 时的 classify_labeling_gate),各自有自己一份 system/tool,语义上可能影响当轮生成的 system_body,但不会作为单独一行出现在本条终稿表里。下列顺序与同文件函数及注释、「可缓存前缀」的拼接常量一致。

  1. MATCHMAKER_SOUL · 人设正文(FEIGE 前缀第 ① 段)

    MATCHMAKER_SOUL · MATCHMAKER_SOUL_FALLBACK_INLINE

    飞鸽人设灵魂;缺失时用内联兜底。全文见仓库 persona/MATCHMAKER.md

  2. 【称呼与隐私】(FEIGE 前缀第 ② 段)

    固定短文

    对用户称「你」、禁输出登记真实姓名等。

  3. COMBINED_CONDUCT_REPLY_INSTRUCTION(品行 JSON + 正文 · FEIGE 前缀第 ③ 段)

    COMBINED_CONDUCT_REPLY_INSTRUCTION

    品行评估 JSON + 分隔线 + 对用户正文; misconduct 与高姿态冷处理口径。

  4. _FEI_GE_RELAY_STATIC_INTRO 全文(FEIGE 前缀第 ④ 段)

    _FEI_GE_RELAY_STATIC_INTRO

    飞鸽传书自然语言说明;勿在用户可见正文写旧方括号/机器协议串,由系统闭环。

  5. CHAT_OPERATION_TOPIC_BLOCK · 接在 FEIGE 前缀之后的运营短段(system_prefix

    CHAT_OPERATION_TOPIC_BLOCK

    运营话题:助手主动挑起的话题气泡须自然延展,不显摆后台模板。

  6. build_context_for_model · 拼装进主对话的用户记忆上下文

    build_context_for_model(记忆摘要段)

    重要记忆 + L2 + L1 等摘要块,介于前缀与 system_body 之间。

  7. system_body · 当轮业务大段(运行时拼装)

    system_body

    门控态、画像/真诚度、需求与传话条件、对话摘录等运行时拼装。

  8. _build_persona_rag_context · 人设相关 RAG 追加

    _build_persona_rag_context_with_timeout

    人设相关 Milvus 追加上下文,按用户本轮合并输入检索。

  9. merchant_kb_ctx · 主对话挂载的商家知识正文段

    merchant_kb_ctx

    商家咨询链路下向量检索正文注入(非工具轮或首轮概要)。

  10. merchant_kb_tool_suffix · 商家工具轮 system 尾部补注

    merchant_kb_tool_suffix

    工具轮可取块清单等动态尾段。

  11. build_progress_reply_context_before_chat · 主对话挂载的需求进度上下文

    build_progress_reply_context_before_chatis_progress_inquiry

    进度追问打开时并入需求进度简述。

  12. format_now_for_llm_system · 当前时间说明(system 尾部)

    format_now_for_llm_system

    为模型注入可读「当前时间」短行。

  13. 传话匹配邀请工具 · 系统追加说明

    RELAY_MATCH_INVITE_TOOL_SYSTEM

    use_relay_invite_tool 为真时追加(含工具前「飞鸽传书简述」);可与主对话分拆 API Key 以利于缓存命中。

  14. 最近原始对话摘录 · build_context_for_model(recent_raw_text)

    RECENT_MESSAGES_LIMIT / CHAT_SYSTEM_MAX_CHARS

    最近 N 条原文置尾;超长预算时组装循环优先削减此段。

未列入上表的 LLM:如门控 classify_labeling_gate(idle 分流)、其余 classify_*、回合 mes_type、传话流水线摘要、画像/需求抽取等,均为单独的 LLM 调用,各有独立 system,不拼接进上面这条主对话 system;逐项摘录见 门控与标注流 · 回合 · 传话(含 需求匹配·扁平 RAG Top30 择一) · 需求 · LLMClient 速查

文档目录:docs/llm-call-catalog/