Wie beschreibe ich eine gewünschte JSON-Ausgabe?

Das Problem

Ihre Anwendung, Ihr Automatisierungswerkzeug oder Ihr Skript soll die Antwort einer KI weiterverarbeiten, etwa um Kundenanfragen in Felder zu zerlegen. Dafür braucht es feste Datenfelder. Doch die KI antwortet in freiem Text, einmal mit Einleitung, einmal mit anderen Feldnamen, einmal mit einer Erklärung nach dem Datenblock. Das Programm kann damit nichts anfangen.

Die Lösung ist ein Datenformat, das beide Seiten verstehen: JSON. Es ist ein einfaches Textformat, in dem Daten als Paare aus Name und Wert notiert sind. Mehr dazu im Eintrag JSON. Sie müssen der KI nur genau sagen, wie das JSON aussehen soll.

Diese Seite zeigt, welche Angaben in einen solchen Prompt gehören, damit die Ausgabe zuverlässig brauchbar wird. Eine Garantie für fehlerfreie Ausgabe gibt es nicht, deshalb gehört eine Prüfung dazu.

So lösen Sie es mit KI – Schritt für Schritt

1. Felder festlegen. Überlegen Sie, welche Angaben Ihre Anwendung braucht, zum Beispiel «thema», «dringlichkeit», «kundennummer», «zusammenfassung».

1. Feldnamen einheitlich wählen. Verwenden Sie kleingeschriebene Namen ohne Leerzeichen und Umlaute, etwa «kundennummer». So gibt es weniger Probleme in Programmen.

1. Datentypen bestimmen. Legen Sie fest, ob ein Feld Text, Zahl, Ja/Nein (true/false) oder eine Liste ist. Beispiele: «dringlichkeit» als Zahl von 1 bis 3, «bezahlt» als true/false.

1. Erlaubte Werte nennen. Wenn nur bestimmte Werte erlaubt sind, listen Sie sie auf, zum Beispiel «thema» ist eines von «Rechnung», «Lieferung», «Reklamation», «Sonstiges».

1. Fehlende Angaben regeln. Sagen Sie, was bei unbekannten Werten gelten soll: Feld mit «null» ausgeben, nichts erfinden.

1. Beispiel mitgeben. Zeigen Sie ein kurzes Beispiel des gewünschten JSON. Das ist die wirksamste Anweisung.

1. Nur JSON verlangen. Schreiben Sie: «Gib ausschliesslich das JSON aus, ohne Erklärung und ohne Markdown-Zeichen.»

1. Maschinell prüfen. Lassen Sie Ihre Anwendung prüfen, ob die Antwort gültiges JSON ist und die Felder stimmen. Bei Fehler fordern Sie eine neue Antwort an. Siehe JSON-Schema prüfen.

1. Stichproben kontrollieren. Prüfen Sie von Hand, ob die Inhalte stimmen, nicht nur das Format.

Vorlage zum Kopieren

Mit diesem Prompt lassen Sie Texte in festen Feldern auswerten:

Lies den folgenden Text und gib die Angaben als JSON aus.
Gewünschte Felder:
- "thema": Text, einer von ["Rechnung", "Lieferung", "Reklamation", "Sonstiges"]
- "dringlichkeit": Zahl von 1 (niedrig) bis 3 (hoch)
- "kundennummer": Text oder null, wenn nicht genannt
- "zusammenfassung": Text, höchstens 20 Wörter
- "rueckruf_gewuenscht": true oder false
Regeln: Erfinde keine Angaben. Wenn etwas nicht im Text steht, verwende null.
Gib ausschliesslich das JSON aus, ohne Einleitung, Erklärung oder Markdown.
Beispiel einer gültigen Ausgabe:
{"thema": "Lieferung", "dringlichkeit": 2, "kundennummer": null, "zusammenfassung": "Paket nicht angekommen", "rueckruf_gewuenscht": false}
Text: [Text einfügen]

Passen Sie Felder und Werte an Ihre Anwendung an. Verwenden Sie für erste Tests erfundene Beispieltexte.

