#发版日志

#v1.6.0

#功能和增强

#推理模型支持

Smart Doc 现在可以适配推理模型。推理工作量设置（minimal、low、medium 或 high）可以在推理深度和响应速度之间进行权衡。当 LLM 网关支持 OpenAI Responses API 时，聊天图表还可以在答案生成过程中实时显示推理摘要。不支持工具调用的模型可以声明为不支持工具调用，这样智能体会回退到普通问答，而不会执行失败。

#按模型划分的能力配置文件

现在，配置模型的上下文窗口和能力将从按模型划分的配置文件中解析，而不再使用固定表格。如果无法识别模型名称，或提供服务的端点截断了上下文窗口，管理员可以显式设置模型系列和上下文窗口。

#外部 MCP 服务器的用户身份透传

现在，外部 MCP 服务器可以在每次工具调用中，通过新的按服务器配置的 forward_headers 字段接收调用用户的 ACP 身份（用户令牌、用户名、集群或命名空间）。这样可以确保工具调用受 ACP RBAC 约束，并使其能够在审计日志中追溯。此功能需要选择启用，默认关闭。

#从 Secret 加载外部 MCP 服务器

现在，除了 ConfigMap 外，还可以从 Kubernetes Secret 加载外部 MCP 服务器列表，因此包含凭据的服务器定义不会再被任何能够访问该命名空间中 ConfigMap 的人员读取。PostgreSQL 连接字符串也会作为文件挂载，而不是作为环境变量传递。

#更精细地控制外部 MCP 工具

现在，每个外部 MCP 服务器都可以设置自己的 tool_timeout 和 tool_max_retries，因此无需更改全局默认值即可调整速度较慢或非幂等工具的配置。新的 read_only_tools allowlist 允许管理员将特定工具标记为只读，以便将未发布工具注解的服务器中的工具提供给智能体。

#感知审计日志的故障排查

在故障排查和运维模式下，智能体现在可以查询 ACP 审计日志，以查找可能解释问题的近期变更。

#改进技能选择

现在，技能只会根据用户的问题进行匹配。单次交互中可以应用多个技能（可配置，默认值为 1），并且可以将技能标记为 always: true，使其无论问题内容如何都会在每次交互中应用。

#改进

• 添加了可配置的回复语言，使单语言部署始终使用预期语言进行回答。
• 在安装配置中公开了 LLM 请求超时时间，并提高了其默认值，因此较长的智能体工具链不再会在循环中途结束且不返回答案。
• 将智能体推理轮次的默认最大数量从 3 次提高到 5 次。
• 恢复了流式智能体响应的令牌使用量报告，因此每用户配额和成本核算会包含智能体模式流量。
• 移除了内置的 node-not-ready 技能。

#Bug 修复

• 修复了某些模型上的智能体交互可能仅以工具调用轨迹结束而没有答案文本的问题。
• 修复了智能体的中间叙述和模型内部标记泄露到聊天图表的问题。
• 修复了 LLM 流被中断后用户未收到任何消息的问题；现在会显示易于理解的错误信息。
• 修复了 BM25 混合搜索因所需数据库扩展未预加载而静默回退到仅向量检索的问题。
• 修复了数据库镜像升级后遗留过时排序规则版本，导致知识库初始化失败的问题。
• 解决了所有尚未处理的高危和严重依赖项及镜像安全漏洞。

#v1.5.0

#功能和增强

#默认启用智能体模式

现在默认启用智能体模式，不再需要部署时开关。Smart Doc 会通过显式推理循环调用 MCP 工具来获取实时集群信息，并将每个请求路由到正确的行为（问答、故障排查或运维），从而更可靠地处理多步骤任务。

#工具调用审批

现在，任何会创建、修改或删除集群资源的智能体操作，都必须在执行前获得用户的明确确认。只读工具仍会直接执行，不会中断流程，让你能够获取实时信息，同时确保写入操作处于人工控制之下。

#外部 MCP 服务器

管理员可以通过 ConfigMap 注册其他 MCP 服务器，使自定义工具可供智能体使用。系统会为每个服务器添加工具名称前缀以避免冲突，并通过审批策略控制哪些工具可以公开。

#自定义技能

技能通过简单的 frontmatter 格式，帮助你针对特定任务调整智能体的行为，并根据名称和描述为每个请求匹配相应技能。

