Apply Patch OpenAI API: modifica archivos y código con GPT
Apply Patch OpenAI API permite que modelos compatibles de OpenAI creen, actualicen o eliminen archivos mediante patches estructurados y unified diffs. Dentro de Responses API, Apply Patch resulta especialmente útil para agentes de programación que necesitan editar código, corregir errores, actualizar archivos y realizar cambios iterativos sobre un proyecto.
¿Qué es Apply Patch OpenAI API?
Apply Patch OpenAI API es una herramienta de Responses API que permite al modelo proponer cambios sobre archivos utilizando un formato de patch. Puede servir para crear, modificar o eliminar archivos sin tener que devolver manualmente el contenido completo de cada fichero después de cada cambio.
Qué permite hacer Apply Patch OpenAI API
Apply Patch está diseñado para workflows donde el modelo necesita editar archivos de forma estructurada.
Crear archivos
Añadir nuevos archivos al proyecto mediante un patch.
Modificar código
Actualizar líneas concretas sin reemplazar todo el archivo.
Eliminar archivos
Proponer la eliminación de archivos que ya no se necesitan.
Corregir errores
Aplicar cambios después de analizar tests o logs.
Cambios estructurados
Utiliza diffs para representar exactamente qué cambia.
Agentes de programación
Combinar edición, shell y validación en ciclos iterativos.
Cómo funciona Apply Patch en OpenAI API
El modelo analiza el estado del proyecto, genera un patch y tu aplicación lo aplica sobre los archivos.
El modelo analiza
Examina archivos, errores o contexto del proyecto.
Genera el cambio
Produce operaciones estructuradas sobre los archivos.
Tu aplicación lo aplica
El entorno modifica los archivos y devuelve el resultado.
Apply Patch OpenAI API dentro de Responses API
Apply Patch forma parte del sistema de herramientas disponible para modelos compatibles.
Edición estructurada de archivos
La referencia actual define Apply Patch como una herramienta que permite al asistente crear, eliminar o actualizar archivos utilizando unified diffs.
En lugar de devolver un archivo completo, el modelo puede representar únicamente los cambios que deben aplicarse.
Ver Responses API →Cómo habilitar Apply Patch OpenAI API
La herramienta puede declararse dentro del array de herramientas de Responses API.
Permitir edición mediante patches
{
"model": "gpt-5.6-sol",
"tools": [
{
"type": "apply_patch"
}
],
"input": "Corrige el error del archivo app.js y aplica el cambio mínimo necesario."
}La herramienta debe formar parte de un entorno que pueda aplicar los cambios generados y devolver el resultado al modelo.
Qué es un unified diff
Un unified diff representa diferencias entre una versión anterior y una nueva versión de un archivo.
Solo se describen los cambios
Las líneas eliminadas y añadidas pueden representarse de forma compacta, lo que resulta útil cuando un archivo es grande y solo necesita unas pocas modificaciones.
Ejemplo simple de un patch
Un cambio pequeño puede representarse sin reenviar todo el archivo.
Modificar una línea
--- a/app.js
+++ b/app.js
@@ -10,7 +10,7 @@
-const timeout = 5000;
+const timeout = 10000;Crear, actualizar y eliminar archivos
Apply Patch no está limitado únicamente a modificar líneas existentes.
| Operación | Descripción |
|---|---|
| Crear | Añadir un archivo nuevo al proyecto |
| Actualizar | Modificar contenido existente mediante un diff |
| Eliminar | Retirar un archivo que ya no debe existir |
Apply Patch dentro de un workflow iterativo
La herramienta resulta especialmente útil cuando un agente revisa, modifica y valida código varias veces.
El agente inspecciona el proyecto.
Identifica el archivo que necesita cambios.
Genera un patch.
El entorno aplica el cambio.
Hosted Shell puede ejecutar los tests.
Si fallan, el modelo analiza el error y genera otro patch.
Forzar Apply Patch en Responses API
OpenAI dispone
de un tipo
de tool_choice
específico
para Apply Patch.
Forzar edición mediante patch
{
"tool_choice": {
"type": "apply_patch"
}
}En selección automática, el modelo puede decidir si necesita modificar archivos o responder sin realizar cambios.
Apply Patch y Hosted Shell
Estas dos herramientas forman una combinación especialmente útil para agentes de programación.
Inspeccionar y probar
Ejecuta comandos, tests y herramientas del proyecto.
Modificar
Crea, actualiza o elimina archivos.
Analizar → modificar → probar → revisar → volver a modificar.
Ver Hosted Shell →Apply Patch vs editar archivos mediante shell
Es posible modificar archivos mediante comandos de shell, pero Apply Patch está especializado en representar cambios.
| Aspecto | Apply Patch | Shell |
|---|---|---|
| Objetivo | Modificar archivos | Ejecutar comandos generales |
| Formato | Diff estructurado | Comando |
| Legibilidad | Alta para cambios | Depende del comando |
| Uso típico | Edición de código | Tests, tooling y sistema |
Apply Patch vs Function Calling
Function Calling y Apply Patch resuelven necesidades muy diferentes.
| Aspecto | Apply Patch | Function Calling |
|---|---|---|
| Objetivo | Editar archivos | Ejecutar lógica externa |
| Salida | Patch | Argumentos de función |
| Backend | Entorno aplica el patch | Tu aplicación ejecuta la función |
| Uso típico | Código y archivos | Procesos de negocio |
Un agente puede modificar código con Apply Patch y utilizar funciones para interactuar con sistemas externos.
Ver Function Calling →Casos de uso de Apply Patch OpenAI API
Apply Patch encaja especialmente bien en tareas de ingeniería de software y mantenimiento de proyectos.
Bug fixing: corregir errores en archivos existentes.
Refactoring: modificar partes concretas sin reemplazar todo el archivo.
Features: añadir archivos o código nuevo.
Tests: corregir código después de detectar pruebas fallidas.
Configuración: actualizar archivos de configuración.
Agentes de coding: realizar iteraciones autónomas sobre un repositorio.
Modelos OpenAI compatibles con Apply Patch
La compatibilidad depende del modelo, por lo que conviene comprobar la ficha oficial antes de implementar.
| Modelo | Apply Patch | Orientación |
|---|---|---|
| GPT-5.6 Sol | Compatible | Programación y trabajo profesional complejo |
| GPT-5.6 Terra | Compatible | Equilibrio entre capacidad y costo |
| GPT-5.6 Luna | Compatible | Alto volumen y menor costo |
| GPT-5.6 Cyber | Compatible | Workflows técnicos y de seguridad |
OpenAI publica Hosted Shell, Apply Patch, Code Interpreter y Tool Search entre sus herramientas compatibles.
Ver GPT-5.6 Sol →Buenas prácticas con Apply Patch OpenAI API
Modificar archivos puede afectar directamente el comportamiento de una aplicación.
Trabaja sobre repositorios o entornos controlados.
Revisa los diffs antes de cambios sensibles.
Ejecuta tests después de aplicar modificaciones.
No expongas secretos dentro del código.
Mantén control de versiones.
Limita los archivos que el agente puede modificar.
Apply Patch funciona mejor con control de versiones
Utilizar Git u otro sistema de versionado facilita revisar y revertir cambios.
Los cambios deben ser auditables
Un workflow de coding con IA debería permitir revisar exactamente qué archivos cambiaron, por qué y cómo volver a una versión anterior.
Prefiere cambios mínimos y focalizados
Un patch pequeño suele ser más fácil de revisar, probar y revertir que una modificación excesivamente amplia.
Modifica solo lo necesario
Cuando solucionas un error concreto, pedir al modelo el cambio mínimo puede reducir regresiones accidentales en otras partes del proyecto.
Valida siempre después de aplicar el patch
El hecho de que un patch se aplique correctamente no significa que el software funcione correctamente.
Comprueba que el patch se aplicó.
Ejecuta linting cuando corresponda.
Ejecuta tests.
Revisa errores de compilación.
Verifica el comportamiento esperado.
Costos de Apply Patch OpenAI API
El costo de un workflow depende principalmente del modelo, contexto y herramientas que intervienen.
Un cambio puede requerir varias iteraciones
Analizar código, generar un patch, ejecutar tests y volver a corregir puede requerir varias respuestas del modelo.
Para agentes de programación, una métrica útil es el costo total de completar una corrección o feature.
Ver precios OpenAI API →Apply Patch y los límites de OpenAI API
Los workflows de programación también consumen solicitudes y tokens del modelo seleccionado.
Los ciclos iterativos pueden aumentar el consumo
Una sola tarea puede necesitar múltiples rondas de análisis, edición y validación.
Ver límites OpenAI API →Documentación oficial de Apply Patch OpenAI API
Apply Patch forma parte del ecosistema de herramientas de Responses API, que continúa evolucionando.
Apply Patch Tool
Consulta la definición actual de la herramienta, tool choice y modelos compatibles.
Consultar documentación oficial →Guías relacionadas con Apply Patch OpenAI API
Continúa explorando herramientas para programación, agentes y Responses API.
FAQ sobre Apply Patch OpenAI API
Respuestas sobre patches, unified diffs, modelos, seguridad y Responses API.
Apply Patch OpenAI API permite que modelos compatibles creen, actualicen o eliminen archivos mediante patches estructurados.
Sí. OpenAI incluye Apply Patch entre las herramientas disponibles para determinados modelos mediante Responses API.
Es un formato que representa las diferencias entre versiones de un archivo, indicando líneas añadidas y eliminadas.
Sí. La herramienta está diseñada para crear, actualizar y eliminar archivos.
Sí. Responses API dispone de un tipo de tool choice específico para Apply Patch.
Sí. OpenAI publica Apply Patch entre las herramientas compatibles de GPT-5.6 Sol.
Sí. OpenAI publica Apply Patch entre las herramientas compatibles de GPT-5.6 Terra y GPT-5.6 Luna.
No. Apply Patch está especializado en modificar archivos, mientras Hosted Shell ejecuta comandos generales de terminal.
Sí, especialmente cuando los cambios afectan código crítico, configuración, seguridad o datos importantes.
Sí. Puede combinarse con herramientas como Hosted Shell para modificar código, ejecutar tests y repetir el proceso hasta resolver una tarea.
Continúa con Tool Search en OpenAI API
Ya sabes cómo GPT puede modificar archivos mediante Apply Patch. El siguiente paso es aprender cómo un modelo puede buscar dinámicamente la herramienta adecuada dentro de catálogos grandes.
Ver Tool Search →