Luftfracht-KI mit Provider- und Freigabekontrolle nutzen

Zweck und Einsatzbereich

Der Reiter KI-Assistent einer geöffneten Luftfrachtakte bündelt vier belegte Arbeitsflächen: KI-Cockpit, E-Mail / Dokument, Akten-Chat und Antwortentwurf. Das Cockpit erzeugt regelbasierte Hinweise zu Datenqualität, Fristen, Luftsicherheit, Gefahrgut, eAWB, Zoll und Marge. Bei konfiguriertem KI-Provider kann zusätzlich eine modellgenerierte Zusammenfassung entstehen. Text- und Dokumentanalyse schlagen passende Aktenwerte und nächste Schritte vor; der Chat beantwortet Fragen anhand der geöffneten Akte; der Antwortbereich erzeugt einen kopierbaren Entwurf.

Die KI ist eine Arbeitshilfe, keine fachliche Freigabe. Ein Vorschlag ändert die Akte erst nach Bestätigen. Eine Sicherheitsprüfung kann nicht auf diesem Weg bestätigt werden. Ein Antwortentwurf wird weder gespeichert noch versendet. Prüfen Sie Aussagen zu Airline, Zoll, Luftsicherheit, Gefahrgut, Terminen und Finanzen immer gegen die Originalquelle.

Die sichtbare Arbeitsfläche erlaubt das Einfügen eines E-Mail-Texts, aber keine Auswahl einer bereits im NeuraPort-Posteingang gespeicherten E-Mail. Eine mandanten- und OE-begrenzte E-Mail-Analyse ist serverseitig vorhanden, im geprüften Hauptfrontend jedoch nicht verdrahtet. Verwenden Sie im sichtbaren Weg deshalb nur den manuell eingefügten Text oder ein geprüftes Dokument.

$TODO: Screenshot – geöffnete synthetische Luftfrachtakte im Reiter KI-Assistent und Unterreiter KI-Cockpit mit neutralen regelbasierten Hinweisen, sichtbarer Quellenangabe sowie Bestätigen und Verwerfen; keine echten Akten-, Kunden-, AWB-, Routing-, Security-, DGR-, Zoll-, Finanz- oder Providerdaten$

Voraussetzungen und Berechtigungen

Sie benötigen eine aktive Anmeldung in einem Mandanten, eine zulässige Organisationseinheit, das Modul KI & Automatisierung und für die geöffnete Akte Luftfracht Export oder Luftfracht Import. Ein reines Luftfrachtmodul ohne KI-Modul genügt nicht. Ein Modulstatus READ_ONLY lässt lesende Zugriffe zu, blockiert aber die hier als Schreibaufruf ausgeführten Aktionen.

Für offene Vorschläge, die Aktenprüfung und den Akten-Chat genügt serverseitig Akten anzeigen. Text- und Dokumentanalyse, Bestätigen und Verwerfen benötigen Akten bearbeiten. Ein Antwortentwurf benötigt E-Mails anlegen. Die nicht sichtbar verdrahtete Analyse einer gespeicherten E-Mail benötigt E-Mails anzeigen. Die Seitenrolle Luftfracht-Sachbearbeitung bezeichnet daher ein Aufgabenprofil aus passenden Modulen, OE-Zuweisung und den jeweils erforderlichen Rechten; sie ist kein eigener technischer Rollenname.

Mandant und erlaubte Organisationseinheiten begrenzen Akte, Vorschläge und gespeicherte E-Mail. Fremde oder nicht erreichbare Objekte werden nicht offengelegt. Die Lizenzprüfung richtet sich bei aktenbezogenen Aktionen nach Richtung und aktuell gewählter Organisationseinheit. Plattformkonten dürfen keine operativen Mandantendaten in diesem Bereich öffnen.

Die Oberfläche reicht das Bearbeitungsrecht nicht an den KI-Assistenten weiter und zeigt deshalb alle Aktionen auch Benutzern mit reinem Leserecht. Maßgeblich bleibt die serverseitige Prüfung. Lösen Sie bei unerwartet sichtbaren Schaltflächen keine wiederholten Versuche aus, sondern lassen Sie Rolle, Modulstatus und OE-Zuweisung prüfen.

