Welche Stelle das Werkzeug ersetzt
Das Werkzeug replace_in_file sucht nach dem exakten Textabschnitt in old und ersetzt ihn durch new. Es arbeitet mit Textsuche; eine Zeilennummer wird nicht übergeben. Der Abschnitt kann ein Teil einer Zeile sein oder mehrere Zeilen umfassen. Im gezeigten Quelltext kommt return str(amount) genau einmal vor.
Bei mehreren Treffern bricht das Werkzeug mit einem Fehler ab und lässt die Datei unverändert. Dasselbe gilt, wenn der gesuchte Text gar nicht mehr vorkommt. Steht dieselbe return-Zeile in zwei Funktionen, kann der Agent einen längeren Ausschnitt angeben, etwa vom passenden Funktionsnamen bis zur betroffenen Zeile. Das Werkzeug muss dafür keine Funktionsnamen verstehen; es vergleicht Text.
Bei genau einem Treffer schreibt es die geänderte Datei und liest sie zur Kontrolle erneut. replacements: 1 und written: true bestätigen diesen Schreibvorgang. Ob die Änderung fachlich richtig ist, zeigt erst der Test. Ein bloßer Änderungsvorschlag im Chat hätte keine Datei verändert.
replace_in_file, old und new sind Namen unseres Beispielwerkzeugs. Das Verfahren gibt es auch in echten Coding-Agenten: Claude Codes Edit verwendet dafür old_string und new_string und verlangt bei einer einzelnen Ersetzung ebenfalls einen eindeutigen Treffer. Andere Werkzeuge verwenden einen Patch mit altem, neuem und umgebendem Code oder einen Textbereich mit Start- und Endposition. 3 Wenn deine Entwicklungs-KI also gelegentlich meldet, eine Änderung