Mehrere Dateien gleichzeitig bearbeiten mit apply_patch

Kennst du das Problem? Du musst Code-Änderungen über mehrere Dateien hinweg koordinieren und ein einzelner API-Aufruf für jede Änderung fühlt sich einfach zu riskant an. Manuelle Edits sind oft fehleranfällig, besonders wenn die Struktur komplex wird.

Anstatt dich mit einzelnen, zerbrechlichen Edits herumzuschlagen, bietet ein strukturiertes Patch-Format eine deutlich bessere Lösung. Du kannst Änderungen bündeln und so sicherstellen, dass dein Code konsistent bleibt.

What You’ll Need

• Ein OpenAI Modell (inklusive OpenAI Codex).
• Zugriff auf die Konfiguration unter tools.exec.

Quick Start

Das apply_patch Tool ist standardmäßig deaktiviert. Folge diesen Schritten, um es zu nutzen:

1. Aktiviere das Tool in deiner Konfiguration über tools.exec.applyPatch.enabled.
2. Definiere bei Bedarf erlaubte Modelle über tools.exec.applyPatch.allowModels.
3. Erstelle einen input String, der zwingend mit *** Begin Patch beginnt und mit *** End Patch endet.
4. Nutze innerhalb des Patches Befehle wie *** Update File:, *** Add File: oder *** Delete File:.

Hier ist ein Beispiel für einen API-Aufruf:

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

Pfade werden immer relativ zum Root-Verzeichnis des Workspace aufgelöst. Wenn du Dateien umbenennen möchtest, kannst du *** Move to: innerhalb eines *** Update File: Blocks verwenden. Für reine Einfügungen am Ende einer Datei nutzt du *** End of File.

Troubleshooting

• Tool reagiert nicht: Das Tool ist experimentell und standardmäßig deaktiviert. Prüfe, ob tools.exec.applyPatch.enabled in deiner Konfiguration korrekt gesetzt ist.
• Modell-Fehler: Dieses Tool funktioniert ausschließlich mit OpenAI-Modellen. Falls du ein anderes Gateway oder Modell nutzt, wird der Aufruf fehlschlagen.

Du hast Fragen zur Einrichtung? Nutze den AI Setup Assistant für schnelle Hilfe.

What’s Next

• Tool Konfigurations-Guide
• API Referenz