intermedio
Tool search: tus herramientas ya no van en el prompt
Respuesta rápida:
El 5 de marzo de 2026, OpenAI dejó de pedirle al prompt que cargara con el catálogo de herramientas. No es que haya menos herramientas: es que el sitio donde se declaran ha cambiado de dueño, y con él lo que pagas en cada llamada.
Qué ha salido
gpt-5.4 y gpt-5.4-pro, del 5 de marzo de 2026. OpenAI los presenta como modelos para trabajo profesional, con 1M de contexto, computer use integrado, compactación nativa y tool search.
Las tres cosas no son la misma noticia. Computer use mete la interacción con una interfaz —pantallazos, clics— dentro de la API, como herramienta computer del Responses API. La compactación convierte un prompt de agente largo en un problema de mantenimiento —qué conservar— y no de encaje. Y tool search aplaza el catálogo de herramientas hasta el momento de la llamada.
El 17 de marzo llegaron gpt-5.4-mini y gpt-5.4-nano. La mini trae tool search y computer use; la nano trae compactación pero no búsqueda de herramientas.
Qué cambia al razonar
OpenAI da tres razones para tool search: gastar menos tokens, conservar la caché y responder antes. Las tres salen del mismo movimiento. Ochenta definiciones en cada petición son ochenta definiciones que se pagan, que ocupan prefijo y que hay que leer antes de decidir nada.
El cambio de fondo es dónde vive el índice. Una descripción de herramienta era texto de prompt: la escribías una vez y la pegabas en cada llamada, en el mismo fichero que el resto del prompt. Ahora es un artefacto que se consulta en ejecución. Se nota en la factura del mes siguiente. La lista ya no puede quedarse vieja dentro del prompt, porque no está dentro. Y el prefijo estable deja de arrastrar definiciones que esa llamada no va a usar, que es lo que OpenAI llama conservar el rendimiento de la caché.
Lo que no cambia es la descripción. Una que no distingue search_orders de lookup_order sigue eligiendo mal, la lea quien la lea. El trabajo no desaparece: se muda de enumerar a describir.
Qué cambia al escribir prompts
Un prompt que enumeraba herramientas se rompe por tres sitios, y ninguno avisa con un error.
La lista se queda atrás: una herramienta que ya no está en el catálogo sigue en el texto, y el modelo la pide. La referencia por posición: «la tercera herramienta» era una dirección mientras el orden lo ponías tú, y ahora lo pone la búsqueda. Y el esquema duplicado en prosa: si describes los parámetros en el prompt y también en la definición, hay dos versiones y la que llega es la definición.
Lo que se escribe en su lugar es la política: cuándo buscar, con qué palabras, qué hacer si no hay nada y cuándo parar.
text
Herramientas: el catálogo se consulta en tiempo de ejecución y no va en
este prompt.
1. Busca con el verbo y el objeto de la petición —"buscar pedido",
"reembolsar pedido"—, no con la frase entera del usuario.
2. Usa la herramienta que devuelva la búsqueda. No adaptes una parecida
para que encaje.
3. Si la búsqueda no devuelve nada que sirva, di qué falta y para. No
encadenes la más próxima.
4. Antes del resultado, una línea: qué herramienta usaste y por qué.
Y una regla que sobrevive a los dos regímenes: prohíbe inventar herramientas, no usar una que no esté en la lista. La lista ya no es la fuente de verdad; el catálogo sí.
Qué dejas de hacer
- Pegar el catálogo en el bloque de sistema. Es lo que tool search existe para quitar, y con él se va el coste fijo de cada llamada.
- Duplicar el esquema en prosa. Cuando el prompt y la definición se contradicen, gana la definición.
- Referirte a herramientas por posición. «La tercera» solo funcionaba mientras el orden era tuyo.
- Medir el prompt como si las definiciones fueran parte de él. Con el catálogo fuera, el presupuesto se cuenta sobre lo que queda.
- Dar por hecho que toda la familia lo trae.
gpt-5.4-nanono tiene tool search: si su prompt cuenta con él, el catálogo vuelve a entrar por la puerta de atrás.
Resumen
OpenAI lo presentó como una forma de gastar menos tokens, conservar la caché y responder antes, y las tres cosas salen del mismo movimiento: las definiciones salen de la petición. Lo que no cambia es que la descripción sigue decidiendo la elección, así que el trabajo se muda de enumerar a describir. Y no todos los modelos de la familia lo traen: el más pequeño se queda sin búsqueda.
Artículos relacionados
¿Listo para crear mejores prompts?
SystemPrompt Master aplica el método de estas guías para escribir el prompt del modelo que elijas y guarda cada versión.