intermedio
El 30 de noviembre cierra prompts/v1: tus prompts, al código
Respuesta rápida:
El 30 de noviembre de 2026 v1/prompts deja de existir como objeto de la API. La fecha se apunta y se olvida; lo que se queda es el cambio de sitio: el texto del prompt deja de vivir en tu cuenta y pasa a vivir en un fichero del repositorio.
Qué ha salido
OpenAI retira los objetos de prompt reutilizables de su API. La creación de prompts se desaconsejó a partir del 3 de junio de 2026 y v1/prompts se cierra el 30 de noviembre de 2026, a menos de un mes de la fecha de este post. Lo dicen la guía de prompt engineering de la compañía y su página de deprecaciones. En la misma tanda de junio cayeron la plataforma de Evals y Agent Builder.
La migración que propone OpenAI cabe en una frase, y está donde nadie la busca: "Guarda los prompts de producción en el código de tu aplicación en lugar de crear objetos de prompt reutilizables. Los prompts gestionados en código te permiten usar entradas tipadas, revisión de código, tests y tu proceso de despliegue normal para cambiar el comportamiento del modelo."
Traducido a lo que toca esta semana: el texto del prompt tiene que estar en un sitio que controles tú. A partir del 30 de noviembre, la cuenta de OpenAI deja de ser ese sitio.
Qué cambia
Un prompt deja de ser un objeto que se edita y pasa a ser un fichero que se despliega.
La razón por la que estos objetos existían es justo esa: cambiar una frase y ver el efecto sin tocar el repositorio. La ventaja se nota el mismo día. El coste llega tarde: ese cambio no pasó por revisión, no tiene test y no aparece en ningún historial que puedas leer dentro de seis meses.
Con el prompt en un fichero, cambiar una frase es un diff. Un diff se revisa, se despliega y se revierte. La diferencia no está en la herramienta: está en que por primera vez hay algo que revertir.
Lo segundo que cambia es qué significa "entradas tipadas" en la frase de OpenAI. Los huecos de un prompt dejan de ser marcadores de plantilla que nadie valida y pasan a ser argumentos de una función. Si falta un dato o llega con el tipo equivocado, el error salta antes de gastar una llamada.
Qué cambia al escribir prompts
El prompt gana un sitio en el repositorio y pierde la costumbre de la edición rápida. La primera tarea es un inventario: un prompt que se editó fuera del repositorio hay que encontrarlo antes de moverlo, y esos prompts suelen estar repartidos entre servicios, cuadernos y un cron que heredó alguien. La parte mecánica de la migración es convertirlos en ficheros con una llamada que los lee; la parte que exige pensar es decidir qué puede prometer cada uno.
Después, tres consecuencias. Primero, el prompt se escribe como se escribe el código que lo rodea: en un fichero con nombre, cerca de la función que lo usa. Un prompts/triage-incidencias.md al lado del módulo de incidencias se encuentra; un prompt pegado en un panel, no.
Segundo, necesita tests que no comprueben una cadena exacta. Un test de prompt mira propiedades: que la salida no invente un dato que no estaba en el contexto, que respete el límite de longitud, que no proponga una acción que el prompt prohíbe. Los casos se guardan como fixtures, y añadir un caso es más barato que reescribir el prompt entero.
Tercero, el historial de git pasa a ser el registro de cambios de comportamiento. La pregunta "¿por qué este asistente cambió de tono en marzo?" tiene respuesta, y está en un diff.
text
# prompts/triage-incidencias.md
Clasifica la incidencia en una de estas cuatro categorías: acceso, datos,
facturación o rendimiento. Devuelve solo la categoría y una frase de motivo.
Incidencia: [texto]
Sistema afectado: [sistema]
Si el texto no permite decidir, devuelve "sin_clasificar" y la pregunta exacta
que falta por responder. No propongas una solución.
Qué dejas de hacer
- Editar prompts en un panel. Un cambio hecho ahí no lo ha visto nadie más que tú, no se puede discutir en una revisión y no deja rastro cuando alguien pregunta por qué el asistente responde distinto.
- Tener la única copia fuera del control de versiones. Un prompt de producción cuya única copia vive en la cuenta no tiene historial, ni revisión, ni tests: tiene una fecha límite que no decides tú.
- Cambiar comportamiento sin desplegar. Si el prompt vive en el código, editarlo es un despliegue y merece el mismo trato: rama, revisión, despliegue y vuelta atrás si el resultado empeora.
- Improvisar en la consola. Probar una variante a mano está bien. Dejarla en producción porque la respuesta salió buena, no. La variante se convierte en un caso del fixture o no se queda.
Resumen
La creación de prompts en la API se desaconsejó a partir del 3 de junio de 2026 y prompts/v1 se cierra el 30 de noviembre. El cambio de fondo importa más que la fecha: un prompt deja de ser un objeto que se edita y pasa a ser un fichero que se revisa, se prueba y se despliega.
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.