发版日志

v1.7.0

功能与增强

回答中的图表

智能体现在可以在回答中绘制图表。默认情况下,当图表比文字更能清楚地解释答案时,智能体会使用 Mermaid 流程图和时序图;只有用户明确要求时,才会生成 HTML 图表。管理员可以通过 diagramFormat 设置将默认格式切换为 HTML,或关闭图表(mermaid、html 或 none)。在回答 HTML 显示于聊天图表之前,系统会先对其进行清理。

响应速度指标

每个实时回答下方的页脚现在都会显示首个令牌的耗时和模型的解码速度。工具提示会按 LLM 调用细分这些数据,便于判断缓慢的是模型还是工具链。

令牌使用统计

现在会按用户和请求记录令牌使用情况。管理员可以通过 /api/admin/token_usage 端点查询每日、每周和每月的使用总量。使用记录默认保留 400 天(tokenUsageRetentionDays,0 则表示永久保留)。

自动清理会话历史记录

现在会自动删除 90 天内没有活动的聊天会话,以及其中的消息和摘要。置顶会话不会被删除。可以通过 historyRetentionDays 配置保留期限;将其设为 0 可禁用清理。已删除的会话无法恢复。

内置 ACP 4.4 知识库

内置知识库现在涵盖 ACP 4.4,且新安装默认使用该知识库。Smart Doc 会记录已恢复的知识库转储,并在配置的转储发生变化时重新恢复。在全新安装中,转储会先恢复到暂存区并经过验证,然后才投入使用,因此恢复中断不再会导致知识库不完整。

自定义 LLM 请求参数

新增的 llmExtraBody 设置会向每个 LLM 请求添加一个 JSON 对象。可用它设置 Smart Doc 未直接提供的模型专属选项,例如对支持该功能的推理模型关闭思考。

改进

  • 在安装配置中公开了 LLM 请求重试次数(llmMaxRetries,默认值为 3),因此 HTTP 503 等短暂网关错误不再会终止对话。
  • 要求模型完成回答的指令现在会以各模型系列接受的形式发送,从而改进 Qwen3、DeepSeek 和 GLM 模型的最终回答。
  • Hyperflux 插件现在已注册到平台的 Agent 目录中。

Bug 修复

  • 修复了模型静默超过 60 秒时聊天图表因“Network abnormal”而断开连接的问题;服务器现在会在等待期间按固定间隔发送心跳。
  • 修复了严格聊天模板拒绝最终回答指令并返回 HTTP 400、导致 Qwen3 模型回答丢失的问题。
  • 修复了问题中包含 site:、冒号或方括号等查询语法时,BM25 混合搜索会静默退化为仅向量检索的问题。
  • 修复了安装配置中的 MCP 服务器 TLS 和 ingress 设置被忽略的问题。
  • 修复了 API 服务器的证书链缺少 Authority Key Identifier 扩展时,ACP API 调用返回 HTTP 500 的问题。
  • 解决了所有尚未处理的高危和严重依赖项及镜像安全漏洞。

v1.6.0

功能与增强

推理模型支持

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

按模型划分的能力配置

现在会根据每个模型的配置文件解析已配置模型的上下文窗口和能力,而不是使用固定表。如果无法识别模型名称,或者服务端点截断了上下文窗口,管理员可以显式设置模型系列和上下文窗口。

向外部 MCP 服务器传递用户身份

现在,外部 MCP 服务器可通过新增的每服务器 forward_headers 字段,在每次工具调用时接收发起调用用户的 ACP 身份(用户令牌、用户名、集群或命名空间)。这样可以确保工具调用受 ACP RBAC 限制,并可在审计日志中追溯来源。此功能为可选功能,默认关闭。

从 Secret 加载外部 MCP 服务器

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

更精细地控制外部 MCP 工具

现在,每个外部 MCP 服务器都可以分别设置自己的 tool_timeout 和 tool_max_retries,因此无需更改全局默认值即可调整耗时较长或非幂等的工具。新增的 read_only_tools 允许列表可让管理员将特定工具标记为只读,从而允许智能体使用未发布工具注解的服务器所提供的工具。

结合审计日志进行故障排查

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

改进技能选择

现在只会根据用户的问题匹配技能。单轮对话中可以应用多个技能(可配置,默认值为 1),也可以将技能标记为 always: true,使其无论用户提出什么问题,都会在每轮对话中应用。

改进

  • 新增可配置的回复语言,确保仅使用单一语言的部署始终以预期语言作答。
  • 在安装配置中公开了 LLM 请求超时时间并提高了其默认值,因此较长的智能体工具调用链不再会在循环中途结束而没有回答。
  • 将智能体推理轮数上限的默认值从 3 提高到 5。
  • 恢复了流式智能体响应的令牌用量报告,因此每用户配额和成本核算现在会将智能体模式流量纳入统计。
  • 移除了内置的 node-not-ready 技能。

Bug 修复

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

v1.5.0

功能与增强

默认启用智能体模式

现在默认启用智能体模式,不再需要部署时切换开关。Smart Doc 会通过可调用 MCP 工具来检索集群实时信息,并使用明确的推理循环生成答案,同时将每个请求路由到正确的行为(问答、故障排查或操作),从而更可靠地处理多步骤任务。

工具调用审批

现在,任何会创建、修改或删除集群资源的智能体操作,都必须先获得用户的明确确认才能执行。只读工具仍会不间断地执行,让你能够实时了解情况,同时确保写操作处于人工控制之下。

外部 MCP 服务器

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

自定义技能

技能让你可以使用简单的 frontmatter 格式,针对特定任务调整智能体的行为,并根据名称和描述为每个请求匹配相应技能。

作为 MCP 服务器的 Hyperflux

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

数据脱敏

可配置的脱敏子系统会对用户查询、工具参数和工具结果中的敏感数据进行遮盖,同时支持 redact 和 tokenize 模式。仅限管理员使用的审计 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

注意:Agent 模式是一项实验性功能,请谨慎使用。

Bug 修复

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

改进

  • 改进了提示词,以确保使用正确的 Hyperflux 身份。
  • 从安装页面中移除了未使用的配置项。

v1.2.0

功能和增强

  • 默认使用 RAG 链回答用户问题,以提高答案准确性。
  • 支持导入数据库转储以初始化知识库,简化设置流程。
  • 实验性:支持启用 Agent 模式,利用 MCP 工具获取集群实时信息。
  • 支持连接到部署在 Alauda Hyperflux 安装环境之外的 PGVector 数据库。
  • 支持 Cohere Reranker 模型,以提高答案相关性。
  • 支持设置 RAG 链参数,例如 total_search_k 等。

已知问题

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