#Hyperflux 作为 MCP 服务器

现在可以从 IDE 或其他智能体将 Hyperflux 作为 MCP 服务器使用。它通过 ACP bearer token 身份验证提供读取访问权限，并通过基于 elicitation 的审批流程控制写入操作。

#数据脱敏

可配置的脱敏子系统会对用户查询、工具参数和工具结果中的敏感数据进行掩码处理，同时支持脱敏和令牌化模式。仅限管理员使用的审计 API 只会将脱敏命中记录为元数据，因此绝不会存储原始值。

#传输安全

现在，Smart Doc 支持为向 LLM、MCP 和 reranker 服务的出站连接配置自定义 CA 证书，以及可配置的 TLS 配置文件和安全标头。支持隔离网络和数据驻留部署，包括故障安全的 reranker 路径。

#改进

• 默认启用 BM25 混合搜索，以提高检索质量。
• 在推理轮次之间复用 MCP 会话，避免每轮重新握手，降低智能体模式下的延迟。
• 并行执行模式分类和术语表查询，并在不同模式之间共享缓存的基础提示词，以降低响应延迟。
• 添加了停止生成控制，可真正取消后端正在进行的请求，并将被中断的答案记录到历史记录中。
• 添加 SSE 心跳，使长时间运行的工具调用不再导致前端断开连接。
• 通过提供仅 CPU 构建版本，减小了容器镜像大小。
• 强化了身份验证和机密处理，包括 JWT 过期验证以及对日志中的机密信息进行脱敏。
• 通过为每个请求提供跟踪 ID 并减少日志噪声，改善了生产环境中的可诊断性。

#Bug 修复

• 修复了访问控制问题，该问题可能导致用户访问其他用户的会话。
• 修复了会话和历史记录 API 的错误处理路径，使故障能够返回正确的状态码。
• 修复了请求在流式传输过程中被取消时智能体对话历史记录丢失的问题。
• 修复了从历史记录恢复对话时，残留的 UI 标记被重新发送给模型的问题。
• 修复了全新安装以及 Kunpeng 920（ARM）硬件上的知识库初始化问题。
• 解决了所有尚未处理的高危和严重依赖项及镜像安全漏洞。

#v1.4.0

#功能和增强

#改进检索质量

随附的知识库已使用更强大的模型重新生成嵌入，大幅提升了答案的相关性，包括跨语言检索（例如，针对英文文档使用中文提问）。现有的 v1.3.x 部署会在升级过程中自动迁移 — 请参阅升级指南。

#混合关键词和语义检索

现在，系统会结合语义相似度和关键词匹配来检索答案，然后将两者融合为统一的排名结果。这种方式能够找回纯语义搜索可能遗漏的精确关键词匹配，例如 CRD 名称、命令标志和错误字符串，同时保留回答自然语言问题的能力。

#文档级检索

现在，除对每个文档的各个章节建立索引外，系统还会在文档级别建立索引。即使用户的措辞与任何特定段落都没有重叠，关于文档总体主题的问题现在也能找到正确的文档。

#内置知识库预设选择

安装页面现在提供随附知识库的两种预设供选择。默认预设适用于大多数查询；较大的预设在涉及长篇文档的问题上可能提供略好的召回率。

#升级期间刷新随附知识库

从 v1.3.x 升级到 v1.4.x 时，系统会使用新的 GTE 嵌入数据替换随附的产品知识库，并自动迁移每个文档的元数据。无需手动执行数据库导出、导入或重启操作 — 请参阅升级指南。自定义知识库和 BYO 知识库不会受到此步骤影响（请参阅下方的“重大变更”和“已知限制”）。

#对话历史记录压缩

系统会自动对较长的对话进行摘要，使其能够适应 LLM 的上下文窗口，同时保留更早的对话轮次。这降低了长时间智能体模式会话的令牌成本，并让用户可以跨越多条消息继续调查，而不会导致质量下降。

#现在可以独立配置智能体模式和 MCP 工具加载

智能体模式（多步骤推理）和 ACP MCP 工具加载现在由独立的安装开关控制。您可以在不加载 ACP MCP 工具的情况下启用智能体模式 — 例如，当 LLM 仅应基于随附知识库进行规划时 — 并在需要对实际运行中的集群执行操作时重新启用这些工具。

#构建自定义知识库

