KI Bearbeitung - Versionsgeschichte

Stefan: 3614 /* Wiki vervollständigen */

2026-05-05T09:00:28Z

3614 Wiki vervollständigen

← Nächstältere Version		Version vom 5. Mai 2026, 11:00 Uhr
Zeile 176:		Zeile 176:

	=== Testfenster ===		=== 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]]		[[Datei:ChatTestfenster.png]]

Stefan am 5. Mai 2026 um 08:55 Uhr

2026-05-05T08:55:22Z

← Nächstältere Version		Version vom 5. Mai 2026, 10:55 Uhr
Zeile 46:		Zeile 46:

	'''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.		'''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 ===		=== Extraktionanweisungen ===
Zeile 113:		Zeile 114:

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


	=== Feldzuordnungen ===		=== Feldzuordnungen ===
Zeile 147:		Zeile 149:

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


	=== Modelparameter ===		=== 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]]		[[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 ===		=== Testfenster ===
	[[Datei:ChatTestfenster.png]]		[[Datei:ChatTestfenster.png]]

Stefan: /* Feldzuordnungen */

2026-05-05T08:35:23Z

Feldzuordnungen

@@ Zeile 115: / Zeile 115: @@
 === Feldzuordnungen ===
 [[Datei:FelderSchema.png]]
 === Modelparameter ===

Stefan: /* User-Prompt */

2026-05-05T08:31:18Z

User-Prompt

← Nächstältere Version		Version vom 5. Mai 2026, 10:31 Uhr
Zeile 109:		Zeile 109:

	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:		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.		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.		Für einfache Extraktionsaufgaben kann dieses Feld kurz gehalten werden, da die eigentlichen Anweisungen bereits vollständig im System-Prompt enthalten sind.

Stefan: /* System-Prompt */

2026-05-05T08:30:57Z

System-Prompt

← Nächstältere Version		Version vom 5. Mai 2026, 10:30 Uhr
Zeile 94:		Zeile 94:

	## Extraktionsanweisungen		## Extraktionsanweisungen
	Siehe ~~genaue~~ Anweisung in ~~der Benutzereingabe~~		Siehe weitere Anweisung in den jeweiligen Schemabemerkungen
	Extrahiere aus Rechnungen:		Extrahiere aus Rechnungen:
	- Vorname und Nachname der angeschriebenen Person ~~(meist oben links in der Anschrift)~~		- Vorname und Nachname der angeschriebenen Person
	- Ort aus der Anschrift		- Ort aus der Anschrift
	- Rechnungstotal		- Rechnungstotal
	- ~~flugnummer~~		- usw..

	## Ausgabe		## Ausgabe

Stefan: /* Extraktionanweisungen */

2026-05-05T08:28:16Z

Extraktionanweisungen

@@ Zeile 48: / Zeile 48: @@
 === Extraktionanweisungen ===
 [[Datei:Extraktionsprompt.png]]
 === Feldzuordnungen ===

Stefan: /* API */

2026-05-05T08:15:05Z

API

← Nächstältere Version		Version vom 5. Mai 2026, 10:15 Uhr
Zeile 27:		Zeile 27:

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

			[[Datei:APIKonfiguration.png]]

	{\| class="wikitable"		{\| class="wikitable"
Zeile 44:		Zeile 46:

	'''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.		'''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.

	~~[[Datei:APIKonfiguration.png]]~~

	=== Extraktionanweisungen ===		=== Extraktionanweisungen ===

Stefan: /* API */

2026-05-05T08:11:40Z

API

← Nächstältere Version		Version vom 5. Mai 2026, 10:11 Uhr
Zeile 25:		Zeile 25:

	=== API ===		=== API ===

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

			{\| 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.

	[[Datei:APIKonfiguration.png]]		[[Datei:APIKonfiguration.png]]

Stefan am 5. Mai 2026 um 07:55 Uhr

2026-05-05T07:55:52Z

← Nächstältere Version		Version vom 5. Mai 2026, 09:55 Uhr
Zeile 8:		Zeile 8:
	== Beschreibung ==		== Beschreibung ==

	Ermöglicht die Auswertung von Text und Bilddateien über verschiedene KI Modelle ~~- insbesondere Sprachmodelle - über Prompt gesteuerte Anweisungen~~. Unterstützt werden PDF Dateien, sowie JPEG und PNG Bilddateien.		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 und API Schnittstellen angesprochen werden, ~~Online~~ oder in lokaler Infrastruktur. Als API wird die OpenAI API in der neuesten Version empfohlen.		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.		Der Serverjob macht genau einen Aufruf mit einer Anfrage.
Zeile 24:		Zeile 24:
	== Konfiguration ==		== Konfiguration ==

			=== API ===
	[[Datei:APIKonfiguration.png]]		[[Datei:APIKonfiguration.png]]

			=== Extraktionanweisungen ===

	[[Datei:Extraktionsprompt.png]]		[[Datei:Extraktionsprompt.png]]

			=== Feldzuordnungen ===

	[[Datei:FelderSchema.png]]		[[Datei:FelderSchema.png]]

			=== Modelparameter ===
	[[Datei:ModelParameter.png]]		[[Datei:ModelParameter.png]]

			=== Testfenster ===
	[[Datei:ChatTestfenster.png]]		[[Datei:ChatTestfenster.png]]

	~~== Konfiguration ==~~

Stefan: 3614 /* Konfigurationsbilder einfügen */

2026-05-05T07:48:42Z

3614 Konfigurationsbilder einfügen

← Nächstältere Version		Version vom 5. Mai 2026, 09:48 Uhr
Zeile 8:		Zeile 8:
	== Beschreibung ==		== Beschreibung ==

	Ermöglicht die Auswertung von Text und Bilddateien über verschiedene KI Modelle -insbesondere ~~LLM's~~ - über Prompt gesteuerte Anweisungen. Es werden PDF Dateien sowie JPEG und PNG Bilddateien ~~unterstützt~~.		Ermöglicht die Auswertung von Text und Bilddateien über verschiedene KI Modelle - insbesondere Sprachmodelle - über Prompt gesteuerte Anweisungen. Unterstützt werden PDF Dateien, sowie JPEG und PNG Bilddateien.
	Es können verschiedene Anbieter und API Schnittstellen angesprochen werden, Online oder in lokaler Infrastruktur. ~~Generell~~ wird die OpenAI API in der neuesten Version empfohlen. ~~Die meisten Anbieter unterstützen diese.~~
	Der Serverjob macht genau einen Aufruf mit einer Anfrage. Es gibt einen Sytstem-Prompt und einen User-Prompt, ~~welcher generell als~~ der Chatprompt bei Chatbasierten LLM Applikationen.		Es können verschiedene Anbieter und API Schnittstellen angesprochen werden, Online oder in lokaler Infrastruktur. Als API wird die OpenAI API in der neuesten Version empfohlen.
	Der System-Prompt ~~hat mehr Gewicht als der User-Prompt. Über diesen wird~~ die KI als Werkzeug ~~definiert~~ und ~~in ihrem Verhalten instruiert~~ und ~~eingeschränkt~~. Der User-Prompt ~~macht dann nur noch eine spezifische~~ Anfrage.
			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.		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 ==

			[[Datei:APIKonfiguration.png]]

			[[Datei:Extraktionsprompt.png]]

			[[Datei:FelderSchema.png]]

			[[Datei:ModelParameter.png]]

			[[Datei:ChatTestfenster.png]]

	== Konfiguration ==		== Konfiguration ==