# 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](/docs/feldmapping) – manuelles Mapping im Detail
- [Limits & Kontingente](/docs/limits-und-kontingente) – alle Rate Limits auf einen Blick