新增指南将指导管理员如何将内部 Git 仓库摄取到 Hyperflux 知识库中，使 Hyperflux 能够基于私有运行手册、设计文档或其他内部参考资料回答问题。请参阅构建自定义知识库。

#改进

• 降低工具返回较长输出（例如日志或大型资源定义）时智能体模式答案的令牌成本。
• 提升随附知识库数据库的存储性能。

#重大变更

• 必须在升级前重新构建 v1.3.x 下创建的自定义知识库。 新的嵌入模型与之前的模型不兼容，因此现有的自定义语料库数据在重建之前将无法使用。有关新操作步骤，请参阅构建自定义知识库指南。

#已知限制

• 通过 BYO Knowledge 工具上传的文档在 v1.4.0 升级过程中会保持不变 — 只有随附的产品知识库会被刷新。

#v1.3.1

#功能与增强

#BYO Knowledge 工具

BYO Knowledge 工具支持企业导入私有知识，并在问答过程中将其作为专用的可搜索知识源使用。这有助于团队基于内部文档、运维知识和组织特定上下文提供回答。

#多集群支持

多集群支持使用户能够按集群名称访问多个集群中的信息，扩展跨集群边界的问答能力。这让用户能够更轻松地查询和比较不同集群环境中的资源。

#令牌配额限制

令牌配额限制支持按用户限制请求频率和令牌使用量。这有助于管理员控制成本、管理配额并防止模型资源被过度消耗。

#历史记录

历史记录支持用户查看之前的对话和问答结果。这让用户能够更轻松地追溯上下文、继续之前的调查，并基于过去的交互排查问题。

#改进

• 优化 RAG（langchain）和重排序流程，大幅提升答案的准确性和相关性。
• 将核心 AI 框架升级到 LangChain 1.0，以保持与最新功能和优化的兼容性。
• 添加例行系统检查提示，并执行全面的代码优化和单元测试 lint 检查。
• 分离系统知识库、用户知识库和聊天历史记录的数据库，以提升数据隔离性和性能。
• 重新设计 Smart Doc 交互页面，提供更直观、高效的用户体验。
• 升级 MCP 服务器，新增对 OAuth 身份验证和可写工具配置的支持。
• 增强文件上传集成，使知识摄取过程更加顺畅。
• 新增对自定义元素中 ID 的支持，并解决相关数据冗余问题。
• 实现基于 Redis 的速率限制器，以增强系统稳定性并管理 API 流量。

#Bug 修复

• 修复模型下载可能失败的问题，并改进嵌入模型的环境变量配置。
• 解决更新值合并和解包过程中出现的数据处理错误。
• 修复自定义元素中出现冗余数据前缀的错误。
• 解决偶发的服务调用失败问题，提升整体系统可靠性。

#v1.2.1

注意：智能体模式是一项实验性功能，请谨慎使用。

#Bug 修复

• 修复设置知识库名称可能不生效的问题。此修复在安装过程中新增设置数据库转储文件名的选项，并自动使用指定的数据库转储文件初始化知识库。
• 修复在智能体模式下，MCP 工具无需人工确认即可创建或删除 K8s 资源的问题。
• 修复使用智能体模式请求磁盘空间信息时服务器可能卡住的问题。
• 修复在 ACP 4.2 或更高版本上部署时未处理默认节点污点的问题。
• 修复部署错误：kubeVersion: >=1.20.0 which is incompatible with Kubernetes v1.33.7-1。
• 修复部署时 LLM 服务和重排序服务的 API 密钥以明文显示的问题。

#改进

• 优化提示词，以使用正确的 Hyperflux 身份。
• 移除安装页面中未使用的配置项。

#v1.2.0

#Features and Enhancements

• 默认使用 RAG chain 回答用户问题，提升答案准确性。
• 支持导入数据库转储文件以初始化知识库，简化设置流程。
• 实验性功能：支持启用智能体模式，利用 MCP 工具检索集群实时信息。
• 支持连接部署在 Alauda Hyperflux 安装环境之外的 PGVector 数据库。
• 支持 Cohere Reranker 模型，提升答案相关性。
• 支持设置 RAG chain 参数，例如 total_search_k 等。

#Known Issues

• 当 LLM 返回错误时，答案生成可能失败。返回查看聊天历史记录时，会再次向 LLM 发送该问题，导致对话重复。