Tool schemas

Studiennotizen: JSON Schema für Tool Calling

• Definition JSON Schema:
• JSON Schema ist eine Spezifikation zur Datenvalidierung.
• Es ist ein Satz von Regeln, um die Gültigkeit (Validität) von JSON-Daten zu überprüfen.
• Es ist nicht spezifisch für Sprachmodelle, wird aber von der Community für Tool Calling genutzt.

• Struktur des Schemas:
• Das gesamte Objekt enthält einen Namen und eine Beschreibung.
• Der eigentliche Spezifikationsinhalt befindet sich unter dem Schlüssel input schema.

• Best Practices für Beschreibungen:
• Tool-Beschreibung: Soll idealerweise 3 bis 4 Sätze lang sein. Sie muss erklären, was das Tool tut, wann es verwendet werden soll und welche Daten es zurückgibt.
• Argument-Beschreibung: Soll ebenfalls 3 bis 4 Sätze lang sein. Sie muss erklären, was das Argument steuert und wie es den Funktionsaufruf beeinflusst.

• Workflow zur Generierung des Schemas:
• Man kann Claude bitten, basierend auf der Tool-Funktion und der Anthropic API Dokumentation ein gültiges JSON Schema zu erstellen.

• Code-Konventionen:
• Benennung: Die Schema-Datei sollte dem Tool-Funktionsnamen folgen, z. B. [Funktionsname]_schema.
• Typ-Sicherheit: Verwende ToolParam aus anthropic. types, um spätere Typfehler zu verhindern.

Takeaways

• JSON Schema ist eine Spezifikation zur Datenvalidierung, die Regeln zur Überprüfung der Gültigkeit von JSON-Daten festlegt.
• Der eigentliche Spezifikationsinhalt eines Schemas befindet sich unter dem Schlüssel input schema.
• Beschreibungen für Tools und Argumente sollten detailliert sein (ideal 3 bis 4 Sätze), um Funktion und Einfluss klar zu definieren.
• Code-Konventionen erfordern, dass die Schema-Datei dem Funktionsnamen folgt (z. B. [Funktionsname]_schema) und ToolParam zur Gewährleistung der Typ-Sicherheit verwendet wird.