> ## Documentation Index
> Fetch the complete documentation index at: https://docs.armin.cx/llms.txt
> Use this file to discover all available pages before exploring further.
# CSV-Produktfeed
> Produktkatalog per CSV-URL importieren, damit Klassische KI Produktfragen beantwortet.
Der CSV-Produktfeed importiert Produkte aus einer CSV-Datei unter einer öffentlichen URL in Chatarmin CX. Nutze ihn, wenn deine Produkte nicht in einem Shopsystem liegen, das cx direkt anbindet, zum Beispiel ein ERP-Export, ein PIM-Feed oder eine Tabelle. Nach dem Import kann ein Agent der Klassischen KI den Katalog nutzen, um Fragen zu Produkten, Preisen und Verfügbarkeit zu beantworten.
Der Feed ist nur eine Produktquelle für die **Klassische KI**. [KI-Agenten](/de/ai-agents/intro) lesen keine Produkte aus CSV-Feeds. Wenn du auf KI-Agenten umsteigst, sieh dir [Klassische KI ersetzen](/de/ai-agents/migrate-from-classic-ai) an.
## Wann du es brauchst
Nutze einen CSV-Produktfeed, wenn:
* dein Katalog in einem System ohne native cx-Integration liegt
* du einen CSV-Export unter einer URL bereitstellen kannst, die cx herunterladen kann
* ein Agent der Klassischen KI Produkte empfehlen und Preise, Größen, Farben oder Lagerbestand nennen soll
Wenn du über Shopify verkaufst, verbinde stattdessen [Shopify](/de/integrations/shopify).
## Feed einrichten
Stell deine CSV unter einer URL bereit, die die Datei direkt und ohne Login herunterlädt. Teile die Datei bei Google Drive als **Jeder mit dem Link kann ansehen**. Bei Dropbox funktioniert ein normaler Freigabelink.
[Öffne Integrationen](https://armin.cx/app/_/settings/integrations) in den Workspace-Einstellungen und wähle **CSV Product Feed**.
Klick auf **Verbinden**. Trag einen **Integration Name** (eine Bezeichnung für dein Team) und die **CSV URL** ein und klick im Dialog auf **Connect**. cx startet den ersten Import sofort.
Klick unter deinen verbundenen Konten auf den Feed. Die Box **Sync Status** zeigt nach dem Import **Synced** mit der Anzahl der Produkte und Varianten, oder **Failed** mit der Fehlermeldung.
Öffne den Agenten der Klassischen KI, geh zu **Quellen** → **AI Integrations** und wähle **CSV Product Feed**. Klick unter **Connected Feeds** neben deinem Feed auf **Connect**. Der Feed zeigt dann das Badge **Connected**.
Du kannst einen Feed mit mehreren Agenten der Klassischen KI verknüpfen, und ein Agent kann mehrere Feeds nutzen. Um einen Feed zu lösen, klick unter **Connected Feeds** auf das Entfernen-Symbol daneben.
## CSV vorbereiten
cx nutzt keine feste Vorlage. Beim Import liest cx die Kopfzeile und einige Beispielzeilen und ermittelt per KI, welche Spalte welches Produktdetail enthält. Spaltennamen auf Deutsch oder Englisch funktionieren, zum Beispiel `Artikelnummer` oder `Preis`.
Jede Datei braucht mindestens:
* eine Spalte mit der **Produkt-ID**. Fehlt sie, kann cx eine Spalte mit der Produkt-URL nutzen und den letzten Teil der URL als ID nehmen.
* eine Spalte mit dem **Produkttitel**
Außerdem erkennt cx Beschreibung, Kurzbeschreibung, Produkt-URL, Bild-URL, Status, Tags, Hersteller, Produkttyp, Varianten-ID, Variantentitel, Preis, SKU, Lagermenge, Verfügbarkeit, Größe und Farbe. Weitere nützliche Spalten werden als zusätzliche Produktdetails gespeichert.
Eine Datei mit diesen Spaltennamen wird zum Beispiel sauber zugeordnet:
```csv theme={null}
product_id,title,description,price,sku,size,color,in_stock,url,image_url
```
So werden aus Zeilen Produkte:
* **Varianten**: Zeilen mit derselben Produkt-ID werden zu einem Produkt, jede Zeile wird eine Variante (zum Beispiel eine Zeile pro Größe).
* **Preise**: Schreib Preise wie `1234.56`, `1234,56` oder `1.234,56`. Währungssymbole sind erlaubt. Vermeide Kommas als Tausendertrennzeichen: `1,234.56` wird falsch gelesen. Die Währung kommt aus dem Symbol im Preis der ersten Zeile (`€`, `$`, `£`, `¥`), Standard ist EUR.
* **Verfügbarkeit**: Werte wie `yes`, `true`, `1`, `in stock` oder `available` gelten als verfügbar. `no`, `false`, `0`, `out of stock` oder `unavailable` gelten als nicht verfügbar.
* **Status**: `inactive`, `draft`, `hidden` oder `archived` markieren ein Produkt als inaktiv. Inaktive Produkte werden aus dem Wissen des Agenten entfernt.
* Zeilen ohne Produkt-ID werden übersprungen.
* Komma, Semikolon, senkrechter Strich und Tab funktionieren als Trennzeichen.
## So funktioniert die Synchronisierung
cx importiert den Feed:
* beim ersten Verbinden
* wenn du in der Box **Sync Status** des Feeds auf **Re-sync Products** klickst
* wenn du den Feed mit einem Agenten der Klassischen KI verknüpfst und der letzte Import älter als 12 Stunden ist
Es gibt **keinen automatischen Zeitplan**. Wenn du die Datei unter der URL aktualisierst, klick auf **Re-sync Products**, damit cx die Änderungen übernimmt. Ein Re-sync erkennt die Spalten außerdem neu, umbenannte oder neue Spalten werden also berücksichtigt.
Produkte werden über die Produkt-ID zugeordnet. Eine geänderte Zeile aktualisiert also das bestehende Produkt, statt ein Duplikat anzulegen.
Wenn du eine Zeile aus der CSV löschst, wird das Produkt in cx **nicht** entfernt. Damit ein Agent ein Produkt nicht mehr anbietet, behalte die Zeile und setz ihren Status auf `inactive` oder löse den Feed vom Agenten.
## Feed entfernen
Öffne in den [Integrationen](https://armin.cx/app/_/settings/integrations) **CSV Product Feed**, öffne am Feed das Menü **Connected** und wähle **Disconnect**. Bestätige mit **Delete**.
## Fehlerbehebung
### Der Status zeigt Failed
* Öffne die CSV-URL in einem privaten Browserfenster. Siehst du eine Webseite oder einen Login statt eines Datei-Downloads, kann cx die Datei auch nicht lesen. Korrigiere die Freigabe und klick auf **Re-sync Products**.
* Prüfe bei Google Drive, ob die Datei als **Jeder mit dem Link kann ansehen** geteilt ist.
* Meldet der Fehler, dass keine Spalte für Produkt-ID oder Titel gefunden wurde, ergänze eindeutige Spaltennamen dafür und synchronisiere erneut.
### Produkte fehlen oder Details stimmen nicht
* Prüfe, ob die Zeile eine Produkt-ID hat. Zeilen ohne ID werden übersprungen.
* Zeilen mit derselben Produkt-ID werden zu einem Produkt zusammengeführt. Gib Produkten eigene IDs, falls sie versehentlich zusammengeführt wurden.
* Klick nach Änderungen an den Spaltennamen auf **Re-sync Products**, damit cx die Spalten neu erkennt.
### Der Agent der Klassischen KI erwähnt die Produkte nicht
* Prüfe, ob der Feed unter **Quellen** → **AI Integrations** → **CSV Product Feed** des Agenten als **Connected** angezeigt wird.
* Prüfe, ob die Produkte in der CSV nicht als inaktiv markiert sind.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.