From 24617166ce2edf9ce5e78e98673a74d3f3880d38 Mon Sep 17 00:00:00 2001 From: yurekami Date: Wed, 24 Dec 2025 22:55:25 +0900 Subject: [PATCH] docs: add GPT-OSS (openai) tool parser documentation MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Add documentation for the `openai` tool call parser that supports GPT-OSS models. This parser was previously only documented in the cookbook but not in the main tool calling documentation. Fixes: #31211 Signed-off-by: yurekami 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 --- docs/features/tool_calling.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/docs/features/tool_calling.md b/docs/features/tool_calling.md index 7b6945cb71c27..d113652cbb710 100644 --- a/docs/features/tool_calling.md +++ b/docs/features/tool_calling.md @@ -396,6 +396,24 @@ Supported models: Flags: `--tool-call-parser gigachat3` +### GPT-OSS Models (`openai`) + +OpenAI's GPT-OSS models use a special token-based format (Harmony format) for tool calling that is parsed using the `openai` tool parser. + +Supported models: + +* `openai/gpt-oss-120b` +* `openai/gpt-oss-20b` + +Known limitations: + +* Only `tool_choice='auto'` is currently supported +* Streaming tool calls have limited support + +Flags: `--tool-call-parser openai --enable-auto-tool-choice` + +For more detailed examples and usage patterns, see the [GPT-OSS cookbook](https://docs.vllm.ai/projects/recipes/en/latest/OpenAI/GPT-OSS.html). + ### Models with Pythonic Tool Calls (`pythonic`) A growing number of models output a python list to represent tool calls instead of using JSON. This has the advantage of inherently supporting parallel tool calls and removing ambiguity around the JSON schema required for tool calls. The `pythonic` tool parser can support such models.