Einen Assistenten für Industriekataloge wie in unserer Demo bauen

Demo ansehen

Die Industriekatalog-Demo hilft Ingenieuren, von einer Spezifikationsfrage zu einer Kaufentscheidung zu gelangen. Sie können nach Teilenummer, Nennwert oder Schnittstelle suchen, Teile vergleichen, Bestand und Lieferzeit prüfen, ein Datenblatt öffnen und ein Live-Angebot erstellen, ohne den Katalog zu verlassen.

Diese Anleitung folgt dem Aufbau in der Reihenfolge, auf die es ankommt: Belege indexieren, die Suche zum schnellen Weg machen, Tools für echte Aktionen ergänzen und dann das Ergebnis testen.

1. Seiten und Dokumente indexieren

Legen Sie einen Memory-Datensatz an und erfassen Sie Produkt-, Kategorie-, Spezifikations- und Bestandsseiten. Nehmen Sie dann die Produktdokumente auf, die Details enthalten, die eine Produktkarte nicht bieten kann.

Platzieren Sie jedes Dokument auf der passenden Produktseite, damit der Crawler es indexieren und als Quelle zurückgeben kann. Ingenieure fragen nach Grenzwerten, Stromaufnahme, Reflow-Profilen und I²C-Adressen; diese Angaben stehen meist im PDF, nicht im Marketingtext.

Siehe Eine Wissensdatenbank aufbauen und Datenerfassungsjobs konfigurieren.

„Eine korrekte Zahl mit dem falschen Datenblatt dahinter ist trotzdem die falsche Antwort.“

2. Die Spezifikationssuche zum schnellen Weg machen

Ein Ingenieur, der seine Anforderung kennt, sollte sie eintippen und eine direkte Antwort mit Quellenangabe erhalten. Die Startseite beginnt daher mit einem Intelligenten Suchcenter, während ein Chat mit einem Anwendungsingenieur die tiefergehenden Fragen übernimmt, die Kontext oder Rückfragen brauchen.

Verwenden Sie einen Platzhaltertext, der den Suchstil vermittelt: „Suche nach Teilenummer, Spezifikation, Schnittstelle, Gehäuse oder Kategorie.“ Ist die Suche leer, zeigen Sie ausgewählte Teile, damit die Startseite weiterhin wie ein Katalog wirkt.

Eine Wissensdatenbank für beide Oberflächen nutzen

Sucherlebnis und Chat sind getrennte Konfigurationen, nutzen aber einen Datensatz. So bleiben alle Fakten konsistent, und Sie pflegen eine Datenblattrevision nur einmal.

• Quellen abgleichen. Suche und Chat rufen dieselben Teileinformationen ab.
• Funktionen dort lassen, wo sie hingehören. Formulare und verknüpfte Dienste gehören zum Assistenten; der gemeinsame Datensatz sorgt dafür, dass ihre Antworten auf demselben Katalog beruhen.
• Aufgaben klar trennen. Die Suche liefert eine schnelle Antwort mit Quellen. Der Chat ist für die nächste Frage da: „Welches ist bei großen Stückzahlen günstiger, und ist es auf Lager?“

Siehe Ein Suchcenter aufbauen und Retrieval im Suchcenter konfigurieren.

Dem Assistenten eine präzise Rolle geben

Konfigurieren Sie den schwebenden Assistenten als Anwendungsingenieur für diesen Katalog. Sein Verhalten sollte eindeutig sein:

• Antworten auf Basis indexierter Spezifikationen und Datenblätter geben.
• Das Teil oder Dokument zitieren, das die Antwort belegt.
• Teile über ihre Katalogkennung benennen.
• Für ein Angebot, eine Bestandsabfrage oder einen Selektor eine Live-Aktion nutzen, statt den Ablauf zu beschreiben.
• Offen sagen, wenn die Quellen eine Antwort nicht stützen.

Das ist mehr als eine Frage des Tons. Eine falsche Spannungs- oder Drehmomentangabe ist nicht nur eine schwache Empfehlung; sie kann zu einer Fehlbestellung führen. Siehe Einen Assistenten erstellen und Einen Assistenten starten.

3. Vorschläge nutzen, die zeigen, dass der Katalog antworten kann

Technische Vorschläge sollten echte Teile und echte Entscheidungen benennen. Jeder ist ein kleines Versprechen, das der Assistent halten muss.

• 3,3-V-I²C-Sensor für das CX-40
• Welche Module sind CE- und FCC-zertifiziert?
• CX-40: Datenblatt, Bestand und Lieferzeit
• CX-40 und CX-08 vergleichen

Diese Beispiele decken Spezifikationssuche, Compliance, Dokument- und Verfügbarkeitsabfrage sowie Vergleich ab. Siehe Nützliche Vorschläge für Ihr Suchcenter schreiben.

4. Aus einer Frage einen technischen Workflow machen

Textantworten decken „Wie hoch ist der Nennwert?“ ab. Eine Teileauswahl oder Kaufentscheidung braucht dagegen ein paar strukturierte Angaben. Die Demo erfasst sie mit kurzen Widgets direkt im Gespräch.

Jedes Widget ist ein Assistenten-Formular mit Auslöser, Feldern und einer Absendeaktion. Komplexe Widgets nutzen ein WIDGET-Feld: Die Vorlage enthält das Markup, Hilfsfunktionen verarbeiten Ereignisse, und ein verknüpfter Dienst liefert die Daten.

