Commit Graph

95 Commits

Author SHA1 Message Date
MerCry aa02ab79d2 feat(AC-AISVC-93): 完整流程测试12步执行时间线与步骤详情
改进内容:
- 每个步骤添加详细的input_data和output_data
- InputScanner: 显示用户输入文本
- FlowEngine: 显示会话ID和流程名称
- IntentRouter: 显示查询和匹配结果
- QueryRewriter: 显示查询和重写状态
- MultiKBRetrieval: 显示查询、top_k、命中数、最高分、top_hits详情
- PromptBuilder: 显示模板ID、行为规则、prompt预览
- LLMGenerate: 显示模型名称(deepseek-chat)、回复长度、回复预览
- OutputFilter: 显示文本长度、是否过滤、触发词
- Confidence: 显示回复长度、命中数、置信度、是否转人工
- Memory: 显示会话ID、保存状态
- Response: 显示置信度、是否转人工、回复预览

修复问题:
- OrchestratorService没有返回execution_steps
- 前端字段名与后端不一致(camelCase vs snake_case)
- RetrievalResult.evidence -> RetrievalResult.hits
- LLM模型名称显示unknown -> 显示实际模型名称
2026-02-28 14:01:15 +08:00
MerCry 6b21ba8351 feat(v0.7.0): 验收通过 - Dashboard统计增强、流程测试、对话追踪
验收通过的标准:
- AC-ASA-59~64: 前端话术流程和护栏监控功能验收
- AC-AISVC-91~95: Dashboard统计增强和完整流程测试验收
- AC-AISVC-108~110: 对话追踪和导出功能验收

修复问题:
- flow_test.py: 修复OrchestratorService导入和调用
- 前后端字段不一致: orderstep_no, wait_for_inputwait_input
- 数据库迁移: 添加chat_messages缺失的监控字段

新增文件:
- ai-service/app/api/admin/flow_test.py
- ai-service/scripts/migrations/add_chat_message_fields.py
- ai-service-admin/src/views/admin/prompt-template/components/VariableManager.vue
2026-02-28 12:52:50 +08:00
MerCry 5fbb72aa82 feat(admin): v0.7.0 前端监控功能增强 - Dashboard统计卡片与对话追踪
- Dashboard 统计卡片增强
  - 新增四个监控统计卡片:意图规则命中、Prompt模板、话术流程、护栏拦截
  - 支持时间范围筛选(今日/本周/本月/最近7天/最近30天)
  - 显示Top 3排行数据,卡片支持点击跳转

- 完整流程测试台
  - RAG实验室新增完整流程测试模式切换
  - 支持12步执行流程时间线展示
  - 支持步骤详情展开查看输入输出
  - 流程配置开关(意图识别、话术流程、RAG检索、输出护栏、上下文记忆)

- 对话追踪页面
  - 对话列表支持会话ID、时间范围、流程、护栏筛选
  - 对话详情展示触发规则、使用模板、话术流程
  - 执行链路时间线展示
  - 导出功能支持JSON/CSV格式

- 监控导航路由
  - 新增 /admin/monitoring/conversations 路由

验收标准: AC-ASA-45~AC-ASA-52, AC-ASA-65~AC-ASA-68
2026-02-28 00:30:54 +08:00
MerCry 3cf7d02daf feat(v0.7.0): implement intent rule testing and prompt template monitoring
Backend APIs:
- [AC-AISVC-96] POST /admin/intent-rules/{ruleId}/test - Intent rule testing with conflict detection
- [AC-AISVC-97] GET /admin/monitoring/intent-rules - Intent rule statistics
- [AC-AISVC-98] GET /admin/monitoring/intent-rules/{ruleId}/hits - Intent rule hit records
- [AC-AISVC-99] POST /admin/prompt-templates/{tplId}/preview - Prompt template preview with token count
- [AC-AISVC-100] GET /admin/monitoring/prompt-templates - Prompt template usage statistics

Frontend Components:
- [AC-ASA-53] IntentRuleTestDialog - Test dialog for intent rules
- [AC-ASA-54/55] IntentRules monitoring page with hit records drawer
- [AC-ASA-56/57] PromptTemplatePreviewDialog with variable editing
- [AC-ASA-58] PromptTemplates monitoring page with scene breakdown

