Startseite > Lexikon > KI im Marketing > JSON Schema

Bleistiftskizze: Hand steckt Würfel in Steckbrett, zwei orange runde Klötze passen in ihre Löcher, daneben formlose Klumpen, als Bild für JSON Schema
KI im Marketing

JSON Schema

Der Bauplan, der festlegt, wie Daten im JSON-Format aussehen müssen. In der KI sorgt er dafür, dass ein Sprachmodell nicht plaudert, sondern Felder liefert, mit denen dein Workflow weiterarbeiten kann.

Auch bekannt alsJSON-Schema

7 Min

Lesezeit

21.11.2026

Letzte Aktualisierung

Was ist JSON Schema?

Stell dir vor, du lässt eine KI jede Kontaktanfrage auswerten. Mal kommt „Name: Meier“, mal „Herr Meier aus Kiel“, mal ein ganzer Absatz. Dein CRM kann damit nix anfangen. JSON Schema löst genau dieses Problem.

JSON ist ein Textformat für Daten: Felder mit Namen und Werten, etwa "name": "Meier". JSON Schema ist der Bauplan dazu. Laut json-schema.org ist es eine deklarative Sprache, die Aufbau und Regeln für JSON-Daten festlegt. Ein Schema sagt:

  • Welche Felder es gibt, etwa name, email und interesse
  • Welchen Typ sie haben: Text, Zahl, Ja/Nein, Liste
  • Welche Pflicht sind und welche fehlen dürfen
  • Welche Werte erlaubt sind, etwa nur „Website“, „SEO“ oder „Ads“

Ob Daten zum Bauplan passen, prüft ein Validator, also ein Programm, das die Regeln anwendet. Die aktuelle Fassung heißt 2020-12. Der Name führt in die Irre: Die gültige Ausgabe erschien im Juni 2022. Die ersten Ideen stammen von 2007.

Warum JSON Schema für KI so wichtig ist

Ein Sprachmodell schreibt von Haus aus Text. Für Automationen brauchst du aber Felder, die das nächste Programm sicher lesen kann. Dafür gibst du dem Modell das Schema mit.

Die großen Anbieter setzen das Schema dabei technisch durch. OpenAI nennt das Structured Outputs: Das Schema wird in eine Grammatik übersetzt, und das Modell darf nur noch Zeichen erzeugen, die dazu passen. Im eigenen Test von 2024 hielt sich GPT-4o damit zu 100 % an komplexe Schemas. Das ältere GPT-4 kam ohne diese Technik auf unter 40 %.

Auch Claude von Anthropic und Gemini von Google arbeiten mit JSON Schema. Bei Claude beschreibt das input_schema jedes Werkzeugs die Parameter, beim Function Calling ist es genauso. Das Model Context Protocol nutzt Schemas für Ein- und Ausgaben von Tools. Und in n8n steckt es im Baustein „Structured Output Parser“.

So sieht ein Schema aus

Ein kleines Schema für Kontaktanfragen. Lies es von oben nach unten: ein Objekt mit vier Feldern, alle Pflicht, keine weiteren erlaubt.

Feld

Regel

name

Text

email

Text im E-Mail-Format

interesse

nur Website, SEO oder Ads

termin

Ja oder Nein

Im Schema selbst heißt das "type": "object", darunter die properties, die Liste required und "additionalProperties": false. Die Claude-Dokumentation nutzt fast genau dieses Beispiel: Aus einer Mail werden Name, E-Mail, gewünschter Tarif und Demo-Wunsch gezogen.

Beispiele aus dem Marketing

Anfragen direkt ins CRM

Das Kontaktformular landet in n8n, ein Sprachmodell liest die Nachricht und füllt das Schema von oben. Weil jedes Feld sicher da ist, kann der nächste Schritt den Kontakt ohne Handarbeit in HubSpot anlegen. Fehlt der Bauplan, bricht der Workflow beim ersten kreativen Kunden.

Themen bewerten lassen

