apply_patch herramienta

Aplique cambios en archivos utilizando un formato de parche estructurado. Esto es ideal para ediciones de varios archivos o de varios fragmentos donde una sola llamada edit sería frágil.

La herramienta acepta una sola cadena input que envuelve una o más operaciones de archivo:

*** Begin Patch
*** Add File: path/to/file.txt
+line 1
+line 2
*** Update File: src/app.ts
@@
-old line
+new line
*** Delete File: obsolete.txt
*** End Patch

Parámetros

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

Notas

• Las rutas de parche soportan rutas relativas (desde el directorio del espacio de trabajo) y rutas absolutas.
• tools.exec.applyPatch.workspaceOnly se predetermina en true (contenido en el espacio de trabajo). Establézcalo en false solo si intencionalmente desea que apply_patch escriba/elimine fuera del directorio del espacio de trabajo.
• Use *** Move to: dentro de un fragmento *** Update File: para cambiar el nombre de los archivos.
• *** End of File marca una inserción solo de EOF cuando sea necesario.
• Disponible de forma predeterminada para los modelos OpenAI y OpenAI Codex. Establezca tools.exec.applyPatch.enabled: false para desactivarlo.
• Opcionalmente restringir por modelo mediante tools.exec.applyPatch.allowModels.
• La configuración solo está bajo tools.exec.

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

Diffs

Visor de diferencias de solo lectura para la presentación de cambios.

Exec tool

Ejecución de comandos de shell desde el agente.

Code execution

Análisis remoto de Python en espacio aislado con xAI.