Fanout-Ergebnis-Schema: Vollrun, Auswahl und Vergleich validieren
Native und modellierte Vollruns verwenden toolVersion und methodVersion, ohne root-schemaVersion. Query-Auswahl und lokaler Vergleich haben eigene schemaVersion-Werte. Die Referenz prüft vier Exportfamilien; der Validator ergänzt Zähl- und Scope-Regeln.
Wenn du JSON aus dem aktuellen Website-Tool weiterverarbeitest. Die Referenz gilt für die dokumentierten Versionen; rohe Provider-Antworten und der ältere Planner-Vertrag bleiben eigene Formate.
Prüfe anschließend ein eigenes ErgebnisDas Offline-Kit braucht keinen API-Schlüssel. Im kostenlosen Tool kannst du später einen separaten, begrenzten Lauf prüfen.Kostenloses Tool öffnenVier Familien mit unterschiedlichen Aufgaben
Ein nativer Vollrun enthält die normalisierte Query-Liste, Suchaktionen, Quellen, Provider-Status und Laufmetadaten. Ein modellierter Vollrun enthält zehn Objekte mit query, intent und reason. Die modellierten Objekte sind Rechercheideen; ein ähnlicher Query-Text macht sie nicht zur Provider-Beobachtung.
Die Query-Auswahl enthält nur angekreuzte Strings und ihre ursprünglichen, einsbasierten Indizes. Ihr run-Objekt hält den Kontext, enthält aber keine Quellenliste. Der Vergleich enthält dagegen mehrere gespeicherte Läufe, Auswertungen und gemeinsame Mengen. Ein run-Domainset in einem Vergleich ist kein Quellenbeleg pro CSV-Query.
Vertiefe das mit im Tool den passenden Export wählen.
Die JSON-Schema-Datei ist eine neue Referenz für diese vorhandenen Verträge, kein neu erfundenes Feld im Tool-Response. Die unten genannten Versionen stammen aus dem aktuellen Quellcode. Der alte ai-fanout.export/1.0-Planner mit branches und der SEO-Research-Handoff sind nicht Teil dieses Validators und werden nicht stillschweigend umgedeutet.
Vertrag auswählen
Quellcode geprüft am 10. Oktober 2026. Das Referenzartefakt v1 ist kein root-schemaVersion-Wert eines Vollruns.
| Datei | Kennzeichnung | Umfang |
|---|---|---|
| Nativer Vollrun | native-fanout-tool/1.1.0 · provider-native-search/1.1 | Normalisiertes Ergebnis eines Laufs |
| Modellierter Vollrun | modelled-fanout-tool/2.1.0 · openrouter-structured-fanout/2.1 | Zehn Rechercheideen |
| Query-Auswahl | ai-fanout.query-selection/1.0 | Gewählte Strings, keine Quellen |
| Lokaler Vergleich | ai-fanout.local-comparison/1.0 | Gespeicherte Läufe und Ableitungen |
JSON-Form und fachliche Zählregeln separat prüfen
Das Kit verwendet Ajv 8.20.0 mit der Draft-2020-12-Klasse. Es kompiliert das echte JSON Schema, statt nur einige Felder mit eigenen if-Abfragen nachzubauen. Strenge Objektregeln erkennen beispielsweise eine erfundene Quellenliste in der Query-Auswahl oder einen falschen Evidence-Status.
JSON Schema allein vergleicht hier keinen selectedQueryCount mit der tatsächlichen Arraylänge. validate.mjs ergänzt diese Prüfung sowie eindeutige Auswahlindizes, Vergleichs-IDs, Run- und Analysezahlen. Es prüft auch, ob der gespeicherte Gemini-Vertrag seine Quellen entfernt und ob ein exact_query-Scope zu einer Einzel-Query-Aktion passt.
Nach npm ci kannst du npm run validate ausführen. Das Paket enthält vier ausdrücklich synthetische Exportformen; Auswahl und Vergleich wurden mit den tatsächlichen Exportfunktionen der Website erzeugt. Im Repository werden zusätzlich die Ausgaben beider Service-Funktionen mit gemockten Providern geprüft. Es wurden dafür keine kostenpflichtigen Anfragen gemacht.
Vertiefe das mit negative Vertragstests prüfen.
npm run validate
node validate.mjs path/to/your-export.jsonEin gültiges Schema bestätigt keine Herkunft
Ein korrekt aufgebautes JSON kann trotzdem erfunden sein. Der Validator beweist Form und die aufgeführten Beziehungen, nicht die Herkunft eines Providers, die Richtigkeit eines Zitats oder heutige Preise. Die Nullwerte der synthetischen Usage sind Platzhalter und keine Kostenmessung.
Auch ein formal gültiger Vergleich ist nicht automatisch methodisch fair. Die aktuelle Typbezeichnung prüft Themen und Provider, aber nicht die Gleichheit sämtlicher Locale- und Protokollfelder. Gemeinsame Query-Mengen sind eine deterministische Ableitung, kein allgemeiner Qualitätsscore. Diese Fragen gehören in den Wiederholungs- und Vergleichsplan.
Vertiefe das mit einen kontrollierten Vergleich vorbereiten.
Die Referenz überprüft serialisierte ISO-Zeitstempel in der verwendeten Form, nicht deren Aktualität oder jede Kalendergrenze. Sie rekonstruiert nicht sämtliche Schnittmengen. Bewahre daher den unveränderten eigenen Export auf und dokumentiere Schema- und Parser-Version separat. Bei einer neuen Tool-Version prüfst du die Referenz erneut, bevor du sie akzeptierst.
Verwendete Quellen
Diese Quellen stützen die beschriebenen Funktionen und Grenzen. Sie belegen keine darüber hinausgehenden Aussagen.
- Ajv: unterstützte JSON-Schema-DraftsQuelle öffnen
Stützt die Ajv2020-Klasse für Draft 2020-12. Das Kit verwendet Ajv 8.20.0 mit gelockten Abhängigkeiten. Die Quelle authentifiziert keine Provider-Herkunft und bestätigt nicht die Wahrheit exportierter Aussagen.
- Eigenes ausführbares Offline-Parser- und Randfall-TestkitQuelle öffnen
Eigener Lehrcode und 27 Offline-Prüfungen. Synthetische Antwortstrukturen sind keine Provider-Ausgaben. Geprüft werden Strings, Status, Quellenumfang und ausgeschlossene Payloads. Kein bezahlter Aufruf oder neues reales Grounding-Material; der Lehr-Parser unterscheidet sich ausdrücklich vom Website-Wrapper.
- Aktuelle Website-Exportverträge und ReferenzvalidierungQuelle öffnen
Draft-2020-12-Referenz für aktuelle native/modellierte Vollruns, Query-Auswahlen und lokale Vergleiche. Geprüft gegen tatsächliche Service-/Exportfunktionen mit synthetischen Provider-Stubs und negativen Semantiktests. Vollruns erhalten keine erfundene root-schemaVersion; ältere Planner- und Handoff-Formate bleiben getrennt.