v3 · 2026-10-13 · 用户于 2026-10-14 确认并完成本机实施。实施与验收记录。前版仅作为历史参考。
知识库管理资料与索引；知识应用管理查询方式和工具输出。应用只允许组合向量模型及版本一致的知识库。检索必选，重排序与生成回答分别可选。
本轮修正（v3）
- 默认分块与自定义分块并列展示，两个策略入口始终可见。默认状态展示自动策略说明，同时展示自定义参数及高级设置入口；参数置灰，选择自定义后启用。切换策略保留本页自定义输入。
- 恢复文档分类、搜索、状态与标签筛选、包含子分类、创建 Markdown、元数据字段配置、批量操作、上传、刷新及原有四列表格。分类节点菜单、新建／删除分类、分页、失败重试与权限继续沿用现有组件，不改造文档管理区域。当前真实知识库只有根分类，不虚构分类节点。
- 右侧应用管理保留发布状态、版本与历史、API Keys、工具所属团队、查看／发布／下线工具、停用／启用应用及删除。工具同步失败时仍保留现有重试同步／重试下线入口。原型顶部可切换状态检查按钮，不代表真实应用。
- 未创建应用的管理操作禁用；工具存在后可查看。工具下线与应用停用分别显示状态；应用停用和删除保留影响说明与确认。删除仅在有删除权限时出现，工具与团队操作遵循原有权限。
1. 已确认方向与本轮取舍
- 移除知识库持久化回答默认设置。知识库测试的回答参数只临时生效；知识应用独立保存自己的回答参数。
- 知识库取消“设置”页签，保留“文档／测试”。右上角“知识库设置”展开或收起右侧面板。
- 知识应用不展示向量模型字段，包括只读字段。选库时校验模型 ID 与配置版本；模型名称相同不足以证明兼容。
- 用户已明确简化第一版：不做异构向量模型的分组检索与合并。该决定替代上一轮提出的跨模型检索方向。
2. 知识库右侧设置面板
右侧设置以 400px 覆盖面板展开，默认收起。底层分类与文档表格宽度不变，不挤压原有操作列。保留背景遮罩、关闭按钮和 Escape 操作；窄屏按可用宽度适配。
面板收纳向量模型与分块默认值，保留高级分块和情境增强入口。情境增强中的 LLM 用于文档入库，继续保留；应用生成回答的 LLM 用于查询，两者作用不同。面板不再出现回答 Token 预算或回答推理开关。
收起保留未保存表单，标记“未保存”；离开当前知识库时提示放弃或继续编辑。更换向量模型仍需确认重建，展示真实文档数与分块数。修改分块默认值只影响后续入库，已有文档保留自身配置。保存失败保留表单与错误信息，不显示成功状态。
情境增强配置、预览限制和模型能力校验继续沿用已有功能。原型只示意入口，不生成情境前缀。正式实现保留只读权限、分类侧栏和上传等现有行为。
3. 应用配置从步骤向导改为可直接编辑的区域
左侧依次是基本信息、知识来源、检索方式、重排序、生成回答。用户可以直接编辑任一配置。右侧始终显示实际执行链路、工具输出形式及保存发布动作。关闭某个可选环节后，隐藏其字段，不要求配置其模型，不参与执行校验。
新应用建议默认向量检索，重排序关闭，生成回答关闭。开启时才要求模型；仅有一个可用模型可预选，多个时明确选择。关闭后保留本页临时值以便重新开启，提交时只保存 disabled 状态，避免无效模型影响发布。已有应用迁移后保持当前开关和生成回答行为。
| 重排序 | 生成回答 | 执行与工具输出 |
|---|
| 关 | 关 | 检索 → 返回片段与来源 |
| 开 | 关 | 检索 → 重排序 → 返回片段与来源 |
| 关 | 开 | 检索 → LLM → 返回回答与引用 |
| 开 | 开 | 检索 → 重排序 → LLM → 返回回答与引用 |
每条链路均可选择向量、关键词或混合检索，共 12 种配置组合。第一版沿用知识库已入库索引的前提；关键词检索不实际调用向量模型，但仍保留选库兼容约束，不在本次增加“无向量索引的知识库”支持。
有回答能力的上层智能体可以调用纯检索工具，获得资料后自行组织答案，从而省去知识应用内部的一次 LLM 调用。
4. 知识库选择与即时校验
- 至少选择一个有权限访问的知识库。第一个已选库建立模型 ID 与配置版本的兼容条件。
- 与已选集合不兼容的候选禁用，旁边显示“与已选知识库的向量模型配置不一致”；未配置模型的候选提示先完成知识库设置。
- 应用页面只显示知识库名称、选择数量及一致性状态，不显示模型名称、版本或模型下拉框。错误定位到具体知识库。
- 取消或重新选择时立即重算兼容条件；清空后允许选择另一组。确认前在选择面板使用草稿，取消不影响原选择。
- 前端刷新时发现已选库后来改变模型，不自动删除该库，也不静默重绑；显示冲突并阻止保存、测试及发布，要求用户处理。
- 保存、测试、发布以及已发布调用均保留服务端依赖校验，防止前端通过后知识库配置变化。继续检查可见范围、索引版本与资源授权。
当前 common_model 和 libraryEmbedding 已检查模型 ID 与版本一致，可复用这项约束。新增工作集中在选择器即时提示，以及把隐藏的模型引用交给服务端解析。
5. 测试、发布与工具调用必须使用同一链路
应用测试不再一律调用 answer。运行入口按 answer.enabled 分派到检索或问答；只有开启生成回答时才校验、解析和调用 Chat 模型。重排序同理。纯检索应用可在没有可用 Chat 模型时保存、测试、发布并调用。
发布应用仍冻结配置；发布为工具使用已发布版本。保存草稿不会改变线上工具。已登记工具的应用再发布时，沿用现有工具同步机制并更新输出说明；工具 ID 与现有启用、停用、删除和权限规则保持不变。
工具输入仍是查询文本，不让调用方通过 query 参数切换已发布的执行模式。输出以明确模式区分，候选契约如下；此处是拟定字段，不是当前已实现接口。
| 字段 | 检索型 | 问答型 |
|---|
| mode（拟新增） | retrieve | answer |
| hits（拟用于检索型） | 片段数组，保留知识库、文档、片段标识、正文和位置 | 不要求消费方读取此字段 |
| answer / citations | 不伪造回答；不把原文片段拼成 answer 冒充生成 | 沿用回答与引用字段 |
| requestId | 两种模式均保留，失败同样可追踪 |
需要同步工具描述、API 文档和结果消费方，核对 MCP 包装完整保留片段正文与来源。已发布问答型继续提供 answer/citations；新增字段采用兼容方式。暂未核对全部消费方的严格 schema，正式实现前必须完成契约审查。
6. 回答设置归属与迁移
预算、推理、温度和提示词由应用保存；回答关闭时不要求它们。知识库问答测试从产品初始值开始，按选择模型校验，不再继承库默认设置。
移除旧知识库回答设置入口前，把每个应用草稿当前生效的继承值写入应用配置，保持原语义。已有发布版本继续使用已冻结的参数。多库已有冲突无法解析的草稿必须明确标记待修复，不猜测采用哪个库的值。旧字段先保留兼容读取，再按独立迁移清理；不在界面改版时直接删表字段。
兼容旧应用时，answer.enabled 缺省按 true 解释；新创建表单显式提交 false。校验关闭状态时不加载或检查 Chat 模型、回答预算及推理能力。必须统一草稿、发布快照、工具调用的缺省解释。
7. 异常与数量校验
可选环节关闭时，目录失败不阻断其他能力。已开启环节模型缺失或失效时明确报错，用户可以主动关闭该环节，不静默降级。没有候选片段时不调用 Rerank 或 LLM，检索型返回空片段，问答型说明没有依据。错误状态不得伪装为成功结果。
返回片段数 1–20，候选数 1–100 且不小于返回数。重排序开启时，排序后数量不能大于候选数；兼容存量配置，实际返回上限取返回数与排序后数量的较小值，且保持当前 1–20 上限；关闭时不校验这组参数。关键词模式不校验隐藏的向量阈值和融合权重。推理开启按当前产品约束校验至少 2048 Token，同时核对所选模型能力。
已有超时与错误追踪继续保留。测试时保留正在执行的配置快照，禁止旧响应覆盖新配置；重复付费调用不自动重试。停止等待不承诺外部模型调用立即中断。
8. 候选方案与取舍
| 方案 | 结论与代价 |
|---|
| 知识库继续保留设置页签 | 改动少，但配置内容偏少，用户需要离开当前文档或测试。采用右侧面板。 |
| 应用保留四步向导，仅增加跳过按钮 | 仍暗示所有阶段依次必经，发布校验也容易保留强依赖。采用直接编辑的区域与实时链路摘要。 |
| 应用隐藏模型字段，继续强制调用 LLM | 无法提供纯检索工具。必须同时调整配置、运行入口与工具输出。 |
| 不同向量模型按库分组检索后合并 | 需要解决分数比较和跨模型合并，实施范围更大。用户已选择第一版不做。 |
9. 影响范围与实施顺序
- 确定检索型工具输出契约及兼容方式。复核平台、KB 和 agent-base 的工具描述与结果处理。
- KB 新增可选生成回答配置，拆分检索与问答校验和执行。沿用相同模型的多库约束，补齐旧请求缺省行为。
- 固化现有应用的有效回答参数，保留已有发布快照；先部署兼容后端。
- 平台更新知识库设置面板、知识库选择器、应用配置与测试结果。再部署新版 UI。
- 验证 12 种组合及真实发布工具调用。回退先恢复 UI，再恢复兼容后端；不得破坏新建检索型应用数据。
前端主要涉及 KnowledgeBaseDocuments、KnowledgeBaseConfiguration、KnowledgeBaseAnswerSettings、RagTestPanel、RagAppForm、appConfig、AppLifecycle；后端主要涉及 AppConfig / AnswerConfig、validate_config、kb_app_runtime、测试与 runtime invoke、发布快照；共享契约归 meta 的 docs/contracts/，最终是否新增契约文件在实施时按范围确定。
10. 验收与原型边界
- 知识库无设置页签；面板展开、收起及模式切换保留输入。更换模型显示重建确认。
- 设置面板无回答默认预算或推理开关；情境增强仍在入库高级配置中。
- 应用页无向量模型字段。真实同模型库可多选；不同模型或版本不能加入。移除全部选择后可选另一组。
- 检索方式 × 重排序 × 生成回答共 12 种配置均可测试；检索型完全没有 Chat 调用。
- 关闭回答后不被空 Chat 模型、非法旧预算或推理开关阻断；关闭重排序同理。
- 工具测试不等于调用验收。实施后须从真实工具入口核对 hits 与 answer/citations 的正确模式、权限和来源信息。
本原型中的知识库名称、模型绑定、4 篇文档和 62 个分块来自 2026-10-13 本机只读接口；冲突候选“链路详情日志不匹配排查”确实绑定了另一模型。文档片段来自“DNS 值班交接说明”。应用名称由用户在原型中填写，不声称存在真实应用。原型不调用模型、不保存业务数据、不发布应用或工具。
上版检索／问答模式区分继续保留；v2 已取代其中“设置页签”和“继承知识库回答默认值”的设计。原型为前端交互示意，后端改造及真实 12 组合调用尚未实施。
11. 已确认默认策略与契约核对
本版默认策略为“新应用只检索，两个可选环节默认关闭”；旧应用保持原行为。工具返回模式字段的最终命名需在实施前审查消费方后确定，不影响当前页面交互评审。