Worauf Sie achten müssen

• Gültigkeit nicht garantiert: Auch bei klaren Vorgaben kann die KI ungültiges JSON liefern, etwa mit fehlenden Klammern. Prüfen Sie jede Antwort maschinell.
• Erfundene Werte: Die KI kann Felder füllen, obwohl die Angabe fehlt. Verlangen Sie «null» und prüfen Sie Stichproben.
• Datentypen: Zahlen als Text oder umgekehrt führen in Programmen zu Fehlern. Kontrollieren Sie Typen.
• Feste Schnittstelle: Manche Anbieter bieten eine Funktion für strukturierte Ausgabe an, bei der das Format technisch erzwungen wird. Prüfen Sie, ob Ihr Werkzeug das kann.
• Datenschutz: Wenn der Text Personendaten enthält, gelten die Datenschutzregeln für KI-Dienste. Anonymisieren Sie wenn möglich.
• Änderungen im Modell: Nach einem Modellwechsel kann sich das Verhalten ändern. Testen Sie erneut.
• Weitere Formate: Für Tabellen kann CSV einfacher sein, siehe CSV-Ausgabe anfordern.

Ein Beispiel aus der Praxis

Ein Beispiel: Ein Online-Händler in Winterthur möchte eingehende Kundenmails automatisch nach Thema und Dringlichkeit sortieren. Sein Ticketsystem verlangt feste Felder.

Vorher: Die KI antwortet in Fliesstext, und die Mitarbeiterin muss jede Antwort von Hand übertragen. Nachher: Der Entwickler des Händlers gibt der KI das Muster mit fünf Feldern und einem Beispiel und verlangt nur das JSON. Sein Programm prüft jede Antwort auf Gültigkeit und erlaubte Werte. Ungültige Antworten werden automatisch neu angefordert. Eine Mitarbeiterin kontrolliert täglich zehn Stichproben, und bei Unsicherheit entscheidet ein Mensch.

Wenn Ihre Anwendung langfristig laufen soll, lohnt es sich, das gewünschte Format in einem kurzen Dokument festzuhalten: Feldnamen, Typen, erlaubte Werte, Beispiele und was bei Fehlern geschieht. Dieses Dokument dient als Vertrag zwischen KI-Prompt und Programm. Wenn später jemand den Prompt ändert oder das Modell wechselt, kann er damit prüfen, ob die Ausgabe noch passt.

Testen Sie das Format ausserdem mit schwierigen Fällen: sehr kurze Texte, Texte mit Sonderzeichen, Texte in einer anderen Sprache und Texte, in denen Angaben fehlen. Genau dort zeigen sich die Schwächen am deutlichsten.

So hilft Ihnen Alpasana

Wer KI in Software einbinden will, findet bei absofort den Kurs KI für Developer mit Claude und Codex. Laut Beschreibung behandelt er LLM-Grundlagen, Claude API, Codegenerierung, Debugging, Review und ein Entwickler-Playbook mit Prompts, Tests und Datenschutzgrenzen. JSON wird in der Beschreibung nicht einzeln genannt.

Häufige Fragen

Muss ich JSON-Kenntnisse haben?

Grundkenntnisse helfen, aber ein Beispiel genügt für den Anfang. Das Format ist einfach: Namen und Werte in geschweiften Klammern. Ihre Entwicklerin oder das Automatisierungswerkzeug übernimmt die Prüfung.

Warum gibt die KI manchmal Text vor und nach dem JSON aus?

Weil sie gewohnt ist, zu erklären. Verlangen Sie ausdrücklich «ausschliesslich JSON». Ihre Anwendung sollte trotzdem Text ausserhalb der Klammern abschneiden oder die Antwort ablehnen.

Kann ich Umlaute in Feldnamen verwenden?

Technisch oft ja, in der Praxis führen sie aber leicht zu Problemen. Verwenden Sie für Feldnamen einfache Buchstaben ohne Umlaute. In den Werten sind Umlaute unproblematisch.