qwen-code/docs/users/configuration
顾盼 240c99c186
fix(openai): default splitToolMedia so tool-returned images reach strict backends (#4917)
OpenAI Chat Completions only permits text on `role:"tool"` messages, so an image
read via read_file — the only image path available to a subagent — was embedded
there and silently dropped by strict OpenAI-compatible backends (doubao /
new-api / LM Studio). The model never saw the image and returned content
unrelated to it (#4876). Permissive backends (e.g. DashScope) happen to parse
it, which is why the same model worked for the main agent via @-image
(role:"user") but not for the subagent via read_file (role:"tool").

Flip the runtime default of splitToolMedia to true so tool-returned media is
lifted into a follow-up role:"user" message — spec-compliant and visible to all
backends. Opt out via generationConfig.splitToolMedia = false.

Also:
- modalityDefaults: recognize ByteDance Doubao (Seed chat + *vision/*vl => image;
  seedance/seedream generation models => text-only).
- settingsSchema + docs: default true, description corrected to cover the
  built-in read_file (not only MCP tools).

Tests: pipeline default-true regression, modalityDefaults doubao cases, converter
opt-out wording.
2026-06-11 04:51:14 +08:00
..
_meta.ts Hide internal docs from docs site (#4357) 2026-06-01 15:55:14 +08:00
auth.md refactor(cli): remove legacy qwen auth CLI subcommand, redirect to /auth TUI dialog (#3959) 2026-05-11 16:44:09 +08:00
model-providers.md refactor(cli): provider-first auth registry with unified install pipeline (#3864) 2026-05-08 12:19:28 +08:00
qwen-ignore.md Merge pull request #1266 from QwenLM/docs-fix 2025-12-17 22:04:27 +08:00
settings.md fix(openai): default splitToolMedia so tool-returned images reach strict backends (#4917) 2026-06-11 04:51:14 +08:00
themes.md docs: add /diff command and auto theme detection documentation (#4699) 2026-06-02 21:28:34 +08:00
trusted-folders.md docs: updated all links, click and open in vscode, new showcase video in overview 2025-12-17 11:10:31 +08:00