Ein KI-Agent bewertet Blog-Themen und soll je Thema thema, score als Zahl und begruendung liefern. Der Structured Output Parser in n8n erzwingt diese Felder. Erst dann schreibt der Workflow die Zeile ins Google Sheet. Wichtig: Erzeugst du das Schema in n8n aus einem Beispiel, macht n8n jedes Feld zum Pflichtfeld.

Häufige Fehler

Fehler 1 · „Antworte als JSON“ in den Prompt schreiben

Das bringt dir meistens gültiges JSON, aber nicht die richtigen Felder. Auch der reine JSON-Modus prüft nur die Syntax. Laut OpenAI sichern erst Structured Outputs, dass die Antwort zum Schema passt.

Fehler 2 · Annehmen, jeder Anbieter kann alles

Die Unterstützung ist uneinheitlich. Claude lehnt im strikten Modus etwa Mindest- und Höchstwerte mit einem Fehler ab. Gemini ignoriert manche Regeln wie Mindestlängen still. n8n kann keine Verweise per $ref. Was das Modell nicht erzwingt, prüfst du im nächsten Schritt selbst.

Fehler 3 · Beschreibungen weglassen

Ein Feld namens score sagt dem Modell wenig. Anthropic nennt gute Beschreibungen den mit Abstand wichtigsten Faktor für saubere Tool-Nutzung und empfiehlt drei bis vier Sätze je Werkzeug. Schreib dazu, was 1 und was 10 bedeutet.

Fehler 4 · Das Schema zu groß bauen

Es gibt Grenzen. Bei OpenAI sind es höchstens 5.000 Eigenschaften und 10 Ebenen Verschachtelung je Schema, Gemini lehnt sehr tiefe Schemas ganz ab. Lieber mehrere kleine Schritte als ein Monster-Schema.

So fängst du an

  • Erst die Felder aufschreiben, die der nächste Schritt wirklich braucht — nicht alles, was die KI wissen könnte.
  • Erlaubte Werte festlegen, wo es geht. Eine feste Auswahl schlägt freien Text.
  • Beschreibung an jedes Feld, in normalen Sätzen.
  • Strikten Modus einschalten, wenn dein Anbieter ihn hat.
  • Inhalt trotzdem prüfen: Plausibilitäts-Check oder Freigabe durch einen Menschen, bevor etwas Wichtiges passiert.

Häufige Fragen

Was ist der Unterschied zwischen JSON Schema und Schema.org?

JSON Schema beschreibt, wie Daten für Programme aufgebaut sein müssen. Schema.org ist ein Vokabular, mit dem du Suchmaschinen erklärst, was auf deiner Seite steht, etwa ein Produkt oder eine FAQ. Beide sehen aus wie JSON, haben aber verschiedene Aufgaben.

Brauche ich JSON Schema für SEO?

Nein. Für Rich Results und Strukturierte Daten nutzt Google fast immer das Schema.org-Vokabular, empfohlen als JSON-LD. JSON Schema brauchst du, wenn du KI-Antworten oder API-Daten in eine feste Form bringen willst.

Garantiert ein JSON Schema, dass die KI-Antwort stimmt?

Nein. Es garantiert nur die Form, also Felder und Typen. Ob der Inhalt stimmt, musst du weiter prüfen. Auch die Form kann brechen, wenn das Modell ablehnt oder die Antwort am Längenlimit abbricht.

Welche Version von JSON Schema ist aktuell?

Die Fassung 2020-12. Ältere Stände heißen draft-04, draft-06 und draft-07 und tauchen in vielen Tools noch auf. Für neue Projekte empfiehlt json-schema.org die aktuelle Version.

Wie nutze ich JSON Schema in n8n?

Über den Baustein „Structured Output Parser“ am KI-Agenten. Du kannst ein JSON-Beispiel einfügen, aus dem n8n das Schema erzeugt, oder das Schema selbst schreiben. Verweise per $ref unterstützt der Baustein nicht.

Begriff teilenHat dir die Definition geholfen? Schick sie weiter.