Schritt-für-Schritt-Anleitung

Akte prüfen und Vorschläge entscheiden

Öffnen Sie Luftfracht, wählen Sie eine erreichbare Akte und öffnen Sie KI-Assistent.
Wählen Sie KI-Cockpit und dann Akte mit KI prüfen. Die Prüfung kann auch ohne externen Provider regelbasierte Hinweise erzeugen; eine modellgenerierte Zusammenfassung ist providerabhängig und wird in der Oberfläche nicht angezeigt.
Prüfen Sie je Hinweis Typ, Vertrauenswert, Titel, Erläuterung, gegebenenfalls Aktuell, Vorschlag und Quelle. Ein Vertrauenswert ist keine fachliche Richtigkeit.
Wählen Sie Bestätigen nur nach Vergleich mit Originalunterlage und Akte. Übernommen werden ausschließlich dafür zugelassene Aktenfelder; Luftsicherheits-, Zoll-, eAWB-, CASS- oder allgemeine Aktenstatus gehören nicht dazu. Verwerfen beendet den Vorschlag ohne Aktenänderung.
Bei SECURITY_REVIEW fehlt Bestätigen bewusst. Prüfen Sie die Quelle manuell und verwerfen Sie den Hinweis erst nach dokumentierter fachlicher Klärung.

Text oder Dokument analysieren

Öffnen Sie E-Mail / Dokument. Für ein Dokument wählen Sie eine PDF-, PNG-, JPG-, JPEG-, TXT-, XML- oder CSV-Datei und dann Dokument mit KI analysieren. Die sichtbare Auswahl ist auf diese Formate begrenzt; maximal 10 MiB sind standardmäßig konfiguriert.
Alternativ tragen Sie optional Betreff und Absender ein, fügen mindestens drei Zeichen unter Text aus E-Mail oder Buchungsbestätigung einfügen… ein und wählen Text analysieren. Dies ist eine manuelle Textanalyse, keine direkte Verknüpfung mit dem E-Mail-Posteingang.
Prüfen Sie im Analyseergebnis Dokumenttyp, Vertrauenswert und Zusammenfassung. Die eigentlichen Feldvorschläge erscheinen im KI-Cockpit.
Wechseln Sie ins Cockpit und entscheiden Sie jeden Vorschlag einzeln. Eine erkannte Aktennummer, AWB- oder Booking-Referenz, Route, Gewichts-, Termin-, Gefahrgut- oder Security-Angabe bleibt bis zur Bestätigung ein Vorschlag.

Akten-Chat und Antwortentwurf nutzen

Öffnen Sie Akten-Chat, stellen Sie eine konkrete Frage zu fehlenden Daten, Risiken, Fristen, Route oder nächstem Arbeitsschritt und senden Sie sie. Der Chat verwendet die geöffnete Akte, ihre Flugsegmente, Meilensteine, das Speditionskonto sowie Security-/Zollwerte als Kontext.
Behandeln Sie die genannten Quellenkategorien als Kontextliste, nicht als zitierte Einzelnachweise. Prüfen Sie die Antwort an der Akte. Nach einem Neuladen lädt die Oberfläche die gespeicherte Unterhaltung nicht wieder ein.
Öffnen Sie Antwortentwurf, fügen Sie optional eine eingegangene Nachricht ein und beschreiben Sie unter Was soll die Antwort erreichen? das Ziel. Die sichtbare Sprache ist Deutsch.
Wählen Sie Antwort vorschlagen. Prüfen Sie Betreff, Text und Hinweise wie einen offenen Luftsicherheitsstatus oder eine fehlende DGR-Erklärung.
Wählen Sie Kopieren und bearbeiten Sie den Text im vorgesehenen E-Mail-Weg weiter. Der Entwurf wird nicht automatisch versendet und im KI-Assistenten nicht als E-Mail-Entwurf gespeichert.

Feldreferenz

