2. Daten anbinden

Klariton ist ein beratender Layer über Ihrer bestehenden Shop- oder SaaS-Seite. Damit daraus persona-genaue, quellenbelegte Antworten werden, braucht Klariton Zugang zu Ihrem Wissen: Produktdaten, Dokumente, Texte. Dieser Abschnitt erklärt, welche Quellen Sie anbinden können und wie Sie dabei vorgehen.

Es gibt zwei Arten von Wissen, die Sie einspielen:

• Produktdaten — strukturierte Informationen zu Ihren Produkten (Name, Beschreibung, Preis, Verfügbarkeit, Eigenschaften). Quelle: Shopify, CSV oder API.
• Material — unstrukturiertes Wissen: Dokumente und Webseiten (Ratgeber, Handbücher, FAQ-Seiten, Hersteller-Infos). Quelle: Datei-Upload oder URL-Crawl.

Aus beidem entsteht Ihre Wissensbasis — die Grundlage, aus der Klariton später die Antworten (BIQs) generiert.

Best Practice: Die Qualität Ihrer Quellen bestimmt die Qualität Ihrer Antworten — “garbage in, garbage out”. Binden Sie zuerst Ihre verlässlichsten, offiziellsten Quellen an. Veraltete oder widersprüchliche Inhalte erzeugen veraltete oder widersprüchliche Antworten.

Shopify anbinden (LIVE)

Wenn Ihr Shop auf Shopify läuft, ist die Shopify-Anbindung der schnellste Weg, Ihren kompletten Produktkatalog in Klariton zu bringen.

So funktioniert die Verbindung

Die Anbindung läuft über den offiziellen Shopify-OAuth-Flow:

1. Sie starten die Verbindung in Klariton und geben Ihre Shop-Domain an (z. B. ihr-shop.myshopify.com).
2. Sie werden zu Shopify weitergeleitet und autorisieren Klariton dort.
3. Shopify leitet Sie zurück, die Verbindung steht. Klariton zieht anschließend Ihre Produktdaten.

Klariton arbeitet ausschließlich lesend. Es werden nur Lese-Berechtigungen angefragt (Produkte, Produkt-Listings, Inventar, Content). Klariton schreibt nichts in Ihren Shop zurück, verändert keine Produkte und zieht keine Kundendaten oder Bestellungen. Das Zugriffs-Token wird verschlüsselt gespeichert (AES-256-GCM).

Was übernommen wird

Pro Produkt importiert Klariton unter anderem Name, Beschreibung, Hersteller/Vendor, Produkttyp, Kategorien, Tags, Bilder, Preis, Vergleichspreis, Währung und Verfügbarkeit. Zusätzlich werden Metafelder (Metafields) vollständig und unverändert übernommen — die kundenspezifischen Zusatzfelder, in denen oft die entscheidenden Produktdetails stecken.

Re-Sync und veraltete Daten

Klariton merkt sich, wann der letzte Abgleich stattfand und ob er erfolgreich, teilweise oder fehlerhaft war. Wenn Shopify neue oder geänderte Produktdaten liefert, werden die betroffenen Produkte als veraltet (stale) markiert. Das ist ein Hinweis darauf, dass eine erneute Antwort-Generierung sinnvoll sein kann, damit Ihre BIQs den aktuellen Stand widerspiegeln. Nach einem erfolgreichen Re-Sync und einer erneuten Generierung verschwindet der Hinweis wieder.

Den Verbindungsstatus sehen Sie jederzeit: verbunden, widerrufen oder fehlerhaft. Eine Verbindung lässt sich widerrufen — danach zieht Klariton keine weiteren Daten.

Best Practice: Lassen Sie die Verbindung bestehen, statt sie nach dem ersten Import zu trennen. So erkennt Klariton Produktänderungen und kann Sie auf veraltete Antworten hinweisen.

Produktdaten per CSV oder API anbinden (LIVE)

Läuft Ihr Shop nicht auf Shopify oder möchten Sie Produktdaten unabhängig pflegen, können Sie sie auch per CSV oder über eine API einspielen. Die Produkte werden dabei nach demselben Modell abgelegt wie bei Shopify (inklusive Eigenschaften und Zusatzfeldern), die Herkunft wird intern als CSV bzw. manuell vermerkt.

Andere Systeme oder Sonderfälle: Integrationen jenseits von Shopify, CSV und API sind auf Anfrage möglich. Sprechen Sie uns an, wenn Sie eine spezifische Quelle anbinden möchten.

Material anbinden: Dokumente und Webseiten (LIVE)

