CSV URL-Integration

Importieren Sie Dokumente direkt aus öffentlich zugänglichen CSV-Dateien über URL in die Wissensdatenbank Ihres KI-Assistenten.

---

Schnellstart

Beginnen Sie in 3 Schritten:

1. Navigieren: Verwaltung → Meine Assistenten → [Assistentenname] → Integrationen → CSV URL
2. URL hinzufügen: Geben Sie Ihre öffentliche CSV-URL ein und wählen Sie den Importtyp (FAQ/Produkt/Standard)
3. Importieren: Klicken Sie auf "URL hinzufügen" und überwachen Sie den Status

Tipp: Testen Sie zunächst mit einer kleinen CSV-Datei, um sich mit dem Prozess vertraut zu machen.

---

Was Sie tun können

• ✅ Importieren von öffentlichen HTTP/HTTPS CSV-URLs
• ✅ Mehrere URLs gleichzeitig im Bulk importieren
• ✅ Automatische Erkennung der CSV-Struktur (FAQ, Produkt oder allgemein)
• ✅ Kategorien zuweisen und benutzerdefinierte Spalten zuordnen
• ✅ Importstatus und -historie verfolgen

---

Voraussetzungen

• Administratorzugang zu Ihrem KI SmartTalk-Assistenten
• Öffentlich zugängliche CSV-Dateien (keine Authentifizierung erforderlich)
• Richtige CSV-Struktur mit Spaltenüberschriften
• UTF-8-Codierung empfohlen

---

Importtypen

1. FAQ-Import

Am besten geeignet für: Support-Dokumentation, Wissensdatenbanken

Erforderliche Spalten:

• question
• answer

Beispiel:

question,answer
"Wie setze ich mein Passwort zurück?","Klicken Sie auf 'Passwort vergessen' und folgen Sie den Anweisungen."
"Was sind Ihre Öffnungszeiten?","Montag-Freitag, 9 Uhr - 18 Uhr."

2. Produkt-Import

Am besten geeignet für: E-Commerce-Kataloge, Inventar

Erforderliche Spalte:

• idProduct (oder benutzerdefinierte zugeordnete Spalte)

Optional:

• name (oder benutzerdefinierte zugeordnete Spalte)

Beispiel:

idProduct,name,description,price
"PROD001","Premium Widget","Hochwertiger Widget","99.99"
"PROD002","Standard Widget","Basis Widget","49.99"

3. Standard-Import

Am besten geeignet für: Allgemeine Inhalte, gemischte Daten

• Erkennt automatisch die FAQ- oder Produktstruktur
• Fällt auf den allgemeinen Dokumentenimport zurück
• Verarbeitet verschiedene CSV-Formate

---

Schritt-für-Schritt-Anleitung

Schritt 1: Integration Zugreifen

1. Melden Sie sich bei AI SmartTalk an
2. Gehen Sie zu Administration → Meine Assistenten → [Ihr Assistent]
3. Klicken Sie auf Integrationen → CSV-URL

Schritt 2: CSV-URL Hinzufügen

Einzelne URL:

1. Klicken Sie auf Neue CSV-URL hinzufügen
2. Geben Sie die CSV-Datei-URL ein
3. Geben Sie einen optionalen Namen an
4. Wählen Sie den Importtyp (FAQ/Produkt/Standard)
5. Wählen Sie eine Kategorie (optional)
6. Klicken Sie auf URL hinzufügen

Massenimport:

1. Klicken Sie auf Massenimport-URLs
2. Geben Sie die URLs ein (eine pro Zeile)
3. Konfigurieren Sie die gemeinsamen Einstellungen
4. Klicken Sie auf Alle URLs importieren

Schritt 3: Spaltenzuordnung Konfigurieren (Nur Produkt)

Ordnen Sie Ihre CSV-Spalten den erwarteten Feldern zu:

• ID Produktspalte: Standard idProduct → Zuordnen zu product_id, sku usw.
• Namensspalte: Standard name → Zuordnen zu product_name, title usw.

Schritt 4: Import Überwachen

Verfolgen Sie den Status im Importverlauf:

• Ausstehend: Wartet auf Verarbeitung
• Importiert: Erfolgreich abgeschlossen
• Fehler: Fehlgeschlagen (Details anzeigen)

Schritt 5: Erneut importieren (Daten aktualisieren)

1. Finden Sie die URL im Verlauf
2. Klicken Sie auf Erneut importieren
3. Bestätigen Sie die Aktion
4. Überwachen Sie den aktualisierten Status

Schritt 6: Import Überprüfen