// A helper wired from the widget markup (oninput="skdwn.instance.helpers.ikcCompareSearch(event)").
function ikcCompareSearch(event) {
  skdwn.instance.executeProxyRequest('part-search', {}, (res) => {
    const matches = JSON.parse(res.payload.reply).matches;
    renderCompareRows(matches);
  }, { query: event.target.value });
}

Siehe Leads erfassen und Formulare nutzen.

5. Live-Aktionen des Katalogs anbinden

Nutzen Sie verknüpfte Dienste für Daten, die sich ändern: Selektorergebnisse, Preisstaffeln, Bestand und Lieferzeit. Der Assistent ruft jeden Dienst über seine ID auf, während der echte Endpunkt und alle Zugangsdaten serverseitig bleiben.

Registrieren Sie jeden Dienst mit ID, Methode und URL. Werte pro Aufruf gehören in {{params.x}}-Platzhalter:

part-quote  GET  https://your-site/api/quote?sku={{params.sku}}&quantity={{params.quantity}}

Liefern Sie eine kleine Antwort zurück, die das Gespräch direkt darstellen kann:

{
  "reply": "**Quote VC-Q-560146** — 20 × CX-40 — **Total EUR 699** — lead time 4 days",
  "references": [
    { "title": "CX-40 Cortex-M4 Dev Board", "url": "/demos/industrial-catalog/product/cx40-dev-board" }
  ]
}

Verwenden Sie GET für explorative Widget-Abfragen wie Typeahead und POST für ein bewusstes Absenden eines Formulars, etwa einer Angebotsanfrage. Senden Sie aus dem Dienst einen normalen Browser-User-Agent, damit eine WAF die Anfrage nicht stillschweigend blockiert. Siehe Verknüpfte Dienste.

6. Modus und Erscheinungsbild an die Seite anpassen

Derselbe Assistent sollte nicht überall gleich auftreten.

Nutzen Sie seitenbezogene Metadaten für Beschreibung, Vorschläge und Kontext. Halten Sie auf einer Produktseite Fragen an dieses Teil gebunden. Schaffen Sie auf einer Kontoseite Raum für ein Gespräch über Bestellungen und Angebote.

Passen Sie Marken- und Akzentfarben, Flächen, Texte, Schaltflächen und den Kopfbereich der Suche an den Katalog an. Gestalten Sie Formularfelder genauso sorgfältig wie den Widget-Rahmen, damit Vergleichs- und Angebotstools wie ein Teil des Produkterlebnisses wirken. Siehe den Abschnitt zum Erscheinungsbild in Einen Assistenten starten.

7. Einbettung und Einkäuferkontext hinzufügen

Laden Sie die Runtime einmal und starten Sie dann die Suche und den Anwendungsingenieur-Assistenten jeweils in einem eigenen Container.

<div id="seekdown-assistant-root"></div>
<script src="https://saas.seekdown.ai/js/seekdown-assistant.js"></script>
<script>
  // Spec search center and floating application engineer on the same page.
  skdwn.startAssistant({ assistantId: 'catalog-search', container: '#catalog-search',
    config: { settings: { baseTemplate: 'overlay' } } });
  skdwn.startAssistant({ assistantId: 'application-engineer', container: '#app-engineer',
    config: { settings: { floatingActionButton: { useFloatingActionButton: true } } } });
</script>

Übergeben Sie für das Geschäftskundenkonto beim Laden des Assistenten userId und einen knappen additionalContext. Jede kontobezogene Antwort kann diesen Kontext dann nutzen, während die private Abfrage hinter einem verknüpften Dienst bleibt.

Tragen Sie die Website vor dem Start bei den erlaubten Origins ein und erzeugen Sie einen API-Schlüssel. Siehe Einen Assistenten bereitstellen.

8. Die Belege testen und aktuell halten

Testen Sie den Katalog so, wie ein Ingenieur ihn nutzen würde:

• Exakte Teilenummern und Spezifikationsanforderungen.
• Fragen zu Zertifizierungen und das Abrufen von Dokumenten.
• Ein Angebot für eine realistische Menge und eine Bestandsabfrage.
• Nicht abgedeckte Anfragen.

Prüfen Sie bei jedem Ergebnis die Antwort und ihre Quelle. Eine korrekte Zahl, die auf das falsche Datenblatt verweist, ist trotzdem ein Fehler.

Prüfen Sie nach jeder Überarbeitung von Katalog oder Dokumenten die neue Angabe in der Quelle, im Datensatz und in der Antwort des Assistenten. Planen Sie die Erfassungen passend zur Änderungsrate von Katalog und Datenblättern.

Die Integration mit einem MCP-Client bauen

Endpunkt-Anbindung, Widget-Hilfsfunktionen, Einbettung und Verhaltensanweisungen eignen sich gut als Aufgabe für einen MCP-Client wie Claude Code, GitHub Copilot oder Codex. Geben Sie ihm ein konkretes Briefing und prüfen Sie anschließend Datenverträge und Ergebnisse: „Teile nach Spezifikation finden, vergleichen, für eine Menge ein Angebot erstellen und den Bestand prüfen.“ Siehe MCP-Clients verbinden.

Verwandte Themen: Eine Wissensdatenbank aufbauen · Ein Suchcenter aufbauen · Einen Assistenten erstellen · Verknüpfte Dienste · Einen Assistenten bereitstellen · MCP-Clients verbinden. Die Variante dieses Aufbaus für einen Endkunden-Shop finden Sie unter So wurde die Retail-Demo gebaut.