接入软件
RAGFlow
在 RAGFlow 的 Model providers 里添加一个 OpenAI-API-compatible 供应商。
约 6 分钟适合:自己部署 RAGFlow 做文档问答的管理员
开始之前
- RAGFlow 已部署并能登录
- 一把 Key 和一个模型名
步骤 1 · STEP 0x01
选择供应商
User settings → Model providers
1
Available models
OpenAI-API-compatible
2
实例名称
随便取
进入 User settings → Model providers,在 Available models 里选 OpenAI-API-compatible 这一类供应商,给这个实例取个名字。中文界面对应「用户设置 → 模型提供商」,以你的版本为准。
步骤 2 · STEP 0x02
填 Key、Base URL 并添加模型
OpenAI-API-compatible
1
API Key
<你的 Key>
2
Base URL
https://api.suanlimao.shop/v1
3
模型名(自定义模型)
<模型名>
4
模型类型
chat
5
Max context length(可选)
按模型参数
6
Tool calling(可选)
模型支持时开
7
验证并保存
- Base URL 填
https://api.suanlimao.shop/v1。官方提示「使用兼容 API 时确认路径是否需要包含 /v1」——我们的接口需要。 - 添加自定义模型时,官方要求模型名必须与供应商 API 暴露的模型 ID 一致,即模型广场里的名字。
- 保存前会验证;失败时会有警告标记,点开看具体报错。
模型名不要自己猜:到「模型广场」点模型卡片上的「复制模型名」,再粘贴到软件里。模型名写错是最常见的报错原因。
步骤 3 · STEP 0x03
设为默认模型并测试
Model providers → System model settings
1
Chat model
<模型名>
2
聊天助手 → 测试
用一句话介绍这份文档
- 在系统模型设置里把 Chat model 指到这个模型,然后在聊天助手里试一句。
向量(embedding)、重排序模型也可以用同样方式添加,模型类型分别选 embedding / rerank;模型广场没有的类型就用 RAGFlow 内置模型。
✓ 怎么确认成功了
- 供应商验证通过;聊天助手能回答;控制台「用量」页出现请求。
常见问题
验证失败?
官方排错顺序:凭据、端点(Base URL 是否带 /v1)、模型名、服务可用性、额度。逐项核对后重新验证。
模型能聊但解析文档很慢?
文档解析走的是 embedding 和 OCR 等模型,与聊天模型无关;检查那些模型的配置。
相关教程
还是不行?
先看排错教程;仍然解决不了,提交工单时附上 request_id、时间、模型和报错原文(不要贴 Key)。