智能体#

#1 编排与显示

#1.1 高级编排画布无法正常显示

高级编排设置页面的画布显示异常，通常是浏览器内核版本过低（如谷歌浏览器 93.0.4577.63）导致，升级浏览器即可解决。

注意：工作流编排不支持 Safari 浏览器，建议使用最新版本的谷歌浏览器。

#1.2 同一个应用显示不同语言界面

应用显示设置中的语言选择未统一，需要在应用显示设置中选择所需语言并保存。

#1.3 对话中上传文件的存储与清理

MaxKB 应用在对话过程中上传的文件，先临时存储在数据库中，然后通过清除聊天记录的方式，每天定时（00:05:00）进行清除，以保障数据的安全性。

#2 检索与回答

#2.1 使用“换个答案”后检索不到知识库

当使用“换个答案”功能时，检索机制会排除上一次检索到的所有分段，然后重新进行检索。如果上一次检索结果中只有一个匹配项，那么重新检索时可能会出现结果为空的情况。

#3 MCP 与工具

#3.1 应用添加 MCP 组件报错

应用添加 MCP 组件失败通常有两类原因。提示“unhandled errors in a TaskGroup(1 sub-exception)”时，是 MCP 服务启动失败，一般为数据库连接密码包含特殊字符 @，与 dbhub 启动命令冲突；提示“transport”时，是 MCP Server Config 配置格式不正确，缺少 "transport": "sse"，需要在配置中补充该字段。

#4 文档与 API

#4.1 应用文档内容提取报错“File is not a zip file”

上传的文件实际是 doc 类型文件，而非 zip 文件，需要确保上传文件格式正确。同类现象可参考知识库中“上传文档向量化后，字符数为 0”的说明。

#4.2 请求 Swagger API 报错“URL scheme must be 'http' or 'https' for CORS request”

Swagger 文档的 schemes 格式未正确选择，IP 地址使用了 http，而域名使用了 https，需要确保 IP 和域名的协议匹配。