Werkzeuge für LLM-Agenten entwerfen

Ein Werkzeug ist ein Handbuch für ein Modell

Ein Werkzeug für einen Agenten zu entwerfen heißt, Namen, Beschreibung, Parameter und Fehler so zu schreiben, dass ein Modell es richtig nutzt. Diese Wörter sind das einzige Handbuch des Modells.

Ein Werkzeug namens machen mit fünf losen Optionen wird erraten. Ein Werkzeug namens datei_lesen mit einem Pfad wird gut genutzt.

Am Ende dieser Lektion

Notiz

Ich kann ein Werkzeug schreiben, das ein Modell richtig nutzt, mit klarem Namen, genannter Grenze und hilfreichem Fehler.

Schlüsselwörter

Begriff	Was er bedeutet
Werkzeug	eine Funktion, die der Agent vom Harness ausführen lassen darf
Beschreibung	die Wörter, die dem Modell sagen, wann ein Werkzeug zu nutzen ist
Schmales Werkzeug	ein Werkzeug mit genau einer Aufgabe
Parameter	eine benannte Eingabe eines Werkzeugs
Mehrdeutigkeit	zwei Werkzeuge, die für eine Aufgabe passend wirken
Werkzeugfehler	der Text, den ein Werkzeug bei einem Fehlschlag zurückgibt

Die Zellen, die Lernende ausfüllen, bleiben in dieser Vorschau leer.

Schmale Werkzeuge schlagen breite

Ein schmales Werkzeug hat eine Aufgabe und wenige Parameter. Ein breites Werkzeug wie alles_ausfuehren(optionen) zwingt das Modell, eine Mini-Sprache zu erfinden, und es irrt oft.

Geben Sie jeder Aufgabe ihr Werkzeug: datei_lesen, datei_schreiben, dateien_auflisten. Bleiben Sie bei vier Parametern oder weniger. Ein Werkzeug, das mehr braucht, sind meist zwei Werkzeuge.

Namen und Beschreibungen sagen, wann nicht

Ein Name ist ein Verb und ein Substantiv: text_suchen, nicht helfer. Eine Beschreibung sagt, was das Werkzeug tut, und auch, wann man es nicht nutzt.

Dieser zweite Satz trennt zwei Werkzeuge, die sich ähneln. Ohne ihn wählt das Modell zufällig zwischen datei_lesen und text_suchen, und Sie merken es erst im Protokoll des Laufs.

Mängel, auf die man prüft

Mangel	So sieht er aus	Behebung
Vager Name	`machen`, `helfer`	Ein Verb und ein Substantiv
Kurze Beschreibung	`Macht Dinge`	Sagen, was es liest oder ändert
Keine Grenze	Kein «nicht verwenden»	Hinzufügen, wofür es nicht gedacht ist
Zu viele Parameter	Fünf oder mehr	In Werkzeuge aufteilen

Die Zellen, die Lernende ausfüllen, bleiben in dieser Vorschau leer.

Fehler für das Modell schreiben

Ein Werkzeugfehler ist die nächste Eingabe, die das Modell liest. Schreiben Sie ihn also für das Modell: was schiefging, dann was als Nächstes zu tun ist.

Fehler: keine Datei unter src/app.pyy. Rufen Sie dateien_auflisten auf und versuchen Sie es erneut. sagt dem Modell, wie es sich erholt. Ein nacktes ENOENT tut das nicht. Sagen Sie bei einer Verweigerung, dass es nicht erneut versuchen soll, sonst versucht es endlos.

Ein häufiger Fehler

Warnung

Viele schreiben die Wörter eines Werkzeugs für sich selbst und halten sie kurz. Das Modell hat nichts anderes. Schreiben Sie die Beschreibung so, als wäre sie für eine Kollegin, die den Code nie gesehen hat.