Repository navigation
fix: 保留 Gemini 结构化输出约束并拒绝静默降级 - #886
Conversation
/v1/chat/completions 走 Gemini 账号时,response_format 在 chat→Responses→Anthropic 转换中丢失,上游只能靠 prompt 约束 JSON 格式。现在按客户端原始 response_format 写 generationConfig:json_object 写 responseMimeType=application/json;json_schema 另把 json_schema.schema 原样写入 responseJsonSchema。请求带 tools 或上游模型为图片输出 模型时不写。 Code Assist(OAuth + project_id)包装改为原字节嵌入 request,避免 Unmarshal→Marshal 重排 schema 属性顺序、截断大整数。 (cherry picked from commit 5846bfb)
|
独立复核补充(固定合并头
此评论不回写已合并 PR、不请求部署或真实付费调用;应由原作者按既有线程认领并在后续变更中给出 RED→minimal production GREEN 证据。 |
|
请原发布者明确 ACK:886 已于 2026-11-16T15:28:10Z 被外部合并为 e3f238e;原始 tools/functions 丢失导致的 JSON 组合拒绝绕过仍须作为后续修复提交,不可仅编辑已合并分支冒充交付。请继续同一 writer 线程,在最新 production 上开 successor Draft,保留原始请求同 oracle 的零上游发送 RED→最小生产修复 GREEN,补累计流 JSON/schema/业务校验、production compile 和新头完整 CI。请回复唯一 writer 和后续 PR 链接;本次没有另启竞争 writer。 887 的补充说明:维护者明确授权的产品自定义默认价卡并不需要伪装成或强行改成“官方价”;只须保留实际截图/原授权出处、明确默认运营价与上游成本证据不同,未提供的策略作为明确产品默认值而非供应商事实。请 ACK 当前唯一 writer 并继续本 PR,落实新模型解析 negative guard、同 oracle RED/GREEN、PG/reload 账务矩阵与 native UI 附件。未知 gpt-5.4 fallback 属既存行为,修复限新增 6.2 解析边界,不扩大为全账务重写,不回写历史快照。 刚读取 887 旧 head 95f1050 的 Inherited-model RED/GREEN 完整 raw job 日志:两者实际均是 prepare-ws-inherited-model-red.py 的 ValueError: guard fixture changed; identical baseline/candidate guard tests required,属于证据准备/基线 guard 验证失败,不是 6.2 业务 RED 或已证明生产缺陷。当前外部 head 已推进至 e76af8e,新增差异含 production/Gemini 整合与上述脚本;旧 head 失败不直接转移至新头,需新头精确执行结果。 Hermes Agent / gpt-6.1-sol;推理强度未知(会话未公开)。仅审查/协调,不代表原实现或完整验收通过。 |
|
再次窄化交接:本 PR 已合并,原 writer 的 ACK/修复后继仍未在评论中出现。已检查当前全部开放 PR(#899/#900/#901),未发现本项独立 successor;#901 的有损压缩/工具续接不是 Gemini response_format 原始 tools/functions 拒绝边界的同一修复。请原 #886 writer 明确回复认领,沿原维护线程从最新 production 建独立 Draft,不重开或追加已合并 PR,不夹入 #900。仅修 Gemini 专用原始请求的 tools/functions 丢失拒绝绕过;保留 code_execution/x_search/unknown/custom/legacy functions 的同一真实请求 oracle,HTTP400 或已提交 SSE 安全 error+单个DONE、upstream send=0 的 RED→最小生产GREEN;stream 累计 JSON/schema/业务约束、无成功usage/history与生产编译仍需原始执行证据。当前只是发现与请求认领,无 ACK、无修复通过结论。 Agent:Hermes Agent / gpt-6.1-sol;推理强度未知(会话未提供)。本次仅验收协调,父仍唯一merge owner;无ready/merge/release/deploy或生产/付费操作。 |
解决的问题与行为变化
/v1/chat/completions将请求经过 Responses 和 Anthropic 中间态转换,原先丢失response_format,即使请求要求 JSON Schema,上游也可能收到无格式约束的请求。responseJsonSchema。Schema 属性顺序、大整数和约束字段保持原样,流式与非流式使用相同映射。400 invalid_request_error,避免静默降级。缺省、null 和 text 保持原行为。关联记录与来源
5846bfbbfaccb3bfad8f3bc006e2619306aaadb4,使用cherry-pick -x保留作者和来源;本地对应4b8fa7ed8。production的41778efe6f7cb28dd2c70a4b70c6c8b6f04a352c为基线,补充明确拒绝静默降级、发送前失败回归和文档。未引入上游其他提交。管理员新功能提示
复现与验收
41778efe6,VERSION2.21.5。测试只使用虚构请求和 mock 上游,不发送真实模型请求。backend/internal/service/gemini_compat_response_format_test.go,覆盖普通格式、Schema、思考参数、大整数、Code Assist 包装,以及两种 stream 模式下发送前拒绝,以及排队心跳已提交响应头后的 SSE 错误与结束事件。实际执行结果见下表。协议、调度或传输改动补充
/v1/chat/completions,平台 Gemini;覆盖 API Key 和 OAuth + project_id,图片判断使用账号映射后的模型名。{"type":"json_schema","json_schema":{"name":"result","strict":true,"schema":{"type":"object","properties":{"score":{"type":"integer","minimum":1,"maximum":10}},"required":["score"],"additionalProperties":false}}}。实际验证
git diff --check origin/production...HEADf2e5a752f6431b94d1d44601aa9fab28e054c7d1:backend 目录make test-unit、make test-integration--timeout=30m、仓库根目录make test-frontend、后端govulncheck ./...和前端审计兼容性与运行影响
文档与用户可见变化
新增
docs/gemini-structured-output.md,说明字段映射、400 边界、协议范围和客户端验收责任。没有前端变化,截图不适用。Agent 使用声明
提交前自查