# VISTA Link AI 与智能体产品需求文档 ## 文档状态 | 项目 | 内容 | |---|---| | 产品名称 | VISTA Link | | 文档类型 | AI 与智能体产品需求文档 | | 当前版本 | V1.14 | | 最近更新 | 2026-09-01 | | 当前状态 | 正式产品需求依据 | | 主要用户 | 销售人员、销售经理、营销企划、项目管理员 | | 基础能力基线 | [VISTA Link 产品需求文档 V0.250](./VISTA_Link_产品需求文档.md) | | 关联文档 | [VISTA Link 用例文档](./VISTA_Link_用例文档.md)、[VISTA Link AI 与智能体用例文档](./VISTA_Link_AI与智能体用例文档.md)、[修订记录](./VISTA_Link_AI与智能体产品需求文档_修订记录.md) | 本文规定 VISTA Link 面向外部智能体和内置智能体提供的产品能力、使用场景和业务规则。每项 AI 能力必须以主 PRD 已有人工操作为基础，不得先于对应基础能力单独生效。本文不规定具体接口、命令、服务结构、模型选择和部署方式。 --- ## 1. 需求背景 VISTA Link 已经管理项目、客户、素材、Widget、分享页面、固定链接、客户追踪和营销统计。用户目前主要通过 VISTA Link 页面逐项查找和操作。 用户也希望在自己常用的智能体中直接说明目标，例如： - 根据一位客户的年龄、家庭情况和关注点，从当前项目选择素材并制作页面。 - 根据客户已经保存的标签、购房意向、备注和浏览记录准备后续资料。 - 查询最近 30 天最活跃的客户，查看他们主要浏览了哪些内容。 - 检查已有页面中的失效素材或 Widget 问题，并准备修改。 用户表达目标的方式无法穷举，但 VISTA Link 可以提供的业务对象和业务操作可以明确列出。因此，本需求以“业务能力 + 代表场景 + 必须遵守的规则”为主要写法。 主 PRD 更新后，销售完整工作已经包含接待前准备、客户查找、页面选择或制作、现场讲解、讲解记录处理、访问地址复制、客户自主访问查看、再次推荐和客户状态手动修改。基础能力完整，但用户仍需在多个页面之间反复查找、筛选、比较和检查。AI 的作用是减少这些准备和整理工作，不改变最终业务结果。 --- ## 2. 产品目标 ### 2.1 总目标 让用户可以通过任意兼容的智能体使用自己有权使用的 VISTA Link 功能，同时保持和人工操作相同的项目范围、权限、业务检查和数据结果。 ### 2.2 具体目标 1. 用户可以在 Codex、Claude Code 等外部智能体中使用 VISTA Link。 2. VISTA Link 可以提供自己的内置智能体，用户通过网页使用。 3. 外部智能体和内置智能体使用同一套业务对象和业务规则。 4. 智能体可以读取、检索和解释用户有权查看的数据。 5. 智能体可以组合多项现有能力完成页面制作、客户查找和统计问答。 6. 智能体执行写入前，应按官方规则向用户说明将要发生的变化并取得明确同意。 7. 智能体的统计回答能够指出时间范围、指标、数据更新时间和依据。 8. 更换智能体或模型时，不要求 VISTA Link 重新定义客户、素材、Widget、页面和统计规则。 9. 每项 AI 方案都能指出它代替或缩短了主 PRD 中哪段人工操作。 10. AI 不可用时，用户仍能使用主 PRD 定义的原有页面完成同一项工作。 11. 根据客户访问生成摘要或建议时，只使用主 PRD 可以确认归属的访问和行为记录，并说明访问发生时的内容与当前可用内容的差异。 12. AI 结果使用的访问依据发生纠正、排除或归属变化后，系统应阻止继续使用旧结果，并允许用户按最新数据重新生成。 ### 2.3 从功能操作改为目标表达 主 PRD 按客户、素材、页面、固定链接、现场讲解、客户追踪和营销统计分别定义功能。这种写法适合研发确定对象和规则，但要求销售先理解产品结构，再判断应该进入哪个页面、使用哪些筛选和按什么顺序操作。 AI 需要解决的不是缺少功能，而是用户不知道如何把多个功能组合成一次完整工作： - 用户不需要先知道 Widget、素材候选范围、固定链接参数或访问记录层级。 - 用户先用自然语言说明目标、客户和限制，例如「给李娜找一份适合下午接待使用的页面」。 - AI 把目标拆成主 PRD 已定义的查询、判断、方案准备和写入操作。 - AI 先使用确定规则检查项目、权限、对象状态和候选范围，再使用 AI 理解客户条件和任务目的。 - AI 展示找到的结果、没有找到的原因、准备的新方案和仍需用户决定的事项。 - 用户只在客户事实、页面内容、正式保存、客户关联和其他业务变化前作出决定。 AI 不能用一个答案跳过必要业务步骤。用户操作变少，项目、权限、页面检查、客户识别、写入确认和操作记录仍然完整执行。 原界面按功能拆开是合理的，因为客户是否存在、页面是否匹配、素材是否可用、客户是否访问、讲解是否关联以及客户实际反馈都会变化。AI 不取消这些分支，而是在一次任务中识别分支、补问缺失条件、组织候选结果，并把需要判断的内容交给用户检查。 ### 2.4 AI 如何回答销售最关心的三个问题 主 PRD §1.3 提出销售需要解决「发什么」「购房客户看了没有」「下一步怎么做」三个问题。AI 应把这三个问题作为销售使用入口，而不是要求用户从功能菜单开始。 | 销售问题 | 自然语言示例 | AI 使用的基础能力 | AI 返回结果 | 销售仍需决定 | |---|---|---|---|---| | 发什么？ | 「李娜下午来，找一份适合现场讲解的页面」「根据她最近的反馈准备一份回家后看的页面」 | 客户资料、历史讲解、客户自主访问、页面搜索、Widget 规则、素材搜索、页面准备和预览 | 可直接使用的已有页面；部分匹配页面及差异；没有匹配时的新页面方案、选材理由和资料缺口 | 确认本次客户条件，选择已有页面或新页面方案，预览并确认保存，决定是否发送 | | 购房客户看了没有？ | 「李娜最近两周有没有打开页面，主要看了什么？」 | 购房客户追踪、固定链接筛选、时间筛选、访问次数、页面、内容、有效时长和明确动作 | 是否访问、访问次数、最近访问时间、主要浏览内容、明确动作、数据异常和原始记录入口 | 核对事实；不需要自己逐层查看累计数据、趋势、内容分布和单次记录 | | 下一步怎么做？ | 「最近应该先看哪些客户？下一次给李娜准备什么？」 | 正式客户排行、单个客户追踪、客户已保存资料、页面和素材能力 | 建议优先查看的客户、客观依据、建议询问的问题、建议准备的资料和页面方案 | 决定是否联系、如何沟通、是否采用建议，以及是否保存和发送页面 | AI 回答「更感兴趣」时，只能改写为最近浏览次数更多、有效时长更长或重复查看的内容。AI 回答「是否现在联系」时，只能给出带依据的建议，不能生成客户分数、意向等级或强制任务。 ### 2.5 操作简化目标 下表统计的是主 PRD 中用户最少需要完成的操作项，不是最终界面的点击次数。实际交互完成后再通过可用性测试记录点击和耗时。 | 销售任务 | 原人工操作 | AI 使用后的用户操作 | 主要减少内容 | |---|---|---|---| | 接待前准备 | 搜索客户 → 打开详情 → 查看资料 → 查看历史讲解 → 查看自主访问 → 查找可用页面，至少 6 项 | 描述客户和接待目的 → 检查 AI 摘要 → 选择页面，通常 3 项 | 页面跳转、重复查找和手工整理 | | 制作客户页面 | 选择新建或复制 → 填写名称和封面 → 添加 Widget → 逐项筛选素材 → 排序 → 检查 → 预览 → 确认保存，至少 8 项 | 描述客户和页面目的 → 检查或修改预览 → 确认保存，通常 3 项 | Widget 选择、素材筛选、排序和规则检查 | | 查看客户是否访问 | 打开客户追踪 → 选择客户 → 选择时间 → 查看累计数据 → 查看内容分布 → 查看单次记录，至少 6 项 | 提出一个问题 → 检查带来源的回答，通常 2 项 | 时间筛选、数据切换和手工汇总 | | 访问后准备新资料 | 查看客户记录 → 判断浏览重点 → 查找素材 → 选择 Widget → 生成页面 → 预览 → 确认保存，至少 7 项 | 询问客户最近情况 → 检查 AI 依据和页面方案 → 确认保存，通常 3 项 | 行为整理、选材和页面编排 | | 处理未完成讲解 | 进入讲解记录 → 找到记录 → 打开详情 → 选择处理方式 → 填写客户或理由 → 确认，至少 6 项 | 要求查看待处理讲解 → 选择处理方式并填写必要理由 → 确认，通常 3 项 | 记录查找和状态判断 | 操作简化不能删除用户必须承担的决定。客户反馈、客户状态、讲解客户关联、无效讲解、页面保存和对外发送仍由用户决定。 ### 2.6 主要销售场景中的确定步骤、变数和人工审核 以下七个场景来自主 PRD §2.2.1。系统确定规则负责项目、权限、对象状态、记录和写入；AI 负责处理中间不能只靠固定条件决定的部分；用户负责检查 AI 结果和确认真实业务信息。 | 销售场景 | 确定步骤 | 中间存在的变数 | AI 简化方式 | 人工审核点 | |---|---|---|---|---| | 接待前准备 | 查找客户、读取资料和历史、查询可用页面 | 客户今天关注点是否变化；哪些历史信息仍适用；已有页面是否适合本次接待 | 汇总客户资料、讲解和访问事实，列出缺失问题，查找并说明候选页面 | 确认本次客户条件；选择实际讲解页面 | | 已有客户现场接待 | 选择客户和已保存页面、开始和结束讲解、保存讲解记录 | 应先讲什么；哪些内容与客户已知条件更相关；现场反馈与历史是否一致 | 接待前准备页面和建议顺序；讲解后把展示事实与销售补充反馈分开整理 | 决定讲解内容和顺序；确认客户真实反馈；决定是否更新资料 | | 临时客户现场接待 | 从页面开始临时讲解、保存记录、结束后选择或创建客户 | 客户身份可能不知道；初始需求不完整；结束后是否应该关联客户 | 根据销售当场描述查找通用页面；讲解后提示未关联记录和可选操作 | 确认客户身份；决定创建或选择客户；确认关联或标记无效及理由 | | 远程咨询与首次发送 | 查找或创建客户、选择或制作页面、预览确认并保存、取得访问地址 | 客户表达通常是自然语言；已有页面可能完全匹配、部分匹配或不匹配 | 整理客户条件，先找已有页面；部分匹配时给出差异；没有匹配时准备新页面方案 | 确认客户资料、页面内容、保存和实际发送 | | 到访后发送资料 | 读取讲解记录、补充客户反馈、选择或制作新页面、保存并取得地址 | 讲解记录只表示销售展示过什么；真正反馈来自销售现场确认；下一份资料需要重新选择 | 分开讲解事实和销售补充反馈，根据确认后的反馈准备页面方案 | 确认客户反馈；检查选材理由和页面；决定保存和发送 | | 根据访问继续推荐 | 查询客户自主访问、查看页面和内容记录、再次准备页面 | 浏览次数和时长不能直接等于兴趣；是否联系、问什么、发什么仍需判断 | 汇总客观行为和异常，提出带依据的询问方向和资料建议，按需要准备页面方案 | 判断是否联系；修改沟通重点；决定是否采用和发送资料 | | 购买申请与签约 | 外部系统处理申请、贷款和合同；VISTA Link 只手动修改客户状态 | 外部业务结果是否真实完成，不能由页面或访问行为判断 | 根据用户明确提供的外部结果，展示当前状态和待修改状态，准备状态修改确认 | 确认真实业务结果和目标状态；AI 不推断申请成功或签约 | 每个场景中的 AI 输出都必须能回到原始客户资料、页面、素材、讲解或访问记录。用户修改 AI 结果时，系统保存用户最终确认的内容；未确认的建议不进入正式业务数据。 ### 2.7 主要销售场景的 AI 固定流程 | 任务编号 | 销售场景 | AI 固定执行顺序 | 主要分支 | |---|---|---|---| | AI-SALES-01 | 接待前准备 | 确认项目和查询时间 → 读取关联业务系统明确提供的近期预约信息 → 返回客户、预约时间、来源和备注 → 用户选择客户 → 读取客户资料 → 分开读取有效讲解和自主访问 → 整理已知条件与缺失问题 → 调用 AI-PAGE-01 查找页面 → 返回接待准备摘要 | 没有预约时返回空结果；预约信息无法关联现有客户时说明限制；客户同名时要求选择；资料不足时补问；无可用页面时询问是否准备新页面 | | AI-SALES-02 | 已有客户现场接待 | 执行接待前准备 → 用户选择页面 → 提供现场讲解入口 → 讲解结束后读取客观记录 → 询问销售是否补充客户反馈 → 准备资料修改或后续页面 | 页面不匹配时调用新建流程；反馈与已有资料冲突时要求用户选择；未确认反馈不写入 | | AI-SALES-03 | 临时客户现场接待 | 读取销售临时描述 → 调用 AI-PAGE-01 查找页面 → 提供临时讲解入口 → 讲解结束后检查客户关联 → 返回关联、保留未关联或标记无效选项 | 知道客户身份时选择或创建客户；不知道时保持未关联；只有用户确认误触或测试并填写理由后才能标记无效 | | AI-SALES-04 | 远程咨询与首次发送 | 确认项目和客户 → 整理咨询条件 → 查找已有客户或准备创建客户 → 调用 AI-PAGE-01 → 用户审核并保存 → 准备访问地址 | 客户不存在时先确认是否创建；页面完全匹配时直接候选；部分匹配或无匹配时进入调整或新建分支；不自动发送 | | AI-SALES-05 | 到访后发送资料 | 读取本次有效讲解 → 分开显示展示事实和销售补充反馈 → 用户确认反馈 → 调用 AI-PAGE-01 准备后续页面 → 保存后准备访问地址 | 讲解未关联时先处理关联；没有销售确认的反馈时只按讲解事实整理，不能推断客户兴趣 | | AI-SALES-06 | 根据访问继续推荐 | 确认客户和时间 → 读取自主访问及访问数据状态 → 排除异常数据并标明部分缺失 → 汇总页面、内容、次数、时长和明确动作 → 检查历史内容的当前可用状态 → 给出带依据的询问方向和资料建议 → 由用户采用、修改或忽略 → 按用户要求调用 AI-PAGE-01 | 没有访问时返回空结果；异常数据不进入建议依据；部分缺失时只使用能够确认的记录；历史内容已不可用时不直接推荐；有行为但资料不足时只给询问方向；不自动生成意向等级或客户状态 | | AI-SALES-07 | 购买申请与签约 | 读取客户当前状态 → 获取用户明确提供的外部业务结果 → 查询当前项目未停用状态 → 展示原状态、目标状态和依据 → 用户确认后修改 | 没有明确业务结果时不修改；目标状态不存在或已停用时要求重新选择；页面、讲解和访问行为不能作为签约依据 | AI-PAGE-01 是多个销售场景共用的页面查找与准备流程，定义见 §10.3。其他重复能力也应采用相同方式复用，不能在不同场景中形成含义不同的页面、客户或统计规则。 AI-SALES-06 的优先级为 P1，沿用主 PRD §4.6.1 购房客户追踪的优先级，不属于当前内部 MVP。 --- ## 3. 产品范围 ### 3.1 本文包含 - 外部智能体使用 VISTA Link 的产品方式。 - VISTA Link 内置智能体的产品方式。 - 用户授权、项目范围和权限继承规则。 - 智能体可读取和操作的业务能力。 - AI 页面方案、页面制作、页面检查、预览确认和保存。 - 根据客户资料或用户临时描述选择素材。 - 客户追踪和营销统计问答。 - 读取关联业务系统明确提供的预约信息，用于查找近期预约客户和准备接待。 - 接待前客户资料和历史记录整理。 - 现场讲解后的客观摘要、后续页面准备和讲解记录处理提示。 - 项目总览问答和详情入口建议。 - 素材说明、素材标签和客户资料修改建议。 - 写入前的用户确认规则。 - 内置智能体的工作文件夹和会话组织规则。 - 日文和英文的使用规则。 - 错误、恢复、操作记录、隐私和验收要求。 ### 3.2 本文不包含 - AI 图片、视频、文案或三维内容制作系统。 - 大模型供应商、模型名称和模型调用费用的具体方案。 - 具体接口、字段结构、命令格式和部署方式。 - 自动发送 LINE、邮件、短信或其他销售消息。 - 根据浏览行为自动生成客户分数、意向等级或购买结论。 - 自动修改客户状态、负责人、标签、备注或讲解客户关联。 - 根据客户行为自动生成或更新兴趣标签、阶段标签、风险标签或行动标签。 - 自动把现场讲解内容解释成客户兴趣或客户反馈。 - 销售任务、沟通记录、预约创建、修改或确认、到访、认购、签约和交易结果管理。 - 分享渠道识别、营销活动归因、获客成本或 ROI。 - 独立 AI 审核中心、模型配置中心或提示词配置页面。 - 购房客户访问端的 AI 问答、AI 推荐或 AI 聊天。 - 修改 Widget 定义、素材来源数据或营销统计计算规则。 - 为产品增加简体中文界面。 - 团队共享工作文件夹、文件夹独立权限或跨项目文件夹。 ### 3.3 AI 参与范围与人工操作出处 AI 只能参与下表所列工作。表中的“原始操作”是 AI 方案成立的依据，也是研发和验收检查范围。 | AI 场景 | 主 PRD 中的原始操作 | 原始繁琐之处 | AI 参与方式 | 用户保留的决定 | |---|---|---|---|---| | 接待前准备 | §2.2.1 接待前准备；§4.1 客户管理；§4.6.1 购房客户追踪 | 销售要分别查客户资料、标签、状态、历史讲解和自主访问，再找可用页面 | 汇总已保存资料和客观历史，列出资料缺口、可用页面和需要销售确认的问题 | 选择客户、确认本次接待重点、决定使用哪个页面 | | 根据客户条件制作页面 | §4.3.4 新建与复制分享页面 | 销售要选择创建方式、Widget、候选素材、顺序、封面，反复检查和预览 | 根据用户目标搜索候选素材，生成 AI 页面方案、选材理由、检查结果和预览 | 修改方案，确认保存 | | 到访后准备后续页面 | §2.2.1 到访后发送资料；§2.2.2 销售主流程；§4.3.8 现场讲解 | 销售要回看讲解内容、手动补充客户反馈，再重新选材和制作页面 | 分开整理讲解事实与销售补充反馈，生成后续页面方案 | 确认客户反馈、修改方案、决定是否保存和发送 | | 客户访问后的查看与再次推荐 | §2.2.1 根据访问继续推荐；§4.6.1 购房客户追踪；§4.6.2 营销统计 | 销售要查看累计数据、趋势、内容分布和单次过程，再自己整理重点 | 按时间范围汇总客观访问事实，给出带依据的查看顺序和后续资料建议 | 判断是否联系客户，选择沟通内容，不由 AI 修改客户状态 | | 页面问题检查与修改准备 | §4.2 素材更新和下线规则；§4.3.5 编辑分享页面 | 用户要逐项检查停用 Widget、失效分类、更新、下线或删除素材，并寻找替代项 | 列出问题、影响和可用替代素材，生成修改方案并重新检查 | 选择替代内容，预览并确认保存 | | 客户资料整理 | §4.1.3 编辑客户资料；§4.1.5 客户标签管理 | 销售要把沟通中的信息手动拆成购房意向、备注和标签 | 把用户明确提供的信息整理成待确认修改，标明原文和目标字段 | 逐项确认、修改或取消；AI 不根据行为补写资料 | | 素材说明和标签整理 | §4.2.3 素材详情；§4.2.4 素材标签管理 | 营销企划要逐项阅读来源信息，再编写说明和选择已有标签 | 基于素材当前信息生成说明草稿和已有标签建议 | 确认文本和标签；AI 不修改分类或来源数据 | | 现场讲解记录处理 | §4.3.8 讲解记录、异常中断和客户关联 | 销售要查找未关联、未正常结束或误操作记录，并逐项处理 | 汇总待处理记录，解释可用操作；按用户明确提供的客户或理由准备修改内容 | 决定继续或结束、选择客户、填写修改理由、决定是否标记无效 | | 项目总览问答 | §4.9 项目总览 | 用户要分别查看总体数据、负责人分布并进入各详情页 | 回答当前项目、当前时间范围内的已定义数据，并给出可继续查看的详情入口 | 选择查看范围；AI 不评价销售表现或生成客户分数 | --- ## 4. 用户和使用方式 ### 4.1 用户角色 智能体不成为新的业务角色。智能体代表当前 VISTA Link 用户执行任务，实际权限仍来自该用户在当前项目中的角色、功能权限和数据权限。 适用用户包括： - 销售人员。 - 销售经理。 - 营销企划。 - 项目管理员。 同一项能力对不同用户是否可用，以 [VISTA Link 产品需求文档](./VISTA_Link_产品需求文档.md) 中对应功能的权限规则为准。 ### 4.2 外部智能体 用户可以在 Codex、Claude Code 或其他兼容智能体中安装 VISTA Link 官方 Skill，并通过 VISTA Link 官方命令行程序使用业务能力。 外部智能体负责： - 理解用户目标。 - 在信息不足时补问。 - 选择需要使用的 VISTA Link 能力。 - 向用户解释查询结果、AI 页面方案和统计依据。 - 按 Skill 规定处理写入前确认。 VISTA Link 需要提供： - 官方命令行程序。 - 官方 Skill。 - 安装、授权、升级和退出说明。 - 可供智能体理解的能力说明和结果。 - 日文和英文的固定说明与错误信息。 ### 4.3 内置智能体 VISTA Link 可以在网页中提供自己的智能体入口。用户在 VISTA Link 登录后，通过对话提出要求并查看结果。 **入口与使用过程：** - VISTA Link 为已登录并已选择项目的用户提供内置智能体入口。 - 登录页、项目选择页、购房客户访问页和现场讲解页不提供内置智能体入口。 - 用户可以从共通入口进入，也可以从客户详情、页面编辑、讲解记录、客户追踪和项目总览中的相关操作进入。 - 用户进入后，系统显示「VISTA Link AI」和当前项目；从带明确对象的业务页面进入时，同时显示实际使用的客户、页面或其他业务对象。 - 从共通入口进入且没有明确业务对象时，智能体只使用当前项目，不猜测客户或页面。 - 首次使用或开始新会话时，系统提供客户跟进、访问建议、素材查找和页面检查等常用问题，不显示新闻、广告或产品宣传。 - 用户可以直接输入问题，也可以继续当前项目内最近一次未结束的会话。 - 用户切换项目后，系统清除原项目对象和对话上下文，后续查询和操作使用新项目。 - 用户离开内置智能体后可以继续使用原有业务功能；未经用户确认的正式业务修改不得执行。 - 不同屏幕尺寸下必须能够查看当前项目、当前对象、对话、结果和必要操作；具体页面结构和入口位置由界面设计确定。 内置智能体： - 使用当前登录用户的身份和当前项目。 - 首次使用前仍需要由当前登录用户明确开启 AI 使用授权；用户可以单独关闭该授权。 - 使用与外部智能体相同的业务能力。 - 遵守与外部智能体相同的权限和确认规则。 - 不直接绕过业务检查访问或修改数据。 - 内置智能体首次提供时可以使用文字回答；页面制作需要提供页面预览。 - 内置智能体的入口位置、页面结构和结果展示方式由界面设计确定，不在本文中规定固定布局。 - 同一任务从业务页面进入时，自动带入当前项目和当前对象；仍需向用户显示实际使用的项目和对象，不能静默使用错误上下文。 ### 4.4 两种智能体的关系 - 内置智能体和外部智能体地位相同。 - 内置智能体不能拥有外部智能体无法使用的隐藏业务功能。 - 同一用户在同一项目执行同一操作时，业务检查和结果应一致。 - 两种智能体可以有不同的界面表现，但不能改变对象含义和业务规则。 ### 4.5 AI 通用任务执行流程 每项 AI 任务都必须使用同一套基本流程。具体场景可以增加分支，但不能省略项目、权限、依据、确认和失败处理。 ```mermaid flowchart TD START["用户用自然语言说明目标"] --> CONTEXT{"项目、对象和目的是否明确"} CONTEXT -->|否| ASK["只补问完成任务必需的信息"] ASK --> CONTEXT CONTEXT -->|是| CHECK["检查当前项目、权限和对象状态"] CHECK -->|不可用| DENY["说明原因并提供用户可用的原页面入口"] CHECK -->|可用| PLAN["拆成主 PRD 已定义的业务操作"] PLAN --> READ["读取事实、规则和当前版本"] READ --> PREPARE["准备查询结果、建议或页面方案"] PREPARE --> EVIDENCE["展示结果、依据、限制和待决定事项"] EVIDENCE --> CHANGE{"是否会修改正式业务数据"} CHANGE -->|否| DONE["返回结果和可继续操作"] CHANGE -->|是| CONFIRM{"用户是否确认当前变化"} CONFIRM -->|修改| PREPARE CONFIRM -->|取消| CANCEL["不执行写入，保留允许保留的文字结果"] CONFIRM -->|确认| RECHECK["重新检查权限、对象版本和业务规则"] RECHECK -->|检查失败| RECOVER["说明变化并重新准备或返回人工操作"] RECHECK -->|检查通过| EXECUTE["执行现有业务操作并记录结果"] EXECUTE --> DONE PREPARE -->|AI 失败| FALLBACK["保留已有输入并返回原人工操作入口"] ``` 通用流程中的“拆成业务操作”必须能被研发列举和测试。一个任务需要调用多项能力时，智能体按依赖顺序执行；前一步没有可靠结果时，不能继续假装后一步已经成立。 本文中的每个 AI 任务都需要形成任务流程说明，至少包含：触发说法、必需信息、确定规则、AI 判断内容、判断分支、使用的基础能力、需要人工检查的结果、写入确认、成功结果、失败处理和返回人工操作的入口。不能只列一个“AI 可以完成”的功能名称。 ### 4.6 对话、快捷操作和原有页面 内置智能体使用对话理解用户目的、补问必要条件、组合已有业务能力并返回结果。客户列表、客户详情、素材、分享页面、客户追踪、营销统计和现场讲解继续使用主 PRD 已定义的页面，不由智能体根据回答临时生成新的业务页面。 对话和原有页面按下列规则分工： - 对话负责理解目标、跨对象查找、整理依据、返回少量候选、补问缺失条件和取得用户确认。 - 原有页面负责大量数据的搜索、筛选、比较，以及需要连续操作、精确选择或视觉判断的工作。 - 智能体可以把用户带到已有业务操作，但不能在对话中重新定义该操作的字段、权限、状态和结果。 - 同一项正式操作无论从智能体还是原有页面进入，都使用主 PRD 的同一业务能力和检查规则。 智能体返回一个具体分享页面时，应同时返回该页面在当前状态下允许用户继续执行的固定快捷操作。固定快捷操作来自系统预先登记的页面类型和业务能力，不由 AI 临时命名、增加或删除。分享页面的快捷操作类型固定为以下四种；当前可用的操作可以执行，当前不可用的操作只说明原因，不能执行： - 查看页面详情。 - 复制客户访问地址。 - 预览客户页面。 - 进入现场讲解。 快捷操作只负责把页面对象和当前任务中已经明确的参数带入原有业务能力。系统必须遵守以下规则： - 查看页面详情使用当前项目和页面，不要求客户参数。 - 复制客户访问地址时，必须明确取得无参数固定链接还是指定客户访问地址；当前任务不能确定时，先让用户选择。 - 预览客户页面使用目标页面最新保存内容，不把预览记录成客户自主访问或现场讲解。 - 进入现场讲解时，必须明确目标页面以及已有客户或临时讲解；当前任务没有客户时，先让用户选择。 - 当前对话已经明确且仍然有效的项目、页面、客户和使用目的可以继续使用；智能体必须向用户显示实际使用的对象，不能静默带入同名对象或其他项目对象。 - 缺少必要参数时，智能体只补问当前快捷操作需要的信息，不要求用户理解页面地址或内部参数。 - 用户选择快捷操作时，系统重新检查当前项目、权限、页面状态、最新保存内容和该操作对应的主 PRD 规则；AI 回答生成时可用不表示点击时仍然可用。 系统内部页面地址、客户访问地址和现场讲解页面是三种不同目标： | 目标 | 使用者 | 用途 | 是否作为客户访问地址 | |---|---|---|---| | 系统内部页面 | VISTA Link 用户 | 查看和操作客户、素材、分享页面、统计及系统设置 | 否 | | 客户访问页面 | 购房客户；销售可以预览 | 通过固定链接或指定客户访问地址查看最新保存内容 | 是 | | 现场讲解页面 | 销售人员 | 开始、继续和结束现场讲解，并形成独立讲解记录 | 否 | 现场讲解页面是可以单独进入的 VISTA Link 业务页面，归属 B 端现场讲解能力。该页面可以复用客户访问页面的内容展示规则，但开始、继续、结束、客户关联和讲解记录不属于购房客户访问端。普通客户访问页面不显示讲解操作，也不需要理解讲解状态。 用户从智能体选择「进入现场讲解」时，系统进入专门的现场讲解页面；开始和结束讲解继续由该页面按主 PRD §4.3.8 执行。智能体只负责推荐页面、补充进入所需参数和提供入口，不能把打开普通客户访问页面写成已经开始现场讲解。 ### 4.7 工作文件夹和会话组织 内置智能体为用户提供工作文件夹，用于整理多个会话。用户可以按客户名称、工作主题或自己的习惯命名文件夹。销售人员、销售经理、营销企划和项目管理员都可以在自己有权使用的内置智能体中使用工作文件夹，规则相同。工作文件夹不是 VISTA Link 项目，不改变主 PRD 的项目、成员、角色、权限或业务数据范围。本能力优先级为 P1，不改变当前内部 MVP 范围。 - 每个工作文件夹只属于当前用户和一个明确的 VISTA Link 项目，不在团队成员之间共享。 - 工作文件夹只保存名称和会话所属关系，不关联客户、素材、页面或其他业务对象。 - 文件夹名称可以使用客户姓名，但该名称只是用户自己的分类，系统不能据此确定当前会话实际使用的客户。 - 会话实际使用的客户、素材、页面或其他业务对象，必须根据用户在当前会话中的明确输入、当前打开的业务页面或用户随后作出的选择确定。 - 一个工作文件夹可以包含多个会话；一个会话最多属于一个工作文件夹，也可以不放入任何文件夹。 - 用户可以在工作文件夹中创建新会话，也可以把同一项目内已有会话移入、移出或改放到其他工作文件夹。 - 工作文件夹和其中会话不能移动到其他 VISTA Link 项目；切换项目后，只显示目标项目中的工作文件夹和会话。 - 用户可以创建、重命名和删除自己的工作文件夹。 - 删除工作文件夹时，其中会话改为不属于任何文件夹；客户、页面、素材、访问记录、讲解记录和其他业务数据不删除。 创建工作文件夹时，用户只填写名称，系统创建一个空文件夹。创建文件夹不能同时移动当前会话，也不能根据当前客户自动创建文件夹。 用户失去整个项目的访问权后，不能查看该项目中的工作文件夹和会话；项目访问恢复后，按最新角色和权限重新检查。项目停用或删除时，工作文件夹和会话不形成脱离项目的独立副本，其可见性和数据保留继续使用主 PRD 的项目规则。 --- ## 5. 共通产品规则 ### 5.1 不建立第二套业务规则 - 客户字段、素材分类、Widget 规则、页面规则、固定链接规则和统计公式继续由各自正式需求定义。 - AI 需求只规定智能体如何读取、组合、解释和调用这些能力。 - 人工不能执行的操作，智能体也不能执行。 - 人工操作和智能体操作不能产生两种不同含义的业务结果。 ### 5.2 项目必须明确 - 所有查询和操作都属于一个明确的当前项目。 - 智能体不得只凭上一次对话猜测项目。 - 用户可以访问多个项目时，智能体应使用用户明确指定的项目；无法确定时让用户选择。 - 不允许在一次页面制作中混用不同项目的客户、素材、Widget 或页面。 - 项目切换后，后续操作使用新项目的角色和权限。 ### 5.3 事实、解释和建议分开 - 客户标签、购房意向和备注属于销售已经保存的信息。 - 用户在当前对话中补充的客户情况属于本次任务输入。 - 访问次数、浏览内容、有效时长和明确动作属于行为记录。 - 智能体可以根据事实给出选材或跟进建议，但必须说明依据。 - 智能体不能把建议写成客户已经确认的事实。 ### 5.4 自动准备不等于自动发送 - 智能体可以查找素材、组装页面、保存页面并取得访问地址。 - 页面保存成功不表示客户已经收到。 - VISTA Link 不自动发送销售消息。 - 智能体应把页面和访问地址交给销售，由销售在外部工具中发送。 ### 5.5 能用确定规则完成时不用 AI 判断 - 项目范围、权限、对象状态、Widget 候选范围、页面检查、统计公式和客户重复检查继续使用确定的系统规则。 - AI 可以解释规则结果和准备修改方案，但不能替代系统校验。 - 客户访问次数、页面排行和客户排行直接使用正式计算结果，不由 AI 重新计算另一套结果。 - 讲解记录是否未关联、未正常结束或已经标记无效，直接使用记录状态，不由 AI 猜测。 - AI 不得为了显示“智能”而新增标签、分数、阶段、风险等级或业务状态。 ### 5.6 AI 结果必须能核对和纠正 - 客户摘要、行为摘要、选材理由和后续建议必须能返回对应客户资料、讲解记录、访问记录、素材或页面。 - 事实、用户临时输入、AI 整理结果和 AI 建议必须分开显示。 - 用户可以修改或驳回 AI 草稿和建议。 - 用户驳回建议不修改原始事实，也不自动修改客户标签、状态或资料。 - AI 结果缺少可查看依据时，只能说明资料不足，不能给出确定结论。 - 访问摘要和后续建议只能使用主 PRD 中状态正常的访问数据及部分缺失数据中可以确认的记录；异常数据不得作为建议依据。 - 待检查、异常和已排除的访问数据不得作为新的摘要、排序或建议依据。 - 每项访问摘要和后续建议都必须保留生成时实际使用的访问、内容、统计范围、数据状态和数据最后更新时间。 - 依据记录的客户归属、数据状态或可确认内容发生变化时，原 AI 结果标记为「依据已变化」。 - 「依据已变化」的结果保留在 AI 工作记录中，但不能继续采用、修改、合并或用于准备页面。 - 用户可以按最新有效数据重新生成；新结果不覆盖原结果和原处理记录。 - 历史访问对象与当前素材、页面或 Widget 状态不一致时，必须分开展示「访问记录中的对象和参数」与「当前可用情况」；访问记录不能用来还原或回放当时的完整页面。 - AI 不可用、超时或生成失败时，原有客户、素材、页面、讲解记录和统计页面继续可用。 ### 5.7 确定规则、AI 判断和人工审核的分工 - 确定规则负责当前项目、权限、对象状态、页面是否已经保存且可用、Widget 和素材候选范围、统计公式、重复检查、内容变化检查和操作记录。 - AI 负责自然语言理解、资料整理、条件比较、匹配程度、候选排序、缺失信息识别、草稿生成和建议说明。 - 人工负责检查 AI 依据，确认客户真实情况，选择候选结果，并决定正式保存、关联、状态修改和对外发送。 - AI 输出的匹配、摘要、草稿和建议首先是待审核结果；未经用户确认，不能成为客户事实或引起正式业务数据变化。 - 只读回答可以直接展示，但用户应能查看依据和提出纠正；用户根据回答采取正式操作时，仍按写入确认规则执行。 - 确定规则已经能够得到唯一结果时，直接使用规则结果，不再由 AI 重新判断。 --- ## 6. 授权与权限 ### 6.1 用户授权 - 用户必须明确允许某个智能体或命令行程序使用自己的 VISTA Link 能力。 - AI 使用授权与普通网页登录状态可以分别查看和撤销。 - 授权时可以限定一个或多个可访问项目。 - 授权时可以分别选择只读能力和写入能力；未授权写入时，智能体只能查询和准备草稿，不得修改正式业务数据。 - 授权具有明确的有效期限；到期后需要用户重新授权。 - 用户可以查看已经连接的智能体和命令行程序。 - 用户可以撤销单个连接。 - 授权过期、被撤销、用户停用或项目成员停用后，对应智能体不能继续访问。 - 用户密码不得交给智能体保存。 ### 6.2 权限判断 - 智能体权限不得超过当前用户权限。 - 用户允许智能体读取客户，不表示智能体可以读取用户本人无权查看的客户。 - 每次操作都要使用最新的项目成员状态、角色和功能权限。 - 用户权限变化后，智能体下一次操作立即使用新权限。 - 无权执行的能力不应继续返回目标数据或修改结果。 ### 6.3 数据范围 - 客户、标签、素材、Widget、页面、固定链接、访问记录、统计、成员、角色和操作记录都使用当前项目范围。 - 内部素材预览继续受登录、项目和素材权限限制。 - 智能体不能把内部素材预览地址作为客户分享地址。 - 客户联系方式、购房意向、备注和行为记录只返回完成当前任务所需的内容。 --- ## 7. 语言规则 ### 7.1 产品支持语言 - VISTA Link 产品只支持日文和英文。 - 本 PRD 使用简体中文，仅供内部需求评审、设计和开发使用。 - VISTA Link 不承诺提供简体中文的界面、系统说明或错误信息。 ### 7.2 智能体回答语言 - 用户明确指定日文或英文时，智能体使用指定语言回答。 - 用户没有指定时，智能体优先使用用户当前输入所使用的日文或英文。 - 当前输入无法判断时，依次使用用户保存的 VISTA Link 语言、当前项目默认语言和日文。 - 用户在对话中切换日文和英文后，智能体后续回答跟随最新明确语言。 - 日文和英文以外的输入不属于 VISTA Link 保证范围。外部智能体是否使用其他语言回答，由外部智能体自行决定。 ### 7.3 系统信息和业务内容 - 能力名称、字段说明、状态名称、固定提示和错误信息提供日文与英文。 - 稳定对象标识、状态代码和业务数值不随显示语言改变。 - 素材名称、素材说明、客户备注、购房意向、页面名称和页面内容保留原文。 - VISTA Link 不自动翻译用户输入或项目内容。 - 项目素材本身是日文时，智能体直接使用日文原文，不需要由 VISTA Link 再生成一份日文副本。 - 外部智能体自行把日文或英文内容翻译成其他语言时，该翻译只属于智能体回答，不写回 VISTA Link。 --- ## 8. 智能体需要理解的业务对象 ### 8.1 共通信息 主要对象需要提供： - 稳定对象标识。 - 所属项目。 - 对象类型。 - 名称或显示名称。 - 当前状态。 - 创建时间和更新时间。 - 当前版本或可判断变化的信息。 - 用户是否可以查看、修改或删除。 - 与其他对象的关系。 ### 8.2 客户 智能体需要理解： - 客户姓名和稳定标识。 - 客户状态、标签和负责人。 - 购房意向和备注。 - 当前任务允许读取的联系方式。 - 客户是否有访问记录和客户追踪数据。 家庭情况、生活偏好、学校、通勤、景观和预算敏感等内容目前可以记录在客户标签、购房意向或备注中。智能体必须说明实际使用了哪些信息，不能把缺失内容当作已经保存。 ### 8.3 素材 智能体需要理解： - 素材名称、分类、标签和说明。 - 来源系统、来源版本和更新时间。 - 结构化业务属性。 - 上线、更新、下线或删除状态。 - 内部预览是否可用。 - 哪些 Widget 可以使用该素材。 ### 8.4 Widget 智能体需要理解： - Widget 标识、名称和启停状态。 - 候选素材范围。 - 素材数量和组合限制。 - 必需内容。 - 可编辑内容和展示形式。 - 删除和重复添加规则。 - 保存前检查规则。 Widget 规则以 Widget 自身需求和当前正式配置为准。智能体不能根据 Widget 名称猜测配置方式。 ### 8.5 页面和固定链接 智能体需要理解： - 页面名称、备注、封面和创建来源。 - 创建人和当前保存状态；A 端来源页面还包括用于识别来源内容变化的更新标记，该标记不是 B 端页面历史版本。 - Widget 实例、顺序、素材和配置。 - 页面是否可以编辑、复制或删除。 - 固定链接地址、启用状态和公开状态。 - 页面和客户的关联关系。 - 素材更新、下线、删除和 Widget 停用对页面的影响。 分享页面是否支持客户访问和现场讲解不由创建人逐页配置。分享页面类型固定支持主 PRD 已定义的页面详情、固定链接、客户页面预览和现场讲解能力；每项操作当前是否可用，只按与该操作有关的页面状态、最新保存内容、固定链接状态、当前用户权限和必需参数判断。 智能体返回页面对象时，需要取得： - 当前项目和页面唯一标识。 - 页面名称、来源、当前状态和最新保存时间。 - 当前用户可以执行的固定快捷操作及不可用原因。 - 当前快捷操作需要且已经明确的客户、地址类型和其他必要业务参数。 页面对象数量和用户说法可以变化，但系统支持的页面类型、快捷操作和每项操作的必需参数必须能够预先列出和测试。 ### 8.6 客户追踪和营销统计 智能体读取统计时需要取得： - 查询项目。 - 时间范围和时区。 - 数据最后更新时间。 - 使用的筛选条件。 - 指标名称、数值和正式计算口径。 - 对应客户、页面和实际内容。 - 数据缺失、延迟或失败状态。 ### 8.7 现场讲解记录 智能体需要理解： - 现场讲解、普通预览和客户自主访问是三种不同记录。 - 讲解人、关联客户、开始和结束情况，以及实际打开内容。 - 实际打开内容、打开次数和可靠的页面前台展示时长。 - 记录是进行中、正常结束、未正常结束还是无效讲解。 - 客户关联修改历史、修改理由、操作人和操作时间。 - 讲解记录只证明销售展示过什么，不证明客户关注、喜欢或确认了什么。 ### 8.8 项目总览 智能体需要理解： - 当前项目和项目总览的时间范围。 - 客户、页面、固定链接和负责人总体数据。 - 数据最后更新时间、空状态、部分失败和不可计算状态。 - 项目总览只提供总体情况，不包含客户活动明细、访问趋势或排行。 ### 8.9 工作文件夹和会话 智能体需要理解： - 工作文件夹所属用户和 VISTA Link 项目。 - 工作文件夹名称和包含的会话。 - 会话是否属于工作文件夹，以及会话当前使用的实际业务对象。 - 文件夹名称不能用来推断会话的实际业务对象。 - 文件夹删除和项目切换对会话组织的影响。 --- ## 9. 智能体可使用的业务能力 本章描述完整产品目标，不表示所有能力都进入首批验证。首批内容以 §18.1 为准，§18.2 所列能力属于后续内容。 ### 9.1 项目和能力查询 - 查询当前用户。 - 查询可访问项目。 - 选择和切换当前项目。 - 查询当前项目中的角色和权限。 - 查询当前可用能力及其用途。 - 查询对象字段、状态和可用筛选条件。 ### 9.2 客户能力 - 浏览和搜索客户。 - 按主 PRD 已支持的姓名、标签和状态条件筛选。 - 读取客户详情。 - 创建和编辑客户。 - 修改客户状态、标签和负责人。 - 新建、修改、合并和删除客户标签。 - 导入和导出客户。 - 删除客户。 - 读取客户与固定链接的关系。 上述操作继续使用客户管理中的权限、重复检查、删除和操作记录规则。 关联业务系统已经向 VISTA Link 提供预约事实时，智能体可以按当前项目和用户指定的时间范围读取客户、预约时间、预约来源和本次备注，用于查找近期预约客户和准备接待。智能体不能创建、修改或确认预约，也不能把预约写成客户已经到访。预约信息无法明确关联现有客户时，智能体必须说明限制，不能据此修改客户资料。 ### 9.3 素材能力 - 浏览和搜索素材。 - 按名称、分类和标签筛选。 - 读取素材详情、状态和内部预览。 - 读取来源端已经提供的结构化业务信息，并在用户指定条件时比较候选素材；这不增加 B 端素材列表的筛选项。 - 修改素材说明。 - 给素材添加或移除标签。 - 新建、修改、合并和删除素材标签。 - 查询指定 Widget 的候选素材。 智能体不能创建来源素材、改变素材分类或修改来源系统数据。 ### 9.4 Widget 能力 - 查询当前可选 Widget。 - 查询 Widget 使用规则。 - 查询指定 Widget 的候选素材。 - 检查 Widget 内容、素材、数量和展示形式。 - 返回不能使用某项素材的具体原因。 ### 9.5 页面能力 - 浏览和搜索页面。 - 读取页面详情。 - 准备新页面方案和预览。 - 从允许复制的页面准备修改方案和预览。 - 添加、删除和排序 Widget。 - 为 Widget 选择素材。 - 修改允许编辑的内容和展示形式。 - 检查页面规则。 - 生成页面预览。 - 按用户确认内容新建分享页面。 - 按用户确认内容修改用户有权编辑的页面。 - 保存用户有权新建或编辑的页面。 - 删除用户有权删除的页面。 - 返回具体页面当前可用的固定快捷操作和不可用原因。 - 使用当前任务已经明确且为所选快捷操作所需的项目、页面、客户、地址类型和其他必要参数。 ### 9.6 固定链接能力 - 读取页面固定链接和状态。 - 取得无参数固定链接。 - 为指定客户取得访问地址。 - 取得二维码所需内容。 - 查询链接关联客户。 - 设置或取消公开访问。 - 启用或停用固定链接。 取得访问地址不表示已经发送。智能体回答不能把关联客户写成实际发送记录。 智能体提供「复制客户访问地址」时，复制结果必须是主 PRD 定义的无参数固定链接或指定客户访问地址，不能复制系统内部页面地址或现场讲解页面地址。当前任务无法确定地址类型时，智能体必须先让用户选择；用户选择指定客户访问地址但尚未明确客户时，再让用户选择客户。 ### 9.7 客户追踪能力 - 查询产生过客户自主访问或已关联有效现场讲解的客户。 - 读取单个客户累计访问数据。 - 按固定链接和时间查看访问趋势。 - 查看客户实际浏览的页面和内容。 - 查看浏览次数、有效时长和明确动作。 - 查看单次访问中的浏览顺序。 - 从统计结果继续查看客户追踪记录。 - 查询已关联客户的有效现场讲解，并与客户自主访问明确区分。 - 汇总指定时间内的客观事实并返回原始记录入口。 - 根据客观事实准备后续页面或沟通重点建议，但不生成客户分数或修改客户状态。 ### 9.8 营销统计能力 - 按正式支持的时间范围查询。 - 按客户负责人筛选。 - 查询整体访问情况。 - 查询页面排行和客户排行。 - 查询页面中的内容浏览情况。 - 查询浏览某项内容的客户。 - 返回统计数据更新时间和正式指标说明。 ### 9.9 系统设置和操作记录能力 - 查询项目成员、角色和功能权限。 - 邀请或修改项目成员。 - 启用或停用项目成员。 - 查询、创建、修改和删除自定义角色。 - 查询操作记录。 成员、角色和权限操作只允许具备对应系统设置权限的用户执行。 ### 9.10 现场讲解能力 - 查询当前用户自己的讲解记录。 - 查询未关联客户、未正常结束或已经标记无效的记录。 - 读取讲解详情和客观展示摘要。 - 根据用户明确指定的客户准备关联或修改关联。 - 修改已经关联的客户时要求用户填写理由，并保留修改历史。 - 根据用户明确决定准备继续讲解、结束异常讲解或标记无效。 - 为具体已保存页面准备现场讲解入口，并在需要时补问已有客户或临时讲解。 - 现场讲解的开始、继续、内容展示和结束仍在专门的 VISTA Link 现场讲解页面中进行；智能体不代替销售向客户讲解。 智能体不能根据页面内容、讲解时长或打开次数自行选择关联客户，不能自行把记录标记无效，也不能把讲解内容写成客户兴趣。 ### 9.11 项目总览能力 - 查询当前项目的总体数据和时间范围。 - 查询负责人分布。 - 说明数据更新时间、缺失或失败状态。 - 返回客户管理、页面库、购房客户追踪或营销统计的可用详情入口。 智能体不能从项目总览生成销售排名、销售好坏判断、客户分数、意向等级或转化率。 ### 9.12 工作文件夹能力 - 查询当前用户在当前项目中的工作文件夹。 - 创建空的工作文件夹。 - 重命名工作文件夹。 - 在工作文件夹中创建新会话。 - 把同一项目内会话移入、移出或改放到其他工作文件夹。 - 删除工作文件夹，并把其中会话改为不属于任何文件夹。 工作文件夹操作不能修改客户、页面、素材、访问记录、讲解记录、项目成员、角色或权限。智能体不能跨项目读取、移动或合并工作文件夹和会话。 --- ## 10. 页面准备和保存 ### 10.1 当前页面方案 智能体可以在当前会话中准备页面方案并生成预览，但不把未确认方案保存为独立业务对象，也不提供可跨会话继续编辑的页面草稿。 当前页面方案可以包含： - 所属项目。 - 来源方式：空白创建、复制页面或修改现有页面。 - 页面名称、备注和封面。 - Widget 实例、顺序、内容、展示形式和素材。 - 页面检查结果。 - 选材依据和对应来源。 - 用户已经修改或驳回的建议。 页面方案规则： - 页面方案只用于当前会话中的准备、修改和预览，不创建固定链接，客户不能访问。 - 页面方案不是 VISTA Link 中已保存的分享页面，也没有独立标识、版本、列表、详情、删除或恢复功能。 - 用户结束当前准备过程、刷新或关闭页面、退出登录、切换项目、换设备或删除会话后，未保存页面方案不再作为可编辑内容保留；重新打开同一会话只能查看会话记录，不能恢复或继续编辑这份未保存页面方案。 - 保存前必须重新检查当前权限、目标页面、Widget 和素材状态。 - 新建页面保存成功后，按主 PRD §4.3.4 创建分享页面和唯一固定链接；固定链接立即使用最新保存内容。 - 修改已有页面时，保存前必须重新读取目标页面；目标页面已经变化时不能直接覆盖，必须让用户检查更新后的预览。 - 保存成功后，AI 工作记录可以记录保存结果和目标页面，但不能把保存前方案继续当作未保存内容重复提交。 ### 10.2 页面组装 智能体制作页面时应： 1. 确认项目和用户权限。 2. 确认页面目的和目标客户。 3. 读取可选 Widget 和使用规则。 4. 搜索当前项目素材。 5. 说明客户条件与选材依据。 6. 只使用 Widget 允许的素材。 7. 生成当前页面方案并执行页面检查。 8. 生成页面预览。 9. 按智能体确认规则说明将保存的页面、主要变化和固定链接影响。 10. 用户明确同意后保存页面；新建页面按主 PRD 创建固定链接，已有页面保留原固定链接，固定链接立即使用最新保存内容。 11. 用户要求给客户准备访问地址时，按权限选择客户并取得访问地址；取得地址不表示已经发送。 用户确认只对当前预览内容有效。预览内容、目标页面、Widget、素材或权限发生变化时，必须重新预览并重新确认。 ### 10.3 AI-PAGE-01 为客户查找或准备页面 **触发说法：** - 「给李娜找一份下午讲解用的页面。」 - 「给李娜找一份页面，没有合适的就帮我准备一份。」 - 「根据李娜最近关心的通勤和三居室，准备下一次发送的页面。」 **必需信息：** - 当前项目。 - 目标客户，或本次任务使用的临时客户描述。 - 使用目的：现场讲解、远程发送或到访后补充资料。 - 用户明确提出的条件和限制。 **页面可用性先使用确定规则检查：** - 页面属于当前项目。 - 用户具备查看页面的权限。 - 页面没有删除，并且存在可用的最新保存内容。 - 页面和固定链接状态满足用户准备执行的下一步操作。 - 需要调整页面时，用户具备复制或编辑对应页面的权限。 通过确定规则的页面再由 AI 判断与客户条件和本次目的的相关程度。结果分为： 1. 完全匹配：页面可以直接用于本次目的，没有需要调整的关键内容。 2. 部分匹配：页面有可复用内容，但缺少用户明确要求的内容，或包含本次不需要的内容。 3. 没有匹配：没有可用页面满足本次的主要条件。 ```mermaid flowchart TD START["用户要求为客户找页面"] --> CONTEXT{"项目、客户和使用目的是否明确"} CONTEXT -->|否| ASK["补问缺少的必要信息"] ASK --> CONTEXT CONTEXT -->|是| PERMISSION["检查客户、页面和素材权限"] PERMISSION -->|不可用| DENY["说明缺少的权限并返回可用入口"] PERMISSION -->|可用| FACTS["读取已保存客户资料、临时描述和允许使用的历史事实"] FACTS --> SEARCH["先搜索当前项目内可用的已保存页面"] SEARCH --> MATCH{"匹配结果"} MATCH -->|完全匹配| EXACT["展示候选页面和匹配依据"] MATCH -->|部分匹配| PARTIAL["展示可复用内容、缺少内容和不适用内容"] MATCH -->|没有匹配| INTENT{"用户是否已要求没有合适页面时准备新页面"} PARTIAL --> CHOICE{"用户选择直接使用还是调整"} CHOICE -->|直接使用| EXACT CHOICE -->|调整| EDITABLE{"是否允许复制或编辑该页面"} EDITABLE -->|否| ALTERNATIVE["说明限制并返回其他候选或新建选项"] EDITABLE -->|是| SOURCE["按现有页面准备修改方案"] INTENT -->|否| OFFER["说明没有匹配并询问是否准备新页面"] OFFER -->|取消| END["结束任务，不创建页面"] OFFER -->|准备| SOURCE2["使用自由模板准备新页面方案"] INTENT -->|是| SOURCE2 ALTERNATIVE --> INTENT SOURCE --> RULES["读取 Widget 规则和当前候选素材"] SOURCE2 --> RULES RULES --> DRAFT["生成页面方案、选材理由和资料缺口"] DRAFT --> VALIDATE{"页面检查是否通过"} VALIDATE -->|否| REVISE{"是否存在可用替代内容"} REVISE -->|是| DRAFT REVISE -->|否| MISSING["说明缺少的 Widget 或素材，不保存页面"] VALIDATE -->|是| PREVIEW["展示预览、依据和警告"] PREVIEW --> REVIEW{"用户审核结果"} REVIEW -->|修改| DRAFT REVIEW -->|取消| END REVIEW -->|确认| RECHECK["重新检查页面、Widget、素材和权限"] RECHECK -->|失败| DRAFT RECHECK -->|通过| LIVE["保存页面并立即更新固定链接内容"] EXACT --> SELECT{"用户选择页面、要求调整或取消"} SELECT -->|选择页面| NEXT SELECT -->|要求调整| EDITABLE SELECT -->|取消| END LIVE --> NEXT NEXT -->|现场讲解| PRESENT["提供 VISTA Link 现场讲解入口，由销售开始"] NEXT -->|准备访问地址| ADDRESS["按权限取得无参数或指定客户访问地址"] ADDRESS --> SEND["交给销售在外部工具发送"] FACTS -->|读取失败| FALLBACK["保留用户输入并返回原人工操作入口"] DRAFT -->|AI 生成失败| FALLBACK ``` **流程规则：** - 用户只说「找一个页面」时，没有匹配结果不能直接创建页面；AI 应先询问是否准备新页面。 - 用户已经说「没有合适的就准备一份」时，没有匹配结果可以直接准备当前页面方案，但保存仍需确认。 - 完全匹配和部分匹配不是新的页面状态，只是本次 AI 任务的判断结果。 - AI 必须先排除无权限、已删除、尚未保存、来源不可用或不适用于下一步操作的页面，再判断内容是否匹配。 - AI 不能为了得到匹配结果而跨项目使用页面或素材，也不能修改 Widget 候选范围。 - 部分匹配页面不能直接覆盖原页面；只能按用户已有的复制或编辑权限准备页面方案。 - 找到页面或保存页面后，AI 可以继续准备现场讲解入口或访问地址，但不能自动开始讲解，也不能自动发送给客户。 - AI 返回具体页面时，同时返回该页面当前可用的固定快捷操作；快捷操作的名称、必需参数和目标业务能力必须来自系统预先登记内容。 - 用户选择快捷操作后，系统使用当前任务中已经明确且仍有效的参数；参数不足时先补问，参数齐全后再进入对应原有页面或业务操作。 --- ## 11. 客户画像和素材选择 ### 11.1 信息来源 智能体可以使用两类客户信息： 1. VISTA Link 已经保存的客户标签、购房意向、备注和客户追踪记录。 2. 用户在当前对话中明确提供的临时描述。 两类信息必须分开说明。 ### 11.2 临时客户描述 - 年龄、家庭成员和其他未设置为固定字段的信息，可以直接用于本次选材和页面制作。 - 临时描述默认只用于当前任务，不自动写入客户资料。 - 智能体可以建议把某项信息保存为客户标签。 - 用户明确同意后，智能体才能写入标签。 - 临时描述与已保存资料冲突时，智能体必须指出冲突并询问本次使用哪一项。 - 智能体不得根据年龄和家庭情况推断收入、预算、婚姻关系或购买意愿。 ### 11.3 客户条件与素材的关系 - VISTA Link 不维护固定的客户条件与素材标签对应表。 - 智能体根据当前任务解释客户条件，并选择相关素材标签、分类和结构化属性。 - 智能体必须说明本次使用了哪些客户信息，以及这些信息怎样影响选材。 - 没有足够数据时，智能体应说明限制或向用户补问。 - 智能体不能为了找到结果而修改素材分类或编造客户标签。 ### 11.4 客户资料修改建议 - 智能体可以把用户明确说出的客户情况整理为购房意向、备注和客户标签候选。 - 每一项候选修改必须显示用户原始说法、准备写入的字段和写入内容。 - 来自现场讲解记录或客户自主访问的行为不能直接变成客户资料；只有销售明确补充的客户反馈可以进入候选修改。 - 用户可以逐项确认、修改或取消，未确认项不写入。 - 客户状态只能由用户根据实际沟通或外部业务结果选择当前项目内未停用状态；智能体不能建议一条强制变化顺序，也不能自动修改。 --- ## 12. 客户追踪和统计问答 ### 12.1 统计指标 - 活跃客户、客户排行、页面排行和内容排行的指标、公式、默认时间范围和排序由营销统计需求定义。 - AI 需求不新增统计公式。 - 智能体使用正式统计结果，并说明时间范围、指标名称、排序依据和数据更新时间。 - 正式统计没有某个指标时，智能体不能自行发明。 - 营销统计只包含客户自主访问，不包含现场讲解；回答营销统计问题时不能把现场讲解混入访问排行。 - 待跟进客户列表的最近活跃和最近行为可以包含有效现场讲解；回答客户跟进问题时必须标明来源是「现场讲解」还是「客户自主访问」。 ### 12.2 “主要感兴趣内容”的表达 用户询问客户“主要对什么感兴趣”时，智能体应使用以下客观表达： - 最近主要浏览的内容。 - 浏览次数较多的内容。 - 累计有效浏览时长较长的内容。 - 多次查看的页面或素材。 - 已经触发的明确动作。 智能体不能把这些行为直接写成客户已经确认的购买需求。 ### 12.3 “最值得跟进”的表达 - VISTA Link 当前不提供“最值得跟进”分数、意向等级或系统跟进优先级。 - 智能体不能把“最值得跟进”伪装成现有统计指标。 - 智能体可以先返回正式客户排行，再根据客观记录给出“建议销售优先查看”的客户和原因。 - 每条建议必须附带访问或内容浏览依据。 - 建议不修改客户状态、标签或负责人，也不表示客户更可能购买。 ### 12.4 回答结构 统计回答至少包含： - 当前项目。 - 时间范围和时区。 - 使用的正式指标和排序。 - 数据最后更新时间。 - 客户和主要数值。 - 主要浏览页面或内容。 - 明确动作。 - 数据缺失、延迟和判断限制。 - 可以继续打开的客户追踪记录。 - 行为来源：现场讲解或客户自主访问。 - 建议对应的原始记录入口。 明细记录与汇总结果不一致、时间顺序异常或关键对象缺失时，回答必须单列“数据异常”，说明哪些异常记录已被排除，并分别显示正式数据中能够确认的数值和不能确认的部分。异常记录本身不得进入摘要、排序或建议依据；智能体也不能为了生成完整结论而隐去异常。 同一回答同时使用现场讲解和客户自主访问时，必须分开列出。现场讲解只能说明销售展示了什么；客户自主访问只能说明客户实际浏览或操作了什么。两者都不能直接证明客户购买意向。 ### 12.5 访问后建议的返回内容 根据客户自主访问给出询问方向、资料建议或页面方案时，每项结果至少包含： - 客观记录：客户、时间范围、分享页面、访问次数、实际浏览内容、有效时长和明确动作。 - 建议内容：建议销售询问的问题、准备的资料或可继续使用的页面。 - 建议依据：可以返回对应客户追踪、单次访问、内容或素材记录的入口。 - 当前可用情况：历史访问中的页面、内容、素材和 Widget 当前是否仍可用，以及是否已经更新。 - 数据限制：部分缺失的访问记录、无法读取的依据、统计延迟及不能由浏览行为确认的客户事实。 - 用户选择：采用建议、修改建议、忽略建议，或根据建议继续准备页面。 - 当前同一客户存在两条以上依据仍然有效的建议时，用户可以选择合并；AI 先生成一份合并草稿，由用户修改、采用或取消。 采用建议只表示用户选择继续使用该建议，不表示销售已经联系客户、已经发送资料或客户已经回复。建议引起页面保存或其他正式写入时，仍按对应业务操作取得用户确认并记录实际结果。 合并建议只整理建议内容，不合并、修改或补造客户资料、访问事实和统计结果。任一被选建议的依据已变化时，不生成合并草稿。 ### 12.6 历史访问与当前事实检查 - 历史访问使用主 PRD 保存的访问行为记录，说明客户实际浏览或操作过的对象，不用当前对象改写历史，也不声称系统保存了可重新展示的旧页面。 - 建议客户下一步可以使用的资料或页面时，必须重新检查当前项目、用户权限、页面保存状态、素材上下线和删除状态及 Widget 启停状态。 - 客户历史浏览的页面或素材已下线、删除或当前不可用时，智能体可以说明该历史事实，但不能把原对象直接放入新页面或建议继续发送。 - 历史记录所指向的对象与当前内容发生变化时，智能体分开说明访问记录中的对象和参数、当前可用内容，并把是否继续使用交给用户决定；不能声称系统能够回放客户当时看到的完整页面。 - 涉及价格、房源状态、预约结果、联系结果、申请或签约时，只能使用主 PRD 或关联业务系统明确提供的当前事实；数据缺失、过期或冲突时，不生成确定说法，并说明需要人工确认的内容。 --- ## 13. 写入前确认 ### 13.1 确认责任 第一阶段不为 AI 新增专用确认页面或确认凭据。写入前确认由官方 Skill 和内置智能体规则负责。 智能体必须： 1. 准备将要写入的内容。 2. 向用户展示项目、目标对象、主要变化和影响。 3. 等待用户针对当前内容明确同意。 4. 用户拒绝、要求修改、没有明确回答或确认后内容发生变化时，不执行写入或重新确认。 VISTA Link 服务端继续执行用户身份、项目、权限、对象状态、版本和业务规则检查，并记录实际写入结果。 ### 13.2 需要确认的操作 - 新建分享页面。 - 修改并保存分享页面。 - 删除正式页面。 - 创建、修改、合并或删除客户标签和素材标签。 - 给客户或素材添加、移除标签。 - 修改客户资料、状态或负责人。 - 创建或删除客户。 - 改变固定链接公开状态或启用状态。 - 建立客户与固定链接关系。 - 关联或修改现场讲解的客户；修改已有客户关联时必须同时填写理由。 - 结束未正常结束的讲解或把讲解标记为无效。 - 修改成员、角色或权限。 - 其他会创建、修改、删除数据或改变访问范围的操作。 ### 13.3 确认内容 确认说明至少包含： - 当前项目。 - 操作类型。 - 目标对象。 - 新建或修改的主要内容。 - 页面使用的 Widget 和素材。 - 已发现的错误和警告。 - 是否会创建固定链接或改变客户访问范围。 - 用户可以选择确认、修改或取消。 当前页面方案内部的搜索、选材和排序不需要每一步确认。保存页面时按实际影响确认。 用户明确提出“帮我准备一个页面”或“帮我准备一个草稿”时，智能体可以在当前会话中准备和更新页面方案，不再对每次搜索、排序和方案内部调整重复确认。保存页面或修改其他正式业务数据时，仍必须按本章确认。 AI 不能代替用户确认客户状态、客户反馈、讲解客户关联、无效讲解、预约、到访、认购或签约等事实。主 PRD 未包含的事实记录不能通过 AI 新增。 批量操作规则： - 多个页面、客户或标签可以合并为一次确认。 - 智能体必须展示总数量、目标对象、共同变化和存在差异的项目。 - 用户确认后，目标对象或写入内容发生变化时必须重新确认。 - 部分项目失败后，只重试原确认内容中的失败项目时不重复询问；目标或内容变化时重新确认。 --- ## 14. 错误和恢复 | 情况 | 产品要求 | |---|---| | 用户未授权 | 说明需要的授权，不返回目标数据 | | 没有项目访问权 | 拒绝访问，不自动切换到其他项目 | | 多个对象同名 | 返回候选对象，让用户选择 | | 对象不存在 | 说明对象类型和查找条件，不用相似对象替代 | | 没有符合条件的数据 | 返回空结果和实际使用的条件 | | 数据读取失败 | 返回失败和重试方式，不能写成没有数据 | | 统计数据延迟 | 返回数据更新时间和延迟状态 | | 访问数据部分缺失 | 只使用能够确认的访问和行为，在结果中说明缺失范围，不补造次数、时长或操作 | | 访问数据待检查 | 不作为新的摘要、排序或建议依据，说明需要先处理数据问题 | | 访问数据异常 | 不把异常数据作为客户摘要或建议依据，说明本次回答已排除异常数据 | | 访问数据已排除 | 不作为新的摘要、排序或建议依据，不把排除前结果当作当前事实 | | AI 结果依据已变化 | 标记「依据已变化」，保留历史记录，不允许继续采用、修改、合并或准备页面，提供按最新数据重新生成的选择 | | 历史访问内容已更新或不可用 | 分开展示历史内容和当前状态；不把已下线、已删除或当前不可用内容直接放入新页面 | | 素材下线或删除 | 不放入新页面，已有页面按现有规则提示 | | Widget 停用 | 不新增停用 Widget，已有实例按现有规则处理 | | 页面最新保存内容变化 | 停止保存，重新读取页面并让用户检查变化 | | 写入结果不明确 | 先查询原操作结果，不能直接重复创建 | | 部分操作失败 | 分别返回成功项、失败项和可以重试的项目 | | 智能体中断 | 已保存内容保持不变；未保存页面方案不写入业务数据，用户可以在当前会话仍可继续时重试 | | 授权被撤销 | 停止后续读取和写入 | | 对应基础能力尚未提供 | 说明依赖的主 PRD 功能和当前不可执行的步骤，不用 AI 结果代替正式数据 | | AI 生成失败或超时 | 保留当前会话中仍可用的用户输入，提供重试或返回原有人工页面的入口 | | 依据记录无法读取 | 不生成确定摘要或建议，说明缺失的记录和权限 | | 现场讲解与客户访问混淆 | 停止生成结论，按记录类型重新读取并分开回答 | --- ## 15. 操作记录和隐私 ### 15.1 写入记录 智能体执行正式写入时，除现有业务操作记录外，还应能说明： - 实际 VISTA Link 用户。 - 使用的智能体和命令行程序。 - 所属项目。 - 调用的业务能力。 - 目标对象。 - 操作时间。 - 成功、失败或部分成功结果。 界面可以显示“用户本人通过 Codex”或“用户本人通过 VISTA Link 内置智能体”，不能把智能体写成无法追查到实际用户的独立人员。 ### 15.2 AI 工作记录 对页面方案处理结果、客户资料建议、行为摘要、现场讲解摘要和正式写入，AI 工作记录至少保存： - 用户提出的任务目标。 - 使用的项目和业务对象。 - 生成结果及其依据对象。 - 查询或建议使用的数据时间范围、访问数据状态和当前对象状态检查结果。 - AI 结果当前是否有效；依据变化时保留变化状态和重新生成结果的关系。 - 用户确认、修改、驳回或取消的结果。 - 用户对访问后建议的采用、修改或忽略结果。 - 实际执行的业务操作及成功、失败或部分成功结果。 AI 工作记录不替代主 PRD 的业务操作日志。业务对象发生正式修改时，仍按主 PRD 记录实际修改前后值。用户查看 AI 摘要时，可以回到自己有权查看的原始记录；权限被收回后，原始记录入口同时失效。 用户采用一条建议不等于已经执行正式业务操作。只有实际保存、修改或其他已完成的 VISTA Link 操作才记录执行结果；系统不把采用建议写成已联系、已发送或客户已回复。 用户可以删除自己的 AI 工作记录。删除 AI 工作记录不删除已经保存的客户、页面、固定链接、讲解记录或业务操作日志，也不能撤销已经完成的正式写入。 ### 15.3 隐私规则 - 密码、访问凭证和验证码不得提供给智能体，也不得进入普通操作记录。 - 客户标识参数不得完整写入用户可见记录或提供给智能体。 - 智能体只取得完成任务所需的客户资料。 - 只读查询不进入现有用户可见业务操作记录。 - 不因为使用智能体扩大项目管理员或普通成员可查看的数据范围。 - 临时客户描述需要跨会话保留时，只保存在对应 AI 工作记录中，不写入客户资料；删除该工作记录后不再保留这份临时描述。AI 工作记录不能据此恢复一份可编辑的未保存页面。 - 用户只能查看自己的 AI 工作记录；项目管理员不能因为管理员身份读取其他用户的客户临时描述或对话正文。 - 用户失去项目访问权后不能继续打开该项目的 AI 工作记录或其中的原始业务对象。 --- ## 16. 代表场景 ### 16.1 接待前准备 **用户说法：** > 查找今天预约来访的客户。 **系统需要完成：** 1. 确认当前项目、用户指定的时间范围和权限。 2. 读取关联业务系统明确提供的预约信息。 3. 返回预约客户、预约时间、预约来源和本次备注；预约来源必须明确显示。 4. 用户选择一位客户后，智能体确认对应的 VISTA Link 客户；不能明确关联时说明限制。 5. 用户要求准备接待后，智能体分开读取客户已保存资料、有效现场讲解和客户自主访问。 6. 按时间整理最近活动，明确标记每条记录来源。 7. 列出资料中已经明确的需求和缺失信息，不根据行为补写客户资料。 8. 返回用户有权查看且已经保存、来源正常的候选页面，并说明页面与已知客户条件的关系。 9. 列出需要销售现场确认的问题，例如本次关注点是否变化；不生成到访结果。 **禁止结果：** - 把现场讲解内容写成客户主动关注。 - 把客户浏览时长写成确定购买意向。 - 自动修改客户状态、标签、购房意向或备注。 - 创建、修改或确认预约，或者把预约写成客户已经到访。 - 使用其他项目的客户、页面或素材。 ### 16.2 根据单个客户画像制作页面 **用户说法：** > 我有一位大约 45 岁的客户，夫妻二人，有一个上小学的孩子，比较在意通勤和孩子上学。请结合当前项目已有的材料，帮我做一个适合他的营销页面，我确认后发给客户。 **系统需要完成：** 1. 确认当前项目和权限。 2. 用户已经指定 VISTA Link 客户时，读取该客户已经保存的标签、购房意向和备注；没有指定既有客户时，只使用本次临时描述准备不关联客户的页面方案。 3. 分开标明已保存资料和本次临时描述。 4. 根据年龄阶段、家庭成员、学龄子女、通勤和学校需求查找当前项目素材。 5. 说明客户条件与素材选择之间的关系。 6. 选择合适的 Widget，并遵守候选素材和数量规则。 7. 生成当前页面方案和选材理由。 8. 检查页面并生成预览。 9. 用户明确同意后保存页面；新页面自动创建固定链接，已有页面保留原固定链接，固定链接立即使用最新保存内容。 10. 已经指定既有客户时，取得该客户访问地址；没有既有客户时，可以返回已保存页面的无参数固定链接，或由用户创建或选择客户后再取得客户访问地址。 11. 把页面和访问地址交给销售，不自动发送。 **禁止结果：** - 把“大约 45 岁”改成确定出生日期。 - 根据家庭情况推断收入或购买意愿。 - 自动把临时描述写入客户资料。 - 使用其他项目素材。 - 未经用户预览确认保存页面。 - 把取得访问地址写成已经发送。 ### 16.3 根据客户群体制作页面 **用户说法：** > 找出当前项目里有子女、重视学区和通勤的客户，给他们准备合适的页面。 **系统需要完成：** 1. 使用真实客户标签、购房意向和备注查找客户。 2. 返回实际命中的客户信息和条件来源。 3. 资料不足的客户单独说明。 4. 根据明确条件查找素材。 5. 生成一个共用页面方案，或按用户明确要求生成多个页面方案。 6. 展示预览，用户同意后保存页面。 7. 共用页面保存后保持一条固定链接；为每位目标客户分别取得该页面对应的客户访问地址，不重复创建页面。 ### 16.4 查询最近 30 天活跃和建议优先查看的客户 **用户说法：** > 最近 30 天最值得跟进的客户是谁？最活跃的是谁？他主要对什么感兴趣？ **系统需要完成：** 1. 使用营销统计正式支持的最近 30 天范围。 2. 取得正式客户排行；按照主 PRD §4.6.2 的客户排行规则，默认按访问次数从高到低排列，访问次数相同时按最近访问时间倒序排列。 3. 明确该排行只统计客户自主访问，不把现场讲解混入访问次数或排行。 4. 说明排序指标、数值和数据更新时间。 5. 读取排行靠前客户的主要浏览内容、次数、有效时长和明确动作。 6. 分成“正式客户排行”“最近主要浏览”“建议销售优先查看”三部分回答。 7. 每条建议附带依据和限制。 8. 提供对应客户追踪入口。 **禁止结果：** - 新增只供 AI 使用的客户评分公式。 - 把访问次数或停留时长写成高意向。 - 把点击预约入口写成已经预约。 - 把主要浏览内容写成客户已经确认的购买需求。 - 自动修改客户标签、状态或负责人。 ### 16.5 根据客户浏览记录准备后续页面 **用户说法：** > 看一下李娜最近两周的浏览记录，结合她已经填写的购房意向，准备一个下一次沟通用的页面。 **系统需要完成：** 1. 读取客户已经填写的资料。 2. 读取最近两周的实际浏览、明确动作和访问数据状态。 3. 排除异常数据；有部分缺失数据时，只使用能够确认的记录并说明缺失范围。 4. 把销售填写的信息、客户当时实际看到的内容和客户行为分开。 5. 检查历史浏览内容的当前可用情况，分开说明已更新、已下线或已删除的页面和素材。 6. 返回客观记录、建议、依据入口、当前可用情况和数据限制。 7. 查找当前可用的相关素材并说明依据，不把已下线或已删除内容放入新页面。 8. 用户选择采用或修改建议后，生成当前页面方案和预览；用户忽略建议时不准备页面。 9. 用户同意当前预览后保存页面，固定链接立即使用最新保存内容。 ### 16.6 检查并修改已有页面 **用户说法：** > 检查“家庭客户介绍页”有没有失效素材，能修的先给我一个修改方案。 **系统需要完成：** 1. 读取页面、Widget 和素材状态。 2. 找出素材更新、下线、删除和 Widget 停用问题。 3. 返回问题、影响和修改建议。 4. 生成修改方案和预览。 5. 用户同意后保存修改；保存前说明固定链接将立即展示的新内容。 ### 16.7 语言场景 **日文用户：** - 用户用日文向 Codex 提问。 - 智能体使用日文解释能力、错误和查询结果。 - 项目中的日文素材名称和说明保持原文。 - 页面内容不因为智能体调用而自动翻译。 **英文用户：** - 用户用英文提问时，智能体使用英文回答。 - 系统状态、错误和固定说明使用英文。 - 日文素材内容保持日文原文，并明确其原始语言。 - 用户明确要求翻译时，智能体可以在回答中翻译，但不写回素材或页面。 ### 16.8 现场讲解后准备下一次页面 **用户说法：** > 把我刚才给李娜讲过的内容整理一下。我补充的客户反馈是她想进一步了解通勤和三居室，请准备一份回家后看的页面。 **系统需要完成：** 1. 读取本次有效现场讲解记录，列出销售实际展示的页面、内容、次数和可靠时长。 2. 把讲解记录与用户明确补充的客户反馈分开显示。 3. 只把用户明确补充的“通勤和三居室”作为本次选材条件，不从展示时长推断客户反馈。 4. 搜索当前项目内符合 Widget 规则的素材，生成当前页面方案、选材理由和预览。 5. 保存前再次检查页面、Widget、素材和权限；用户确认当前预览后保存页面。 6. 按用户选择取得访问地址，不自动发送。 ### 16.9 处理现场讲解记录 **用户说法：** > 找出我今天还没处理完的讲解记录。 **系统需要完成：** 1. 查询当前用户自己的未关联客户和未正常结束记录。 2. 分别显示页面、开始时间、最后可靠记录时间、当前客户关联和可用操作。 3. 未正常结束记录由用户选择继续或结束；结束时间继续使用主 PRD 的最后可靠记录时间规则。 4. 用户要修改客户关联时，选择目标客户并填写理由后再次确认；不设置「关联错误」状态。 5. 用户认为整场记录是误触或测试时，说明标记无效的影响，取得明确理由和确认后再执行。 智能体不能根据讲解时长或页面内容自行选客户，也不能建议把真实讲解标记无效。 ### 16.10 项目总览问答 **用户说法：** > 这个项目目前有多少客户、页面和启用链接？客户负责人分布怎么样？ **系统需要完成：** 1. 使用当前项目和项目总览当前支持的时间范围。 2. 返回主 PRD 已定义的客户、页面、固定链接和负责人总体数据。 3. 说明数据更新时间、部分失败或不可计算状态。 4. 用户有对应权限时，提供客户管理或页面库入口继续查看。 5. 不增加销售排名、客户分数、成交判断或跨项目合计。 --- ## 17. 验收与评测 ### 17.1 固定业务验收 - 智能体不能读取无权访问的项目。 - 项目切换后不继续使用原项目数据。 - 素材必须属于当前项目和 Widget 候选范围。 - 页面保存前完成现有页面检查。 - 重复请求不能重复创建页面或重复修改数据。 - 目标页面在准备期间发生变化后，不能用准备期间读取的旧内容覆盖，必须重新读取并让用户检查新的预览；这不表示系统保存页面历史版本。 - 页面保存不等于链接已经发送。 - 统计回答使用正式指标，不增加 AI 公式。 - 浏览行为不能被写成购买意向。 - 日文和英文用户得到对应语言的系统说明。 - 项目内容保持原文，不被自动翻译或改写。 - 每项 AI 结果都能指出对应主 PRD 人工操作和实际使用的业务对象。 - 接待准备中，客户资料、现场讲解和客户自主访问分开展示。 - 现场讲解不能被写成客户兴趣，现场讲解不能进入营销统计访问排行。 - AI 不能自动修改客户状态、客户资料、标签、讲解客户关联或有效状态。 - 保存页面使用主 PRD 的预览确认、固定链接和保存即生效规则。 - 修改讲解客户关联必须填写理由，不设置「关联错误」状态；标记无效必须由用户明确决定并填写理由。 - AI 不可用时，原有人工页面和操作仍然可用。 - 用户不需要先说出客户管理、Widget、素材、固定链接或客户追踪等模块名称；AI 可以从销售目标开始选择现有能力。 - 每项 AI 任务都有明确的输入、确定规则、AI 判断分支、人工审核点、成功结果和失败处理。 - 为客户找页面时，AI 必须先找现有已保存页面，再区分完全匹配、部分匹配和没有匹配。 - 用户只要求找页面且没有匹配时，AI 不能直接创建页面；用户允许新建后才能准备当前页面方案。 - AI 对不确定部分给出候选结果和依据，不能把 AI 选择直接写成客户事实或正式业务结果。 - 根据客户访问生成摘要或建议时，异常数据不进入依据，部分缺失数据只使用能够确认的记录。 - 待检查和已排除数据不进入新的 AI 结果依据。 - 访问依据纠正、排除或变更归属后，原 AI 结果标记为「依据已变化」，不得继续采用或用于准备页面。 - 用户可以按最新有效数据重新生成摘要和建议，新结果不覆盖历史结果。 - AI 只能合并依据仍然有效的建议，合并草稿需由用户检查。 - 访问后建议能够说明访问记录中的对象和参数、当前可用情况、建议依据和数据限制，并明确不能回放当时的完整页面。 - 用户可以采用、修改或忽略访问后建议；采用建议不得记录为已联系、已发送或客户已回复。 - 智能体返回具体分享页面时，快捷操作类型必须来自系统预先登记内容；当前可用项可以执行，不可用项只能说明原因，不能临时生成操作名称或任意页面地址。 - 页面快捷操作缺少客户、地址类型等该操作的必要参数时，智能体先补问；用户选择后，系统重新检查权限、页面状态和最新保存内容。 - 系统内部页面地址不能作为客户访问地址复制；客户页面预览不能产生客户自主访问或现场讲解记录。 - 进入现场讲解必须使用专门的现场讲解页面；普通客户访问页面不显示讲解操作，也不记录讲解状态。 - 工作文件夹与 VISTA Link 项目明确区分；文件夹不增加项目、客户或其他业务数据权限。 - 删除工作文件夹只解除其中会话的文件夹关系，不删除会话和正式业务数据。 - 工作文件夹不关联客户或其他业务对象；即使名称使用客户姓名，也不能据此确定会话实际使用的客户。 - 四个内置角色都只能查看自己在当前有权访问项目中的工作文件夹；项目访问失效后不能继续查看。 ### 17.2 代表任务评测 每项主要场景至少准备： - 同一目标的多种日文说法。 - 同一目标的多种英文说法。 - 缺少项目、客户、时间或素材条件。 - 多个对象同名。 - 没有符合条件的数据。 - 用户权限不足。 - 素材更新、下线或删除。 - Widget 停用。 - 页面最新保存内容变化。 - 数据读取失败。 - 访问数据部分缺失或异常。 - 客户当时浏览的页面或素材当前已更新、下线或删除。 - 智能体中断和任务恢复。 - 用户拒绝写入。 - 用户临时描述与已保存客户资料冲突。 - 同一客户同时存在现场讲解和客户自主访问。 - 讲解记录未关联客户、未正常结束或已经无效。 - 用户要求 AI 自动修改客户状态或把讲解时长解释成兴趣。 - 用户确认页面预览后、保存前素材或 Widget 状态发生变化。 - AI 不可用但基础页面仍然可用。 - 用户要求复制页面地址，但没有明确无参数固定链接或指定客户访问地址。 - 用户要求进入现场讲解，但没有明确已有客户或临时讲解。 - AI 返回页面后，页面保存状态、权限或客户上下文在用户选择快捷操作前发生变化。 - 用户在以客户姓名命名的文件夹中，新会话明确指定另一位客户。 - 用户删除包含多个会话的工作文件夹。 评测检查： - 是否选择了正确业务能力。 - 是否使用了正确项目和对象。 - 是否正确解释用户语言和条件。 - 是否说明选材依据。 - 页面是否符合 Widget 和素材规则。 - 是否在写入前询问用户。 - 统计结果是否引用正确数据。 - 是否产生禁止推断。 - 失败时是否给出正确说明。 - 是否能从摘要和建议回到用户有权查看的原始记录。 - 是否正确排除异常数据，并对部分缺失数据说明可确认和不可确认的部分。 - 是否把客户当时看到的历史内容与页面、素材和 Widget 的当前状态分开。 - 是否把采用建议误写成已联系、已发送或客户已回复。 - 是否清楚区分当前未保存页面方案和已经保存的分享页面。 - 是否把主 PRD 未包含的任务、预约、到访或交易结果误写成当前能力。 - 是否执行了正确判断分支，而不是无论输入如何都生成相同结果。 - 是否只补问完成当前任务必需的信息。 ### 17.3 上手难度与操作简化验收 由不了解 VISTA Link 模块结构的新销售完成以下任务： 1. 为一位已有客户准备接待页面。 2. 在没有匹配页面时准备、预览并保存新页面。 3. 查询一位客户最近是否访问及主要浏览内容。 4. 根据访问记录准备下一份页面。 5. 处理一条未正常结束或未关联客户的讲解记录。 验收要求： - 用户可以直接使用自然语言说明销售目标，不要求先选择功能模块。 - AI 只在项目、客户、目的或必要条件缺失时补问。 - AI 返回结果时说明使用了哪些客户资料、页面、素材、讲解和访问记录。 - 用户操作项达到 §2.5 的简化目标；如果未达到，需要说明是缺少产品能力、缺少数据还是 AI 判断失败。 - 页面内容、客户资料、讲解关联、无效讲解、客户状态和保存仍由用户审核。 - 用户可以随时退出 AI 流程并进入对应人工页面继续操作，已有输入和已经保存的正式数据不丢失。 --- ## 18. 实施范围 ### 18.1 首批验证内容 首批先验证外部智能体完成销售准备和页面制作。首批不提供 VISTA Link 网页内置智能体。AI 场景必须等对应主 PRD 基础能力可用后再启用，不能用 AI 结果代替尚未完成的基础功能。 首批内容： 1. 用户授权和项目选择。 2. 客户、素材、Widget 和页面读取。 3. 根据客户条件搜索素材。 4. 当前会话中的页面方案准备和修改，不保存独立页面草稿。 5. 页面组装、检查、预览确认和保存即生效。 6. 取得客户访问地址，但不自动发送。 7. 客户资料、客户标签、素材说明和素材标签的待确认建议。 8. 页面更新、下线、删除素材和停用 Widget 的检查与修改方案。 9. 日文和英文回答。 10. 权限不足、项目错误、数据失败、AI 失败和重复写入处理。 11. 销售三个问题的自然语言入口和 §10.3 页面查找、匹配与新建分支。 12. §17.3 所列上手难度与操作简化测试。 以下内容随基础能力提供，不作为首批独立前置功能： - 购房客户追踪和营销统计可用后，启用接待前准备、客户行为摘要和后续页面建议。 - 现场讲解可用后，启用讲解后摘要、未关联记录、未正常结束记录、客户关联修改和无效讲解处理。 - 项目总览可用后，启用项目总览问答和详情入口建议。 ### 18.2 后续内容 - VISTA Link 网页内置智能体。 - 更多客户资料和负责人修改。 - 客户导入、导出和删除。 - 固定链接公开状态和启用状态修改。 - 成员、角色和权限管理。 - 更多智能体软件的使用验证。 - 内置智能体的固定问题和页面表现。 - 是否保留更长期的 AI 建议纠正记录，以及如何供用户查看。 后续内容仍使用本文的项目、权限、语言、确认和记录规则，不建立另一套 AI 规则。 以下内容不因进入后续阶段而自动纳入范围：自动意向评分、自动客户阶段、自动任务、预约到访和交易结果、渠道归因、AI 审核中心、C 端 AI 对话。需要增加时必须先修改主 PRD 或另立正式产品需求。 --- ## 19. 与其他文档的关系 - 本文是 VISTA Link AI 与智能体功能的产品需求依据。 - [VISTA Link 产品需求文档](./VISTA_Link_产品需求文档.md) 继续定义客户、素材、Widget、页面、固定链接、现场讲解、客户追踪、营销统计、项目总览、系统设置和语言等基础业务规则。 - 主 PRD 对基础能力的修改优先于本文；本文引用的基础能力发生变化时，AI 场景、确认内容和验收必须重新检查。 - 已建立 [VISTA Link AI 与智能体用例文档](./VISTA_Link_AI与智能体用例文档.md)，当前先覆盖“根据访问继续推荐”；其他 AI 场景后续按本文补充。 - 各 Widget 的内容对象、候选素材和配置规则继续以对应 Widget 需求为准。 - AI 内容制作系统不属于本文。 - [AI 与智能体需求讨论记录](./archive/VISTA_Link_AI与智能体需求讨论记录_20260812.md) 只保存讨论过程，不作为开发或验收依据。