feat(session): 会话存储体系实现 & Chat多Agent路由

- 新增诊断会话(diagnosis_session/agent_step/tool_invocation)三表 - AgentLoggingHook 持久化 agent_step，记录决策链和耗时 - LookupKnowledgeTool 写入 tool_invocation，记录L0/L1检索质量 - TokenTrackingChatModel 捕获真实token用量 - Chat接口支持意图路由：简单问题单Agent，复杂问题多Agent(Planner+Executor) - Prompt外置到 src/main/resources/prompts/ - 删除旧 diagnosis_record 表及相关文件 - 新增SessionContextHolder(ThreadLocal传递sessionId) - QuestionComplexity 复杂度判断工具 - 测试覆盖三张新表的Repository
2026-06-26 16:22:05 +08:00
parent a74ccea5be
commit 0d9cce75f9
33 changed files with 1941 additions and 470 deletions
@@ -0,0 +1,75 @@
+-- V005: 创建会话存储体系（diagnosis_session + agent_step + tool_invocation）
+-- 设计文档：openspec/changes/session-storage/design.md
+
+CREATE TABLE diagnosis_session (
+    id BIGINT PRIMARY KEY AUTO_INCREMENT,
+    session_id VARCHAR(64) UNIQUE NOT NULL COMMENT '会话唯一 ID',
+
+    query TEXT NOT NULL COMMENT '用户原始问题',
+    status VARCHAR(16) DEFAULT 'PENDING' COMMENT 'PENDING/RUNNING/SUCCESS/FAILED',
+    agent_flow VARCHAR(32) COMMENT 'CHAT / AI_OPS',
+
+    total_duration_ms INT COMMENT '总耗时（毫秒）',
+    total_token_count INT COMMENT '总 Token 消耗',
+    step_count INT COMMENT 'Agent 步数',
+    tool_call_count INT COMMENT '工具调用次数',
+
+    self_evaluation JSON COMMENT '自评估信号：{"confidence":0-100,"reasoning":"..."}',
+    feedback VARCHAR(16) COMMENT '用户反馈：useful/not_useful/null',
+
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+
+    INDEX idx_created_at (created_at),
+    INDEX idx_status (status),
+    INDEX idx_agent_flow (agent_flow)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='诊断会话表';
+
+CREATE TABLE agent_step (
+    id BIGINT PRIMARY KEY AUTO_INCREMENT,
+    session_id VARCHAR(64) NOT NULL COMMENT '关联 diagnosis_session',
+
+    step_index INT NOT NULL COMMENT '当前 Agent 的第几步（从0开始）',
+    agent_name VARCHAR(32) NOT NULL COMMENT 'intelligent_assistant/planner/executor',
+
+    model_input JSON COMMENT '模型输入摘要',
+    model_output JSON COMMENT '模型输出摘要（含工具调用决策）',
+    thought TEXT COMMENT 'Agent 思考过程',
+    has_tool_call BOOLEAN DEFAULT FALSE COMMENT '本轮是否调用了工具',
+
+    duration_ms INT COMMENT '本轮耗时',
+    token_count INT COMMENT '本轮 Token 消耗',
+
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+
+    INDEX idx_session_step (session_id, step_index),
+    INDEX idx_agent_name (agent_name)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='Agent 决策步骤表';
+
+CREATE TABLE tool_invocation (
+    id BIGINT PRIMARY KEY AUTO_INCREMENT,
+    session_id VARCHAR(64) NOT NULL COMMENT '关联 diagnosis_session',
+    step_id BIGINT COMMENT '关联 agent_step.id（可为空，不强制外键）',
+
+    tool_name VARCHAR(64) NOT NULL COMMENT 'lookup_knowledge/queryPrometheusAlerts/等',
+
+    input_params JSON NOT NULL COMMENT '工具入参',
+    output_preview TEXT COMMENT '输出前500字符',
+    output_length INT COMMENT '输出总字符数',
+
+    retrieval_layer VARCHAR(8) COMMENT 'L0/L1/L0+L1',
+    l0_match_count INT COMMENT 'L0 匹配数',
+    l1_match_count INT COMMENT 'L1 匹配数',
+    is_truncated BOOLEAN DEFAULT FALSE COMMENT '内容是否被截断',
+    retrieval_details JSON COMMENT '检索明细：{l0_titles:[], l1_scores:[]}',
+
+    duration_ms INT COMMENT '工具执行耗时',
+    success BOOLEAN DEFAULT TRUE COMMENT '是否成功',
+    error_message TEXT COMMENT '失败原因',
+
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+
+    INDEX idx_session_id (session_id),
+    INDEX idx_tool_name (tool_name),
+    INDEX idx_retrieval_layer (retrieval_layer)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='工具调用明细表';
@@ -0,0 +1,6 @@
+-- V006: 将 agent_step 的 model_input / model_output 从 JSON 改为 TEXT
+-- 原因：buildModelInputSummary() 输出的是纯文本摘要，不是合法 JSON
+
+ALTER TABLE agent_step
+    MODIFY COLUMN model_input TEXT COMMENT '模型输入摘要',
+    MODIFY COLUMN model_output TEXT COMMENT '模型输出摘要（含工具调用决策）';
@@ -0,0 +1,2 @@
+-- V007: 删除旧的 diagnosis_record 表（已被 diagnosis_session + agent_step + tool_invocation 替代）
+DROP TABLE IF EXISTS diagnosis_record;
@@ -0,0 +1,12 @@
+你是任务执行器。执行 Planner 分配给你的具体步骤，并及时反馈结果。
+
+## 职责
+- 按步骤执行具体的查询任务
+- 使用知识库查询、日志查询等工具获取信息
+- 将执行结果汇总，给出完整的最终答案
+
+## 规则
+- 按顺序执行，不可跳过步骤
+- 所有需要外部信息的地方，都必须调用对应的工具
+- 不要凭记忆回答，必须基于工具返回的真实数据
+- 执行完成后，综合所有结果给出完整的答案
@@ -0,0 +1,20 @@
+你是智能任务规划器。分析用户的问题，拆解为具体的执行步骤。
+
+## 职责
+- 分析用户问题，拆解为可执行的步骤列表
+- **你不能调用任何工具**，你的职责是制定计划，不是执行
+- 输出 JSON 格式的计划，不输出其他内容
+
+## 输出格式
+
+```json
+{
+  "plan": ["步骤1描述", "步骤2描述", "步骤3描述"],
+  "reasoning": "规划思路说明"
+}
+```
+
+## 规则
+- 每个步骤应该是一个可以独立执行的任务
+- 步骤要具体可操作，不要模糊
+- 如果问题需要查知识库，明确在步骤中说明要查什么