Tool schemas

Lernnotizen: JSON Schema für Tool-Funktionen

• Definition JSON Schema:
• JSON Schema ist eine Datenvalidierungs-Spezifikation.
• Es ist ein Satz von Regeln, der zur Validierung jeglicher JSON-Daten verwendet werden kann.
• Wichtig: Es ist nicht spezifisch für Sprachmodelle (LLMs), sondern eine allgemeine Technologie.

• **Zweck bei LLMs (z. B. Claude):**
• Es dient als convenzienter Mechanismus, um LLMs über verfügbare Tool-Funktionen und deren Argumente zu informieren.
• Die Konfiguration enthält einen Namen/eine Beschreibung und den Schlüssel input schema, der die eigentliche Spezifikation enthält.

• Best Practices für Beschreibungen:
• Tool-Beschreibung: Muss Claude mitteilen, was das Tool tut, wann es verwendet werden soll und welche Daten es zurückgibt. (Empfohlen: ca. 3–4 Sätze).
• Argument-Beschreibung: Muss Claude genau erklären, welche Funktion das Argument steuert und wie es den Funktionsaufruf beeinflusst. (Empfohlen: ca. 3–4 Sätze).

• Workflow zur Generierung des Schemas:
• Man kann Claude AI und die Anthropic API Dokumentation nutzen, um ein robustes JSON Schema für eine gegebene Tool-Funktion zu generieren.

• Namenskonvention:
• Es wird empfohlen, den Namen der Tool-Funktion mit dem Schema zu verknüpfen: [Funktionsname] → [Funktionsname]_schema.

• Code-Sicherheit:
• Die Verwendung von tool_param (importiert aus anthropic. types) um das gesamte Schema zu wickeln, ist nicht zwingend erforderlich, verhindert aber spätere Typfehler.

Takeaways

• JSON Schema ist eine allgemeine Datenvalidierungs-Spezifikation, die zur Definition von Tool-Funktionen für LLMs dient.
• Die Konfiguration muss den Funktionsnamen, eine Beschreibung und den Schlüssel input schema enthalten.
• Für eine korrekte Nutzung durch das LLM sind sowohl die Tool-Beschreibung als auch die Argument-Beschreibungen detailliert (ca. 3–4 Sätze) zu formulieren.
• Es wird empfohlen, eine Namenskonvention zu nutzen: [Funktionsname] → [Funktionsname]_schema.