Separate agent tuning from model setup

ai_knowledge_base_v2/development_records/2026-07-06-decision-register.md

@@ -41,6 +41,7 @@
 | D-018 | 模型高级参数用 JSON 对象透传。 | 默认采用 | 用较低成本兼容供应商差异，避免数据库字段无限膨胀。 |
 | D-019 | 管理后台 Element Plus 改为按需注册，并拆分表格和基础 vendor chunk。 | 默认采用 | 解决后台构建单 chunk 过大的提示，降低首屏主入口体积，同时不引入额外构建插件。 |
 | D-020 | MiniMax 快速添加默认使用 Anthropic Messages 兼容协议。 | 默认采用 | MiniMax 文本生成指南推荐 Anthropic-compatible 路径；后端按 `auth_type` 兼容 Bearer 和 x-api-key 两种鉴权。 |
+| D-021 | 模型管理只负责 LLM 接入，Agent 管理负责提示词、知识库、模型选择和推理参数调试。 | 默认采用 | 避免模型连接配置与 Agent 运行策略混在一起，方便后续做 Agent 版本、调试和发布流程。 |
 
 ## 待确认决策
 

ai_knowledge_base_v2/development_records/2026-07-07-agent-management-adjustment.md

@@ -0,0 +1,72 @@
+# Agent 管理与模型接入边界调整记录
+
+日期：2026-07-07
+
+## 背景
+
+模型管理页面此前同时承担了“接入大模型”和“配置调用参数”的职责，导致 API Key 后面出现 Temperature、Top P、Max Tokens、Penalty、高级 JSON 参数等内容。实际产品语义上，这些参数更像 Agent 调试和运行策略，不应该放在模型接入页面。
+
+同时，原来的 Prompt 管理只是一块提示词文本编辑区，无法选择模型、知识库和调试参数，也没有预览聊天窗口，不利于调试 Agent 效果。
+
+## 本次调整
+
+### 模型管理
+
+- 保留模型接入相关字段：
+  - 快速添加 DeepSeek / MiniMax
+  - 协议模板
+  - 供应商标识
+  - 显示名称
+  - 协议类型
+  - 模型名
+  - Base URL
+  - API URL
+  - 鉴权方式
+  - API Key
+  - API Version
+  - 超时秒数
+  - 备注
+- 移除模型管理页面中的 Agent 参数：
+  - Temperature
+  - Top P
+  - Top K
+  - Max Tokens
+  - Presence Penalty
+  - Frequency Penalty
+  - 上下文窗口
+  - 流式输出
+  - 响应格式
+  - 高级 JSON 参数
+
+### Agent 管理
+
+- 将侧边栏“Prompt 管理”改为“Agent 管理”。
+- Agent 管理页新增两栏布局：
+  - 左侧：提示词、模型、知识库、调试参数、调试问题。
+  - 右侧：预览聊天窗口。
+- 支持在 Agent 管理页选择：
+  - 已接入模型。
+  - 已启用知识库。
+  - Temperature、Top P、Top K、Max Tokens、Presence Penalty、Frequency Penalty。
+- 新增管理员调试接口 `POST /api/admin/agent/debug`。
+- 调试接口不会保存参数到模型配置，只对本次请求临时生效。
+
+### 记录审计
+
+- 修复聊天记录筛选区时间范围控件挤压问题。
+- 筛选区改为可换行工具栏。
+- 时间范围控件固定宽度，搜索、重置、导出按钮保持同一行。
+
+## 当前边界
+
+- Agent 调试参数当前只用于调试请求，尚未落库为正式 Agent 配置版本。
+- 目前仍只有一个全局提示词存储表 `sys_prompt`，后续如需要多 Agent、多版本、灰度发布，需要新增 Agent 配置表。
+- 调试接口会调用已选模型；如果本地没有配置真实模型，无法完成真实模型调试。
+- 知识库选择会参与检索范围；当前开发环境仍可能使用 mock 检索结果。
+
+## 后续建议
+
+1. 新增正式 `sys_agent` / `sys_agent_version` 表，把提示词、模型、知识库和参数形成可发布配置。
+2. Agent 管理页增加“保存草稿 / 发布版本 / 回滚版本”。
+3. Agent 调试记录单独落日志，便于追踪调试问题和参数变化。
+4. 模型管理后续只维护连接可用性、密钥、协议和启停状态。

ai_knowledge_base_v2/development_records/README.md

@@ -35,4 +35,5 @@
 | `2026-07-07-admin-chat-records-completion.md` | 管理后台聊天记录补齐记录。 |
 | `2026-07-07-model-management-completion.md` | 管理后台模型管理补全记录。 |
 | `2026-07-07-admin-web-build-optimization.md` | 管理后台构建体积优化记录。 |
+| `2026-07-07-agent-management-adjustment.md` | Agent 管理与模型接入边界调整记录。 |
 | `../test_records/2026-07-06-phase6-verification.md` | 阶段六验证记录。 |