KI-Mapping
Das Feldmapping ist die aufwendigste Arbeit beim Einrichten einer Pipeline. Orderport unterstützt Sie dabei mit zwei KI-gestützten Funktionen, die in der rechten Spalte des Mapping-Canvas erscheinen: den KI-Vorschlägen und dem Chat-Assistenten.
KI-Vorschläge
Beim ersten Öffnen des Mapping-Canvas generiert Orderport automatisch eine Liste von Vorschlägen. Jede Karte zeigt:
- Den vorgeschlagenen Mapping-Typ (direct, static, transform)
- Quell- und Zielfeld
- Eine kurze Begründung, warum diese Zuordnung sinnvoll ist
- Die Konfidenz der KI (hoch / mittel / niedrig)
Ein Klick auf Übernehmen fügt den Vorschlag Ihrem Mapping hinzu. Sie können die Vorschläge Stück für Stück durchgehen, die guten übernehmen und die unpassenden verwerfen.
Wann sind Vorschläge sinnvoll?
- Bei neuen oder wenig dokumentierten Integrationen (z. B. Generisches JSON mit unbekanntem Schema)
- Wenn das Quell- und Zielformat sehr ähnlich sind, aber mit leicht unterschiedlichen Feldnamen
- Um ein Basis-Mapping zu haben, das Sie dann manuell verfeinern
Wann verlassen Sie sich besser auf das Auto-Mapping?
Für etablierte Integrationen (Shopware 6 → openTrans, cXML → JSON usw.) liefert das eingebaute Auto-Mapping konsistentere Ergebnisse als die KI, weil es auf kuratierten Vorschlagskatalogen basiert. Die KI-Vorschläge ergänzen das Auto-Mapping, ersetzen es aber nicht.
Chat-Assistent
Im Tab Chat geben Sie natürliche Anweisungen ein. Die KI interpretiert, erzeugt eine Vorschau-Karte, und Sie übernehmen die Änderung mit einem Klick.
Beispiel-Anweisungen
| Ihre Eingabe | Resultat |
|---|---|
| „Setze die Währung auf EUR" | Static-Mapping für CURRENCY = EUR |
| „Übernimm die Bestellnummer direkt" | Direct-Mapping OrderID → ORDER_ID |
| „Formatiere das Datum auf TT.MM.JJJJ" | Transform-Mapping mit date_format |
| „Ignoriere den OrderType" | Ignore-Mapping für OrderRequestHeader.OrderType |
| „Rechne Preise mal 100" | Transform multiply auf lines[].price mit Argument 100 |
Kontext
Der Chat kennt:
- Die aktuellen Quell- und Zielfelder der Pipeline
- Die bereits definierten Regeln
- Das Beispieldokument (falls geladen)
Deshalb können Sie knapp formulieren – „die Bestellnummer" ohne Pfad – und die KI findet das passende Feld selbst.
Grenzen des Chat-Assistenten
- Der Chat führt keine Transformationsfunktionen ein, die es in Orderport nicht gibt (
uppercase,lowercase,trim,date_format,multiply). - Komplexe Aggregationen („summiere die Positionsbeträge") werden nicht umgesetzt – so etwas macht das Zielsystem.
- Mehrere Anweisungen in einem Satz werden seriell bearbeitet; bei Zweifeln fragt die KI nach.
Technische Details
Kosten
Die Nutzung der KI-Funktionen trägt Orderport. Es gibt keine nutzerbezogene Abrechnung pro Anfrage.
Rate Limits
Die KI-Funktionen sind begrenzt, um Missbrauch zu verhindern:
| Funktion | Limit |
|---|---|
| Vorschläge | 10 Anfragen pro Minute |
| Chat | 20 Anfragen pro Minute |
Wenn Sie ein Limit erreichen, erscheint ein Hinweis im Canvas; nach einer Minute kann die Funktion wieder genutzt werden.
Privacy
Kein Payload-Inhalt Ihrer echten Bestellungen wird an die KI übermittelt. An den KI-Dienst gehen nur Feldnamen (Quelle + Ziel), die Pipeline-Konfiguration und Ihre Eingaben im Chat.
KI-Anbieter
Orderport nutzt für die KI-Funktionen einen DSGVO-konformen externen KI-Dienst. Details zur Verarbeitung finden Sie in der Auftragsverarbeitungsvereinbarung (AVV).
Fehlerbehebung
| Symptom | Ursache | Lösung |
|---|---|---|
| Vorschläge bleiben leer | Feldkatalog der Integration ist klein (z. B. Generisches JSON) oder die Zielfelder sind bereits vollständig belegt | Integrationswahl prüfen; für Generisches JSON manuell mappen und den Chat-Assistenten für einzelne Regeln nutzen |
| Chat antwortet mit allgemeinen Erklärungen statt einer Karte | Anweisung zu vage | Konkreter formulieren, idealerweise mit Feldnamen – „Setze CURRENCY auf EUR" statt „Setze die Währung" |
| Rate Limit erreicht | Kurz hintereinander viele Versuche | Eine Minute warten, Hinweis im Canvas beachten |
Nächste Schritte
- Feldmapping – manuelles Mapping im Detail
- Limits & Kontingente – alle Rate Limits auf einen Blick