Und noch etwas zeigt dieser Katalogeintrag: geraet, akku und gewicht_kg sind Namen, die Mara erfunden hat. Sie hätte auch device, battery und weight schreiben können. In ihrem eigenen Format darf sie das. In einem Brief an Anthropic darf sie es nicht: Dort heißen die Felder so, wie der Anbieter es festgelegt hat. Ein zusätzlich erfundenes Feld wird nicht dadurch zur Funktion, dass es im JSON steht. Diese Unterscheidung zwischen unseren Feldern und Anbieterfeldern ist die halbe Miete.
Drei Fragen für jedes JSON
Wenn dir ab jetzt ein JSON-Block begegnet, in einer Dokumentation, in einer Fehlermeldung oder in der Antwort einer KI, stell ihm drei Fragen.
Wer hat dieses Format festgelegt? Der Anbieter des Modells, ein anderer Dienst oder wir selbst? Anbieterfelder kann man nicht umbenennen. Eigene Felder darf man frei gestalten und sollte sie so benennen, dass ein Mensch sie in einem Jahr noch versteht.
Wohin reist dieser Brief? Vom Browser zu unserem Server, vom Server zum Modellanbieter oder zurück? Derselbe Inhalt sieht auf jeder Strecke anders aus.
Was passiert im Produkt mit jedem Feld? Wird es angezeigt, gespeichert, für eine Entscheidung verwendet oder ignoriert? Ein Feld, das nirgends etwas bewirkt, ist Ballast. Ein Feld, bei dem du nicht weißt, was es bewirkt, ist eine Frage an deine Entwicklungs-KI.