Repository navigation
Open
Description
Issue 1:模型测试连接
标题:
[Bug] GPT-6 系列模型测试连接失败:temperature 参数不被支持,且报错信息不显示真实原因
正文:
## 环境
- GEOFlow 版本:v3.2.1(生产部署,docker-compose.prod.yml,Nginx + PHP-FPM)
- 模型:OpenAI `gpt-6-luna`(GPT-6 推理系列),密钥有效、网络正常
- 复现账号:超级管理员
## 问题描述
配置 OpenAI 官方 API + GPT-6 系列模型,点击「测试连接」始终失败,前端只显示通用错误:
> An unexpected backend error occurred. Check the application log.
日志(storage/logs/laravel-*.log)只有:production.WARNING: AI model connection test failed. {"ai_model_id":1,"exception":"Illuminate\Http\Client\RequestException","reason_code":null}
没有记录 HTTP 状态码和响应体,排查非常困难。手动复现后拿到真实错误:
HTTP 400
{"error":{"message":"Unsupported parameter: 'temperature' is not supported with this model.",...}}
## 根因分析
1. OpenAI GPT-6 推理系列已不支持 `temperature` 参数(必须使用默认值,`max_tokens` 同样需换成 `max_completion_tokens`)。
2. 超管测试连接会先走 AI 工作台探测(`AiWorkspaceModelCapabilityProbe` → `AiWorkspaceModelRuntime::probeStreaming`),底层经 Laravel AI 的 openai 驱动发请求。
3. 以下 4 个 Agent 通过 PHP Attribute 硬编码了 temperature,会被框架无条件注入请求体:
- `app/Ai/Agents/AdminHelpAssistant.php:16` → `#[Temperature(0.2)]`
- `app/Ai/Agents/GeoHubAgent.php:13` → `#[Temperature(0.2)]`
- `app/Ai/Agents/GeoHubPlanDrafterAgent.php:15` → `#[Temperature(0)]`
- `app/Ai/Agents/IntentResolverAgent.php:15` → `#[Temperature(0)]`
4. `AdminHelpAssistant.php:76` 的推理模型白名单 `Str::is(['o1*','o3*','o4*','gpt-5*'], ...)` 未包含 `gpt-6*`,无法走 reasoning 分支。
## 临时解决(本站已验证有效)
- 移除上述 4 处 `#[Temperature]` 属性
- 白名单加入 `'gpt-6*'`
## 建议
1. 官方适配 GPT-6 系列:按模型名/接口探测决定是否下发 temperature 和 max_tokens
2. 模型测试失败时,将 HTTP 状态码 + 响应体写入日志并在前端展示(现在的通用错误对用户排障没有帮助)
## 另一个相关小点
`AiModelController::buildTestPayload()` 中非 Responses API 的 chat 载荷使用 `max_tokens` + `temperature: 0`。官方 api.openai.com 走 Responses API 不受影响,但用户配置第三方 OpenAI 兼容网关 + GPT-6 模型时会命中同样的问题,建议一并处理。
Issue 2:URL 智能采集语言问题
标题:
[
5AB1
Bug/建议] URL智能采集把英文/日文等外文页面全部清洗成中文,需要支持保留原文语言
正文:
## 环境
- GEOFlow 版本:v3.2.1(生产部署)
- 采集 URL:英文站点(日文/高棉语/缅甸语站点同理)
## 问题描述
使用「URL智能采集」,英文页面的正文、知识库、关键词、标题建议全部被 AI 输出成中文,原始语言信息完全丢失。
## 根因分析
`app/Services/GeoFlow/UrlImportProcessingService.php` 的采集管线各阶段提示词全部为中文指令,且没有任何「保持原文语言」的约束:
- 清洗:`buildCleanSystemPrompt()`(:907 附近)/ `buildCleanUserPrompt()`(:943 附近),且 `clean_summary 120-240 字` 暗示中文输出
- 知识库:`buildKnowledgeSystemPrompt()`(:1019 附近)
- 关键词:`buildKeywordsSystemPrompt()`(:955 附近)
- 标题:`buildTitlesSystemPrompt()`(:988 附近)
- 内置素材规则:`builtInGeoCollectionPrompt()`
把英文页面内容喂给中文指令的提示词,模型会自然用中文重写全部输出。
另外注意到采集表单的 `options_json` 里已有 `content_language` 字段(当前留空),但提示词链路似乎并未使用它——如果能让这个字段真正控制输出语言就完美了。
## 临时解决(本站已验证有效)
给全部 8 处提示词追加语言约束,例如:所有输出字段必须与页面正文语言完全一致,禁止翻译:英文页面输出英文,
中文页面输出中文(关键词/标题/知识库 Markdown 同样适用)。
采集英文站后预览四项内容(正文/知识库/关键词/标题)均正确保留英文。
## 建议
1. 利用现有 `content_language` 选项:留空=自动跟随页面语言,可选指定目标语言
2. 或在提示词中默认加入「与页面正文语言一致」约束
3. 多语言场景(日文正常;高棉语/缅甸语为低资源语言)语义召回依赖 embedding 质量,文档里可以提示一句
另外记得:等作者出了官方修复版本,升级前先 cd /opt/GEOFlow && git stash 清掉我们的本地补丁,再拉新版本——如果官方修复合并了,你的本地补丁就不需要了。
Metadata
Metadata
Assignees
Labels
No labels
Activity