Refactor FAQ and troubleshooting documentation with new guides (#6581)

* docs(faq): 更新常见问题文档并新增注意事项页面

- 在 error.mdx 中调整问题序号并新增 OCR 配置问题
- 新增 attention.mdx 页面,提供问题排查步骤和技术支持指引
- 重构 dataset.mdx 内容结构,使用数字序号并补充知识库闪烁问题

* docs: 重构私有部署故障排查文档结构并新增详细指南

将原有的 FAQ 文档拆分为多个专题文档,包括通用问题排查、S3问题、OneAPI错误、模型可用性问题和排查方法。更新了导航菜单和目录结构,使文档组织更清晰,便于用户快速定位和解决特定问题。

新增了详细的故障排查步骤、CURL测试示例和具体错误解决方案,特别是针对对象存储连接、签名错误和模型调用失败等常见问题提供了更全面的指导。

* docs: 移除已弃用的 OneAPI 错误排查文档

移除 `oneapi-errors` 相关文档文件,因其内容已过时或合并至其他章节。同步更新中英文文档目录和元数据文件中的引用。

* docs: 更新文档FAQ内容,移除过时条目并重新编号

- 删除关于OneAPI官网的过时FAQ条目
- 重新编号故障排除FAQ章节,使序号连续
- 同步更新中英文文档内容保持一致

* docs: 重构FAQ和自托管文档结构,合并错误排查内容

将原FAQ中的“报错”和“注意”章节迁移至自托管文档的“故障排查”目录下
在model-errors.mdx中整合常见错误解决方案,如“上游负载饱和”和“Connection Error”
更新meta.json和toc.mdx文件以反映新的文档结构

---------

Co-authored-by: Archer <545436317@qq.com>
This commit is contained in:
zjj-225
2026-03-19 11:32:14 +08:00
committed by GitHub
parent 9959707fb3
commit 765ec526cc
13 changed files with 78 additions and 45 deletions
@@ -1,6 +1,6 @@
---
title: 模型可用性问题排查
description: FastGPT 私有部署模型可用性问题排查
title: 模型问题排查
description: FastGPT 私有部署模型问题排查
---
@@ -255,3 +255,21 @@ curl --location --request POST 'https://oneapi.xxxx/v1/chat/completions' \
### (4)向量检索得分大于 1
由于模型没有归一化导致的。目前仅支持归一化的模型。
---
### (5) 当前分组上游负载已饱和,请稍后再试
如果在日志或请求中遇到此错误(如 `request id:xxx`),这通常是 OneAPI 渠道的问题,可以换个模型使用或者换一家中转站。
---
### (6) 使用API时在日志中报错 Connection Error
大概率是 API Key 填写了 OpenAI 的地址,但是部署的服务器在国内,不能访问海外的 API。可以使用中转或者反代的手段解决访问不到的问题。
---
### (7) 开启图片索引报 400
需在 `Admin` -> `系统配置` 中正确配置 OCR 模型。