Helper - Benutzerbeiträge [de]

JSON Export

2026-05-27T13:25:20Z

Stefan:

;Mantiseinträge:
3638
;Systemtyp:
81

==Beschreibung==
Generiert für DOs ein File im JSON, xls oder xlsx Format bestehend aus einem ausgewählten Metadatum im JSON Format.

Es werden nur flache JSON unterstützt, oder Flache Strukturen innerhalb eines JSON Array. Wenn Arrays vorhanden sind, dann wird der Inhalt des ersten gefundenen Arrays verarbeitet.

Wird eine Excelvorlage Datei angegeben, dann werden die Daten in das Feld eingefügt, welches den 'Tagnamen' vor dem Metadatum trägt.

Bei einer neuen Exceldatei wird der Inhalt in das Feld A1 eingefügt.

Die Datei wird am aktuellen Datenschritt des Jobs gespeichert.

==Pane im Produktionsauftrag (FHK_Maske)==

[[File:JSONExport.png|600px]]

Bsp.: Exportiert das Metadatum "responsejson" in das Excelfeld welches den Text "meinfeld" enthält. Dazu wird die Exceldatei verwendet, welche im Pfad zur Excel Vorlage genannt wurde.
Der Dateiname wird zu "meinexportfilename.xlsx". Die Datei wird im HZ Ordner des aktuellen HZ Schrittes gespeichert.

===Excel Titelzeile===
Es werden aktuell noch keine Titelzeilen erstellt.

===JSON Strukturen===

Flaches JSON: Alle Elemente befinden auf der gleichen Hierarchie und haben genau einen Wert und keine weiteren verschachtelungen. Für jedes Element wird der Wert in eine Excelspalte auf der gleichen Zeile übertragen.

{
"Traktandennummer": "1",
"Titel": "Kantonale Gesetzgebung",
"Aufgegeben_Provenienz": "Die Staatskanzlei",
"Seite": "1"
}

JSON mit einfachem Array aus flachen JSON Objekten: Ein Element "Traktanden" ist ein Array von Objekten. Die Objekte sind gleichwertig und besitzen eine flache Struktur analog zum ersten Beispiel. Für jedes Objekt wird eine neue Zeile im Excel geschrieben.

{
"Ausgabe_Nummer": "1",
"Traktanden": [
{
"Traktandennummer": "1",
"Titel": "Kantonale Gesetzgebung",
"Aufgegeben_Provenienz": "Die Staatskanzlei",
"Seite": "1"
},
{
"Traktandennummer": "2",
"Titel": "Kraftloserklärung eines Schweizerpasses",
"Aufgegeben_Provenienz": "Die Staatskanzlei",
"Seite": "1"
},
{
"Traktandennummer": "3",
"Titel": "Stellenausschreibung",
"Aufgegeben_Provenienz": "Staatskanzlei des Kantons Zug, Der Landschreiber: H. Windlin",
"Seite": "1-2"
}],
"Datum": "08.01.1982",
}

==Essentielle Felder==
HZ_EXPORTFILENAME ''Name ohne Dateiendung, welches das finale Metadatendokument erhält''

HZ_EXPORTFILETYP ''Was für ein File soll generiert werden?''

HZ_EXPORTMETADATEN ''Welche Metadaten sollen unter welchem namen exportiert werden? Format: Titel=[Metaname]''
Mögliche Platzhalter: [DOSEQ], [DOSignatur], [eigene Metadaten], [^Metadaten des Vaters]

HZ_POOLPFAD ''Pfad zur möglichen Excelvorlage''

==Geplante Erweiterungen==

- Excel Titelzeile automatisch generieren
- Mehrere Metadaten exportieren, wobei pro Metadatum ein Excelsheet generiert wird, oder je eine JSON Datei - beides jeweils mit dem Namen des Metadatums oder des Tagnames - geschrieben wird.
- Formeln und Platzhalter in Namen erlauben

[[Kategorie:Workflowschritt]]

2026-05-11T09:21:06Z

Stefan: /* Pane im Produktionsauftrag */

;Mantiseinträge:
1973, 2980, 3582
;Systemtyp:
29

==Beschreibung==
Der Workflow besteht aus dem Serverjob OJOHZDOBarcodeTrenner.
Er durchsucht den Ordner eines Objekts nach Trennblättern, erstellt für jedes erkannte Trennblatt ein Kindobjekt und ordnet diesem alle Seiten bis zum nächsten Trennblatt zu.

