herramienta apply_patch

Aplica cambios en archivos mediante un formato de parche estructurado. Es ideal para ediciones en varios archivos o con varios bloques, en las que una sola llamada a edit sería frágil.

La herramienta acepta una única cadena input que engloba una o más operaciones de archivo:

*** Begin Patch*** Add File: path/to/file.txt+línea 1+línea 2*** Update File: src/app.ts@@ contexto de cambio opcional-línea anterior+línea nueva*** Delete File: obsolete.txt*** End Patch

Parámetros

• input (obligatorio): contenido completo del parche, incluidos *** Begin Patch y *** End Patch.

Notas

• Las rutas del parche admiten rutas relativas (desde el directorio del espacio de trabajo) y rutas absolutas.
• tools.exec.applyPatch.workspaceOnly usa true de forma predeterminada (limitado al espacio de trabajo). Establécelo en false solo si se desea intencionadamente que apply_patch escriba o elimine fuera del directorio del espacio de trabajo.
• Usa *** Move to: dentro de un bloque *** Update File: para cambiar el nombre de archivos.
• *** End of File marca una inserción exclusiva al final del archivo cuando es necesario.
• Está habilitada de forma predeterminada para todos los modelos. Establece tools.exec.applyPatch.enabled: false para deshabilitarla o restríngela a modelos específicos con tools.exec.applyPatch.allowModels (acepta identificadores simples como gpt-5.4 o identificadores completos como openai/gpt-5.4).
• La configuración se encuentra en tools.exec.applyPatch.*.

Ejemplo

{  "tool": "apply_patch",  "input": "*** Begin Patch\n*** Update File: src/index.ts\n@@\n-const foo = 1\n+const foo = 2\n*** End Patch"}

Relacionado