New files:
- ai-service/app/services/intent/tester.py
- ai-service/app/services/monitoring/intent_monitor.py
- ai-service/app/services/monitoring/prompt_monitor.py
- ai-service/app/api/admin/monitoring.py
- ai-service-admin/src/views/admin/intent-rule/components/TestDialog.vue
- ai-service-admin/src/views/admin/monitoring/IntentRules.vue
- ai-service-admin/src/views/admin/monitoring/PromptTemplates.vue
- ai-service-admin/src/views/admin/prompt-template/components/PreviewDialog.vue
2026-02-27 23:15:46 +08:00
MerCry c005066162 feat(v0.7.0-window2): implement flow simulation and guardrail testing/monitoring
Refs: AC-AISVC-101, AC-AISVC-102, AC-AISVC-103, AC-AISVC-104, AC-AISVC-105, AC-AISVC-106, AC-AISVC-107
Refs: AC-ASA-59, AC-ASA-60, AC-ASA-61, AC-ASA-62, AC-ASA-63, AC-ASA-64

Backend changes:
- New: ai-service/app/services/flow/tester.py (ScriptFlowTester)
- New: ai-service/app/services/guardrail/tester.py (GuardrailTester)
- New: ai-service/app/services/monitoring/flow_monitor.py (FlowMonitor)
- New: ai-service/app/services/monitoring/guardrail_monitor.py (GuardrailMonitor)
- Modified: ai-service/app/api/admin/script_flows.py (add POST /{flowId}/simulate)
- Modified: ai-service/app/api/admin/guardrails.py (add POST /test)
- Modified: ai-service/app/api/admin/monitoring.py (add flow/guardrail stats endpoints)

Frontend changes:
- New: SimulateDialog.vue (flow simulation dialog)
- New: TestDialog.vue (guardrail test dialog)
- New: ScriptFlows.vue (flow monitoring page)
- New: Guardrails.vue (guardrail monitoring page)
- Extended: API services (monitoring.ts, script-flow.ts, guardrail.ts)
- Updated: Router with new monitoring routes
2026-02-27 23:13:45 +08:00
MerCry e4dbcda150 fix(AISVC): 修复 knowledge-bases 接口 500 错误 [AC-AISVC-60]
- 添加 KnowledgeBaseService 服务类用于知识库 CRUD 操作
- 添加数据库迁移脚本,补充 knowledge_bases 表缺失字段
  - kb_type: 知识库类型
  - priority: 优先级
  - is_enabled: 是否启用
  - doc_count: 文档数量
- 修复前端 intent-rules 页面加载时知识库接口报错问题
2026-02-27 21:37:48 +08:00
MerCry c06e0dd15c fix(ASA): 修复模板变量语法错误并安装 vuedraggable 依赖 2026-02-27 19:22:26 +08:00
MerCry 7ac00389c7 fix(ASA): 修复 Shield 图标不存在的问题,改用 Warning 图标 2026-02-27 18:48:56 +08:00
MerCry c1f5d3229f feat(ASA): 添加导航菜单入口,将系统配置整合为下拉菜单
- 将知识库导航指向新的多知识库管理页面
- 将嵌入模型、LLM 配置、Prompt 模板、意图规则、话术流程、输出护栏整合到「系统配置」下拉菜单
- 添加下拉菜单样式和交互效果
2026-02-27 18:47:43 +08:00
MerCry 932d4d15ab feat(ASA): 实现 Phase 8-12 前端管理页面 [AC-ASA-23~AC-ASA-44]
实现内容:
- Phase 8: Prompt 模板管理页面(列表、编辑、版本历史、发布/回滚)
- Phase 9: 多知识库管理页面(卡片列表、文档管理)
- Phase 10: 意图规则管理页面(动态表单、关键词/正则输入组件)
- Phase 11: 话术流程管理页面(步骤拖拽编辑、流程预览)
- Phase 12: 输出护栏管理页面(禁词管理、行为规则)

新增文件:
- src/types/prompt-template.ts, knowledge-base.ts, intent-rule.ts, script-flow.ts, guardrail.ts
- src/api/prompt-template.ts, knowledge-base.ts, intent-rule.ts, script-flow.ts, guardrail.ts
- src/views/admin/prompt-template/index.vue, components/TemplateDetail.vue
- src/views/admin/knowledge-base/index.vue, components/DocumentList.vue
- src/views/admin/intent-rule/index.vue, components/KeywordInput.vue, components/PatternInput.vue
- src/views/admin/script-flow/index.vue, components/FlowPreview.vue
- src/views/admin/guardrail/index.vue, components/ForbiddenWordsTab.vue, components/BehaviorRulesTab.vue

