fastgpt

FastGPT 知识库问答平台

补充说明

FastGPT 是面向知识库问答的 LLM 应用平台，提供文档导入、向量检索、工作流编排和 OpenAI 兼容 API。适合中文企业知识库和客服场景。

核心概念：dataset、collection、chunk、app、workflow、API key。

常用示例

Docker Compose 启动：

git clone https://github.com/labring/FastGPT.git
cd FastGPT/deploy/docker
docker compose up -d

访问 http://localhost:3000 初始化账号并配置模型。

通过 API 调用应用：

curl -X POST http://localhost:3000/api/v1/chat/completions \
  -H "Authorization: Bearer $FASTGPT_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"gpt-4o-mini","messages":[{"role":"user","content":"磁盘满怎么排查"}],"stream":false}'

导入文档：

curl -X POST http://localhost:3000/api/core/dataset/collection/create \
  -H "Authorization: Bearer $FASTGPT_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"datasetId":"<DATASET_ID>","name":"manual","type":"file"}'

易错点与排错

• 模型配置不完整，应用无法生成回答。
• 向量库连接失败，文档导入一直处理中。
• 分块大小和检索 top-k 设置不合理，答案缺少上下文。
• Docker 资源不足，MongoDB/向量库启动失败。
• API Key 权限不足或过期，返回 401。
• 知识库文件格式不支持，先转换为 PDF/Word/Markdown。
• 升级前没有备份 MongoDB 和对象存储。
• 公网部署没有 HTTPS 和访问控制。