Feld	Pflicht	Bedeutung	Validierung
Betreff	Nein	Kontext für eine manuell eingefügte E-Mail oder Buchungsbestätigung.	Höchstens 500 Zeichen; wird zusammen mit dem geprüften Text bewertet.
Absender	Nein	Absenderkontext der manuellen Textanalyse.	Höchstens 255 Zeichen; eine E-Mail-Adresse wird vor externem Modellaufruf maskiert.
Text aus E-Mail oder Buchungsbestätigung	Ja bei Textanalyse	Freier Quelltext für Dokumenttyp, Zusammenfassung und Vorschläge.	3 bis 100.000 Zeichen in der Eingabe; höchstens die ersten 12.000 Zeichen werden auf Prompt-Injection geprüft und gegebenenfalls extern verarbeitet.
Datei	Ja bei Dokumentanalyse	Dokument, dessen Text nach Datei- und Schadsoftwareprüfung extrahiert wird.	Sichtbar auswählbar: PDF, PNG, JPG/JPEG, TXT, XML und CSV; Standardgrenze 10 MiB; ohne extrahierbaren Text keine Analyse.
Dokumenttyp	Ergebnis	Erkannte Kategorie wie Booking, AWB, Statusänderung, Rate, Rechnung, Gefahrgut-, Security- oder Zollunterlage.	Modellklassifikation, keine verbindliche Dokumentfreigabe. Bei blockierter Quelle SECURITY_REVIEW.
Vertrauenswert	Ergebnis	Modellwert zwischen 0 und 100 Prozent.	Wird auf den Bereich 0 bis 100 Prozent begrenzt; ersetzt keine Prüfung.
Aktuell / Vorschlag	Ergebnis	Gegenüberstellung des vorhandenen und vorgeschlagenen Feldwerts.	Nur zugelassene Felder; Datentypen und MAWB werden bei Übernahme erneut validiert.
Quelle	Ergebnis	Beschriftung des manuellen Texts oder Dateiname.	Beschreibender Hinweis; kein unveränderbarer Nachweis des Inhalts.
Frage	Ja beim Chat	Frage zur geöffneten Akte.	3 bis 4.000 Zeichen.
Eingegangene Nachricht	Nein	Zusatzkontext für den Antwortentwurf.	Höchstens 50.000 Zeichen in der Eingabe; nur die ersten 12.000 Zeichen werden geprüft und gegebenenfalls an das Modell übergeben.
Ziel des Antwortentwurfs	Nein	Gewünschte Aussage oder nächste Aktion.	Höchstens 500 Zeichen; ohne Text wird ein neutraler Standardzweck verwendet.
Warnungen	Ergebnis	Offener Luftsicherheitsstatus, fehlende DGR-Erklärung oder blockierter Eingangstext.	Vor Kopieren und Versand fachlich klären; keine automatische Sperre außerhalb des Assistenten.
Provider / Modell	Protokolliert, aber nicht sichtbar	Tatsächlich verwendeter Anbieter und aufgelöstes Modell eines Modellaufrufs.	Werden an Vorschlägen beziehungsweise Chatnachrichten gespeichert, aber im geprüften KI-Assistenten nicht angezeigt.

Status und mögliche Übergänge

Ausgangszustand	Aktion	Ergebnis
Kein offener Hinweis	Akte mit KI prüfen	Regelbasierte Hinweise werden erzeugt; bei Providerverfügbarkeit kann zusätzlich eine Zusammenfassung berechnet werden.
Quelltext oder Dokument ausgewählt	Text analysieren oder Dokument mit KI analysieren	Analyseergebnis entsteht; passende Hinweise werden PENDING im Cockpit abgelegt.
Prompt-Injection-Verdacht	Analyse	Ein kritischer Hinweis SECURITY_REVIEW entsteht; die geprüfte Quelle wird nicht an ein externes Modell übergeben.
Vorschlag PENDING	Bestätigen	Zulässiger Feldvorschlag oder eine serverseitig erzeugte E-Mail-Zuordnung wird angewendet und der Vorschlag wird APPLIED; ein allgemeiner Handlungshinweis wird quittiert.
Vorschlag PENDING	Verwerfen	Vorschlag wird DISMISSED; die Akte bleibt unverändert.
SECURITY_REVIEW	Bestätigungsversuch	Keine Übernahme; der Hinweis bleibt PENDING und verlangt manuelle Prüfung.
Vorschlag APPLIED oder DISMISSED	Erneuter Entscheidungsversuch	Konflikt; bereits bearbeitete Vorschläge können nicht erneut entschieden werden.
Chatfrage gesendet	Antwort oder Fallback	Frage und Antwort werden aktenbezogen gespeichert; die Oberfläche zeigt sie nur in der aktuellen Sitzung.
Antwortziel eingegeben	Antwort vorschlagen	Kopierbarer Text mit Warnungen entsteht; keine Speicherung als E-Mail-Entwurf und kein Versand.