更新:
- src/router/index.ts - 添加 5 个新路由
- package.json - 添加 vuedraggable 依赖
- docs/progress/ai-service-admin-progress.md - 更新进度
- spec/ai-service-admin/tasks.md - 更新任务状态
2026-02-27 18:33:25 +08:00
MerCry d4b0bc3101 docs: 更新 Phase 13 话术流程引擎进度文档 [AC-AISVC-71~AC-AISVC-77] 2026-02-27 17:59:23 +08:00
MerCry fba9b9313c docs: update ai-service-admin progress for Phase 8-12 [AC-ASA-23~AC-ASA-44] 2026-02-27 17:58:49 +08:00
MerCry f80f8f72bf docs: update tasks and progress for Phase 14 output guardrail [AC-AISVC-78~AC-AISVC-85] 2026-02-27 17:53:17 +08:00
MerCry 8c259cee30 feat: implement output guardrail with forbidden word detection and behavior rules [AC-AISVC-78~AC-AISVC-85] 2026-02-27 16:40:02 +08:00
MerCry 9d8ecf0bb2 feat: 实现话术流程引擎 (Phase 13 T13.1-T13.6) [AC-AISVC-71~AC-AISVC-76]
- 新增 ScriptFlow 和 FlowInstance SQLModel 实体
- 实现 ScriptFlowService:流程定义 CRUD、步骤校验
- 实现 FlowEngine 状态机引擎:check_active_flow、start、advance、handle_timeout
- 实现话术流程管理 API(POST/GET/PUT /admin/script-flows)
- T13.7(单元测试)留待集成阶段
2026-02-27 15:27:02 +08:00
MerCry ff35538a01 feat(ai-service): implement intent recognition and rule engine (Phase 12 T12.1-T12.5)
[AC-AISVC-65~AC-AISVC-70] Intent recognition with keyword and regex matching

- Add IntentRule SQLModel entity with tenant isolation
- Implement IntentRuleService for CRUD operations with hit statistics
- Implement IntentRouter matching engine (priority DESC, keyword then regex)
- Add rule caching by tenant_id with TTL=60s and CRUD invalidation
- Add intent rules management API (POST/GET/PUT/DELETE /admin/intent-rules)
- Support four response types: fixed/rag/flow/transfer

T12.6 (Orchestrator integration) and T12.7 (unit tests) pending for integration phase
2026-02-27 14:20:31 +08:00
MerCry eb93636227 feat: 实现 Prompt 模板化功能 (Phase 10 T10.1-T10.8) [AC-AISVC-51~AC-AISVC-58]
- 新增 PromptTemplate 和 PromptTemplateVersion SQLModel 实体
- 实现 PromptTemplateService:模板 CRUD、版本管理、发布/回滚、缓存
- 实现 VariableResolver:内置变量注入和自定义变量替换
- 实现 Prompt 模板管理 API(CRUD + 发布/回滚)
- T10.9(修改 Orchestrator)和 T10.10(单元测试)留待集成阶段
2026-02-27 14:15:10 +08:00
MerCry 0f1fa7de5c chore: 修改前端端口映射为8183 [AC-AISVC-50] 2026-02-26 20:05:39 +08:00
MerCry 87de47a5df fix: 添加ai-service配置目录volume持久化 [AC-AISVC-50]
- 添加 ai_service_config volume 挂载到 /app/config
- 解决重建容器时配置文件丢失的问题
2026-02-26 20:04:22 +08:00
MerCry a9d1079294 fix: 修复编排器使用错误的LLM配置问题 [AC-AISVC-50]
- 移除编排器中硬编码的LLMConfig创建
- 让LLM客户端使用自己的默认配置(从LLMConfigManager获取)
- 修复流式生成方法同样的问题
2026-02-26 19:58:55 +08:00
MerCry f81d18a517 feat: 添加LLM配置持久化功能 [AC-AISVC-50]
- LLM配置保存到 config/llm_config.json 文件
- 服务重启后自动加载已保存的配置
- 与嵌入模型配置保持一致的持久化机制
2026-02-26 19:30:26 +08:00
MerCry 15016d3448 fix: 适配qdrant-client 1.17.0 API变更,search方法改为query_points [AC-AISVC-50]
- qdrant-client 1.10+ 版本移除了 search() 方法,改用 query_points()
- 使用 collection_exists() 替代 get_collections() 检查集合存在
- 更新返回结果处理:results.points 替代 results
- 更新 pyproject.toml 版本约束为 >=1.9.0,<2.0.0
- 修正 README.md 中的 docker 命令示例
2026-02-26 19:07:04 +08:00
MerCry d660c19ab9 feat: 添加嵌入配置持久化及模型切换警告 [AC-AISVC-50]
- 添加嵌入配置持久化到config/embedding_config.json
- 服务启动时自动加载保存的配置
- 切换模型时前端显示警告提示需要重新上传文档
- 修复OptimizedRetriever缓存问题,每次检索获取最新配置
- 清理调试用的Python临时文件
- 更新.gitignore忽略config目录
2026-02-26 18:01:03 +08:00
MerCry fd04ed2cef fix: 修复RAG检索多个问题并更新嵌入模型配置 [AC-AISVC-50]
主要修复:
1. 修复ConfigForm和EmbeddingConfigForm组件watch死循环导致内存溢出
2. 修复向量存储格式与检索格式不匹配问题
3. 修复两阶段检索和混合检索互斥问题
4. 修复RRF融合时vector字段丢失问题
5. 修复embedding_full未归一化导致相似度计算错误
6. 修复嵌入模型配置表单不显示参数问题

