微信小程序页面迁移校验之前 P5任务处理之前

docs/prd/AI需求2.md

@@ -0,0 +1,51 @@
+更新：我要建立8个应用，你要帮我写AI应用的提示词，包括提示词，传入的参数，文档引用等。使用模型Qwen3.5-Plus。应用提示词要符合百炼平台和Qwen3.5-Plus的提示词风格。相关文档已经整理，在项目中调用。
+
+风格参考，不要关注内容：
+
+```text
+# 角色
+你是一位数据查询专家，擅长通过MCP工具查询数据库内容，限制查询{{User_ID}}并根据查询结果提供准确的回复。
+## 技能
+### 技能1: 数据库查询
+- **任务**：使用MCP工具查询DWD层数据库中的相关内容。
+- 根据用户提供的关键词或具体需求，构建合适的SQL查询语句。
+- 执行查询并获取相关数据。
+### 技能2: 结果分析与解释
+- **任务**：基于查询结果，为用户提供详细的解释和分析。
+- 解释查询结果的含义及其对用户问题的相关性。
+- 提供清晰、简洁的回复，确保用户能够理解查询结果。
+## 限制
+- 仅限于使用MCP工具进行数据库查询。
+- 查询范围应严格遵循用户的需求和提供的关键词。
+- 确保查询结果的准确性和相关性，避免引入无关信息。
+- 在解释查询结果时，保持语言简洁明了，易于理解。
+## 参考文档
+- 当通过MCP查询数据库时，请参考 “桌球运营小程序 SQL” 内的markdown 文档
+```
+
+6 个 AI 应用的详细需求：
+
+| 应用编号 | 名称 | 用途 | 提示词传入参数 | Prompt要求 | 传入首条 Prompt<br>（调用时实现。） | 返回内容<br>（调用时，通过接口定义） |
+| --- | --- | --- | --- | --- | --- | --- |
+| 应用 1 | 通用<br>对话 | 用户主动与 AI 交流，支持页面上下文 | User_ID；<br>花名（昵称）；<br>Role（助教/管理者）；<br>Nickname。 | 描述使用场景与服务内容。<br>需要严格规范权限限制，若是助教用户，则只查询改助教有关的数据，对权限范围外的请求和对话询问进行驳回。<br>根据MCP手册自主查库。 | 用户正在查看页面内容：页面上下文（来源页面+内容摘要）<br>用户页面视野内容：当前屏幕内容。 | 自然语言对话回复<br>返回格式要求：流式返回（SSE），前端逐字展示 |
+| 应用 2 | 财务<br>洞察 | 自动生成指定范围的的财务分析报告。<br>并结合历史记录进行对比分析。 | 店铺ID；时间维度信息（本月/上月/本周/上周/前3月不含本月/本季/上季/近6月不含本月） | 描述使用场景与服务内容。<br>若是历史数据，则对历史周期财务趋势分析、更多分析（根据数据库已有的数据，为我完善）。<br>若是包含当前周期的请求，则返回异常提醒、当前经营建议、更多分析（为我完善）。 | 使用Json格式传入：<br>时间维度信息（本月/上月/本周/上周/前3月不含本月/本季/上季/近6月不含本月）。<br>对应的日期范围。<br>对应时间维度信息，和上一个周期对应的信息，具体数据：[收入结构、预收资产、支出汇总、平台结算的8维度数据]<br>（更多必要数据为我完善） | 要求JSON输出：<br>数组（键：序号；标题；正文详情） |
+| 应用 3 | 客户<br>数据<br>维客<br>线索<br>分析 | 客户新增消费时，对维客线索分类分析。通过数据和备注分析有效的客户维护线索。提供给助教/工作人员，做客户维护的参考。<br>注意，此应用重点在于客观数据，的分析，主观备注的通过应用6进行处理。<br>此应用回复的内容，提供者统一为“系统” | 无 | 描述使用场景与服务内容。<br>对提供的数据进行价值挖掘，找出对客户画像，消费情况等有价值的信息。总结若干条客户维护线索。<br>对每条线索信息分类，类别固定：客户基础，消费习惯，玩法偏好。<br>内容相似信息可以合并。<br>返回要求：<br>分类标签是枚举值：客户基础，消费习惯，玩法偏好。<br>维客线索详情（120字内）：原数据情况，分析过程，结论依据，总结建议。<br>摘要（20字内）：一段精简的重要内容提取，可以当做本条内容的标题。<br>分配的Emoji：作为生动的信息传达手段，分配一个契合的Emoji，当做二级标签。 | 使用Json格式传入：<br>客户昵称；<br>主要内容：该客户，近3个月消费数据（DWD与DWS 的 订单明细包括台费，充值，助教消费等全维度）；名下会员卡明细；会员卡余额合计；储值卡余额合计；客户应到店日期；当前与上次到店间隔。<br>参考信息：应用6的线索结果 + 该客户最近期的2套维客线索分析历史信息（应用8的结果）作参考，并附上生成时间。 | 要求JSON输出：<br>数组（键：维客线索详情；分类标签；摘要；分配的Emoji；） |
+| 应用 4 | 关系<br>分析/任务<br>建议 | 有助教参与的新结算单出现时、优先召回任务分配时、高优先召回任务分配时，对客户和助教关系进行分析。通过客户维护线索，制订客户召回策略。 | 无 | 描述使用场景与服务内容。<br>分析助教与客户的详细信息数据和服务关系，分析关系，客户偏好，场景等提供提供任务的建议，注意事项。<br>返回说明：<br>数组：返回1或多条采取的措施和行动建议。 | 使用Json格式传入：<br>助教信息；助教服务该的历史信息；任务分配的依据。<br>客户信息：<br>1、提供者：系统。内容：该客户，近3个月消费数据（DWD与DWS 的 订单明细包括台费，充值，助教消费等全维度）；名下会员卡明细；会员卡余额合计；储值卡余额合计；客户应到店日期；当前与上次到店间隔。<br>2、提供者：备注创建者。内容：备注全文。<br>参考信息：该客户当前的维客线索（任务8结果）+ 最近期的2套维客维客线索（任务8结果）,并附上生成时间。） | 要求JSON输出：<br> 键：与我的关系一句话总结。
+<br>键：任务描述与依据（严重情况）；数组（键：采取措施行动建议）；<br>键：一句话总结。 |
+| 应用 5 | 话术<br>参考 | 联动应用4，提供沟通话术 | 无 | 描述使用场景与服务内容。<br>根据提供的信息和数据，分析关系，客户偏好，场景等提供沟针对性沟通话术的建议和。 | 使用Json格式传入：<br>助教信息；助教服务该的历史信息；任务分配的依据。<br>客户信息：<br>1 提供者：系统。内容：该客户，近3个月消费数据（DWD与DWS 的 订单明细包括台费，充值，助教消费等全维度）；名下会员卡明细；会员卡余额合计；储值卡余额合计；客户应到店日期；当前与上次到店间隔。<br>2提供者：备注创建者。内容：备注全文。<br>任务信息：本次任务建议（应用4返回）。<br>参考信息：该客户最近期的2套维客线索分析历史信息作参考，并附上生成时间。） | 要求JSON输出：<br>数组（键：话术内容）； |
+| 应用 6 | 备注<br>分析 | 每个备注提交后自动分析内容，评分及提炼客户维护线索。<br>注意，此应用重点在于主观备注的分析，客观的数据分析通过应用3进行处理。<br>此应用回复的内容，提供者统一为当前备注提供人。 | 无 | 描述使用场景与服务内容。<br>分析备注内容并评分：<br>分析：对提供的数据和信息进行价值挖掘，<br>根据提交的备注，客户信息及维客线索进行分析。找出对客户画像，消费情况等有价值的信息。总结0到若干条客户维护线索。<br>若内容毫无用处，则返回0条，数组无内容即可。<br>对每条线索信息分类，类别固定：客户基础，消费习惯，玩法偏好，促销接受，社交关系，重要反馈。<br>返回要求：<br>分类标签是枚举值：客户基础，消费习惯，玩法偏好，促销接受，社交关系，重要反馈。<br>维客线索详情（120字内）：原数据情况，分析过程，结论依据，总结建议。<br>摘要（20字内）：一段精简的重要内容提取，可以当做本条内容的标题。<br>评分：<br>返回：1-10分数，以及评价。(6分为标准分，被别人备注过多的信息酌情扣分，无价值/低价值/时效性低/个性化弱/业务性弱/私密性低等弱销售线索信息酌情扣分。反之高价值信息则酌情加分) | 使用Json格式传入：<br>本次主要处理的备注信息；<br>参考信息：<br>客户昵称；该客户，近3个月消费数据（DWD与DWS 的 订单明细包括台费，充值，助教消费等全维度）；名下会员卡明细；会员卡余额合计；储值卡余额合计；客户应到店日期；当前与上次到店间隔。<br>所有助教对该客户的全部备注；<br>应用3的线索结果 + 该客户最近期的2套维客线索分析历史信息（应用8的结果）作参考，并附上生成时间。 | 要求JSON输出：<br>数组（键：分类标签；分配的Emoji；维客线索详情；摘要；）<br>；键：分数。 |
+| 应用 7 | 客户<br>分析 | 不同于应用3和应用4，本应用将基于客户全量信息，给出该客户的运营建议。<br>当客户结账单出现后。 | 客户ID；客户昵称。 | 描述使用场景与服务内容。<br>基于客户全量信息，系统地总结该客户现状。找到客户运营与维护过程中的关键问题。并在数据洞察的基础上，输出可执行的客户维护策略与行动建议，为后续客户维护工作提供明确指导，提高召回可能性。<br>数据来源分为客观数据和主观信息。主观信息分析时需要标注【来源：XXX;XXX，请甄别信息真实性】<br>返回内容：<br>数组：每条包括标题和正文，列出适合当前客户的运营策略。<br>键：就客户所有策略和情况进行总结性的说明。 | 使用Json格式传入：<br>提供客观数据内容：该客户，近3个月消费数据（DWD与DWS 的 订单明细包括台费，充值，助教消费等全维度）；名下会员卡明细；会员卡余额合计；储值卡余额合计；客户应到店日期；当前与上次到店间隔。<br>提供主观信息：该客户所有备注，及创建者与备注全文。<br>参考：该客户最新的，及最近期的2套应用8的客户分析历史信息作参考，并附上生成时间。 | 要求JSON输出：<br>数组（键：标题；正文。）<br>；键：总结 |
+| 应用 8 | 维客<br>线索<br>整理 | 当应用3 或 应用6有新内容产生时。使用此应用进行整合。 | 无 | 描述使用场景与服务内容。<br>提供的线索是经过价值挖掘的客户画像，消费情况等有价值的信息。已经总结成的客户维护线索。<br>但都是分别整理的，你的任务是对提供的所有线索进行整体审核整理，对很相似的线索进行合并，返回要记录为多个提供者。<br>除此外，其他的原文返回，保持最小改动原则，不要私自增加任何额外内容。<br>返回要求：<br>分类标签是枚举值：客户基础，消费习惯，玩法偏好，促销接受，社交关系，重要反馈。<br>维客线索详情（120字内）：原数据情况，分析过程，结论依据，总结建议。<br>摘要（20字内）：一段精简的重要内容提取，可以当做本条内容的标题。<br>提供者：完整返回，多个提供者用逗号隔开。<br>分配的Emoji：作为生动的信息传达手段，分配一个契合的Emoji，当做二级标签。 | 使用Json格式传入：<br>当前最新 应用3+应用6内容。 | 要求JSON输出：<br>数组（键：维客线索详情；分类标签；摘要；分配的Emoji；提供者。） |
+
+关键技术要点：
+
+1. 应用1（通用对话）：唯一支持流式返回的应用，使用 SSE 技术
+2. 应用2-8：返回结构化 JSON，自动解析写入 member_retention_clue 表。解析Json，存入 ai_cache 供前端读取
+3. 用途：
+应用1：chat页面，用于AI对话。
+应用2：财务看版页。
+客户备注出现时，使用应用6。
+应用3 + 应用6 内容给到应用8 输出内容，结合应用 7，用于客户详情页和任务详情页。
+应用8数据用于应用4，结合应用5一起用于任务详情页。
+4. 信息隔离：所有应用通过 biz_params.user_prompt_params 传入用户身份，百炼平台侧做数据查询隔离
+5. 持久化：所有对话记录存入 ai_conversations + ai_messages，包含 tokens 消耗统计