Tool-Schemas (Tools & JSON Schema)

1. Überblick über das Konzept und den Zweck

Stellen Sie sich vor, Sie haben einen neuen Assistenten ins Büro geholt und ihm gesagt: „Hier ist unsere spezielle Software, benutze sie.“ Aber Sie haben nicht erklärt, welche Buttons was tun oder welche Felder ausgefüllt werden müssen. Selbstverständlich wird der Assistent verwirrt sein.

Damit ein Sprachmodell weiß, über welche digitalen Werkzeuge es verfügt, übergeben Entwickler ihm ein Tool Schema.

Dies ist eine kompakte Beschreibung, die nach dem Standard JSON Schema erstellt wird:

• Name: Ein kurzer Name des „Buttons“ (z. B. book_hotel).
• Description: Eine Erklärung in menschlicher Sprache, wofür diese Aktion dient.
• Parameters: Welche Daten für die Ausführung erforderlich sind (Stadt, Check-in-Datum, Anzahl der Gäste).

Mentales Modell: Eine Stellenbeschreibung für KI: eine Werkzeugliste am Gürtel eines Handwerkers mit klaren Anweisungen, wann man den Hammer und wann man den Schraubenzieher verwendet.

2. So sieht ein reales Tool Schema aus

{
  "name": "calculate_mortgage",
  "description": "Розраховує щомісячний платіж за іпотечним кредитом.",
  "parameters": {
    "type": "object",
    "properties": {
      "loan_amount": {
        "type": "number",
        "description": "Повна сума кредиту в гривнях, наприклад 1500000"
      },
      "years": {
        "type": "integer",
        "description": "Термін кредиту в роках від 1 до 30"
      },
      "interest_rate": {
        "type": "number",
        "description": "Річна відсоткова ставка у відсотках, наприклад 7.5"
      }
    },
    "required": ["loan_amount", "years"]
  }
}

3. Vier goldene Regeln für die Erstellung guter Schemas

1. Schreiben Sie Beschreibungen so, als würden Sie sie einem Praktikanten erklären: Geben Sie nicht nur an, was das Tool tut, sondern auch wann es NICHT aufgerufen werden sollte.
2. Fügen Sie Beispiele im Description-Feld hinzu: „Datumsformat strikt YYYY-MM-DD, z. B. 2026-05-18“.
3. Begrenzen Sie Optionen mit enum: Wenn der Bestellstatus nur drei Werte annehmen kann, definieren Sie dies streng: ["pending", "shipped", "delivered"].
4. Markieren Sie Pflichtfelder im Array required: Wenn eine Funktion ohne die E-Mail-Adresse des Kunden nicht arbeiten kann, erlauben Sie dem Modell nicht, sie blind auszuführen.

4. Praktische Schlussfolgerung

Die Qualität und Autonomie Ihres AI-Agents hängt zu 80 % nicht von der Größe des Modells ab, sondern von der Qualität und Klarheit der Beschreibungen in Ihren Tool Schemas. Je präziser die Beschreibung, desto seltener macht der Agent Fehler.