Ein Trennblatt kann auf unterschiedliche Weise erkannt werden:

* über einen Barcode mit einem definierten Wert
* über eine Seite, die einen bestimmten Text enthält (OCR)
* über einen Bildvergleich mit einer oder mehreren bereitgestellten Vorlagendatein

'''Dieser Schritt hat zwei Ausgänge:'''

* erster Ausgang (grün) - Für das Vaterobjekt
* zweiter Ausgang (rot) - Für die Kindobjekte

==Konfiguration für Barcodes==
[[Datei:Barcode mode.png|400px]]
===Barcodetyp===
Hier können Sie im Dropdown definieren nach welchen Barcodetypen gesucht werden soll. Falls alle Barcodes gefunden und überprüft werden soll, wählen Sie "Alle finden".
===Barcodewert===
Definieren Sie einen Wert, welcher der Barcode beinhalten muss, damit diese Seite als Trennblatt zählt. Es ist möglich statische Werte sowie einen '''Regex''' zu definieren. Sie können zusätzlich den Platzhalter "[DOSEQ]" (ohne Anführungszeichen) verwenden. Mit dieser Konfiguration wird ein bereits bestehendes DO mit der entsprechenden Nummer gesucht. Die Seite wird nur zum Trennblatt wenn ein bestehendes Objekt gefunden wurde. Falls Sie das Kind nach dieser Sequenznummer zuordnen müssen, lesen Sie den Abschnitt "Signatur der Kinder".

Beispiele für Regex:
* Alle Zahlen: [0-9]*

