Tool Search OpenAI API: busca herramientas dinámicamente con GPT
Tool Search OpenAI API permite que modelos compatibles de OpenAI localicen las herramientas relevantes para una tarea cuando una aplicación dispone de un catálogo amplio de funciones o capacidades. Mediante herramientas diferidas, búsqueda dinámica y Responses API, puedes evitar cargar todas las definiciones de herramientas desde el inicio y construir agentes más escalables.
¿Qué es Tool Search OpenAI API?
Tool Search OpenAI API es una capacidad que permite al modelo buscar herramientas disponibles cuando estas se han configurado para cargarse de manera diferida. En lugar de proporcionar al modelo todas las herramientas completas desde el comienzo, Tool Search puede localizar el subconjunto relevante y ponerlo a disposición cuando la tarea realmente lo necesita.
Qué permite hacer Tool Search OpenAI API
Tool Search está pensado para aplicaciones con catálogos de herramientas que pueden crecer considerablemente.
Buscar herramientas
Localizar capacidades relevantes según la tarea solicitada.
Carga diferida
Evitar cargar todas las definiciones desde el comienzo.
Reducir contexto
Mantener fuera del contexto inicial herramientas irrelevantes.
Catálogos grandes
Diseñado para escenarios con muchas funciones y capacidades.
BYOT
La referencia contempla búsqueda alojada y búsqueda de herramientas proporcionada por tu sistema.
Agentes escalables
Permite diseñar agentes con muchas capacidades sin presentar todo simultáneamente.
Cómo funciona Tool Search en OpenAI API
Tool Search introduce una etapa de descubrimiento antes de utilizar una herramienta diferida.
El modelo entiende la tarea
Determina qué tipo de capacidad necesita para continuar.
Busca herramientas
Tool Search localiza las herramientas relevantes.
Utiliza la herramienta
Una vez disponible, el modelo puede seleccionarla dentro del workflow.
Tool Search OpenAI API dentro de Responses API
Tool Search forma parte del sistema de herramientas disponible para modelos compatibles.
Búsqueda para herramientas diferidas
La referencia actual describe Tool Search como una configuración de búsqueda alojada o BYOT destinada específicamente a herramientas diferidas.
Tool Search ayuda a encontrar qué capacidad debería cargarse. La herramienta localizada sigue siendo la que posteriormente ejecuta la tarea.
Ver Responses API →Qué son las herramientas diferidas
Una herramienta diferida no necesita cargarse completamente en el contexto inicial del modelo.
Cargar solo cuando sea relevante
Las definiciones que pueden necesitarse más adelante pueden marcarse para carga diferida, permitiendo que Tool Search participe en su descubrimiento.
Si tu aplicación solo dispone de tres o cuatro funciones, cargar todo desde el comienzo puede seguir siendo perfectamente razonable.
Cómo utilizar Tool Search OpenAI API
Un workflow puede habilitar Tool Search y mantener determinadas funciones como herramientas diferidas.
Tool Search + función diferida
{
"model": "gpt-5.6-sol",
"tools": [
{
"type": "tool_search"
},
{
"type": "function",
"name": "buscar_cliente",
"description": "Busca un cliente en el CRM.",
"defer_loading": true,
"parameters": {
"type": "object",
"properties": {
"nombre": {
"type": "string"
}
},
"required": ["nombre"],
"additionalProperties": false
}
}
],
"input": "Busca los datos de contacto de Empresa Ejemplo."
}Tool Search está evolucionando. Comprueba los campos exactos de la versión de Responses API y SDK que estés utilizando antes de llevar una implementación a producción.
Qué ocurre cuando cargas demasiadas herramientas
Una aplicación puede llegar a disponer de decenas o cientos de funciones.
Más definiciones ocupan más contexto.
El modelo tiene más opciones entre las que elegir.
Muchas herramientas pueden ser irrelevantes para la solicitud actual.
Los schemas extensos pueden aumentar los tokens de entrada.
Mantener el catálogo se vuelve más complejo.
Tool Search carga solo las herramientas relevantes
El objetivo es reducir el conjunto activo antes de ejecutar una herramienta concreta.
Menos herramientas en el contexto activo
La guía de modelos de OpenAI recomienda considerar Tool Search para catálogos grandes, de modo que las definiciones puedan diferirse y cargarse únicamente cuando resulten relevantes.
Qué es un tool_search_call
Cuando el modelo utiliza Tool Search, Responses API dispone de un tipo de output específico para representar esa búsqueda.
Solicitud para localizar herramientas
La referencia actual
define un objeto
tool_search_call
que contiene información
relacionada con
la consulta de herramientas.
Qué devuelve Tool Search
La API también define un elemento de salida específico para los resultados encontrados.
Herramientas recuperadas
El output puede proporcionar el conjunto de herramientas relevantes que pasan a formar parte del flujo del modelo.
Hosted Tool Search vs BYOT
La referencia de Responses API contempla búsqueda de herramientas alojada y una alternativa BYOT.
| Aspecto | Hosted Tool Search | BYOT |
|---|---|---|
| Búsqueda | Administrada dentro del sistema | Tu integración participa en la búsqueda |
| Control | Configuración más directa | Mayor personalización |
| Infraestructura propia | Menor | Puede ser necesaria |
| Uso | Catálogos diferidos | Búsqueda personalizada de herramientas |
Puede ser interesante cuando necesitas controlar de forma específica cómo se seleccionan las herramientas candidatas.
Namespaces para organizar herramientas
Responses API también contempla herramientas de namespace para agrupar funciones y custom tools bajo un espacio común.
Herramientas de clientes
Buscar cliente, consultar oportunidades o revisar actividad.
Herramientas de tienda
Consultar productos, pedidos, stock y despacho.
Herramientas de soporte
Buscar tickets, consultar estados y gestionar casos.
Agrupar herramientas relacionadas puede ayudar a mantener un catálogo más comprensible a medida que crece.
Tool Search vs Function Calling
Tool Search no ejecuta la función de negocio por sí mismo.
| Aspecto | Tool Search | Function Calling |
|---|---|---|
| Objetivo | Encontrar herramientas relevantes | Solicitar una función concreta |
| Catálogo grande | Especialmente útil | Puede utilizarse sin Tool Search |
| Ejecución de negocio | No es su objetivo | La realiza tu backend |
| Resultado | Herramientas disponibles | Argumentos para una función |
Tool Search puede localizar una función relevante y el modelo puede utilizarla posteriormente mediante Function Calling.
Ver Function Calling →Tool Search y MCP
Los agentes modernos también pueden disponer de herramientas provenientes de servidores MCP.
Muchas integraciones pueden generar muchos tools
Cuando un agente se conecta a diversos sistemas, seleccionar dinámicamente herramientas relevantes puede resultar más eficiente que mantener todo el catálogo activo.
Ver MCP OpenAI API →Tool Search y tool_choice
Responses API también permite controlar qué herramientas puede utilizar el modelo.
| Configuración | Uso general |
|---|---|
auto |
El modelo decide si necesita utilizar herramientas |
required |
Debe llamar una o más herramientas |
none |
Las herramientas quedan deshabilitadas para esa respuesta |
| Allowed tools | Restringe las herramientas a un conjunto predefinido |
Tool Search vs Allowed Tools
Ambos mecanismos pueden reducir el espacio de herramientas, pero no hacen exactamente lo mismo.
| Aspecto | Tool Search | Allowed Tools |
|---|---|---|
| Selección | Busca herramientas relevantes | Restringe el conjunto permitido |
| Catálogos grandes | Especialmente útil | Útil para control |
| Seguridad | Reduce herramientas activas | Define explícitamente cuáles están permitidas |
| Uso conjunto | Pueden formar parte de la misma estrategia de control | |
Casos de uso de Tool Search OpenAI API
Tool Search aporta mayor valor cuando el agente dispone de muchas capacidades posibles.
CRM: seleccionar entre numerosas operaciones de clientes y ventas.
Ecommerce: localizar herramientas de productos, pedidos, stock o despacho.
SaaS: manejar grandes catálogos de acciones internas.
Agentes empresariales: elegir capacidades entre diferentes departamentos.
MCP: organizar catálogos provenientes de varias integraciones.
Automatización: localizar acciones apropiadas para cada etapa de un workflow.
Cuándo conviene utilizar Tool Search
No todos los agentes necesitan una capa adicional de descubrimiento.
Cuando tienes muchas herramientas.
Cuando los schemas ocupan demasiado contexto.
Cuando cada usuario dispone de capacidades diferentes.
Cuando las integraciones crecen continuamente.
Cuando quieres cargar herramientas solo bajo demanda.
Cuándo probablemente no necesitas Tool Search
Para un agente sencillo, añadir búsqueda dinámica puede generar complejidad innecesaria.
Catálogo pequeño
Si dispones de tres o cuatro funciones, puede ser más sencillo declararlas directamente.
Herramienta conocida
Si tu aplicación ya sabe exactamente qué función necesita, la búsqueda puede no aportar valor.
Tool Search y el consumo de contexto
Una de las razones principales para utilizar carga diferida es evitar incluir definiciones irrelevantes en cada solicitud.
Los schemas también forman parte del contexto
Nombres, descripciones, parámetros y JSON Schemas de las herramientas añaden información que el modelo debe procesar.
OpenAI recomienda considerar búsqueda de herramientas para catálogos grandes y diferir definiciones que no necesitan cargarse inmediatamente.
Tool Search también añade una etapa de búsqueda
Reducir contexto no significa que Tool Search sea automáticamente mejor para todos los escenarios.
Contexto frente a descubrimiento
Con catálogos pequeños, declarar directamente las herramientas puede resultar más simple. Con catálogos grandes, la búsqueda dinámica puede compensar esa etapa adicional.
Modelos OpenAI compatibles con Tool Search
Tool Search no debe asumirse como disponible en todos los modelos.
| Modelo | Tool Search | Orientación |
|---|---|---|
| GPT-6 Astra | Compatible | Workflows end-to-end complejos |
| GPT-5.6 Sol | Compatible | Trabajo profesional y agentes complejos |
| GPT-5.6 Terra | Compatible | Equilibrio capacidad/costo |
| GPT-5.6 Luna | Compatible | Alto volumen y costo optimizado |
| Chat Latest | No compatible | Chat general |
OpenAI publica por separado las herramientas compatibles con cada modelo.
Comparar modelos →Tool Search dentro de un agente de IA
Un agente avanzado puede disponer de diferentes capas de herramientas.
El usuario solicita una tarea.
El modelo determina qué capacidad necesita.
Tool Search localiza las herramientas candidatas.
Se carga el subconjunto relevante.
El modelo llama la herramienta adecuada.
El resultado vuelve al workflow.
Buenas prácticas con Tool Search OpenAI API
Encontrar una herramienta no significa que el modelo deba tener permiso para utilizarla sin controles.
Aplica permisos antes de exponer herramientas.
Separa tools por usuario, empresa o rol cuando corresponda.
Utiliza allowed tools para limitar capacidades sensibles.
Requiere confirmación para efectos importantes.
Registra qué herramienta fue encontrada y utilizada.
Mantén descriptions precisas y sin instrucciones ambiguas.
Escribe buenas descripciones de herramientas
La calidad del catálogo sigue siendo importante aunque utilices búsqueda dinámica.
“Busca cosas”
Una descripción demasiado genérica dificulta distinguir cuándo corresponde utilizar una herramienta.
“Busca clientes por nombre o email”
Una descripción concreta comunica claramente la finalidad de la herramienta.
Costos de Tool Search OpenAI API
El costo final depende del modelo, contexto, búsqueda y herramientas utilizadas durante el workflow.
No midas solo el costo de una llamada
Si Tool Search reduce la cantidad de definiciones introducidas continuamente en el contexto, el beneficio puede observarse a nivel del workflow completo.
Para tu aplicación, mide tokens, latencia, tool calls y tasa de éxito antes de decidir entre catálogo completo o carga diferida.
Ver precios OpenAI API →Tool Search y los límites de OpenAI API
El uso de herramientas continúa sujeto a límites del modelo y proyecto.
Un workflow puede realizar varias etapas
Buscar herramientas, seleccionar una, ejecutarla y continuar razonando puede involucrar múltiples operaciones dentro de la tarea.
Ver límites OpenAI API →Documentación oficial de Tool Search OpenAI API
Tool Search forma parte de un conjunto de capacidades que sigue evolucionando dentro de Responses API.
Tool Search y deferred tools
Comprueba la configuración actual, modelos compatibles, búsqueda alojada, BYOT y parámetros disponibles.
Consultar documentación oficial →Guías relacionadas con Tool Search OpenAI API
Continúa explorando el ecosistema de herramientas de Responses API.
FAQ sobre Tool Search OpenAI API
Respuestas sobre herramientas diferidas, catálogos, BYOT, agentes y Responses API.
Tool Search OpenAI API permite buscar herramientas relevantes cuando una aplicación utiliza herramientas que pueden cargarse de forma diferida.
Sí. OpenAI incluye Tool Search entre las herramientas compatibles de Responses API para modelos determinados.
Indica que una herramienta puede cargarse de forma diferida en lugar de incluir toda su definición inmediatamente en el conjunto activo.
Es un tipo de elemento de respuesta utilizado para representar una llamada de búsqueda de herramientas.
BYOT significa Bring Your Own Tool Search y permite incorporar una implementación propia de búsqueda de herramientas.
No. Tool Search ayuda a localizar herramientas relevantes. Function Calling permite solicitar una función concreta y sus argumentos.
Principalmente cuando una aplicación dispone de un catálogo grande de herramientas y no resulta eficiente cargar todas desde el inicio.
Sí. OpenAI publica Tool Search entre las herramientas compatibles de GPT-5.6 Sol.
Sí. OpenAI publica Tool Search entre las herramientas compatibles de GPT-5.6 Terra y GPT-5.6 Luna.
Su enfoque de herramientas diferidas permite evitar cargar inicialmente definiciones completas que no son relevantes para la tarea actual.
Continúa con Skills en OpenAI API
Ya sabes cómo un modelo puede encontrar herramientas dinámicamente. El siguiente paso es conocer Skills, otra capacidad del ecosistema actual de agentes y modelos OpenAI.
Ver Skills →