Über Produktdaten hinaus lebt eine gute Beratung von Hintergrundwissen: Ratgeber, Handbücher, Pflegehinweise, Hersteller-Texte. Dieses Wissen binden Sie als Material an — auf zwei Wegen.

Variante A: Dateien hochladen

Sie laden Dokumente direkt hoch. Unterstützte Formate:

• PDF
• DOCX (Word)
• Markdown (MD)
• Text (TXT)

Optional können Sie beim Upload die Sprache des Dokuments angeben — das hilft Klariton bei der korrekten Verarbeitung mehrsprachiger Wissensbasen.

Variante B: URL crawlen

Statt eine Datei hochzuladen, geben Sie eine URL an. Klariton ruft die Seite ab, extrahiert den lesbaren Hauptinhalt (ohne Navigation, Banner und Beiwerk) und übernimmt ihn als Material. Es wird zusätzlich ein Schnappschuss der Seite gesichert, sodass nachvollziehbar bleibt, in welchem Zustand die Seite zum Zeitpunkt des Abrufs war.

Vom Material zur Wissensbasis: was im Hintergrund passiert

Nach dem Anbinden durchläuft jedes Material automatisch mehrere Schritte:

1. Verarbeitung (Parsing): Klariton liest den Inhalt aus und zerlegt ihn in sinnvolle Abschnitte.
2. Embeddings: Die Abschnitte werden in eine durchsuchbare Form überführt (Embeddings). Erst dadurch wird das Wissen für Klariton inhaltlich auffindbar und nutzbar.
3. Aufnahme in die Wissensbasis: Die fertig verarbeiteten Abschnitte stehen als Grundlage für die Antwort-Generierung bereit.

Den Status sehen Sie pro Material. Mögliche Zustände sind unter anderem: in Warteschlange, in Verarbeitung, fertig verarbeitet, teilweise verarbeitet oder fehlgeschlagen. Beim URL-Crawl kann zusätzlich der Hinweis erscheinen, dass die Seite den Abruf vermutlich blockiert hat (z. B. durch einen Bot-Schutz) — dann wird das Material zur Sicherheit nicht automatisch weiterverarbeitet, damit keine fehlerhaften Inhalte in Ihre Wissensbasis gelangen.

Best Practice: Markieren Sie offizielle, verlässliche Quellen entsprechend. Klariton belegt jede Antwort mit ihren Quellen und bewertet, wie gut sie abgesichert ist. Eine Aussage, die von mindestens zwei Ihrer Quellen gedeckt ist, erreicht das höchste Vertrauens-Level (CONFIRMED). Je sauberer und offizieller Ihre Quellenlage, desto höher die Confidence Ihrer Antworten.

Wie sich die Quellenlage auf die Antwort-Qualität auswirkt

Jede generierte Antwort (BIQ) trägt ein Confidence-Level, das direkt aus Ihrer Quellenlage abgeleitet wird:

• CONFIRMED — durch mehrere (mindestens zwei) Ihrer eigenen Quellen gedeckt. Höchstes Vertrauen.
• SINGLE_SOURCE — durch genau eine Ihrer Quellen gedeckt.
• EXTERNAL — nicht durch Ihre Quellen, aber durch externe Daten gestützt.
• INFERRED — weder durch Ihre noch durch externe Quellen belegt, sondern vom System abgeleitet.

Das bedeutet konkret: Je mehr verlässliches, sich gegenseitig bestätigendes Material Sie anbinden, desto mehr Ihrer Antworten erreichen das CONFIRMED-Level — und desto stärker steht Ihre Beratung auf belegtem Boden. Wie Sie mit den einzelnen Levels umgehen und welche Antworten ausgespielt werden, behandeln die Abschnitte zu Personas, BIQ-Generierung und Kuratierung.

Reihenfolge in der Praxis

Empfohlener Einstieg:

1. Produktkatalog anbinden — Shopify verbinden oder per CSV/API einspielen. Das gibt Klariton die strukturierte Basis Ihres Sortiments.
2. Kern-Material ergänzen — Ihre wichtigsten Ratgeber, Handbücher und offiziellen Texte als Datei oder per URL anbinden.
3. Verarbeitung abwarten — bis die Materialien den Status “fertig verarbeitet” erreicht haben und Teil der Wissensbasis sind.
4. Weiter zu Personas und BIQ-Generierung — sobald die Wissensbasis steht, definieren Sie Ihre Personas und lassen Klariton daraus Antworten generieren.

Best Practice: Starten Sie fokussiert mit wenigen, hochwertigen Quellen statt mit allem auf einmal. So sehen Sie früh, wie gut Klariton aus Ihrem Wissen Antworten formt, und können die Quellenlage gezielt erweitern, wo Antworten noch zu schwach belegt sind.