==Konfiguration für OCR==
[[Datei:ocr mode.png|400px]] 
Beachten Sie, dass dieser Schritt nur Funktioniert, wenn die Objekte vorher durch den [https://www.helper.ch/wiki/index.php?title=OCR_Texterkennung OCR-Serverjob] gelaufen sind!
===OCR-Trenntext===
Mithilfe des OCR-Trenntextes können Sie definieren was für ein Text auf einer Seite stehen muss, damit die Seite als Trennblatt gewertet wird. Es ist möglich statische Begriffe sowie Regex zu definieren. Beachten Sie, dass sich der gesamte Ausdruck auf '''einer Zeile''' befinden muss!
====Beispiele====
OCR-Trenntext: Auszug aus dem Protokoll ==> Es wird auf jeder Seite nach "Auszug aus dem Protokoll" gesucht 
OCR-Trenntext: [0-9][0-9][0-9] ==> Es wird auf jeder Seite nach 3 stelligen Zahlen gesucht (123, 822, 111) 
OCR-Trenntext: aus .{5} ==> Es wird auf jeder Seite nach "aus <Wort mit 5 Zeichen egal welche>" gesucht ("aus Berlin" nicht aber "aus Bern")

==Konfiguration für Trennblatt-Vorlagedatei==

[[Datei:Bildschirmfoto 2026-01-23 um 17.32.41.png|Konfiguration Trennblattvorlage]]

'''Merke:''' Es werden nur Bilddateien unterstützt.

Im HZ-Ordner muss sich mindestens eine Datei befinden, die als Vorlage für die Trennblatterkennung verwendet wird.
Diese Vorlagen sind in einem Unterordner mit dem Namen „Trennblatt“ abzulegen.

Der Ordner kann über die Konfiguration mit der Taste „Vorlagenordner öffnen…“ direkt geöffnet werden.
Existiert der Ordner noch nicht, wird er automatisch erstellt. Voraussetzung dafür ist, dass in der Konfiguration des Arbeitsschrittes bereits ein HZ-Ordner definiert ist.

Über die Einstellung „Grenzwert“ kann die Erkennungsschwelle mit einem Wert zwischen 0.00 und 100.00 festgelegt werden.
Zur Ermittlung eines geeigneten Grenzwerts lassen sich einzelne Dateien über die Taste „Teste Datei!“ prüfen.
Der Vergleichs-Score wird anschließend in einer Meldung ausgegeben. Bei eindeutigen Vorlagen ist typischerweise ein Wert um 75 ausreichend.

==Allgemeine Konfiguration==

===Anzahl Trennlätter prüfen===
Wenn eine genaue Anzahl Trennblätter vorhanden sein muss, dann kann dieser Wert hier eingegeben werden. Die Objekte bleiben mit einem Fehler stehen, falls die Anzahl über- oder unterschritten wird.

[[Datei:Bildschirmfoto 2026-05-04 um 11.39.36.png]]

===Modus für erste Datei im Vater===
Hier können Sie definieren ob die erste Datei im Vater ein Trennblatt sein '''muss''' oder ob alle Dateien bis zum ersten Trennblatt '''ignoriert''' werden sollen. Falls die erste Seite ein Trennblatt sein soll sie jedoch keine ist, gibt es ein Fehler. 
[[Datei:father mode.png|300px]]

===Modus für Trennblätter===
Hier können Sie definieren, was mit dem Trennblatt geschehen soll: Soll die Datei mit ins Kind kopiert werden, oder nicht? 
[[Datei:trennblatt mode.png|300px]]

====Anzahl Files zu löschen nach dem Trennblatt====
Steht diese Zahl auf 0 werden alle Seiten, nach dem Trennblatt bis zum nächsten, ins Kind kopiert. Schreiben Sie zB. 2 hinein werden alle Seiten, '''bis auf die ersten 2''', nach dem Trennblatt ins Kind kopiert. 
Diese Zahl kann auch negativ sein; In diesem Falle werden X Blätter '''vor''' dem nächsten Trennblatt gelöscht.

===Modus für Kinder===
[[Datei:child mode.png|500px]]
====Nichts tun====
Nichts tun ist aktuell keine Option! Es gibt einen Fehler und der aktuelle Arbeitsschritt wird gestoppt.
====Kinder erstellen====
Wählen Sie die Option "Kinder erstellen", wird für jedes Trennblatt ein neues Kind erstellt.

====Daten bestehendem Kind zuordnen====
Wählen Sie diese Option, falls ein bestimmtes Objekt gesucht werden soll, welches die getrennten Daten erhält. Gesucht wird nach dem Typ des Objektes sowie der definierten Signatur. Wird kein passendes Objekt gefunden, gibt es einen Fehler. Das gefundene Objekt wird danach automatisch zum Kind vom Haupt-Objekt.
=====Typ der Kinder=====
* Welchen Typ sollen die neu erstellten Kinder erhalten?
* Von welchem Typ sollen die gesuchten Kinder sein?
=====Signatur der Kinder=====
Hier definieren Sie eine Omnisformel, welche beim erstellen evaluiert wird und die Signatur des neuen Kindes definiert. Oder aber es definiert die Signatur des zu findenden Objektes (Je nach der Konfiguration "Modus für Kinder") 

'''Für alle "Kinder-Modus" brauchbar:'''
* Eine Liste der Omnisfunktionen finden Sie hier: [https://helper.ch/wiki/index.php?title=Omnisgrundlagen] 
* Es ist möglich Attribute des Vaters zu evaluieren ("[Attributname]")
* Es ist möglich der Ahnen des Vaters zu evaluieren ("[^Attributname]" für jede Generation nach oben ein "^" mehr)
* Es ist möglich via OCR nach Text auf der Seite zu suchen und diesen zu evaluieren ("[OCR-Treffer='<Wort>'+/-<Treffer Offset>]")
* Es ist möglich den Platzhalter [DOSignatur] zu verwenden (Signatur des aktuellen DO / Vater der Kinder)
* Es ist möglich den Platzhalter [BarcodeValue] zu verwenden (Den Wert des Barcodes) 
'''Für den Kind-Modus "Kinder erstellen" brauchbar:'''
* Es ist möglich den Platzhalter [DOKindNr] zu verwenden (Laufnummer des Kindes -> Das wievielte Kind bin ich?) 
'''Für den Kind-Modus "Daten bestehendem Objekt zuordnen" brauchbar:'''
* Es ist möglich den Platzhalter [DOSEQ=BarcodeValue] '''ALLEINE''' zu verwenden (Sucht das Kind basierend auf der DOSEQ im BarcodeValue und '''nicht''' nach der Signatur!)
 
'''Beispiele:''' 
* con('Buch_',[Jahr]) ==> Attribut "Jahr" des aktuellen DO wird eigesetzt ==> Mögliche Resultate: Buch_1999 / Buch_2018
* con('Ordner_',[^Farbe])" ==> Attribut "Farbe" des Vaters des aktuellen DO wird eingesetzt ==> Mögliche Resultate: Ordner_grün, Ordner_Blau
* con('Kalender_',[^^Grösse],'_gebunden')" ==> Attribut "Grösse" des Grossvaters des aktuellen DO wird eingesetzt ==> Mögliche Resultate: Kalender_200cm_gebunden
* con('Buch_',[OCR-Treffer="Nr."+1]) ==> Es wird auf der Seite nach dem ersten Vorkommen von "Nr." gesucht und das '''Folgewort''' eingesetzt
* con('Buch_',[OCR-Treffer="Personen"+3]) ==> Es wird auf der Seite nach dem ersten Vorkommen von "Personen" gesucht und das '''3. Wort nach Personen''' eingesetzt
* con('Buch_',[OCR-Treffer="[0-9][0-9]"-2]) ==> Es wird auf der Seite nach der ersten 2 stelligen Zahl (21, 00, 11) gesucht und das '''2. Wort vor dieser Zahl''' eingesetzt

====Objekte müssen bereits Kinder sein====
Hier können Sie definieren ob irgend ein Objekt mit der gewünschten Signatur gesucht werden soll, oder ob dieses '''bereits''' ein Kind des Hauptobjektes sein '''muss'''. 
Nein = Irgend ein Objekt wird gesucht mit der gewünschten Signatur
Ja = Es werden nur bestehende Kinder mit der gewünschten Signatur gesucht

====Dateinamen der Kinder für die Belegzuordnung vorbereiten====

Dieses Option ist Pflicht für eine anschliessende Belegzuordnung.
Falls einer der nächsten Arbeitsschritte eine Belegzuordnung sein wird, dann müssen die Dateinamen der bereits zugeordneten Dateien entsprechend der Namenskonvention des Belegzuordungsfenster geändert werden.
Ansonst wird das Belegzordnungsfenster nicht mit den Dateinamen umgehen können und daher nicht verwendbar sein.

==Fehler handling==
Grundsätzlich stoppt der Job falls ein unerwarteter Umstand auftritt (Fehler beim aktualisieren von Daten, falsche Konfiguration). Ist der Kind-Modus "Daten bestehendem Objekt zuordnen" ausgewählt und es gibt Trennblätter wofür kein passendes Objekt gefunden wurde, arbeitet der Job einfach weiter.

===Produktionsauftrag 20P0010===
Bei diesem Auftrag werden "]" welche aus dem OCR gelesen wurden durch "1" ersetzt. Diese Anpassung ist nötig, da das GDPicture OCR die Schreibmaschinen Eins als eckige Klammer interpretiert.

==Essentielle Felder==
HZ_BARCODETYP ''Welcher Barcodetyp soll geprüft werden?''

HZ_BARCODEWERT ''Nach welchem Wert soll im Barcode gesucht werden, damit die Seite ein Trennblatt wird?''

HZ_BARCODEFILEWEG ''Wieviele Files nach dem Barcodeblatt sollen gelöscht werden?''

HZ_BARCODE1WEG ''0 = Trennblatt wird nicht ins Kind kopiert 1 = Trennblatt wird ins Kind kopiert''

HZ_FORMEL ''Eine Omnisformel welche evaluiert wird und danach als Signatur für neue Kinder verwendet wird, oder aber mit der bestehende Kinder gesucht werden''

HZ_HASHTYP ''0 = Es wird nach Barcodes gesucht 1 = Es wird nach OCR-Text gesucht 2 = Es wird mit einer Dateivorlage verglichen''

HZ_DATENVORHERLOSCHEN ''0 = Erste Seite muss ein Trennblatt sein 1 = Alle Seiten bis zum ersten Trennblatt werden ignoriert''

HZ_FILEVERHALTEN ''Modus für Kinder: 0 = Nichts tun 1 = Kinder erstellen 2 = Daten bestehendem Kind zuordnen''

HZ_DY_SEQ1 ''Sequenznummer des Objekttypes welche die Kinder haben sollen''

HZ_KINDERVERDOPPELN. ''0 = Objekt muss kein Kind vom Haupt DO sein 1 = Objekt muss bereits ein Kind des Haupt DO sein

HZ_EXPORTFILETYP ''0 = Die Dateinamen bleiben bestehen 1 = Die Dateinamen der den Kindesobjekte zugeordneten Dateien werden für die benötigte Nameskonvention bereits zugeordneter Belege im Belegzuordnungsfenster angepasst.

HZ_WORDERSETZEN ''Regex nach dem getrennt werden soll im Fall 'Trennen nach OCR-Text' ''

HZ_WARTEDAUER ''Grenzwert für Suche nach OCR-Score''

;Erlaubte Werte:
Es soll ein regulärer Ausdruck angegeben werden, um nur die erlaubten Worte zuzulassen.

In Wikipedia befindet sich eine genaue Erklärung dazu: https://de.wikipedia.org/wiki/Regulärer_Ausdruck#Reguläre_Ausdrücke_in_der_Praxis

;Beispiel:

Das Format der Barcodewerte wäre zum Beispiel: AB1234
Dann wird Folgendes für den Barcodewert angegeben: [A-Z][A-Z][0-9][0-9][0-9][0-9]
Wenn der Anfang der Barcodes immer fix AB wäre, dann kann man stattdessen Folgendes angeben: [A][B][0-9][0-9][0-9][0-9]

Damit ist es fix, dass nur AB am Anfang zugelassen wird. Sonst wäre alles zwischen A-Z erlaubt.

Auf https://guides.gdpicture.com/content/GdPicture.NET.14~GdPicture14.Barcode1DReaderType.html stehen die Barcodetypen von GdPicture und deren Werte.

==Pane im Produktionsauftrag==

[[File:barcode.png|400px]]

[[Kategorie:Workflowschritt]]

Datei:Barcode.png

2026-05-11T09:20:14Z

Stefan: Stefan lud eine neue Version von Datei:Barcode.png hoch

2026-05-08T13:13:17Z

Stefan: Stefan lud eine neue Version von Datei:Generische Vorerfassung.png hoch

Konfigurationsfenster der Generischen Vorerfassung

KI Bearbeitung

2026-05-05T09:00:28Z

Stefan: 3614 /* Wiki vervollständigen */

;Mantiseinträge:
3614
;Systemtyp:
80

'''OJOHZDOKIBearbeitung'''

== Beschreibung ==

Ermöglicht die Auswertung von Text und Bilddateien über verschiedene KI Modelle und Endpunkte. Unterstützt werden PDF Dateien, sowie JPEG und PNG Bilddateien.

Es können verschiedene Anbieter, deren Endpunkte und API Schnittstellen angesprochen werden. Web-API, Hosted oder bereitgestellt in lokaler Infrastruktur. Als API wird die OpenAI API in der neuesten Version empfohlen.

Der Serverjob macht genau einen Aufruf mit einer Anfrage.

Es gibt in der Konfiguration einen Sytstem-Prompt und einen User-Prompt, wobei der User-Prompt dem Chatprompt bei Chatbasierten LLM Applikationen entspricht. Dieser ist hier in der Regel eher zweitrangig.

Der System-Prompt definiert die KI strikt als funktionales Werkzeug: Er legt ihr Verhalten, ihre Aufgaben, Regeln und Einschränkungen fest und begrenzt den Interpretationsspielraum klar.
Der User-Prompt übernimmt darauf aufbauend ausschliesslich die konkrete Anfrage zur Auswertung des jeweiligen Dokuments.

Für das Speichern der Ausgabe aus den Abfragen in Metadatenfeldern, ist die Angabe eines fixen Schemas notwendig. Dabei muss der Name des Schemaelements mit dem Metadatumsnamen Feld übereinstimmen, in welches das Resultat abgefüllt werden soll.

== Konfiguration ==

=== API ===

In diesem Abschnitt wird die Verbindung zum KI-Anbieter eingerichtet.

[[Datei:APIKonfiguration.png]]

{| class="wikitable"
|-
! Feld !! Beschreibung
|-
| '''KI Anbieter''' || Bezeichnung des API-Anbieters, z. B. <code>Azure OpenAI</code> oder <code>OpenAI</code>. Dient zur Identifikation und Auswahl der richtigen Verbindungslogik.
|-
| '''API Endpunkt''' || Spezifischer API-Pfad, der angesprochen wird. Empfohlen wird <code>/responses</code> (neueste Version). Alternativ <code>/chat/completions</code> für ältere oder kompatible Anbieter.
|-
| '''URL''' || Stamm-URL des API-Endpunkts, z. B. <code>https://api.openai.com/v1</code> oder die URL einer Azure-Instanz.
|-
| '''API-Key''' || Geheimer Schlüssel zur Authentifizierung gegenüber dem Anbieter. Wird direkt beim Anbieter bezogen und muss vertraulich behandelt werden.
|-
| '''KI Modell''' || Name des zu verwendenden KI-Modells, z. B. <code>gpt-4o</code>, <code>gpt-4o-mini</code> oder ein Azure-Deployment-Name.
|}

'''Hinweis:''' Für Azure OpenAI ist die Basis-URL anbieterabhängig und enthält in der Regel den Azure-Ressourcennamen. Endpunkt und Modell müssen mit dem jeweiligen Deployment in Azure übereinstimmen.

=== Extraktionanweisungen ===

Hier werden die Anweisungen definiert, die der KI mitgeteilt werden, was sie aus dem Dokument extrahieren soll.

[[Datei:Extraktionsprompt.png]]

==== System-Prompt ====

Der System-Prompt ist die wichtigste Konfiguration. Er definiert das Verhalten der KI vollständig und legt fest:

* welche Art von Dokument analysiert wird,
* welche Informationen extrahiert werden sollen,
* in welchem Format die Antwort zurückgegeben werden muss,
* welche Regeln und Einschränkungen gelten (z. B. keine Werte erfinden, nur extrahieren was explizit vorhanden ist).

Der System-Prompt wird als Rolle <code>developer</code> oder <code>system</code> an die API übergeben. Es empfiehlt sich, den hier gezeigten Prompt als Basis zu verwenden, entsprechend anzupassen und im Abschnitt <code>## Extraktionsanweisungen</code> die dokumenttypspezifischen Anweisungen einzutragen.

'''Beispiel:'''
<pre>
Du bist eine Engine zur Analyse von Dokumenten. Deine Aufgabe ist es, Informationen aus dem bereitgestellten Dokument zu extrahieren und als JSON zurückzugeben, das exakt dem im Request definierten Schema entspricht.

## Regeln
- Extrahiere nur Informationen, die im Dokument explizit vorhanden sind.
- Triff keine Annahmen und leite keine Werte ab.
- Wenn ein Feld nicht gefunden werden kann, setze es auf null.
- Gib ausschließlich die im Schema definierten Felder zurück.
- Gib keine Erklärungen, Kommentare oder zusätzlichen Text aus.
- Betrachte mehrseitige Dokumente als eine Einheit.

## Confidence
Wenn im Schema ein entsprechendes Feld vorhanden ist:
- HIGH: Wert ist eindeutig und klar lesbar
- MEDIUM: Wert ist vorhanden, aber nicht eindeutig oder leicht interpretativ
- LOW: Wert ist unsicher oder nur teilweise vorhanden
- NONE: Kein Wert gefunden → zugehöriges Feld ist null

## Fehlerfall
Falls das Dokument nicht verarbeitet werden kann oder keinen Text oder erkennbaren Inhalt enthält, gib stattdessen einer der folgenden zum Fehler passenden Werte in das feld fehlerbeschreibung im json schema aus.

Mögliche Codes:
- NO_DOCUMENT
- UNREADABLE
- WRONG_FORMAT
- NO_CONTENT
- OUT_OF_SCOPE

## Extraktionsanweisungen
Siehe weitere Anweisung in den jeweiligen Schemabemerkungen
Extrahiere aus Rechnungen:
- Vorname und Nachname der angeschriebenen Person
- Ort aus der Anschrift
- Rechnungstotal
- usw..

## Ausgabe
Gib genau ein gültiges JSON-Objekt zurück, das dem Schema entspricht, oder ein Fehlerobjekt.

</pre>

==== User-Prompt ====

Der User-Prompt enthält die konkrete, dokumentbezogene Anfrage und wird direkt nach dem System-Prompt an die KI übergeben. In der Regel genügt ein kurzer Befehl wie:

Analysiere das Dokument und extrahiere die Informationen.

Für einfache Extraktionsaufgaben kann dieses Feld kurz gehalten werden, da die eigentlichen Anweisungen bereits vollständig im System-Prompt enthalten sind.

=== Feldzuordnungen ===

Das Schema definiert, welche Felder aus dem Dokument extrahiert und in welche Metadatenfelder sie geschrieben werden sollen.

[[Datei:FelderSchema.png]]

Jedes Schema-Element besteht aus drei Angaben:

{| class="wikitable"
|-
! Spalte !! Beschreibung
|-
| '''Name''' || Eindeutiger Bezeichner des Feldes. '''Muss exakt mit dem Namen des Ziel-Metadatenfelds übereinstimmen.'''
|-
| '''Typ''' || Datentyp des extrahierten Werts. Mögliche Werte: <code>string</code>, <code>number</code>, <code>integer</code>, <code>boolean</code>, <code>object</code>, <code>array</code>.
|-
| '''Beschreibung''' || Weitere Erklärung für die KI, was zu extrahieren ist und wo sich die Information im Dokument befindet, oder wie sie zu formatieren ist (Datum, Uhrzeit, Währung). Je präziser, desto besser das Ergebnis.
|}

'''Beispiel:'''

{| class="wikitable"
|-
! Name !! Typ !! Beschreibung
|-
| <code>name</code> || string || Nachname der Person aus der Anschrift oben rechts.
|-
| <code>vorname</code> || string || Vorname der Person aus der Anschrift oben rechts.
|-
| <code>titel1</code> || string || Erste Überschrift im Dokument, erkennbar an grösserer Schriftformatierung.
|}

'''Wichtig:''' Wenn ein Wert im Dokument nicht gefunden wird, gibt die KI <code>null</code> zurück. Es werden keine Werte erfunden.

=== Modelparameter ===

Die Modellparameter steuern das Verhalten des KI-Modells bei der Verarbeitung. Für Extraktionsaufgaben empfehlen sich niedrige Kreativitätswerte. Ein Tokenlimit für die Ausgabe kann unter anderem bei Halluzinationen der KI helfen, nicht endlosen text (Tokenkosten!) bis zum Tokenlimit des Modells auszugeben.

Es können vordefinierte Parameter aus der Dropdownliste im Feld des Parameternamens ausgewählt werden, oder eigene Parameternamen eingetragen werden.

[[Datei:ModelParameter.png]]

{| class="wikitable"
|-
! Parameter !! Empfohlener Wert !! Beschreibung
|-
| <code>temperature</code> || <code>0.1</code> || Kontrolliert die Zufälligkeit der Antwort. Niedrige Werte (nahe 0) liefern konsistentere, deterministischere Ergebnisse – ideal für strukturierte Extraktion.
|-
| <code>top_p</code> || <code>1.0</code> || Alternativer Sampling-Parameter. In Kombination mit niedriger Temperature auf <code>1.0</code> belassen.
|-
| <code>max_output_tokens</code> || <code>4096</code> || Maximale Anzahl Token in der Antwort. Für umfangreiche Schemata oder mehrseitige Dokumente ggf. erhöhen.
|}

'''Hinweis:''' Bei der Verwendung des Endpunkts <code>/chat/completions</code> heisst der Parameter <code>max_tokens</code> statt <code>max_output_tokens</code>.

=== Testfenster ===

Das Testfenster ermöglicht es, die aktuelle Konfiguration direkt mit einem Dokument zu testen, ohne den regulären Workflow ausführen zu müssen.

Vorgehensweise:
# Dokument (PDF, JPEG oder PNG) über die Dateiauswahl laden.
# Anfragetext leer lassen oder einfach "Dokument analysieren" eingeben.
# Auf '''Anfrage senden''' klicken.
# Die Antwort der KI wird im rechten Bereich des Fensters angezeigt – entweder als JSON-Objekt (bei erfolgreicher Extraktion) oder als Fehlerobjekt mit Fehlercode.

[[Datei:ChatTestfenster.png]]

KI Bearbeitung

2026-05-05T08:55:22Z

Stefan:

KI Bearbeitung

2026-05-05T08:35:23Z

Datei:ModelParameter.png

2026-05-05T08:13:02Z

Stefan: Stefan lud eine neue Version von Datei:ModelParameter.png hoch

Konfiguration Modelparameter

Datei:FelderSchema.png

2026-05-05T08:12:41Z

Stefan: Stefan lud eine neue Version von Datei:FelderSchema.png hoch

Konfiguration Schema

Datei:Extraktionsprompt.png

2026-05-05T08:12:22Z

Stefan: Stefan lud eine neue Version von Datei:Extraktionsprompt.png hoch

Konfiguration Seite Prompt

Datei:APIKonfiguration.png

2026-05-05T08:11:57Z

Stefan: Stefan lud eine neue Version von Datei:APIKonfiguration.png hoch

Konfiguration Seite API

KI Bearbeitung

2026-05-05T08:11:40Z

Stefan: /* API */

2026-05-04T09:40:30Z

Stefan:

Anzahl Trennblätter