1. Überprüfen Sie die Wissensdatenbank auf neue Dokumente
2. Testen Sie den Chatbot mit Fragen zum importierten Inhalt

---

CSV-Anforderungen

Gültige URLs

✅ https://example.com/data/products.csv
✅ https://cdn.company.com/catalog.csv
✅ https://raw.githubusercontent.com/user/repo/main/data.csv

❌ ftp://files.company.com/data.csv (FTP nicht unterstützt)
❌ https://private.site.com/auth-data.csv (Authentifizierung erforderlich)
❌ file:///local/data.csv (Lokale Dateien nicht unterstützt)

Datei-Anforderungen

• Zugriff: Öffentlich zugänglich über HTTP/HTTPS
• Kopfzeilen: Die erste Zeile muss Spaltennamen enthalten
• Trennzeichen: Komma (,) oder Semikolon (;)
• Kodierung: UTF-8 empfohlen
• Größe: Maximal 10 MB pro Datei

---

Fehlersuche

Häufige Fehler

Fehler	Lösung
URL Nicht Zugänglich	Überprüfen Sie, ob die URL öffentlich und gültig ist
Ungültiges Format	Überprüfen Sie das Trennzeichen und die Kopfzeilen
Fehlende Spalten	Stellen Sie sicher, dass erforderliche Spalten vorhanden sind (Frage/Antwort oder idProduct)
Zeitüberschreitung bei großer Datei	Teilen Sie die Datei oder reduzieren Sie die Größe auf unter 10 MB

Lösungsschritte

1. Testen Sie die URL im Browser
2. Validieren Sie die CSV-Struktur und -Kodierung
3. Überprüfen Sie die Fehlermeldungen im Importverlauf
4. Testen Sie mit einer kleineren Beispieldatei
5. Kontaktieren Sie den Support, wenn das Problem weiterhin besteht

---

Best Practices

URL-Management

• Verwenden Sie stabile, permanente URLs
• Testen Sie URLs monatlich auf Zugänglichkeit
• Verwenden Sie CDN für bessere Leistung
• Fügen Sie die Version in Dateinamen ein: products-v2024.csv

Datenorganisation

• Verwenden Sie klare Kategorienamen
• Halten Sie konsistente CSV-Formate ein
• Bereinigen Sie Daten vor dem Import (leere Zeilen entfernen)
• Halten Sie Dateien unter 10MB

Leistung

• Testen Sie zuerst mit kleinen Proben
• Verarbeiten Sie große Importe während der Nebenzeiten
• Verwenden Sie den Massenimport für mehrere verwandte URLs
• Überwachen Sie regelmäßig die Erfolgsquote des Imports

---

Sicherheit

• ✅ HTTPS-verschlüsselte Übertragungen
• ✅ URL-Validierung
• ✅ Berechtigungsbasierte Zugriffskontrolle
• ✅ Temporäre Dateiverarbeitung (keine permanente Speicherung)
• ✅ Automatische Bereinigung alter Daten
• ✅ Prüfprotokolle für alle Aktivitäten

---

Nach dem Import

Sobald Ihre Daten importiert sind:

1. Werden sie in der Wissensdatenbank durchsuchbar
2. Unterstützen sie sofort die Antworten des Chatbots
3. Erscheinen sie organisiert nach Kategorien
4. Können sie im Abschnitt Wissensdatenbank überprüft werden

Überprüfen Sie Ihren Import:

• Überprüfen Sie die Wissensdatenbank auf neue Dokumente
• Testen Sie den Chatbot mit Fragen zu importierten Inhalten
• Überprüfen Sie Kategorien und Organisation

---

Unterstützung

Brauchen Sie Hilfe?

• 📧 E-Mail: contact@aismarttalk.tech
• 📚 Dokumente: https://docs.aismarttalk.tech/

---

Zusammenfassung

Sie können jetzt:

• ✅ CSV-Daten von öffentlichen URLs importieren
• ✅ FAQ-, Produkt- und allgemeine Datentypen verwalten
• ✅ Mehrere Quellen im Massenimport verarbeiten
• ✅ Benutzerdefinierte Spalten für Produkte zuordnen
• ✅ Importe überwachen und verwalten
• ✅ Daten durch erneute Importe aktualisieren

Nächste Schritte:

1. Testen Sie mit einer Beispiel-CSV
2. Importieren Sie Ihre Produktionsdaten
3. Richten Sie Kategorien ein
4. Planen Sie regelmäßige erneute Importe
5. Überwachen Sie die Leistung

Fragen? Kontaktieren Sie unser Support-Team jederzeit.