功能增强:
- 添加with_vectors参数支持返回向量用于重排序
- 新增两阶段+混合检索组合策略
- 更新README嵌入模型配置说明,推荐nomic-embed-text-v2-moe
- 添加cleanup_qdrant.py脚本用于清理向量数据
2026-02-26 14:45:21 +08:00
MerCry 6150fc0dd2 fix: 修复RAG检索无结果问题-向量存储格式与检索格式不匹配 [AC-AISVC-50] 2026-02-26 12:39:42 +08:00
MerCry 3f1f4cd98d fix: 修复ConfigForm和EmbeddingConfigForm组件watch死循环导致内存溢出 [AC-AISVC-50] 2026-02-26 12:30:04 +08:00
MerCry 6c16132557 fix: 修复EmbeddingConfigForm组件watch无限循环 [AC-AISVC-50] 2026-02-26 12:20:49 +08:00
MerCry a4af74751f fix: 修复ConfigForm组件watch无限循环导致内存溢出 [AC-AISVC-50]
- 添加 JSON.stringify 比较避免 watch 循环触发
- 修复前端页面崩溃问题
2026-02-26 12:17:52 +08:00
MerCry b11b5a027f fix: 更新数据库脚本添加chat_messages缺失字段 [AC-AISVC-50]
- init_db.sql 添加 prompt_tokens, completion_tokens, total_tokens 等字段
- 新增 migrate_add_columns.sql 用于现有数据库迁移
2026-02-26 12:10:14 +08:00
MerCry 72700038c6 fix: 简化Nginx代理配置,移除upstream变量 [AC-AISVC-50] 2026-02-26 11:50:03 +08:00
MerCry 97e7fd0992 feat: 添加API Key认证系统和修复Qdrant搜索问题 [AC-AISVC-50]
- 新增 API Key 数据库模型和服务
- 新增 ApiKeyMiddleware 认证中间件
- 新增 /admin/api-keys 管理接口
- 前端支持 VITE_APP_API_KEY 环境变量
- 修复 optimized_retriever.py 中 Qdrant 搜索调用方式
- 更新 Dockerfile 支持构建时传入 API Key
- 更新 docker-compose.yaml 支持前端 API Key 配置
2026-02-26 03:11:36 +08:00
MerCry ee2c7c0d0c feat: 添加API Key认证功能 [AC-AISVC-50]
- 新增 ApiKey 模型和数据库表
- 新增 ApiKeyService 服务,支持内存缓存验证
- 新增 ApiKeyMiddleware 中间件,验证所有请求
- 应用启动时自动创建默认 API Key
- 新增 /admin/api-keys 管理接口
2026-02-26 02:52:50 +08:00
MerCry 77033efd34 fix: 移除docker-compose过时的version字段 [AC-AISVC-01] 2026-02-26 02:45:00 +08:00
MerCry 1000158550 fix: 修复Docker部署健康检查路径和API Key配置 [AC-AISVC-01]
- 修正docker-compose.yaml中健康检查路径从/health改为/ai/health
- 在middleware中添加/ai/health到API Key和租户检查的跳过列表
- 添加前端.env.example配置文件说明API Key配置方法
- 更新README添加API Key配置步骤说明
2026-02-26 02:41:33 +08:00
MerCry c7a71d6e03 fix: 添加python-multipart依赖解决表单解析错误 [AC-AISVC-01] 2026-02-26 02:29:56 +08:00
MerCry 40ff48498f fix: nginx使用变量延迟解析upstream避免启动报错 [AC-AISVC-01] 2026-02-26 02:28:44 +08:00
MerCry a60a760951 fix: 显式安装rollup原生模块解决Alpine构建问题 [AC-AISVC-01] 2026-02-26 02:23:02 +08:00
MerCry bd38e7816a fix: 修复npm可选依赖安装问题 [AC-AISVC-01] 2026-02-26 02:21:30 +08:00
MerCry b91b57cfa4 fix: 修复TypeScript类型错误以兼容vue-tsc v2 [AC-AISVC-01] 2026-02-26 02:19:51 +08:00
MerCry 5b3f5063a6 fix: 升级vue-tsc到v2解决TypeScript兼容性问题 [AC-AISVC-01] 2026-02-26 02:15:13 +08:00
MerCry a3b7f2cc51 fix: Docker构建时复制README.md文件 [AC-AISVC-01] 2026-02-26 02:13:26 +08:00
MerCry 366f38e17f fix: 使用国内镜像加速Docker构建 [AC-AISVC-01] 2026-02-26 02:12:04 +08:00
MerCry 7c8e4b6dc7 feat: 调整端口映射,后端8182供Java渠道侧调用 [AC-AISVC-01]
- 后端端口从8080改为8182(宿主机映射)
- 前端端口8181保持不变
- 更新宿主机Nginx配置示例,支持前后端分离代理
- 容器间通信使用内部网络,无需修改
2026-02-26 01:46:24 +08:00
MerCry b6218dec1a feat: 调整前端端口为8181并添加宿主机Nginx配置示例 [AC-AISVC-01]
- 前端端口从3000改为8181(避免与常用端口冲突)
- 添加 deploy/nginx.conf.example 宿主机Nginx配置示例
- 更新README添加Nginx配置说明
2026-02-26 01:42:43 +08:00
MerCry d8f440077a fix: 修正DeepSeek配置示例并更新Docker Compose语法 [AC-AISVC-01]
- DeepSeek使用deepseek作为provider而非openai
- 更新所有docker-compose命令为docker compose (V2语法)
2026-02-26 01:39:46 +08:00
MerCry f2d29dc2c4 feat: 添加Ollama服务支持嵌入模型部署 [AC-AISVC-01]
- docker-compose.yaml 添加 Ollama 容器
- 更新 .env.example 添加 Ollama 配置
- README 添加模型拉取步骤和架构图更新
2026-02-26 01:28:08 +08:00
MerCry 0b435a4b57 docs: 更新README,添加Docker部署指南 2026-02-26 01:24:40 +08:00
MerCry adc78a6b9b feat: 添加Docker容器部署配置 [AC-AISVC-01]
- 添加 ai-service 后端 Dockerfile (Python 3.11 + uv)
- 添加 ai-service-admin 前端 Dockerfile (Node 20 + nginx)
- 添加 docker-compose.yaml 编排文件 (含postgres/qdrant)
- 添加 nginx.conf 前端反向代理配置
- 添加 .dockerignore 文件
- 添加 .env.example 环境变量示例
2026-02-26 01:22:30 +08:00
MerCry f631f1dea0 feat: 统一提示词模板并添加全量提示词日志 [AC-AISVC-02, AC-ASA-19, AC-ASA-20]
PR Check (SDD Full Gate) / sdd-full-gate (pull_request) Successful in 2s Details
- 新增 prompts.py 集中管理系统提示词和证据格式化
- orchestrator.py 添加全量提示词日志打印
- openai_client.py 添加全量提示词日志打印(支持普通和流式)
- rag.py 重构使用统一的提示词模板
2026-02-26 01:12:01 +08:00
MerCry dd74ae2585 feat: 切换到优化检索器并增强编排日志 [AC-AISVC-02, AC-AISVC-16] 2026-02-25 23:45:34 +08:00