From 138d891d7f42004c417561050a6813792316b13b Mon Sep 17 00:00:00 2001 From: Davina Zaman Date: Wed, 4 Mar 2026 11:44:39 -0800 Subject: [PATCH] [Docs] Clarify structured outputs configuration for Qwen3 reasoning mode (#32441) Signed-off-by: Davina Zaman Signed-off-by: Harry Mellor <19981378+hmellor@users.noreply.github.com> Co-authored-by: Harry Mellor <19981378+hmellor@users.noreply.github.com> --- docs/features/structured_outputs.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/features/structured_outputs.md b/docs/features/structured_outputs.md index a1f789111..41cf7be89 100644 --- a/docs/features/structured_outputs.md +++ b/docs/features/structured_outputs.md @@ -210,6 +210,12 @@ Note that you can use reasoning with any provided structured outputs feature. Th See also: [full example](../examples/online_serving/structured_outputs.md) +!!! note + When using Qwen3 Coder models with reasoning enabled, structured outputs might become disabled if the reasoning content does not get parsed into the `reasoning` field separately (v0.11.2+). + To use both features together, you must explicitly enable structured outputs in reasoning mode. + To do so, add the following flag when starting the vLLM server: `--structured-outputs-config.enable_in_reasoning=True`. + See also: [Reasoning Outputs](reasoning_outputs.md) documentation. + ## Experimental Automatic Parsing (OpenAI API) This section covers the OpenAI beta wrapper over the `client.chat.completions.create()` method that provides richer integrations with Python specific types.