Werkzeuge für Agenten definieren: Namen, Beschreibungen, Parameter

Ein Agent sieht von deinen Funktionen nur, was du über sie schreibst: Name, Beschreibung, Parameter. Sind diese Angaben vage, wählt er das falsche Werkzeug, füllt Felder mit geratenen Werten oder ruft gar keins auf. Das ist eine häufige und gut behebbare Fehlerquelle.

Dieser Leitfaden zeigt den Aufbau einer Werkzeugdefinition in fünf Teilen, 15 Regeln und 12 Vergleiche von schwachen und guten Definitionen. Feldnamen und Empfehlungen wurden gegen die Dokumentation der Claude-API geprüft; die Regeln gelten auch für andere Schnittstellen mit Funktionsaufrufen.

Zum Prüfen gibt es eine Prüfliste mit 14 Fragen, ein kleines Prüfskript und ein Testverfahren in sechs Schritten, mit dem du misst, ob das richtige Werkzeug gewählt wird. Alle Skripte und Tests wurden in Python ausgeführt. Eine Vorlage für Fehlermeldungen hilft dem Agenten, sich selbst zu korrigieren.

Für wen? Für Entwicklerinnen und Entwickler, die Agenten mit eigenen Funktionen ausstatten und Grundkenntnisse in Python und JSON haben.

Wichtig: Das Testskript nutzt eine Attrappe statt eines echten Modells; es zeigt das Verfahren, nicht das Verhalten eines bestimmten Modells. Gute Beschreibungen ersetzen keine Freigabe und keine Rechtebegrenzung im Code. Unabhängiger Leitfaden, kein Produkt von Anthropic und nicht mit Anthropic verbunden. Stand: Oktober 2026. Funktionen, Befehle und Preise ändern sich – prüfe die offizielle Dokumentation. Mit KI-Unterstützung erstellt.