411 lines
25 KiB
Markdown
411 lines
25 KiB
Markdown
---
|
||
feature_id: "ASA"
|
||
title: "AI 中台管理界面（ai-service-admin）需求规范"
|
||
status: "in-progress"
|
||
version: "0.6.0"
|
||
owners:
|
||
- "product"
|
||
- "frontend"
|
||
- "backend"
|
||
last_updated: "2026-02-27"
|
||
source:
|
||
type: "conversation"
|
||
ref: "Scoping Result Confirmed"
|
||
---
|
||
|
||
# AI 中台管理界面（ASA）
|
||
|
||
## 1. 背景与目标
|
||
- **背景**：随着 AI 中台（ai-service）功能的增强，需要一套专业的管理后台来支持知识库运维、Prompt 工程迭代及 RAG 效果调优。
|
||
- **目标**：提供租户维度的 AI 资产管理能力，实现 RAG 链路的可视化调试与全链路监控。
|
||
- **非目标**：不包含推理引擎实现，不包含面向 C 端的交互 UI。
|
||
|
||
## 2. 模块边界（Scope）
|
||
- **覆盖**：知识库空间与文档管理、索引任务监控、租户级 Prompt 模板版本管理、RAG 实验对比、全局会话审计。
|
||
- **不覆盖**：底层向量数据库维护、模型微调训练。
|
||
|
||
## 3. 依赖盘点（Dependencies）
|
||
- **依赖模块**：
|
||
- `ai-service`：提供所有的管理类 RESTful API（见 `openapi.admin.yaml`）。
|
||
- `RuoYi-Vue-Plus` (或类似基座)：提供用户认证、权限校验及菜单框架。
|
||
|
||
## 4. 用户故事（User Stories）
|
||
|
||
### 4.1 知识库管理
|
||
- [US-ASA-01] 作为租户管理员，我希望能够上传不同格式的文档到指定的知识空间，以便为特定的 AI 场景提供上下文。
|
||
- [US-ASA-02] 作为运维人员，我希望实时查看索引构建任务的进度和错误原因，以便及时处理构建失败的情况。
|
||
|
||
### 4.2 Prompt 工程
|
||
- [US-ASA-03] 作为 Prompt 工程师，我希望对不同场景的 Prompt 进行版本化管理，以便在效果下降时能够快速回滚。
|
||
|
||
### 4.3 RAG 效果实验室
|
||
- [US-ASA-04] 作为 AI 开发者，我希望在后台直接输入问题并查看检索到的文档分片和原始上下文，以便定位召回不准确的问题。
|
||
|
||
### 4.4 监控审计
|
||
- [US-ASA-05] 作为安全合规人员，我希望审计所有租户的会话记录，并查看单次回答的耗时与资源消耗，以便进行成本核算与安全管控。
|
||
|
||
## 5. 验收标准（Acceptance Criteria, EARS）
|
||
|
||
### 知识库管理（KB）
|
||
- [AC-ASA-01] WHEN 提交文档上传 THEN 系统 SHALL 异步启动索引任务，并返回任务 ID。
|
||
- [AC-ASA-02] WHEN 索引任务失败 THEN 系统 SHALL 在管理界面高亮显示，并提供“详细错误”查询入口。
|
||
|
||
### Prompt 管理（Prompt）
|
||
- [AC-ASA-03] WHEN 发布新版 Prompt THEN 系统 SHALL 自动将旧版标记为“历史版本”，且同一时间只有一个“已发布”版本。
|
||
- [AC-ASA-04] WHEN 编辑 Prompt 时 THEN 系统 SHALL 提供内置变量提示（如 `{{context}}`, `{{query}}`）。
|
||
|
||
### RAG 实验室（RAG Lab）
|
||
- [AC-ASA-05] WHEN 运行 RAG 实验 THEN 系统 SHALL 展示 Top-K 检索片段、得分、来源文档及最终生成的提示词。
|
||
- [AC-ASA-06] WHEN 多版本对比时 THEN 系统 SHALL 支持在同一屏幕展示不同配置下的召回差异。
|
||
|
||
### 会话监控（Audit）
|
||
- [AC-ASA-07] WHEN 查看会话详情 THEN 系统 SHALL 展示完整的消息链路，包括中间的工具调用（Tool Calls）和检索命中记录。
|
||
|
||
## 6. 追踪映射（Traceability）
|
||
|
||
| AC ID | Endpoint | 方法 | 备注 |
|
||
|------|----------|------|-----|
|
||
| AC-ASA-01 | /admin/kb/documents | POST | 上传文档并创建任务 |
|
||
| AC-ASA-02 | /admin/kb/index/jobs/{jobId} | GET | 查询任务详情与错误 |
|
||
| AC-ASA-03 | /admin/config/prompt-templates/{tplId}/publish | POST | 发布指定版本 |
|
||
| AC-ASA-05 | /admin/rag/experiments/run | POST | 触发调试实验 |
|
||
| AC-ASA-07 | /admin/sessions/{sessionId} | GET | 获取全链路详情 |
|
||
|
||
---
|
||
|
||
## 7. 迭代需求：嵌入模型管理（v0.2.0）
|
||
|
||
> 说明：本节为 v0.2.0 迭代新增，用于支持嵌入模型的界面配置与管理。
|
||
|
||
### 7.1 嵌入模型配置管理
|
||
|
||
- [AC-ASA-08] WHEN 用户访问嵌入模型配置页面 THEN 系统 SHALL 展示当前激活的嵌入模型提供者及其配置参数。
|
||
|
||
- [AC-ASA-09] WHEN 用户切换嵌入模型提供者 THEN 系统 SHALL 动态展示该提供者的配置参数表单，并保留当前配置值。
|
||
|
||
- [AC-ASA-10] WHEN 用户修改嵌入模型配置并保存 THEN 系统 SHALL 验证配置有效性，更新配置并提示操作结果。
|
||
|
||
- [AC-ASA-11] WHEN 用户点击"测试连接"按钮 THEN 系统 SHALL 调用嵌入模型生成测试向量，展示连接状态、向量维度和响应延迟。
|
||
|
||
- [AC-ASA-12] WHEN 嵌入模型连接测试失败 THEN 系统 SHALL 展示详细错误信息，帮助用户排查配置问题。
|
||
|
||
### 7.2 文档格式支持展示
|
||
|
||
- [AC-ASA-13] WHEN 用户查看嵌入模型配置页面 THEN 系统 SHALL 展示当前支持的文档格式列表（PDF、Word、Excel、TXT 等）。
|
||
|
||
### 7.3 用户故事（迭代追加）
|
||
|
||
- [US-ASA-06] 作为系统管理员，我希望在界面上配置和切换嵌入模型，以便快速适配不同的业务场景而无需修改代码。
|
||
|
||
- [US-ASA-07] 作为系统管理员，我希望在保存配置前测试嵌入模型连接，以便确保配置正确后再正式启用。
|
||
|
||
### 7.4 追踪映射（迭代追加）
|
||
|
||
| AC ID | Endpoint | 方法 | 备注 |
|
||
|------|----------|------|-----|
|
||
| AC-ASA-08 | /admin/embedding/config | GET | 获取当前配置 |
|
||
| AC-ASA-09 | /admin/embedding/providers | GET | 获取提供者列表及配置定义 |
|
||
| AC-ASA-10 | /admin/embedding/config | PUT | 更新配置 |
|
||
| AC-ASA-11 | /admin/embedding/test | POST | 测试连接 |
|
||
| AC-ASA-12 | /admin/embedding/test | POST | 测试失败错误展示 |
|
||
| AC-ASA-13 | /admin/embedding/formats | GET | 获取支持格式 |
|
||
|
||
---
|
||
|
||
## 8. 迭代需求：LLM 模型配置与 RAG 调试输出（v0.3.0）
|
||
|
||
> 说明：本节为 v0.3.0 迭代新增，用于支持 LLM 模型的界面配置及 RAG 实验室的 AI 输出调试。
|
||
|
||
### 8.1 LLM 模型配置管理
|
||
|
||
- [AC-ASA-14] WHEN 用户访问 LLM 模型配置页面 THEN 系统 SHALL 展示当前激活的 LLM 提供者及其配置参数（API Key、Base URL、模型名称等）。
|
||
|
||
- [AC-ASA-15] WHEN 用户切换 LLM 提供者 THEN 系统 SHALL 动态展示该提供者的配置参数表单，并保留当前配置值。
|
||
|
||
- [AC-ASA-16] WHEN 用户修改 LLM 模型配置并保存 THEN 系统 SHALL 验证配置有效性，更新配置并提示操作结果。
|
||
|
||
- [AC-ASA-17] WHEN 用户点击"测试连接"按钮 THEN 系统 SHALL 调用 LLM 生成测试回复，展示连接状态、模型响应和耗时。
|
||
|
||
- [AC-ASA-18] WHEN LLM 连接测试失败 THEN 系统 SHALL 展示详细错误信息，帮助用户排查配置问题。
|
||
|
||
### 8.2 RAG 实验室 AI 输出展示
|
||
|
||
- [AC-ASA-19] WHEN 用户运行 RAG 实验后 THEN 系统 SHALL 在结果区域新增"AI 回复"展示区，显示基于检索结果生成的 AI 最终输出。
|
||
|
||
- [AC-ASA-20] WHEN AI 回复生成中 THEN 系统 SHALL 展示 Loading 状态，支持流式输出展示（SSE）。
|
||
|
||
- [AC-ASA-21] WHEN AI 回复生成完成 THEN 系统 SHALL 展示完整的回复内容、Token 消耗统计、响应耗时。
|
||
|
||
- [AC-ASA-22] WHEN 用户选择不同的 LLM 配置 THEN 系统 SHALL 使用选定的 LLM 模型生成回复，便于对比不同模型效果。
|
||
|
||
### 8.3 用户故事（迭代追加）
|
||
|
||
- [US-ASA-08] 作为系统管理员，我希望在界面上配置和切换不同的 LLM 提供者（如 OpenAI、Ollama、Azure 等），以便快速适配不同的业务场景。
|
||
|
||
- [US-ASA-09] 作为 AI 开发者，我希望在 RAG 实验室中看到 AI 的最终输出，以便完整调试 RAG 链路效果，而不仅仅是检索结果。
|
||
|
||
- [US-ASA-10] 作为 Prompt 工程师，我希望对比不同 LLM 模型在相同检索结果下的回复效果，以便选择最适合业务场景的模型。
|
||
|
||
### 8.4 追踪映射（迭代追加）
|
||
|
||
| AC ID | Endpoint | 方法 | 备注 |
|
||
|------|----------|------|-----|
|
||
| AC-ASA-14 | /admin/llm/config | GET | 获取当前 LLM 配置 |
|
||
| AC-ASA-15 | /admin/llm/providers | GET | 获取 LLM 提供者列表 |
|
||
| AC-ASA-16 | /admin/llm/config | PUT | 更新 LLM 配置 |
|
||
| AC-ASA-17 | /admin/llm/test | POST | 测试 LLM 连接 |
|
||
| AC-ASA-18 | /admin/llm/test | POST | LLM 测试失败错误展示 |
|
||
| AC-ASA-19 | /admin/rag/experiments/run | POST | RAG 实验增加 AI 输出 |
|
||
| AC-ASA-20 | /admin/rag/experiments/stream | POST | RAG 实验流式输出（SSE） |
|
||
| AC-ASA-21 | /admin/rag/experiments/run | POST | Token 统计与耗时 |
|
||
| AC-ASA-22 | /admin/rag/experiments/run | POST | 支持指定 LLM 配置 |
|
||
|
||
---
|
||
|
||
## 9. 迭代需求：智能客服增强管理界面（v0.6.0）
|
||
|
||
> 说明：本节为 v0.6.0 迭代新增，为后端智能客服增强功能提供完整的管理界面，包括 Prompt 模板管理、多知识库管理、意图规则管理、话术流程管理、输出护栏管理。
|
||
|
||
### 9.1 Prompt 模板管理
|
||
|
||
- [AC-ASA-23] WHEN 用户访问 Prompt 模板管理页面 THEN 系统 SHALL 展示当前租户下所有模板列表（含模板名称、场景标签、当前发布版本号、更新时间），支持按场景筛选。
|
||
|
||
- [AC-ASA-24] WHEN 用户点击"新建模板"按钮 THEN 系统 SHALL 展示模板创建表单（名称、场景标签、系统指令编辑区），系统指令编辑区支持 `{{variable}}` 语法高亮提示和内置变量列表参考。
|
||
|
||
- [AC-ASA-25] WHEN 用户编辑模板并保存 THEN 系统 SHALL 调用后端创建新版本，展示版本号变更提示，并在模板详情中展示版本历史列表。
|
||
|
||
- [AC-ASA-26] WHEN 用户点击"发布"按钮 THEN 系统 SHALL 弹出确认对话框，确认后调用发布接口，展示发布成功提示，并更新列表中的发布版本号。
|
||
|
||
- [AC-ASA-27] WHEN 用户在版本历史中点击"回滚到此版本" THEN 系统 SHALL 弹出确认对话框，确认后调用回滚接口，展示回滚成功提示。
|
||
|
||
- [AC-ASA-28] WHEN 用户查看模板详情 THEN 系统 SHALL 展示当前发布版本的完整内容、变量定义列表、版本历史时间线（含版本号、状态、创建时间）。
|
||
|
||
### 9.2 多知识库管理
|
||
|
||
- [AC-ASA-29] WHEN 用户访问知识库管理页面 THEN 系统 SHALL 展示知识库列表（含名称、类型标签、文档数量、优先级、启用状态），替代原有的单一文档列表视图。
|
||
|
||
- [AC-ASA-30] WHEN 用户点击"新建知识库"按钮 THEN 系统 SHALL 展示创建表单（名称、类型选择 product/faq/script/policy/general、描述、优先级权重）。
|
||
|
||
- [AC-ASA-31] WHEN 用户点击知识库卡片/行 THEN 系统 SHALL 进入该知识库的文档管理视图，展示该知识库下的文档列表，上传文档时自动关联到当前知识库。
|
||
|
||
- [AC-ASA-32] WHEN 用户编辑知识库信息 THEN 系统 SHALL 支持修改名称、描述、类型、优先级、启用/禁用状态。
|
||
|
||
- [AC-ASA-33] WHEN 用户删除知识库 THEN 系统 SHALL 弹出二次确认对话框（提示将删除所有关联文档和索引数据），确认后调用删除接口。
|
||
|
||
### 9.3 意图规则管理
|
||
|
||
- [AC-ASA-34] WHEN 用户访问意图规则管理页面 THEN 系统 SHALL 展示规则列表（含意图名称、关键词摘要、响应类型标签、优先级、命中次数、启用状态），支持按响应类型筛选。
|
||
|
||
- [AC-ASA-35] WHEN 用户点击"新建规则"按钮 THEN 系统 SHALL 展示规则创建表单：
|
||
- 基础信息：意图名称、优先级
|
||
- 匹配条件：关键词标签输入（支持多个）、正则表达式输入（支持多个，带语法校验提示）
|
||
- 响应配置：响应类型选择（fixed/rag/flow/transfer），根据类型动态展示：
|
||
- `fixed`：固定回复文本编辑区
|
||
- `rag`：知识库多选下拉
|
||
- `flow`：话术流程选择下拉
|
||
- `transfer`：转人工话术编辑区
|
||
|
||
- [AC-ASA-36] WHEN 用户编辑或删除规则 THEN 系统 SHALL 支持修改所有字段，删除时弹出确认对话框。
|
||
|
||
### 9.4 话术流程管理
|
||
|
||
- [AC-ASA-37] WHEN 用户访问话术流程管理页面 THEN 系统 SHALL 展示流程列表（含流程名称、步骤数、启用状态、关联意图规则数）。
|
||
|
||
- [AC-ASA-38] WHEN 用户点击"新建流程"按钮 THEN 系统 SHALL 展示流程编辑器：
|
||
- 基础信息：流程名称、描述
|
||
- 步骤编辑区：支持添加/删除/拖拽排序步骤，每个步骤包含：
|
||
- 话术内容编辑（支持 `{{variable}}` 占位符）
|
||
- 等待用户输入开关
|
||
- 超时设置（秒数 + 超时动作选择：重复/跳过/转人工）
|
||
- 下一步条件配置（关键词匹配列表 + 跳转目标步骤）
|
||
|
||
- [AC-ASA-39] WHEN 用户查看流程详情 THEN 系统 SHALL 以步骤流程图或时间线形式展示完整流程，直观呈现步骤间的跳转关系。
|
||
|
||
### 9.5 输出护栏管理
|
||
|
||
- [AC-ASA-40] WHEN 用户访问输出护栏管理页面 THEN 系统 SHALL 展示两个标签页：「禁词管理」和「行为规则」。
|
||
|
||
- [AC-ASA-41] WHEN 用户在禁词管理标签页 THEN 系统 SHALL 展示禁词列表（含词语、类别标签、替换策略、命中次数、启用状态），支持按类别筛选，支持批量导入（CSV/文本，每行一个词）。
|
||
|
||
- [AC-ASA-42] WHEN 用户点击"添加禁词"按钮 THEN 系统 SHALL 展示添加表单：词语、类别选择（competitor/sensitive/political/custom）、替换策略选择（mask/replace/block），根据策略动态展示：
|
||
- `replace`：替换文本输入框
|
||
- `block`：兜底话术输入框
|
||
|
||
- [AC-ASA-43] WHEN 用户在行为规则标签页 THEN 系统 SHALL 展示行为规则列表（含规则描述、类别、启用状态），支持添加/编辑/删除/启用/禁用。
|
||
|
||
- [AC-ASA-44] WHEN 用户添加行为规则 THEN 系统 SHALL 展示添加表单：规则描述文本区、类别选择（compliance/tone/boundary/custom）。
|
||
|
||
### 9.6 用户故事（v0.6.0 迭代追加）
|
||
|
||
- [US-ASA-11] 作为 Prompt 工程师，我希望在界面上创建和管理不同场景的 Prompt 模板，支持版本管理和一键回滚，以便快速迭代 AI 人设和话术风格。
|
||
|
||
- [US-ASA-12] 作为运营人员，我希望创建多个知识库并按类型分类（产品/FAQ/话术/政策），以便让 AI 在不同场景下检索最相关的知识。
|
||
|
||
- [US-ASA-13] 作为运营人员，我希望配置意图识别规则，让特定问题走固定回复或话术流程，以便保证关键场景的回复一致性。
|
||
|
||
- [US-ASA-14] 作为运营人员，我希望编排多步骤的话术流程，引导用户按固定步骤完成信息收集，以便提升客服效率。
|
||
|
||
- [US-ASA-15] 作为合规人员，我希望配置禁词和行为规则，确保 AI 不会输出竞品名称、敏感信息或违规承诺，以便满足合规要求。
|
||
|
||
### 9.7 追踪映射（v0.6.0 迭代追加）
|
||
|
||
| AC ID | Endpoint | 方法 | 备注 |
|
||
|------|----------|------|-----|
|
||
| AC-ASA-23 | /admin/prompt-templates | GET | Prompt 模板列表 |
|
||
| AC-ASA-24 | /admin/prompt-templates | POST | 创建模板 |
|
||
| AC-ASA-25 | /admin/prompt-templates/{tplId} | PUT | 更新模板 |
|
||
| AC-ASA-26 | /admin/prompt-templates/{tplId}/publish | POST | 发布模板 |
|
||
| AC-ASA-27 | /admin/prompt-templates/{tplId}/rollback | POST | 回滚模板 |
|
||
| AC-ASA-28 | /admin/prompt-templates/{tplId} | GET | 模板详情 |
|
||
| AC-ASA-29 | /admin/kb/knowledge-bases | GET | 知识库列表 |
|
||
| AC-ASA-30 | /admin/kb/knowledge-bases | POST | 创建知识库 |
|
||
| AC-ASA-31 | /admin/kb/documents | GET | 知识库文档列表 |
|
||
| AC-ASA-32 | /admin/kb/knowledge-bases/{kbId} | PUT | 更新知识库 |
|
||
| AC-ASA-33 | /admin/kb/knowledge-bases/{kbId} | DELETE | 删除知识库 |
|
||
| AC-ASA-34 | /admin/intent-rules | GET | 意图规则列表 |
|
||
| AC-ASA-35 | /admin/intent-rules | POST | 创建意图规则 |
|
||
| AC-ASA-36 | /admin/intent-rules/{ruleId} | PUT/DELETE | 编辑/删除规则 |
|
||
| AC-ASA-37 | /admin/script-flows | GET | 话术流程列表 |
|
||
| AC-ASA-38 | /admin/script-flows | POST | 创建话术流程 |
|
||
| AC-ASA-39 | /admin/script-flows/{flowId} | GET | 流程详情 |
|
||
| AC-ASA-40 | - | - | 护栏管理页面布局 |
|
||
| AC-ASA-41 | /admin/guardrails/forbidden-words | GET | 禁词列表 |
|
||
| AC-ASA-42 | /admin/guardrails/forbidden-words | POST | 添加禁词 |
|
||
| AC-ASA-43 | /admin/guardrails/behavior-rules | GET | 行为规则列表 |
|
||
| AC-ASA-44 | /admin/guardrails/behavior-rules | POST | 添加行为规则 |
|
||
|
||
---
|
||
|
||
## 10. 迭代需求：对话流程测试与监控（v0.7.0）
|
||
|
||
> 说明：本节为 v0.7.0 迭代新增，为 v0.6.0 新增的四个对话流程控制功能（Prompt 模板、意图规则、话术流程、输出护栏）提供完整的测试和监控能力。
|
||
|
||
### 10.1 Dashboard 统计增强
|
||
|
||
- [AC-ASA-45] WHEN 用户访问 Dashboard 页面 THEN 系统 SHALL 在现有统计卡片基础上新增四个统计卡片：
|
||
- 意图规则命中率（命中次数/总对话次数）
|
||
- Prompt 模板使用次数（按模板分组统计）
|
||
- 话术流程激活次数（按流程分组统计）
|
||
- 护栏拦截次数（按类别分组统计）
|
||
|
||
- [AC-ASA-46] WHEN 用户点击统计卡片 THEN 系统 SHALL 跳转到对应的详细监控页面（如点击"意图规则命中率"跳转到意图规则监控页面）。
|
||
|
||
- [AC-ASA-47] WHEN Dashboard 加载统计数据 THEN 系统 SHALL 支持按时间范围筛选（今日/本周/本月/自定义），并展示趋势图表。
|
||
|
||
### 10.2 对话流程测试台（RAG 实验室扩展）
|
||
|
||
- [AC-ASA-48] WHEN 用户访问 RAG 实验室页面 THEN 系统 SHALL 在原有检索测试基础上新增"完整流程测试"模式切换开关。
|
||
|
||
- [AC-ASA-49] WHEN 用户切换到"完整流程测试"模式并输入测试消息 THEN 系统 SHALL 调用后端完整的 12 步生成流程，并以可视化时间线形式展示每一步的执行结果：
|
||
- Step 1: 输入扫描（敏感词检测结果）
|
||
- Step 2: 流程检查（是否存在进行中的话术流程）
|
||
- Step 3: 意图匹配（命中的规则名称、匹配的关键词/正则）
|
||
- Step 4: Prompt 模板（使用的模板名称、版本号、渲染后的系统指令）
|
||
- Step 5-7: RAG 检索（检索的知识库、Top-K 结果、相似度分数）
|
||
- Step 8: 话术流程（流程状态、当前步骤、下一步动作）
|
||
- Step 9: LLM 生成（使用的模型、Token 消耗、生成耗时）
|
||
- Step 10: 上下文管理（会话历史长度、记忆摘要）
|
||
- Step 11: 输出护栏（命中的禁词、替换策略、是否拦截）
|
||
- Step 12: 最终输出（完整回复内容、置信度、是否转人工）
|
||
|
||
- [AC-ASA-50] WHEN 某一步执行失败或跳过 THEN 系统 SHALL 在时间线中标记该步骤状态（成功/失败/跳过），并展示失败原因或跳过原因。
|
||
|
||
- [AC-ASA-51] WHEN 用户点击时间线中的某一步 THEN 系统 SHALL 展开该步骤的详细数据（JSON 格式），支持复制和导出。
|
||
|
||
- [AC-ASA-52] WHEN 用户在测试台中修改配置（如切换 Prompt 模板、指定知识库、调整检索参数）THEN 系统 SHALL 支持对比测试，并行展示不同配置下的执行结果差异。
|
||
|
||
### 10.3 意图规则测试与监控
|
||
|
||
- [AC-ASA-53] WHEN 用户在意图规则管理页面点击"测试"按钮 THEN 系统 SHALL 弹出测试对话框，输入测试消息后展示：
|
||
- 是否命中该规则
|
||
- 匹配的关键词或正则表达式
|
||
- 规则优先级排序中的位置
|
||
- 如果未命中，展示原因（关键词不匹配/正则不匹配/优先级被其他规则抢占）
|
||
|
||
- [AC-ASA-54] WHEN 用户访问意图规则监控页面 THEN 系统 SHALL 展示规则命中统计表格（含规则名称、命中次数、命中率、最近命中时间、平均响应时间），支持按时间范围筛选和导出。
|
||
|
||
- [AC-ASA-55] WHEN 用户点击规则命中统计表格中的某一行 THEN 系统 SHALL 展示该规则的详细命中记录列表（含用户消息、命中时间、匹配的关键词、响应类型、执行结果）。
|
||
|
||
### 10.4 Prompt 模板测试与监控
|
||
|
||
- [AC-ASA-56] WHEN 用户在 Prompt 模板管理页面点击"预览"按钮 THEN 系统 SHALL 弹出预览对话框，展示：
|
||
- 模板原始内容（含变量占位符）
|
||
- 变量列表及当前值（支持手动输入测试值）
|
||
- 渲染后的完整 Prompt（变量替换后的最终内容）
|
||
|
||
- [AC-ASA-57] WHEN 用户在预览对话框中修改变量值 THEN 系统 SHALL 实时更新渲染后的 Prompt 内容。
|
||
|
||
- [AC-ASA-58] WHEN 用户访问 Prompt 模板监控页面 THEN 系统 SHALL 展示模板使用统计表格（含模板名称、使用次数、平均 Token 消耗、最近使用时间），支持按场景标签筛选。
|
||
|
||
### 10.5 话术流程测试与监控
|
||
|
||
- [AC-ASA-59] WHEN 用户在话术流程管理页面点击"模拟执行"按钮 THEN 系统 SHALL 弹出模拟对话框，按步骤展示话术内容，用户可输入模拟回复，系统根据下一步条件推进流程，直到流程结束。
|
||
|
||
- [AC-ASA-60] WHEN 用户访问话术流程监控页面 THEN 系统 SHALL 展示流程激活统计表格（含流程名称、激活次数、完成率、平均完成时长、中断率），支持按时间范围筛选。
|
||
|
||
- [AC-ASA-61] WHEN 用户点击流程激活统计表格中的某一行 THEN 系统 SHALL 展示该流程的详细执行记录列表（含会话 ID、激活时间、当前步骤、执行状态、中断原因）。
|
||
|
||
### 10.6 输出护栏测试与监控
|
||
|
||
- [AC-ASA-62] WHEN 用户在输出护栏管理页面点击"测试"按钮 THEN 系统 SHALL 弹出测试对话框，输入测试文本后展示：
|
||
- 命中的禁词列表（含词语、类别、位置）
|
||
- 应用的替换策略（mask/replace/block）
|
||
- 处理后的文本内容
|
||
|
||
- [AC-ASA-63] WHEN 用户访问输出护栏监控页面 THEN 系统 SHALL 展示护栏拦截统计表格（含禁词、拦截次数、类别、最近拦截时间），支持按类别筛选和导出。
|
||
|
||
- [AC-ASA-64] WHEN 用户点击护栏拦截统计表格中的某一行 THEN 系统 SHALL 展示该禁词的详细拦截记录列表（含原始文本、处理后文本、拦截时间、会话 ID）。
|
||
|
||
### 10.7 对话追踪页面
|
||
|
||
- [AC-ASA-65] WHEN 用户访问对话追踪页面 THEN 系统 SHALL 展示对话记录列表（含会话 ID、用户消息、AI 回复、触发的规则、使用的模板、执行耗时、创建时间），支持按时间范围、规则类型、模板、流程筛选。
|
||
|
||
- [AC-ASA-66] WHEN 用户点击对话记录列表中的某一行 THEN 系统 SHALL 展开该对话的完整执行链路（12 步流程详情），以折叠面板形式展示每一步的输入输出和执行状态。
|
||
|
||
- [AC-ASA-67] WHEN 用户在对话追踪页面点击"回放"按钮 THEN 系统 SHALL 以动画形式回放该对话的执行流程，逐步展示每一步的执行过程和数据流转。
|
||
|
||
- [AC-ASA-68] WHEN 用户在对话追踪页面点击"导出"按钮 THEN 系统 SHALL 支持导出对话记录为 JSON/CSV 格式，包含完整的执行链路数据。
|
||
|
||
### 10.8 用户故事（v0.7.0 迭代追加）
|
||
|
||
- [US-ASA-16] 作为 AI 开发者，我希望在测试台中输入测试消息并查看完整的 12 步执行流程，以便快速定位问题和优化配置。
|
||
|
||
- [US-ASA-17] 作为运营人员，我希望查看意图规则的命中统计和详细记录，以便评估规则效果并优化关键词配置。
|
||
|
||
- [US-ASA-18] 作为 Prompt 工程师，我希望预览 Prompt 模板的渲染结果并查看使用统计，以便评估模板效果并迭代优化。
|
||
|
||
- [US-ASA-19] 作为运营人员，我希望模拟执行话术流程并查看激活统计，以便验证流程设计并优化步骤配置。
|
||
|
||
- [US-ASA-20] 作为合规人员，我希望测试输出护栏并查看拦截统计，以便确保禁词配置有效并满足合规要求。
|
||
|
||
- [US-ASA-21] 作为系统管理员，我希望查看对话追踪记录并回放执行流程，以便排查问题和分析系统行为。
|
||
|
||
### 10.9 追踪映射（v0.7.0 迭代追加）
|
||
|
||
| AC ID | Endpoint | 方法 | 备注 |
|
||
|------|----------|------|-----|
|
||
| AC-ASA-45 | /admin/dashboard/stats | GET | Dashboard 统计增强 |
|
||
| AC-ASA-46 | - | - | 前端路由跳转 |
|
||
| AC-ASA-47 | /admin/dashboard/stats | GET | 时间范围筛选参数 |
|
||
| AC-ASA-48 | - | - | 前端模式切换 |
|
||
| AC-ASA-49 | /admin/test/flow-execution | POST | 完整流程测试 |
|
||
| AC-ASA-50 | /admin/test/flow-execution | POST | 步骤状态标记 |
|
||
| AC-ASA-51 | - | - | 前端详情展开 |
|
||
| AC-ASA-52 | /admin/test/flow-execution | POST | 对比测试参数 |
|
||
| AC-ASA-53 | /admin/intent-rules/{ruleId}/test | POST | 意图规则测试 |
|
||
| AC-ASA-54 | /admin/monitoring/intent-rules | GET | 意图规则监控统计 |
|
||
| AC-ASA-55 | /admin/monitoring/intent-rules/{ruleId}/hits | GET | 规则命中记录 |
|
||
| AC-ASA-56 | /admin/prompt-templates/{tplId}/preview | POST | Prompt 模板预览 |
|
||
| AC-ASA-57 | - | - | 前端实时渲染 |
|
||
| AC-ASA-58 | /admin/monitoring/prompt-templates | GET | Prompt 模板监控统计 |
|
||
| AC-ASA-59 | /admin/script-flows/{flowId}/simulate | POST | 话术流程模拟执行 |
|
||
| AC-ASA-60 | /admin/monitoring/script-flows | GET | 话术流程监控统计 |
|
||
| AC-ASA-61 | /admin/monitoring/script-flows/{flowId}/executions | GET | 流程执行记录 |
|
||
| AC-ASA-62 | /admin/guardrails/test | POST | 输出护栏测试 |
|
||
| AC-ASA-63 | /admin/monitoring/guardrails | GET | 输出护栏监控统计 |
|
||
| AC-ASA-64 | /admin/monitoring/guardrails/{wordId}/blocks | GET | 禁词拦截记录 |
|
||
| AC-ASA-65 | /admin/monitoring/conversations | GET | 对话追踪列表 |
|
||
| AC-ASA-66 | /admin/monitoring/conversations/{conversationId} | GET | 对话执行链路详情 |
|
||
| AC-ASA-67 | - | - | 前端回放动画 |
|
||
| AC-ASA-68 | /admin/monitoring/conversations/export | POST | 对话记录导出 |
|