标签： Python

AI 工具排错

[Docs] Error 500 on API docs

这个 [Docs] Error 500 on API docs 通常发生在访问 Gradio 官方文档站的 API 文档页时，页面引用的 S3 静态 CSS 返回 Access Denied，导致浏览器拦截资源并渲染 500。优先检查文档站静态资源链接是否可访问，或临时屏蔽 gradio.app 的

celebrityanime
2026年 7月 31日

AI 工具排错

Desktop 2.2.9: STDIO MCP tools/list succeeds, but connector.syncTools fails and no tool permissions are registered

此问题发生在 LobeChat Desktop 2.2.9 Windows 环境中，当使用 STDIO 方式运行本地 Docker MCP 服务器时， Test Connection 可以成功获取工具列表，但点击 Install 后 connector.syncTools 报错 500，工具权限页面

celebrityanime
2026年 7月 31日

AI 工具排错

[Question]: Failed to exec “uv sync –python 3.10 –all-extras ” on linux manjaro.

在 Linux Manjaro 上执行 uv sync --python 3.10 --all-extras 安装 RAGFlow 时， datrie 包编译失败，原因是 gcc 将 incompatible-pointer-types 视为错误。优先尝试通过环境变量忽略该编译错误后重新运行命令。

celebrityanime
2026年 7月 31日

AI 工具排错

[Feature Request]: The absence of sandbox configuration and image in helm prevents the execution of code and adminServer, whereas they exist

该报错发生在使用 RAGFlow 的 Helm Chart 部署时，因缺少 sandbox 相关环境变量和镜像引用，导致 code 和 adminServer 无法在沙箱模式下执行。优先排查 Helm values.yaml 与 env.yaml 中是否包含 SANDBOX_HOST 、 SANDB

celebrityanime
2026年 7月 31日

AI 工具排错

[Bug]: Seems like Azure OpenAI models are not working anymore when added directly via Azure?

RAGFlow 升级到 v0.23.x 后，通过 Azure 直接添加的 OpenAI 模型调用时返回 404 Resource not found。优先排查异步聊天路径是否使用了 Azure 专用异步客户端 ( AsyncAzureOpenAI ) 代替通用 AsyncOpenAI 。

celebrityanime
2026年 7月 31日

AI 工具排错

[Bug]: LM Studio not working with LiteLLM Proxy

该报错发生在使用 LiteLLM Proxy 转发请求到仅提供同步 OpenAI 兼容端点的本地模型（如 LM Studio）时，LiteLLM Proxy 默认使用异步请求导致连接失败。优先排查 LiteLLM Proxy 配置中的 api_base 路径是否完整，以及 Docker 环境下的网络

celebrityanime
2026年 7月 31日

AI 工具排错

issue: Admin Panel Open Terminal integration saves to user settings endpoint instead of config endpoint

该报错 “Admin Panel Open Terminal integration saves to user settings endpoint instead of config endpoint” 通常发生在用户在用户个人设置面板（Settings → Integrations）而非管

celebrityanime
2026年 7月 30日

AI 工具排错

Node ‘ID #98:17’ has no class_type. The workflow may be corrupted or a custom node is missing.

该报错 Node 'ID #98:17' has no class_type. The workflow may be corrupted or a custom node is missing. 通常出现在加载工作流时遇到无法识别的节点 ID，最常见原因是该工作流依赖的自定义节点未安装。优先检查工

celebrityanime
2026年 7月 30日

AI 工具排错

bug: run_batched_evaluation mapper parameter’s MapperFunction protocol mismatch

该报错源于 run_batched_evaluation 中 MapperFunction 的参数类型不匹配 —— 函数签名要求 TraceWithFullDetails ，但底层通过 trace.list 返回的是 TraceWithDetails 。优先排查是否使用了 trace‑level 评

celebrityanime
2026年 7月 30日

AI 工具排错

bug: Expected Output doesn’t show/display in Datasets/Items/experiments

此报错出现在 Langfuse Cloud 的 Dataset/Items/experiment 页面中，“Expected Output”列始终为空（不显示任何内容），尽管 API 中数据已正确存储。这是前端 UI 转换函数遗漏了 datasetItemId 字段导致的渲染 Bug，不影响数据完整

celebrityanime
2026年 7月 30日