Tools

apply_patch-Tool

Wenden Sie Dateiänderungen mithilfe eines strukturierten Patch-Formats an. Dies eignet sich ideal für Änderungen an mehreren Dateien oder mehreren Blöcken, bei denen ein einzelner edit-Aufruf fehleranfällig wäre.

Das Tool akzeptiert eine einzelne input-Zeichenfolge, die einen oder mehrere Dateivorgänge umfasst:

text
*** Begin Patch*** Add File: path/to/file.txt+Zeile 1+Zeile 2*** Update File: src/app.ts@@ optionaler Änderungskontext-alte Zeile+neue Zeile*** Delete File: obsolete.txt*** End Patch

Parameter

  • input (erforderlich): Vollständiger Patch-Inhalt einschließlich *** Begin Patch und *** End Patch.

Hinweise

  • Patch-Pfade unterstützen relative Pfade (ausgehend vom Workspace-Verzeichnis) und absolute Pfade.
  • tools.exec.applyPatch.workspaceOnly ist standardmäßig auf true gesetzt (auf den Workspace beschränkt). Setzen Sie den Wert nur dann auf false, wenn apply_patch absichtlich außerhalb des Workspace-Verzeichnisses schreiben oder Dateien löschen soll.
  • Verwenden Sie *** Move to: innerhalb eines *** Update File:-Blocks, um Dateien umzubenennen.
  • *** End of File kennzeichnet bei Bedarf eine Einfügung ausschließlich am Dateiende.
  • Standardmäßig für jedes Modell aktiviert. Legen Sie tools.exec.applyPatch.enabled: false fest, um das Tool zu deaktivieren, oder beschränken Sie es mit tools.exec.applyPatch.allowModels auf bestimmte Modelle (akzeptiert reine IDs wie gpt-5.4 oder vollständige IDs wie openai/gpt-5.4).
  • Die Konfiguration befindet sich unter tools.exec.applyPatch.*.

Beispiel

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

Verwandte Themen

Was this useful?
On this page

On this page