docs(ai-prompt): 9 APP system prompt 独立 MD 目录 + ai-app-prompts.md 瘦身改造 (W1 / F3-2C)
Neo 反馈: 我把百炼 8 APP 的 system prompt 更新到了 ai_system_prompt_by_app.md, 帮我整理成单独 8+1 个文件, 加说明, 放合适目录, 妥善保管。 新增 docs/ai/system-prompts/ 目录: - _INDEX.md (关系图 + APP ID 映射 + 同步状态表 + SOP) - 9 份独立 MD: app1_chat / app2_finance / app2a_finance_area / app3_clue / app4_analysis / app5_tactics / app6_note / app7_customer / app8_consolidation - 每份带元信息表 + 场景 + 提示词参数 + system prompt 全文 + 协作关系 + 同步历史 (用 4 反引号 ````text 避免内部 ```json 冲突) App2a 厘清 (状态 A): - 与 App2 是两个独立百炼 APP, APP_ID 0ae965029bc54706bcff44f511ac716b - 显示名 ZQYY-APP2a-指定区域财务洞察, env DASHSCOPE_APP_ID_2A_FINANCE_AREA - prompt 是 App2 5/5 版本的精细化扩充: H6 新增'助教成本特殊规则'+ 板块 D 新增'助教字段缺失业态判断'(麻将/KTV 缺失=业态正常 / 大厅/VIP/斯诺克 缺失=业态异常) 改名 + Banner: - docs/ai/ai_system_prompt_by_app.md -> docs/ai/system-prompts/_snapshot-20260505-source.md (git mv 保留历史; 文件头加 Banner 说明已被拆分) A 处置 docs/prd/ai-app-prompts.md (Neo 同意): - 727 行 -> 110 行 (减 84.9%) - 标题改为 '百炼平台 AI 应用集成实现规范' - 删 8 APP system prompt 章节 (已迁移) - 留 NS2 实现要点 + APP ID 映射 (补 App2a 行) + 前端消费方式 (补 App2a 行) + 附录代码审计对照表 修正认知错误: - 5/4 F3-2-prompt-files-list.md 给的对照逻辑 (对照 .py 与云端) 是错的 - .py 是 user message 拼装代码, 不是 system prompt 备份 - 5/5 重写该文件: 对照对象改为 docs/ai/system-prompts/*.md 详见 docs/audit/changes/2026-05-05__wave1_f3_2c_system_prompts_split.md
This commit is contained in:
@@ -1,60 +1,89 @@
|
||||
# F3-2B 本地 Prompt 文件清单 — 待 Neo 核对更新
|
||||
# F3-2B 本地 Prompt 文件清单 — 已收口(2026-05-05)
|
||||
|
||||
> 日期:2026-05-04 / 触发:Neo F3-2B 反馈"给我本地的 Prompt 保存地址,我去检查并更新"
|
||||
> 日期:2026-05-04 创建 / 2026-05-05 收口修正
|
||||
> 触发:Neo F3-2B 反馈"给我本地的 Prompt 保存地址,我去检查并更新"
|
||||
> 决策:**B 云端权威 + git 备份**,SDK 调用方式不改(继续用百炼 APP 调用)
|
||||
> 用法:Neo 用本清单逐个对照百炼控制台 prompt,本地过期则更新
|
||||
> **本文件已收口**:5/5 已建立 [`docs/ai/system-prompts/`](../../ai/system-prompts/) 独立 MD 体系,Neo 已一次性同步 8 APP 最新版
|
||||
|
||||
## 一、本地 prompt 文件清单(8 个)
|
||||
## ⚠️ 重要修正(2026-05-05)
|
||||
|
||||
目录:`apps/backend/app/ai/prompts/`
|
||||
之前版本(5/4 创建)给出的对照逻辑是**错误的**:
|
||||
|
||||
| # | APP | 文件 | 用途 |
|
||||
> ❌ 旧逻辑:让 Neo 对照 `apps/backend/app/ai/prompts/app{2-8}_*_prompt.py` 与百炼控制台
|
||||
|
||||
**真相**:`apps/backend/app/ai/prompts/app[2-8]_*_prompt.py` 文件**不是 system prompt 备份**,而是 **user message(数据载荷)拼装代码**:
|
||||
- system prompt 在百炼控制台配置(LLM 真正的角色设定)
|
||||
- .py 文件只负责把 board_data 等数据翻译成中文、拼接成首条 user message,SDK 上传给百炼
|
||||
- 这两层**没有对照关系**,不应该 diff
|
||||
|
||||
证据:`apps/backend/app/ai/prompts/app2_finance_prompt.py:7` 注释明确写"system prompt 在百炼控制台配置"。
|
||||
|
||||
## 一、System Prompt 真实备份位置(收口后)
|
||||
|
||||
**目录**:`docs/ai/system-prompts/`
|
||||
|
||||
| # | APP | 独立 MD | 角色 |
|
||||
|---|---|---|---|
|
||||
| 1 | App2 | [`app2_finance_prompt.py`](../../../apps/backend/app/ai/prompts/app2_finance_prompt.py) | 财务洞察(总览,area=all)|
|
||||
| 2 | App2a | [`app2a_finance_area_prompt.py`](../../../apps/backend/app/ai/prompts/app2a_finance_area_prompt.py) | 财务洞察(区域,area≠all)|
|
||||
| 3 | App3 | [`app3_clue_prompt.py`](../../../apps/backend/app/ai/prompts/app3_clue_prompt.py) | 维客线索分析 |
|
||||
| 4 | App4 | [`app4_analysis_prompt.py`](../../../apps/backend/app/ai/prompts/app4_analysis_prompt.py) | 关系分析 / 任务建议 |
|
||||
| 5 | App5 | [`app5_tactics_prompt.py`](../../../apps/backend/app/ai/prompts/app5_tactics_prompt.py) | 话术建议 |
|
||||
| 6 | App6 | [`app6_note_prompt.py`](../../../apps/backend/app/ai/prompts/app6_note_prompt.py) | 备注分析 |
|
||||
| 7 | App7 | [`app7_customer_prompt.py`](../../../apps/backend/app/ai/prompts/app7_customer_prompt.py) | 客户洞察 |
|
||||
| 8 | App8 | [`app8_consolidation_prompt.py`](../../../apps/backend/app/ai/prompts/app8_consolidation_prompt.py) | 整合去重落库 |
|
||||
| 0 | (索引) | [`_INDEX.md`](../../ai/system-prompts/_INDEX.md) | 关系图 / APP ID 映射 / 同步状态表 / 同步流程 SOP |
|
||||
| 1 | App1 | [`app1_chat.md`](../../ai/system-prompts/app1_chat.md) | 通用对话(SSE 流式) |
|
||||
| 2 | App2 | [`app2_finance.md`](../../ai/system-prompts/app2_finance.md) | 财务洞察(已升级"区域业态专员"模式) |
|
||||
| 2a | App2a | [`app2a_finance_area.md`](../../ai/system-prompts/app2a_finance_area.md) | 财务洞察(区域,**与 App2 关系待 Neo 厘清**) |
|
||||
| 3 | App3 | [`app3_clue.md`](../../ai/system-prompts/app3_clue.md) | 客户数据维客线索分析 |
|
||||
| 4 | App4 | [`app4_analysis.md`](../../ai/system-prompts/app4_analysis.md) | 关系分析 / 任务建议 |
|
||||
| 5 | App5 | [`app5_tactics.md`](../../ai/system-prompts/app5_tactics.md) | 话术参考 |
|
||||
| 6 | App6 | [`app6_note.md`](../../ai/system-prompts/app6_note.md) | 备注分析 |
|
||||
| 7 | App7 | [`app7_customer.md`](../../ai/system-prompts/app7_customer.md) | 客户分析 |
|
||||
| 8 | App8 | [`app8_consolidation.md`](../../ai/system-prompts/app8_consolidation.md) | 维客线索整理 |
|
||||
| - | (5/5 全量快照源) | [`_snapshot-20260505-source.md`](../../ai/system-prompts/_snapshot-20260505-source.md) | 2026-05-05 一次性同步快照(回溯参考) |
|
||||
|
||||
## 二、关键缺失:App1
|
||||
## 二、User Message 拼装代码(辅助,非 system prompt)
|
||||
|
||||
**`app1_chat_prompt.py` 不存在**。
|
||||
**目录**:`apps/backend/app/ai/prompts/`(8 个 .py 文件)
|
||||
|
||||
App1(通用对话/SSE 流式)的 prompt **没有本地副本**,完全在百炼控制台。原因可能是:
|
||||
- App1 是 SSE 流式,prompt 改动频率高,主要在百炼调试
|
||||
- 历史上没有"本地存 prompt"的设计
|
||||
这些文件**不需要**与百炼控制台对照,它们的职责是:
|
||||
- 拼装 user message(数据 JSON + 字段中文翻译)
|
||||
- SDK 调用时上传给百炼
|
||||
- 改动只在代码逻辑层(数据切片、字段映射调整),与 system prompt 无关
|
||||
|
||||
**建议**:
|
||||
- Neo 从百炼控制台导出 App1 prompt → 创建 `app1_chat_prompt.py` 入仓作为备份
|
||||
- 或者:接受 App1 prompt 仅在云端(SSE 场景特殊)
|
||||
| # | APP | .py 文件 | 用途 |
|
||||
|---|---|---|---|
|
||||
| 1 | App1 | (**无**) | App1 SSE 流式由 chat 流式接口直接处理,无独立拼装文件 |
|
||||
| 2 | App2 | `app2_finance_prompt.py` | 财务洞察(area=all)数据拼装 |
|
||||
| 2a | App2a | `app2a_finance_area_prompt.py` | 财务洞察(area≠all)数据拼装 |
|
||||
| 3 | App3 | `app3_clue_prompt.py` | 维客线索数据拼装 |
|
||||
| 4 | App4 | `app4_analysis_prompt.py` | 关系分析数据拼装 |
|
||||
| 5 | App5 | `app5_tactics_prompt.py` | 话术参考数据拼装 |
|
||||
| 6 | App6 | `app6_note_prompt.py` | 备注分析数据拼装 |
|
||||
| 7 | App7 | `app7_customer_prompt.py` | 客户分析数据拼装 |
|
||||
| 8 | App8 | `app8_consolidation_prompt.py` | 维客线索整理数据拼装 |
|
||||
|
||||
## 三、对照核查方法(给 Neo)
|
||||
## 三、对照核查方法(已收口,适用未来)
|
||||
|
||||
对每个 APP:
|
||||
每次百炼控制台 system prompt 调整后:
|
||||
|
||||
1. 打开百炼控制台 → 进入对应 APP 设置 → 找到 system prompt
|
||||
2. 打开本仓库对应文件(上面表格链接)
|
||||
2. 打开 `docs/ai/system-prompts/app<N>_<name>.md` § 四 章节
|
||||
3. **diff** 两边内容
|
||||
4. **如果云端 = git** → 一致,无需更新
|
||||
5. **如果云端 ≠ git** → 云端为权威,**用云端版本覆盖 git 文件**(对齐 Neo 决策"云端权威")
|
||||
6. 在本文件末尾标"已对照 / 已更新 / 一致" + 日期
|
||||
4. **如果云端 = MD** → 一致,无需更新
|
||||
5. **如果云端 ≠ MD** → 云端为权威,**用云端版本覆盖 MD 文件 § 四**(对齐 Neo 决策"云端权威")
|
||||
6. 修改 MD 元信息表"最后同步"为新日期
|
||||
7. 在 MD § 同步历史 追加一行
|
||||
8. 同步更新 [`_INDEX.md`](../../ai/system-prompts/_INDEX.md) §四 同步状态表
|
||||
9. commit:`docs(ai-prompt): 同步 AppN system prompt 至 YYYY-MM-DD`
|
||||
|
||||
## 四、对照状态记录(Neo 自填)
|
||||
## 四、对照状态记录(2026-05-05 同步事件)
|
||||
|
||||
| APP | 对照日期 | 状态 | 备注 |
|
||||
| APP | 同步日期 | 状态 | 来源 |
|
||||
|---|---|---|---|
|
||||
| App1 | — | **缺本地副本,需从云端导出** | — |
|
||||
| App2 | — | 待对照 | — |
|
||||
| App2a | — | 待对照 | — |
|
||||
| App3 | — | 待对照 | — |
|
||||
| App4 | — | 待对照 | — |
|
||||
| App5 | — | 待对照 | — |
|
||||
| App6 | — | 待对照 | — |
|
||||
| App7 | — | 待对照 | — |
|
||||
| App8 | — | 待对照 | — |
|
||||
| App1 | **2026-05-05** | ✅ 已同步最新 | `_snapshot-20260505-source.md §1` |
|
||||
| App2 | **2026-05-05** | ✅ 已同步最新 | `_snapshot-20260505-source.md §2`(prompt 已升级"区域业态专员") |
|
||||
| App2a | **2026-05-05** | ✅ 已同步最新 | 已确认状态 A:独立 APP;prompt 是 App2 5/5 版本的精细化扩充(H6 + 板块 D 助教成本特殊规则) |
|
||||
| App3 | **2026-05-05** | ✅ 已同步最新 | `_snapshot-20260505-source.md §3` |
|
||||
| App4 | **2026-05-05** | ✅ 已同步最新 | `_snapshot-20260505-source.md §4` |
|
||||
| App5 | **2026-05-05** | ✅ 已同步最新 | `_snapshot-20260505-source.md §5` |
|
||||
| App6 | **2026-05-05** | ✅ 已同步最新 | `_snapshot-20260505-source.md §6` |
|
||||
| App7 | **2026-05-05** | ✅ 已同步最新 | `_snapshot-20260505-source.md §7` |
|
||||
| App8 | **2026-05-05** | ✅ 已同步最新 | `_snapshot-20260505-source.md §8` |
|
||||
|
||||
## 五、SDK 调用方式(已确认不改)
|
||||
|
||||
@@ -65,15 +94,23 @@ Neo 反馈:**"SDK 调用不要改,我坚持使用 APP 调用的方式"**。
|
||||
## 六、风险提示
|
||||
|
||||
云端权威方案的已知风险(P2-6 / F3-2B 已讨论):
|
||||
- 不可 git diff / blame
|
||||
- 多 AI 调优时云端可能漂移,git 可能滞后(本对照机制是唯一的同步触发)
|
||||
- 不可 git diff / blame(已通过 `docs/ai/system-prompts/` 本地备份缓解)
|
||||
- 多 AI 调优时云端可能漂移,git 可能滞后
|
||||
|
||||
**缓解**:
|
||||
- 每月定期对照(本文件 § 四 记录)
|
||||
- 重大 prompt 调整后立即同步 git
|
||||
- 重大 prompt 调整后立即同步 git(每个独立 MD 改 §四 + 同步历史 + commit)
|
||||
- 5/5 已建立独立 MD 体系,后续 diff 视角清晰
|
||||
- (Wave 2-3)考虑加 hook 提醒每月对照云端
|
||||
|
||||
## 七、关联
|
||||
|
||||
- 决策来源:[`01-W1-findings-response.md`](01-W1-findings-response.md) §10.4
|
||||
- P2-6 原讨论:[`docs/_overview/04c-feedback/P2-6-and-P2-9-design.md`](../04c-feedback/P2-6-and-P2-9-design.md)
|
||||
- F3-2A SCD2 配置表:Wave 2 实施(`biz.cfg_ai_token_price`)
|
||||
- F3-2C 收口审计:[`docs/audit/changes/2026-05-05__wave1_f3_2c_system_prompts_split.md`](../../audit/changes/2026-05-05__wave1_f3_2c_system_prompts_split.md)
|
||||
- 独立 MD 索引:[`docs/ai/system-prompts/_INDEX.md`](../../ai/system-prompts/_INDEX.md)
|
||||
|
||||
## 八、待 Neo 后续处理
|
||||
|
||||
- [x] ~~App2a 厘清~~(2026-05-05 已确认状态 A:独立 APP,prompt 已同步)
|
||||
- [ ] **App2a APP_ID 补全**:在 [`_INDEX.md`](../../ai/system-prompts/_INDEX.md) §三 表格补 App2a 百炼 APP_ID 和环境变量名
|
||||
|
||||
Reference in New Issue
Block a user