# VISTA Link AI 与智能体用例文档 > 对应 [VISTA Link AI 与智能体产品需求文档 V1.14](./VISTA_Link_AI与智能体产品需求文档.md) > 基础能力对应 [VISTA Link 产品需求文档 V0.250](./VISTA_Link_产品需求文档.md) > 当前覆盖内置智能体入口、工作文件夹、销售从智能体页面结果继续原有操作、销售查询近期预约客户、销售访问建议、销售经理项目总览问答、营销企划素材整理和项目管理员系统设置查询，不计入 [VISTA Link 用例文档](./VISTA_Link_用例文档.md) 的 108 个基础用例。 > 工作文件夹供销售人员、销售经理、营销企划和项目管理员使用，四个角色使用相同规则。以下工作文件夹用例以销售人员为代表，不表示该能力只属于销售人员。 > AI 场景只有在对应基础能力可用后才启用；各用例优先级沿用主 PRD 对应基础能力，不改变当前内部 MVP 范围。 > 修订记录见 [VISTA Link AI 与智能体用例文档修订记录](./VISTA_Link_AI与智能体用例文档_修订记录.md)。 --- ## 顶层用例图 ```plantuml @startuml left to right direction skinparam shadowing false actor "销售人员" as Sales actor "销售经理" as Manager actor "营销企划" as Marketing actor "项目管理员" as Admin rectangle "VISTA Link AI 与智能体" { usecase "进入内置智能体" as AI00 usecase "创建工作文件夹" as AI08 usecase "整理文件夹中的会话" as AI09 usecase "从智能体页面结果\n继续原有操作" as AI07 usecase "查询近期预约客户" as AI06 usecase "根据客户访问\n取得后续建议" as AI01 usecase "处理访问后建议" as AI02 usecase "查询项目总体情况" as AI03 usecase "整理素材说明和标签建议" as AI04 usecase "查询成员和权限情况" as AI05 } Sales --> AI00 Sales --> AI08 Sales --> AI09 Manager --> AI08 Manager --> AI09 Marketing --> AI08 Marketing --> AI09 Admin --> AI08 Admin --> AI09 Sales --> AI07 Sales --> AI06 Sales --> AI01 Sales --> AI02 Manager --> AI03 Marketing --> AI04 Admin --> AI05 @enduml ``` --- ## 内置智能体入口 ### UC-AI入口-01 销售进入内置智能体 - **优先级**：P1 ```plantuml @startuml left to right direction skinparam shadowing false actor "销售人员" as Sales usecase "进入内置智能体" as UC Sales --> UC @enduml ``` **用例目标** 销售进入内置智能体，使用当前项目和可以确认的当前对象开始提问，并在完成后继续原有工作。 **角色** 销售人员。 **前置条件** - 销售已登录并进入一个有权访问的项目。 - 销售已开启 AI 使用授权。 **触发** 销售希望通过自然语言查询、整理或准备 VISTA Link 中的业务内容。 **主流程** 1. 销售从共通入口或业务页面中的相关操作进入内置智能体。 2. 系统显示「VISTA Link AI」和当前项目。 3. 从带明确对象的业务页面进入时，系统同时显示实际使用的客户、页面或其他业务对象。 4. 系统显示销售当前可以处理的常用工作和最近会话；常用工作由系统提供，使用“查找近期预约客户”“查看客户访问”等销售目标，不要求销售自行创建。 5. 销售选择一项常用工作时，系统把对应问题放入输入内容，但不自动发送。 6. 销售检查或修改问题后发送；销售也可以不选择常用工作，直接输入问题。 7. 信息不足时，智能体询问完成当前工作所需的客户、时间或其他条件。 8. 系统按当前用户权限、当前项目和已显示的当前对象处理问题，在会话中返回反馈、依据、限制和一个或多个业务对象。 9. 系统为每个业务对象返回系统预先支持的链接或快捷操作。 10. 销售选择链接或快捷操作。 11. 系统打开或提供进入对应原有页面、操作的方式；销售可以继续会话或选择其他结果。 **异常流程** - 3a. 当前没有明确业务对象 → 系统只显示和使用当前项目，不猜测客户或页面。 - 4a. 销售切换项目 → 系统清除原项目对象和对话上下文，按新项目显示最近会话和常用工作。 - 8a. 销售没有读取目标数据的权限 → 系统说明无法查看，并且不返回对应数据或系统内链接。 - 8b. AI 不可用、超时或生成失败 → 系统保留销售已经输入的内容，并提供原有业务功能入口。 - 10a. 链接或快捷操作对应对象已经删除、不可用或超出当前权限 → 系统不显示对象内容，不执行操作，并在会话中说明原因。 - 11a. 当前设备无法使用目标原有页面或操作 → 系统保留当前会话和业务对象，并说明可以继续使用的方式。 **业务规则** - 进入或离开内置智能体不修改当前业务对象，也不记录为业务操作。 - 常用工作根据当前用户角色和功能权限显示。 - 常用工作由系统提供；当前版本不要求用户从空白内容自行创建常用工作。 - 选择常用工作只填写对应问题，不自动发送，也不执行读取或写入操作。 - 智能体只返回系统预先支持的链接类型，不能生成任意系统地址。 - 客户、素材、页面、统计、成员和角色等内容使用原有系统页面显示，智能体不能根据回答临时生成页面结构。 - 系统内链接必须带有对应对象和查询条件；刷新或继续会话时，链接仍指向相同内容。 - 快捷操作来自系统预先登记的业务对象和原有业务能力，智能体不能临时增加操作或改变操作含义。 - 常用工作使用 VISTA Link 业务内容，不显示新闻、广告或产品宣传。 **后置条件** - 销售可以继续原有业务功能；未经确认的正式业务修改未执行。 --- ## 页面快捷操作 ### UC-AI页面操作-01 销售从智能体页面结果继续原有操作 - **优先级**：P1 ```plantuml @startuml left to right direction skinparam shadowing false actor "销售人员" as Sales usecase "从智能体页面结果继续原有操作" as UC Sales --> UC @enduml ``` **用例目标** 销售从智能体返回的具体分享页面进入该页面当前允许的原有查看、客户访问或现场讲解操作。 **角色** 销售人员。 **前置条件** - 销售已进入内置智能体并提出与分享页面有关的任务。 - 智能体已经返回当前项目内一个或多个具体分享页面。 **触发** 销售希望继续查看、复制客户访问地址、预览客户页面或进行现场讲解。 **主流程** 1. 系统显示分享页面名称、当前状态、智能体推荐依据、当前可用的固定快捷操作及不可用原因。 2. 销售从当前可用操作中选择「查看页面详情」「复制客户访问地址」「预览客户页面」或「进入现场讲解」。 3. 系统使用当前项目、目标页面和当前任务中已经明确且仍然有效的业务参数。 4. 当前快捷操作缺少必要参数时，智能体询问销售完成该操作所需的信息。 5. 销售补充或选择必要参数。 6. 系统重新检查目标页面、当前用户权限、最新保存内容和该快捷操作对应的主 PRD 规则。 7. 系统按销售选择进入对应的原有操作：打开页面详情、取得客户访问地址、打开客户页面预览，或进入专门的现场讲解页面。 8. 销售在原有操作中继续查看、复制地址、预览，或开始和结束现场讲解。 **异常流程** > 1a. 页面没有满足当前任务的可用操作 → 系统显示各项操作的不可用原因，不允许销售选择。 > 3a. 当前任务中的项目、页面或客户已经变化 → 系统不继续使用旧参数，显示变化并要求销售重新选择。 > 4a. 复制客户访问地址但无法确定地址类型 → 智能体让销售选择无参数固定链接或指定客户访问地址，不自行选择。 > 4b. 进入现场讲解但没有明确客户 → 智能体让销售选择当前项目内已有客户或临时讲解。 > 5a. 销售取消补充必要参数 → 系统不进入对应操作，保留当前会话和页面结果。 > 6a. 页面已经删除、尚未保存、来源不可用、权限已变化或其他主 PRD 检查失败 → 系统不进入对应操作，显示实际原因并允许销售返回页面结果。 > 7a. 销售已有进行中的现场讲解 → 系统按主 PRD 显示原讲解，并让销售继续或结束，不创建第二条进行中记录。 **业务规则** - 分享页面的快捷操作类型固定为页面详情、客户访问地址、客户页面预览和现场讲解；不增加由创建人选择的「可分享」或「可讲解」选项。 - 每项固定快捷操作的名称、必需参数和目标业务能力由系统预先登记，智能体不能临时生成。 - 当前可用的快捷操作可以执行；当前不可用的操作只显示原因，不能选择。 - 每项快捷操作当前是否可用，只按与该操作有关的页面状态、最新保存内容、固定链接状态、当前用户权限和主 PRD 原有操作规则判断。 - 查看页面详情使用系统内部页面；系统内部页面地址不能作为客户访问地址复制。 - 复制客户访问地址只能取得主 PRD 定义的无参数固定链接或指定客户访问地址，不复制页面详情或现场讲解页面地址。 - 客户页面预览不产生客户自主访问记录，也不产生现场讲解记录。 - 现场讲解页面属于 B 端现场讲解能力；页面内容可以复用客户访问页面的展示规则，但开始、继续、结束、客户关联和讲解记录不属于购房客户访问端。 - 选择「进入现场讲解」只进入专门的现场讲解页面，不表示讲解已经开始；开始和结束讲解仍在该页面中完成。 - 当前任务已经明确且仍然有效的项目、页面、客户和使用目的可以继续使用；系统必须显示实际使用的对象。 - 仅选择或打开快捷操作不修改正式业务数据；后续操作是否需要确认，继续使用原有业务规则。 **后置条件** - 销售已进入所选页面对应的原有操作，或在条件不满足时保留当前会话和页面结果。 - 仅查看或进入操作时，页面、客户、固定链接和讲解记录未发生修改。 --- ## 工作文件夹 ### UC-AI文件夹-01 销售创建工作文件夹 - **优先级**：P1 ```plantuml @startuml left to right direction skinparam shadowing false actor "销售人员" as Sales usecase "创建工作文件夹" as UC Sales --> UC @enduml ``` **用例目标** 销售创建一个用于整理当前项目 AI 会话的工作文件夹。 **角色** 销售人员。 **前置条件** - 销售已进入内置智能体。 - 销售已进入一个有权访问的项目。 **触发** 销售希望把围绕同一客户或同一工作主题的会话放在一起。 **主流程** 1. 销售选择创建工作文件夹。 2. 系统要求销售填写文件夹名称。 3. 销售填写名称并选择创建。 4. 系统在当前 VISTA Link 项目中创建一个空文件夹。 **异常流程** > 3a. 文件夹名称为空 → 系统要求填写名称，不创建文件夹。 > 3b. 销售取消 → 系统不创建文件夹。 **业务规则** - 工作文件夹属于当前用户和当前 VISTA Link 项目，不在团队成员之间共享。 - 工作文件夹不是 VISTA Link 项目，不增加项目、客户或其他业务数据权限。 - 工作文件夹只保存名称和会话所属关系，不关联客户、素材、页面或其他业务对象。 - 文件夹名称可以使用客户姓名，但系统不能据此确定会话实际使用的客户。 - 创建工作文件夹不能同时移动当前会话。 - 系统不能为全部客户自动创建工作文件夹。 **后置条件** - 当前用户在当前项目中新增了一个空工作文件夹；现有会话和正式业务数据未发生修改。 --- ### UC-AI文件夹-02 销售整理工作文件夹中的会话 - **优先级**：P1 ```plantuml @startuml left to right direction skinparam shadowing false actor "销售人员" as Sales usecase "整理文件夹中的会话" as UC Sales --> UC @enduml ``` **用例目标** 销售把当前项目内的 AI 会话放入合适的工作文件夹，并从文件夹继续工作。 **角色** 销售人员。 **前置条件** - 销售在当前项目中至少有一个工作文件夹。 **触发** 销售希望在文件夹中创建新会话，或整理已经存在的会话。 **主流程** 1. 销售选择一个工作文件夹。 2. 系统显示文件夹名称和其中的会话。 3. 销售可以在文件夹中创建新会话，或把当前项目内已有会话移入该文件夹。 4. 系统保存会话所属文件夹。 5. 销售打开文件夹中的会话继续查看记录或发起新的请求。 **异常流程** > 3a. 目标会话属于其他 VISTA Link 项目 → 系统不允许移动。 > 3b. 销售把已经属于其他文件夹的会话移入当前文件夹 → 系统从原文件夹移出该会话，再放入当前文件夹。 > 5a. 销售失去整个项目访问权 → 系统立即停止显示该项目中的工作文件夹和会话；项目访问恢复后按最新角色和权限重新检查。 **业务规则** - 一个会话最多属于一个工作文件夹，也可以不属于任何文件夹。 - 工作文件夹和会话不能跨 VISTA Link 项目移动。 - 工作文件夹名称不能用来确定会话实际使用的客户或其他业务对象。 - 用户切换 VISTA Link 项目后，只显示目标项目中的文件夹和会话。 - 销售可以把会话移出文件夹，移出后会话仍然保留。 - 重新打开会话可以查看已有对话和 AI 工作记录，但不能恢复或继续编辑此前未保存的页面方案；需要准备页面时必须按当前数据重新开始 AI-PAGE-01。 **后置条件** - 会话所属文件夹已经更新；会话内容和正式业务数据未发生修改。 --- ### UC-AI文件夹-03 销售重命名工作文件夹 - **优先级**：P1 ```plantuml @startuml left to right direction skinparam shadowing false actor "销售人员" as Sales usecase "重命名工作文件夹" as UC Sales --> UC @enduml ``` **用例目标** 销售修改自己的工作文件夹名称。 **角色** 销售人员。 **前置条件** - 销售已经创建工作文件夹。 **触发** 销售希望让文件夹名称更符合当前客户或工作主题。 **主流程** 1. 销售选择重命名工作文件夹。 2. 系统显示当前名称。 3. 销售填写新名称并保存。 4. 系统更新工作文件夹名称。 **异常流程** > 3a. 新名称为空 → 系统要求填写名称，不修改原名称。 > 3b. 销售取消 → 系统保留原名称。 **业务规则** - 重命名工作文件夹不改变所属 VISTA Link 项目和其中会话。 - 重命名工作文件夹不修改正式业务数据。 **后置条件** - 工作文件夹使用新名称；其中会话和正式业务数据未发生修改。 --- ### UC-AI文件夹-04 销售删除工作文件夹 - **优先级**：P1 ```plantuml @startuml left to right direction skinparam shadowing false actor "销售人员" as Sales usecase "删除工作文件夹" as UC Sales --> UC @enduml ``` **用例目标** 销售删除不再需要的工作文件夹，同时保留其中的会话和正式业务数据。 **角色** 销售人员。 **前置条件** - 销售已经创建工作文件夹。 **触发** 销售不再需要使用某个工作文件夹整理会话。 **主流程** 1. 销售选择删除工作文件夹。 2. 系统显示文件夹名称和其中的会话数量，并说明删除文件夹不会删除会话和正式业务数据。 3. 销售确认删除。 4. 系统删除工作文件夹，并把其中会话改为不属于任何文件夹。 **异常流程** > 3a. 销售取消 → 系统保留工作文件夹和其中会话。 **业务规则** - 删除工作文件夹不能删除会话。 - 删除工作文件夹不能删除客户、页面、素材、访问记录、讲解记录或其他正式业务数据。 - 文件夹删除后，其中会话仍属于原 VISTA Link 项目。 **后置条件** - 工作文件夹已经删除，其中会话可以继续从未放入文件夹的会话中查看。 --- ## 接待前准备 ### UC-AI接待准备-01 销售查询近期预约客户 - **优先级**：P1 ```plantuml @startuml left to right direction skinparam shadowing false actor "销售人员" as Sales usecase "查询近期预约客户" as UC Sales --> UC @enduml ``` **用例目标** 销售查询指定时间范围内的预约客户，并选择一位客户继续准备接待。 **角色** 销售人员。 **前置条件** - 销售已登录并进入一个有权访问的项目。 - 销售已开启 AI 使用授权。 - 销售具备「查看客户」功能权限。 - 关联业务系统已经向 VISTA Link 提供当前预约信息。 **触发** 销售希望知道今天或近期有哪些客户预约来访。 **主流程** 1. 销售说明要查询的时间范围。 2. 智能体按当前项目和时间范围读取关联业务系统明确提供的预约信息。 3. 智能体返回预约客户、预约时间、预约来源和本次备注。 4. 销售选择一位预约客户。 5. 智能体确认预约信息对应的 VISTA Link 客户，并提供该客户的系统内链接。 6. 智能体询问销售是否继续准备本次接待。 7. 销售确认后，智能体按 AI PRD §2.7 的 AI-SALES-01 继续读取客户资料、有效现场讲解、自主访问和可用页面。 **异常流程** > 1a. 销售只说“最近”但没有说明时间范围 → 智能体请销售选择今天、未来三天或其他明确时间范围，不自行扩大查询范围。 > 2a. 预约信息读取失败 → 智能体说明读取失败和预约来源，不把读取失败写成没有预约。 > 3a. 没有符合条件的预约 → 智能体返回空结果和实际使用的时间范围，不生成预约客户。 > 3b. 预约信息没有来源或来源无法确认 → 智能体标明信息无法确认，不把该信息作为接待准备依据。 > 5a. 预约信息无法明确关联现有客户 → 智能体显示预约中的姓名、时间和来源，说明无法读取客户资料，并且不修改或新建客户。 > 5b. 销售没有查看目标客户的权限 → 智能体不返回客户资料和系统内链接，并说明权限限制。 > 7a. 销售暂不准备接待 → 智能体保留本次查询结果，用例结束。 **业务规则** - 预约信息必须来自关联业务系统明确提供的当前事实，并显示预约来源。 - 查询范围只使用当前项目和销售指定的时间范围。 - 智能体只能读取预约，不能创建、修改或确认预约。 - 预约不表示客户已经到访，智能体不能生成到访结果。 - 查询和选择预约客户不修改客户资料、客户状态、负责人、标签或备注。 **后置条件** - 销售已看到指定时间范围内可以确认的预约客户，并可以选择一位客户继续准备接待。 - 预约、客户资料和其他正式业务数据未发生修改。 --- ## 访问后建议 ### UC-AI客户跟进-01 销售根据客户访问取得后续建议 - **优先级**：P1 ```plantuml @startuml left to right direction skinparam shadowing false actor "销售人员" as Sales usecase "根据客户访问\n取得后续建议" as UC Sales --> UC @enduml ``` **用例目标** 销售人员根据可以确认归属的客户自主访问，取得带依据的询问方向和资料建议。 **角色** 销售人员。 **前置条件** - 销售人员已登录并选择当前项目。 - 销售人员已授权当前智能体读取 VISTA Link 数据。 - 销售人员具备「查看客户」和「购房客户追踪查看」功能权限。 **触发** 销售人员询问某位客户在指定时间内看了什么，以及下一次可以询问或准备什么。 **主流程** 1. 智能体确认当前项目、目标客户和时间范围。 2. 智能体读取该客户的自主访问、访问行为记录和访问数据状态。 3. 智能体排除异常数据，保留正常数据和部分缺失数据中能够确认的记录。 4. 智能体汇总客户、时间范围、分享页面、访问次数、实际浏览内容、有效时长和明确动作。 5. 智能体检查历史访问中的页面、内容、素材和 Widget 当前是否可用、已更新或已不可用。 6. 智能体分开返回客观记录、建议内容、建议依据、当前可用情况、数据限制和用户选择。 **异常流程** > 1a. 项目、客户或时间范围不明确 → 智能体请销售人员补充或从候选项中选择，不自行猜测。 > 2a. 没有符合条件的自主访问 → 智能体返回空结果和实际使用的查询条件，不生成确定建议。 > 2b. 数据读取失败 → 智能体说明读取失败和重试方式，不把失败写成没有访问。 > 3a. 存在部分缺失数据 → 智能体标明「数据不完整」和缺失范围，只使用能够确认的记录。 > 3b. 存在异常数据 → 智能体说明已排除的异常记录，异常记录不进入摘要、排序或建议依据。 > 3c. 存在待检查或已排除数据 → 智能体不使用这些记录；待检查数据需要先返回人工处理。 > 4a. 统计数据存在延迟 → 智能体显示数据最后更新时间和延迟状态。 > 5a. 历史页面、内容、素材或 Widget 已更新或不可用 → 智能体保留历史访问事实，单独说明当前状态，不直接把不可用内容推荐给客户。 > 6a. 智能体无法读取生成确定建议所需的依据 → 智能体不生成确定建议，说明无法读取的记录和权限限制。 > 6b. AI 生成超时或失败 → 系统保留销售人员已提供的条件，提供重试和原有购房客户追踪入口，不把未完成内容写成建议。 **业务规则** - 建议只能使用主 PRD 可以确认归属的访问和行为记录。 - 待检查、异常和已排除的访问数据不得作为新的摘要、排序或建议依据。 - 浏览次数、有效时长、重复查看和明确动作不能直接写成购买意向、客户反馈或联系结果。 - 现场讲解和客户自主访问必须分开展示，现场讲解不作为本用例的建议依据。 - 历史访问内容和当前可用内容必须分开展示。 - 用户选择是每项访问后建议的必须内容，至少包含采用、修改和忽略。 - 建议不修改客户状态、标签、负责人或其他正式业务数据。 **后置条件** - 销售人员已看到带依据和限制的访问后建议。 - 系统保存本次 AI 工作记录；客户、页面、固定链接和访问记录未发生修改。 --- ### UC-AI客户跟进-02 销售处理访问后建议 - **优先级**：P1 ```plantuml @startuml left to right direction skinparam shadowing false actor "销售人员" as Sales usecase "处理访问后建议" as UC Sales --> UC @enduml ``` **用例目标** 销售人员采用、修改或忽略访问后建议，并在需要时继续准备页面。 **角色** 销售人员。 **前置条件** - 智能体已按 UC-AI客户跟进-01 返回访问后建议。 - 销售人员可以查看该建议及其依据。 **触发** 销售人员决定处理某项访问后建议。 **主流程** 1. 智能体检查建议依据是否仍然有效。 2. 智能体向销售人员提供采用、修改、忽略和可用时的合并选择。 3. 销售人员选择采用建议。 4. 智能体显示已采用的建议内容。 5. 销售人员要求根据建议准备页面。 6. 智能体进入 AI PRD §10.3 的 AI-PAGE-01 流程。 7. 系统在 AI 工作记录中保存销售人员采用、修改、合并或忽略的结果。 **异常流程** > 1a. 建议依据已纠正、排除或变更归属 → 系统将原建议标记为「依据已变化」；智能体不继续采用、修改、合并或准备页面，并提供按最新数据重新生成的选择。 > 2a. 销售人员选择修改建议 → 销售人员说明需要保留、删除或调整的内容；智能体展示修改后的建议，然后从步骤 5 继续。 > 2b. 销售人员选择忽略建议 → 智能体不再继续使用该建议；系统保存忽略结果，用例结束。 > 2c. 销售人员选择合并两条以上建议 → 智能体只使用依据仍然有效的建议生成合并草稿；销售人员可以修改、采用或取消。 > 2d. 修改或合并后的建议把浏览行为写成购买意向、客户反馈或已完成联系 → 智能体说明这些事实无法由访问记录证明，要求销售人员重新修改。 > 5a. 销售人员不要求准备页面 → 系统保存采用、修改或合并结果，用例结束。 > 6a. 准备页面前客户、页面、素材、Widget 或用户权限已变化 → 智能体重新读取当前状态，并请销售人员检查更新后的结果。 > 6b. AI-PAGE-01 依赖的基础能力尚未提供 → 智能体说明当前无法执行的步骤，并返回原有人工页面入口。 **业务规则** - 采用建议只表示销售人员决定参考该建议，不表示已联系客户、已发送资料或客户已回复。 - 采用、修改或忽略建议不修改客户、页面或其他正式业务数据。 - 合并建议只整理建议内容，不合并、修改或补造客户资料、访问事实和统计结果。 - 「依据已变化」的建议保留在 AI 工作记录中，但不能继续采用、修改、合并或用于准备页面。 - 只有销售人员明确要求准备页面时，智能体才进入 AI-PAGE-01。 - 保存新页面、修改已有页面或修改其他正式数据时，必须按 AI PRD 的写入确认规则另行取得用户同意。 - AI-PAGE-01 中的未保存页面方案只在当前打开的准备过程里使用；刷新或关闭页面、退出登录、换设备、切换项目或重新打开会话后，不能恢复或继续编辑该方案。 **后置条件** - AI 工作记录已保存销售人员对建议的处理结果和当前依据状态。 - 采用、修改或忽略建议本身不产生客户联系、资料发送或正式业务数据变化。 --- ## 其他角色 ### UC-AI项目总览-01 销售经理查询项目总体情况 - **优先级**：P2-A ```plantuml @startuml left to right direction skinparam shadowing false actor "销售经理" as Manager usecase "查询项目总体情况" as UC Manager --> UC @enduml ``` **用例目标** 销售经理查询当前项目总体情况，并在智能体业务结果中继续查看有权访问的客户追踪或营销统计。 **角色** 销售经理。 **前置条件** - 销售经理已登录并进入一个有权访问的项目。 - 当前项目的项目总览基础能力已经可用。 **触发** 销售经理希望了解本周或本月的项目总体情况。 **主流程** 1. 销售经理说明要查询的时间范围。 2. 智能体读取项目总览当前支持的总体数据和数据最后更新时间。 3. 智能体返回客户总数、未分配负责人客户数、可访问页面数、启用链接数、新增客户数和访问客户数。 4. 智能体说明哪些数据是当前值，哪些数据受时间范围影响。 5. 智能体按销售经理当前权限显示客户追踪或营销统计业务结果。 **异常流程** > 1a. 时间范围不明确 → 智能体请销售经理选择本周或本月，不自行使用其他范围。 > 2a. 项目总览数据读取失败 → 智能体说明读取失败，保留查询条件，并提供项目总览入口。 > 5a. 销售经理没有查看目标详情的功能权限 → 智能体不提供该详情内容，并说明权限限制。 **业务规则** - 项目总览问答只使用主 PRD §4.9 已定义的数据和时间范围。 - 智能体不根据总体数据评价销售表现，不生成客户分数、意向等级或转化率。 - 项目总览只显示当前项目，不提供跨项目合计。 **后置条件** - 销售经理已看到当前项目总体情况；项目和业务数据未发生修改。 --- ### UC-AI素材整理-01 营销企划整理素材说明和标签建议 - **优先级**：P2-A ```plantuml @startuml left to right direction skinparam shadowing false actor "营销企划" as Marketing usecase "整理素材说明和标签建议" as UC Marketing --> UC @enduml ``` **用例目标** 营销企划根据素材当前信息取得说明草稿和已有标签建议。 **角色** 营销企划。 **前置条件** - 营销企划已进入当前项目。 - 营销企划具备「查看素材」「维护素材说明」和「使用素材标签」功能权限。 **触发** 营销企划希望补充素材说明或整理素材标签。 **主流程** 1. 营销企划指定素材或说明要查找的素材条件。 2. 智能体读取符合条件的素材当前信息、素材说明和已有素材标签。 3. 智能体列出说明为空、说明可能过时或缺少标签的素材。 4. 智能体为每条素材分别生成说明草稿和已有标签建议，并显示使用依据。 5. 营销企划选择采用、修改或忽略建议。 6. 需要写入时，智能体再次显示目标素材、修改前内容和修改后内容，等待营销企划确认。 **异常流程** > 1a. 没有素材符合条件 → 智能体显示空结果和实际查询条件，不生成素材建议。 > 2a. 素材信息读取失败 → 智能体说明读取失败，不把失败写成素材信息为空。 > 4a. 没有合适的已有标签 → 智能体说明没有匹配标签；不自行创建标签，除非营销企划另行发起新增素材标签操作。 > 6a. 素材已经更新 → 智能体停止写入，重新读取当前内容并请营销企划检查变化。 **业务规则** - 智能体不能修改素材分类、来源、文件内容、结构化业务数据或公开状态。 - 说明草稿和标签建议必须按单条素材展示，不批量隐藏依据。 - 未经确认的建议不写入素材说明或素材标签。 **后置条件** - 营销企划已处理说明草稿和标签建议；只有经过单独确认的内容可以写入。 --- ### UC-AI系统设置-01 项目管理员查询成员和权限情况 - **优先级**：P1 ```plantuml @startuml left to right direction skinparam shadowing false actor "项目管理员" as Admin usecase "查询成员和权限情况" as UC Admin --> UC @enduml ``` **用例目标** 项目管理员查询当前项目的成员状态、角色权限和相关操作记录。 **角色** 项目管理员。 **前置条件** - 项目管理员已进入当前项目。 - 项目管理员具备「查看成员」「查看角色」和「查看操作日志」功能权限。 - AI PRD §18.2 的成员、角色和权限能力已经启用。 **触发** 项目管理员希望检查成员状态或最近的角色权限变化。 **主流程** 1. 项目管理员说明要检查的成员、角色或时间范围。 2. 智能体读取当前项目内可见的成员、角色和操作记录。 3. 智能体分开返回成员状态、角色权限和相关操作记录。 4. 智能体在业务结果中显示成员、角色和操作日志记录。 5. 项目管理员通过会话补充条件，或另行发起修改。 **异常流程** > 1a. 查询对象不明确 → 智能体请项目管理员补充成员、角色或时间范围。 > 2a. 部分数据无权查看 → 智能体只返回有权查看的内容，并说明未返回内容的权限限制。 > 2b. 数据读取失败 → 智能体说明读取失败和对应的原有功能入口，不把失败写成没有成员或没有操作记录。 **业务规则** - 查询结果只限当前项目。 - 项目管理员不能因为管理员身份查看其他用户的 AI 对话正文或客户临时描述。 - 查询本身不修改成员状态、成员角色或功能权限。 - 修改成员、角色或权限时必须另行显示修改内容，并在用户确认后执行。 **后置条件** - 项目管理员已看到有权查看的成员和权限情况；成员、角色和权限未发生修改。