# 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. 模型管理后续只维护连接可用性、密钥、协议和启停状态。