Was im Hintergrund passiert

Für Modellaufrufe fordert der Luftfracht-Assistent ein Claude-Sonnet-Modell an. Die zentrale Providerkette kann es je nach Konfiguration über Portkey mit Anthropic oder Anthropic direkt ausführen. Ist die Fallbackkette aktiviert, können Gemini, ein OpenAI-kompatibler Anbieter oder MiniMax mit dem jeweils konfigurierten Ersatzmodell übernehmen. Ohne Provider bleiben die festen Aktenregeln und sichere Fallbacktexte verfügbar; freie Text- und Dokumentanalyse liefert keine strukturierten Modellwerte.

Vor dem externen Aufruf maskiert eine Schutzschicht erkannte Personennamen, E-Mail-Adressen, Telefonnummern, IBANs und Umsatzsteuer-IDs. Sie anonymisiert nicht vollständig: Firmennamen, Häfen, Länder und bestimmte Logistikkennungen bleiben bewusst erhalten. Zusätzlich können Aktennummer, Richtung, Status, Kunde, Airline, Route, MAWB/HAWB, Booking, Packstücke, Gewichte, Ware, Termine, Security-, Gefahrgut-, Zoll-, ICS2-, ACAS- und eAWB-Zustände, Kosten und Erlöse sowie Flugsegmente und bis zu 20 Meilensteine zum Aktenkontext gehören. Eine Zusage zur EU-Verarbeitung oder zur vollständigen Anonymisierung ist aus diesem Funktionsweg nicht belegt; behandeln Sie die Provider- und Vertragskonfiguration deshalb als zwingende Datenschutzvoraussetzung.

Ein Prompt-Injection-Filter prüft genau das Textfenster, das extern verarbeitet werden darf. Bei klarem Manipulationsverdacht blockiert er die Weitergabe und erzeugt eine manuelle Sicherheitsprüfung. Dokumente durchlaufen zusätzlich Typ-, Größen- und Schadsoftwareprüfung sowie Textextraktion. Maskierte Werte werden nach der Modellantwort wieder eingesetzt; die Antwort kann deshalb erneut personenbezogene Inhalte enthalten.

Die externe Nutzung wird mandantenbezogen mit Tokenzahl, Provider, Modell, geschätzten Kosten, Modul sowie – soweit der Anfragekontext sie liefert – Benutzer und Organisationseinheit protokolliert. Diese Kosten- und Providerdaten sind im KI-Assistenten selbst nicht sichtbar. Auch das tatsächlich verwendete Modell und der Provider eines Hinweises oder Chats werden zwar gespeichert, im sichtbaren Panel aber nicht dargestellt. Der Benutzer kann daher einen Fallback nicht zuverlässig am Ergebnis erkennen.

Automatisierte Tests belegen die Ausschlussliste für Freigabe- und Statusfelder, JSON-Verarbeitung, einen Provideradapter sowie Mandantentrennung und die kontrollierte Übernahme eines Aktenfelds. Separate Tests decken Provider-Nutzungsmessung, dauerhafte KI-Modulfreigabe und den Prompt-Injection-Filter ab. Nicht belegt sind Browser-End-to-End-Tests des Panels, direkte gespeicherte E-Mail-Analyse, Dokumentanalyse, Chat, Antwortentwurf, sämtliche Provider-Fallbacks oder die sichtbare Rechteausblendung.

Typische Fehler und Lösungen

