openai · OpenAI Platform Docs
Tool search | OpenAI API
Explains how to implement tool search to allow an AI model to select and use specific tools from a large collection by searching through tool definitions.
Derived skill
Files assembled from official documentation
Viewing SKILL.md
Tool search | OpenAI API
Explains how to implement tool search to allow an AI model to select and use specific tools from a large collection by searching through tool definitions.
When To Use
Use when you need to enable an AI agent to navigate and select from a large number of available tools without overwhelming the context window with all tool definitions at once.
Reference Files
| File | Contains | Use For |
|---|---|---|
SKILL.md | Entry point: scope, routing table, and workflow. | Start here. |
docs/tool-search-openai-api-workflow-guide.md | A guide explaining how to use tool search to dynamically load tool definitions into the model context to reduce token usage. | Questions about a guide explaining how to use tool search to dynamically load tool definitions into the model context to reduce token... |
examples/tool-search-openai-api-openai-api-tool-search-namespace-definition.text | A text representation of a tool search configuration defining a namespace and function tools for CRM operations. | Exact payloads, commands, or snippets shown in A text representation of a tool search configuration defining a namespace and function tools for CRM operations. |
examples/tool-search-openai-api-openai-api-tool-search-python-namespace.text | A Python code example demonstrating how to define a tool namespace containing CRM functions for the OpenAI API tool search feature. | Exact payloads, commands, or snippets shown in A Python code example demonstrating how to define a tool namespace containing CRM functions for the OpenAI API tool s... |
examples/tool-search-openai-api-openai-api-tool-search-nodejs-namespace.text | A JavaScript code example demonstrating how to define a namespace containing CRM tools for use with the OpenAI tool search functionality. | Exact payloads, commands, or snippets shown in A JavaScript code example demonstrating how to define a namespace containing CRM tools for use with the OpenAI tool s... |
examples/tool-search-openai-api-openai-api-tool-search-call-and-json.text | A JSON representation of a tool search call and its corresponding server execution output. | Exact payloads, commands, or snippets shown in A JSON representation of a tool search call and its corresponding server execution output. |
examples/tool-search-openai-api-openai-api-python-tool-search-implementation.text | A Python code example demonstrating how to use the OpenAI client to perform a tool search using a model to identify and execute specific tools. | Exact payloads, commands, or snippets shown in A Python code example demonstrating how to use the OpenAI client to perform a tool search using a model to identify a... |
examples/tool-search-openai-api-openai-api-tool-search-nodejs.text | A Node.js code example demonstrating how to use the tool search capability with the OpenAI client to find and execute specific tools. | Exact payloads, commands, or snippets shown in A Node.js code example demonstrating how to use the tool search capability with the OpenAI client to find and execute... |
examples/tool-search-openai-api-openai-api-tool-search-call.text | A JSON representation of a tool search call execution including call ID, status, and arguments. | Exact payloads, commands, or snippets shown in A JSON representation of a tool search call execution including call ID, status, and arguments. |
examples/tool-search-openai-api-openai-api-tool-search.text | A JSON-formatted example of a tool search output containing execution status and tool call details. | Exact payloads, commands, or snippets shown in A JSON-formatted example of a tool search output containing execution status and tool call details. |
examples/tool-search-openai-api-openai-api-tool-search-function-call.text | A text representation of a tool search function call containing a name, namespace, call ID, and JSON arguments. | Exact payloads, commands, or snippets shown in A text representation of a tool search function call containing a name, namespace, call ID, and JSON arguments. |
What This Skill Covers
- Tool search allows the model to dynamically search for and load tools into the model’s context as needed. This allows you to avoid loading all tool definitio...
- Main sections:
Use namespaces where possible,Tool search types,Hosted tool search,Client-executed tool search,Advanced usage.
Workflow
- Open the most relevant file under
docs/for the exact documented workflow and wording. - Open
schemas/files for exact structured contracts. - Open
examples/files for concrete requests, commands, snippets, and manifests. - Do not add behavior or configuration that is not present in the attached source files.
Canonical source: https://developers.openai.com/api/docs/guides/tools-tool-search