将 FreeScout 连接到自定义 OpenAI 兼容服务器
在 ReplyRabbit Pro 或 Team 套餐中,选择 自定义 OpenAI 兼容 以将草稿发送到你控制的 API 服务器或网关。输入其基础 URL、可选的不记名令牌以及确切的聊天模型 ID。ReplyRabbit 会在你依赖它们之前测试你配置的能力。
您的服务器需要支持什么
对于草稿和预览,服务器必须接受 POST /chat/completions 使用 model, messages, max_tokens,以及 temperature,然后在 choices[0].message.content时才会重新索引。ReplyRabbit 会将此路径附加到你输入的基础 URL。
嵌入需要一个单独的嵌入模型,该模型接受 POST /embeddings 使用 model 和 input中返回可用文本,然后为每个输入返回一个向量。视觉功能需要支持聊天补全中 OpenAI 风格图像内容的模型。服务器可以支持聊天,但不支持上述任一能力。
ReplyRabbit 在此提供商下不使用 Responses API、流式传输、工具调用、重排序、自定义标头或自动模型发现。兼容性取决于你提供的 API 形态和模型。
配置邮箱
选择提供方
打开您的 FreeScout 邮箱的 ReplyRabbit 设置。在 AI 提供商,选择 自定义 OpenAI 兼容。此选项需要 Pro 或团队版。输入基础 URL
输入 API 基础地址,例如https://llm.example.com/v1或http://10.0.0.25:8000/v1。仅输入基础地址;ReplyRabbit 会添加/chat/completions或/embeddings。FreeScout 的 PHP 进程必须能够访问此地址。公共地址需要 HTTPS。HTTP 仅允许在受信任网络上的私有或回环地址使用。输入令牌和聊天模型
如果你的服务器需要 bearer 认证,请在以下位置输入其令牌 可选 bearer 令牌。否则留空。输入你的服务器报告的精确聊天模型 ID。ReplyRabbit 会加密存储令牌,并在保存后显示掩码预览。配置其他功能
对于语义检索,选择此提供商进行嵌入并输入嵌入模型 ID。对于邮箱预览或附件视觉,选择或继承提供商,并在需要时输入合适的模型。附件视觉需要 Team。聊天模型不会自动用于嵌入。测试并保存
点击 测试连接。测试会发送简短示例文本,并针对你输入的模型分别报告聊天、嵌入和视觉功能。它不会保存表单。查看结果,然后保存邮箱设置。
将 URL 更改为其他服务器会清除已保存的令牌,除非您输入替代令牌。ReplyRabbit 绝不会将来自其他提供方的已保存密钥发送到自定义端点。
共享和独立服务器
如果一个网关同时服务聊天和嵌入,请输入相同的 /v1 ReplyRabbit 和独立版本中的基础 URL Semantic Search 设置。在 ReplyRabbit 中输入适当的聊天模型,并在语义搜索中输入嵌入模型。这些产品保持独立的设置和令牌。
如果聊天和嵌入运行在不同的主机或端口上,请输入每个服务器自己的 /v1 其产品设置中的基础 URL。ReplyRabbit 还允许你为其自身的语义检索选择另一个现有的嵌入提供商。
故障排除
| 症状 | 应检查什么 |
|---|---|
| 聊天测试失败 | 确认 FreeScout 可以访问基础 URL、聊天模型 ID 完全一致,并且服务器支持 /chat/completions. |
PHP 升级后每个测试都失败,但是 curl 工作方式 | 检查 FreeScout 日志中的 deprecated since 8.5 消息。请参阅 修复 FreeScout 中的 "deprecated since 8.5" 错误. |
| 嵌入不可用 | 输入嵌入模型 ID 并确认服务器支持 /embeddings。当嵌入无法运行时,关键词检索仍然可用。 |
| 视觉测试失败 | 确认所选模型接受图像内容。即使没有视觉功能,文本起草仍可正常工作。 |
| 更改服务器后令牌消失 | 为新服务器输入令牌。ReplyRabbit 会清除旧服务器的令牌以保护它。 |
| 公共 HTTP URL 被拒绝 | 使用带有效证书的 HTTPS。将 HTTP 端点保留在受信任的私有网络上。 |
隐私
所选服务器接收已启用 AI 任务所需的支持内容。远程端点可能会将该内容发送到 FreeScout 主机之外。请使用可信服务器,保护其令牌,并检查其保留策略。连接测试使用示例文本而不是客户对话。