Meldung oder Beobachtung	Ursache	Lösung
KI-Assistent oder Luftfrachtakte fehlt	KI-Modul, Richtungsmodul, aktive OE oder Akten-Leserecht fehlt.	Modulstatus, aktive Organisationseinheit, Export-/Importfreigabe und Rolle prüfen.
Aktion ist sichtbar, wird aber abgewiesen	Das Panel blendet Schreibaktionen nicht nach Akten-/E-Mail-Rechten aus; serverseitig fehlen Recht oder Schreiblizenz.	Nicht wiederholen; Akten bearbeiten, E-Mails anlegen, KI-Modul und READ_ONLY prüfen lassen.
Noch keine offenen KI-Hinweise. Starten Sie die Aktenprüfung. trotz Fehler	Der Leerzustand unterscheidet einen fehlgeschlagenen Abruf nicht sichtbar von einer tatsächlich leeren Liste.	Seite neu laden und Lizenz, OE und Verbindung prüfen; nicht aus dem Leertext auf eine erfolgreiche Prüfung schließen.
KI-Prüfung fehlgeschlagen	Recht, Lizenz, OE, Verbindung oder interne Prüfung ist fehlgeschlagen.	Detailmeldung prüfen, Akte neu laden und keine mehrfachen Prüfungen auslösen.
Analyse fehlgeschlagen	Text ist ungültig, Provider nicht verfügbar oder Analyse konnte nicht verarbeitet werden.	Eingabe und Providerstatus prüfen; Originaldaten nicht aufgrund eines leeren Ergebnisses ändern.
Dokumentanalyse fehlgeschlagen	Format, Größe, Verbindung oder Verarbeitung ist fehlgeschlagen.	Sichtbar unterstütztes Format und 10-MiB-Standardgrenze prüfen; Datei nicht wiederholt hochladen.
Datei wurde von der Sicherheitsprüfung abgelehnt	Schadsoftwareprüfung bewertet die Datei als unsicher.	Datei isolieren und über den Sicherheitsprozess klären; keine Umgehung durch Umbenennen.
Aus der Datei konnte kein Text extrahiert werden	Datei enthält keinen verwertbaren Text oder die Extraktion unterstützt den Inhalt nicht.	Lesbare PDF-, Bild- oder Textquelle verwenden oder relevante Passage kontrolliert einfügen.
Analyse liefert SECURITY_REVIEW	Prompt-Injection-Verdacht; keine externe KI-Analyse erfolgt.	Quelle manuell und außerhalb des KI-Flusses prüfen; keine Bestätigung erzwingen.
Vorschlag wurde bereits bearbeitet	Vorschlag ist bereits APPLIED oder DISMISSED.	Cockpit aktualisieren; den alten Vorschlag nicht erneut verwenden.
Vorschlagswert ist ungültig	Datentyp, Datum, Liste, Zahl oder MAWB-Prüfung schlägt bei der Übernahme fehl.	Wert gegen Originalunterlage prüfen und Akte fachlich manuell korrigieren.
Chatfrage bleibt ohne Antwort	Chatfehler besitzt im Panel keine sichtbare Fehlerbehandlung.	Nicht mehrfach senden; Verbindung und Providerstatus prüfen, danach Akte neu laden.
Antwortentwurf erscheint nicht	Provider- oder Anfragefehler wird im Panel nicht sichtbar gemeldet.	Nicht von erfolgreicher Erstellung ausgehen; neu laden und Rechte/Provider prüfen.
Provider oder Modell ist nicht erkennbar	Provenienzdaten werden gespeichert, aber im Panel nicht angezeigt; Chatantwort gibt sie nicht an die Oberfläche zurück.	Ergebnis nicht anhand eines vermuteten Providers freigeben; technische Nutzungs-/Providerprotokolle durch berechtigte Administration prüfen lassen.
Gespeicherte E-Mail lässt sich nicht auswählen	Der direkte E-Mail-Analyseweg ist im Hauptfrontend nicht verdrahtet.	Inhalt kontrolliert in E-Mail / Dokument einfügen oder Funktion technisch anbinden lassen.