Créer un assistant de catalogue industriel comme notre démo

Voir la démo

La démo de catalogue industriel aide les ingénieurs à passer d’une question de spécification à une décision d’achat. Ils peuvent chercher par référence, caractéristique nominale ou interface ; comparer des composants ; vérifier le stock et le délai ; ouvrir une fiche technique ; et établir un devis en direct sans quitter le catalogue.

Ce guide suit la construction dans l’ordre qui compte : indexer les preuves, faire de la recherche le chemin rapide, ajouter des outils pour les actions réelles, puis tester le résultat.

1. Indexer les pages et les documents

Créez un jeu de données mémoire et capturez les pages produits, catégories, spécifications et stock. Ajoutez ensuite les documents produits qui contiennent les détails qu’une fiche produit ne peut pas donner.

Placez chaque document sur la page produit correspondante afin que le robot d’exploration puisse l’indexer et le renvoyer comme source. Les ingénieurs posent des questions sur les valeurs maximales, la consommation de courant, les profils de refusion et les adresses I²C ; ces informations se trouvent généralement dans le PDF, pas dans le texte marketing.

Consultez Créer une base de connaissances et Configurer les tâches de capture de données.

« Un chiffre correct adossé à la mauvaise fiche technique reste une mauvaise réponse. »

2. Faire de la recherche par spécification le chemin rapide

Un ingénieur qui connaît sa contrainte doit pouvoir la saisir et obtenir une réponse directe et sourcée. La page d’accueil met donc en avant un centre de recherche intelligent, tandis qu’un chat d’ingénieur d’application traite les questions plus poussées qui demandent du contexte ou des échanges.

Utilisez un texte indicatif qui enseigne le style de requête : « Recherchez par référence, spécification, interface, boîtier ou catégorie. » Lorsque la recherche est vide, affichez des composants mis en avant pour que la page d’accueil reste un catalogue.

Utiliser une seule base de connaissances pour les deux interfaces

L’expérience de recherche et le chat sont des configurations distinctes, mais ils utilisent un seul jeu de données. Chaque information reste ainsi cohérente et vous ne mettez à jour une révision de fiche technique qu’une seule fois.

• Aligner les sources. La recherche et le chat récupèrent les mêmes informations sur les composants.
• Placer chaque capacité au bon endroit. Les formulaires et les services connectés appartiennent à l’assistant ; le jeu de données partagé maintient leurs réponses ancrées dans le même catalogue.
• Garder des rôles distincts. La recherche sert à obtenir une réponse rapide et sourcée. Le chat sert à la question suivante : « Lequel est le moins cher en volume, et est-il en stock ? »

Consultez Créer un centre de recherche et Configurer la récupération d’un centre de recherche.

Donner à l’assistant un rôle précis

Configurez l’assistant flottant comme ingénieur d’application pour ce catalogue. Son comportement doit être sans ambiguïté :

• Répondre à partir des spécifications et fiches techniques indexées.
• Citer le composant ou le document qui étaye la réponse.
• Identifier les composants par leur identifiant catalogue.
• Utiliser une action en direct pour un devis, une vérification de stock ou un sélecteur, plutôt que d’expliquer comment le faire.
• Indiquer quand les sources ne permettent pas de répondre.

Il ne s’agit pas seulement de ton. Une tension ou un couple erronés ne sont pas qu’une recommandation médiocre : ils peuvent mener à une mauvaise commande. Consultez Créer un assistant et Lancer un assistant.

3. Utiliser des suggestions qui prouvent que le catalogue sait répondre

Les suggestions techniques doivent nommer de vrais composants et de vraies décisions. Chacune est une petite promesse que l’assistant doit tenir.

• Capteur I²C 3,3 V pour le CX-40
• Quels modules sont certifiés CE et FCC ?
• Fiche technique, stock et délai du CX-40
• Comparer le CX-40 et le CX-08

Ces exemples couvrent une recherche par spécification, la conformité, la recherche de documents et de disponibilité, et la comparaison. Consultez Rédiger des suggestions utiles pour un centre de recherche.

4. Transformer une question en processus technique

Les réponses textuelles traitent « Quelle est la valeur nominale ? ». Le choix d’un composant ou une décision d’achat nécessite quelques informations structurées. La démo les recueille avec de courts widgets intégrés à la conversation.

Chaque widget est un formulaire d’assistant avec un déclencheur, des champs et une action d’envoi. Les widgets riches utilisent un champ WIDGET : le modèle contient le balisage, des fonctions d’aide gèrent les événements et un service connecté fournit les données.

// 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 });
}

Consultez Capturer des prospects avec des formulaires.

5. Connecter les actions du catalogue en direct

Utilisez des services connectés pour les données qui changent : résultats du sélecteur, paliers de prix, stock et délai. L’assistant appelle chaque service par son ID, tandis que le véritable point de terminaison et les éventuels identifiants restent côté serveur.

Enregistrez chaque service avec un ID, une méthode et une URL. Placez les valeurs propres à chaque appel dans des espaces réservés {{params.x}} :

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

Renvoyez une réponse courte que la conversation peut afficher directement :

{
  "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" }
  ]
}

Utilisez GET pour les recherches exploratoires des widgets, comme l’autocomplétion, et POST pour un envoi de formulaire délibéré, comme une demande de devis. Envoyez un User-Agent de navigateur standard depuis le service afin qu’un WAF ne bloque pas silencieusement la requête. Consultez Services connectés.

6. Adapter le mode et l’apparence à la page

Un même assistant ne doit pas se présenter de la même façon partout.

Utilisez des métadonnées par page pour la description, les suggestions et le contexte. Sur une page produit, gardez la question liée à ce composant. Sur une page de compte, laissez place à une conversation sur les commandes et les devis.

Accordez les couleurs de marque et d’accent, les surfaces, le texte, les boutons et l’en-tête de recherche au catalogue. Stylisez les champs de formulaire avec autant de soin que le cadre du widget, pour que les outils de comparaison et de devis fassent partie intégrante de l’expérience produit. Consultez la section sur l’apparence de Lancer un assistant.

7. Ajouter l’intégration et le contexte de l’acheteur

Chargez le script d’exécution une seule fois, puis démarrez la recherche et l’assistant d’ingénieur d’application dans leurs propres conteneurs.

<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>

Pour le compte professionnel, transmettez userId et un additionalContext concis au chargement de l’assistant. Chaque réponse liée au compte peut alors utiliser ce contexte, tandis que la recherche privée reste derrière un service connecté.

Avant le lancement, ajoutez le site aux origines autorisées et générez une clé d’API. Consultez Déployer un assistant.

8. Tester les preuves et les garder à jour

Testez le catalogue comme le ferait un ingénieur :

• Références exactes et contraintes de spécification.
• Questions de certification et récupération de documents.
• Un devis pour une quantité réelle et une vérification de stock.
• Demandes non couvertes.

Pour chaque résultat, vérifiez la réponse et sa source. Un chiffre correct qui renvoie à la mauvaise fiche technique reste un défaut.

Après toute révision du catalogue ou d’un document, vérifiez la nouvelle information dans la source, le jeu de données et la réponse de l’assistant. Planifiez les captures au rythme des changements du catalogue et des fiches techniques.

Construire l’intégration avec un client MCP

Le code de liaison des points de terminaison, les fonctions d’aide des widgets, l’intégration et les instructions de comportement sont autant de tâches adaptées à un client MCP comme Claude Code, GitHub Copilot ou Codex. Donnez-lui un brief précis, puis vérifiez les contrats de données et les résultats : « Trouver des composants par spécification, les comparer, chiffrer une quantité et vérifier le stock. » Consultez Connecter des clients MCP.

À lire aussi : Créer une base de connaissances · Créer un centre de recherche · Créer un assistant · Services connectés · Déployer un assistant · Connecter des clients MCP. Pour la version boutique grand public de cette configuration, consultez Comment la démo de boutique en ligne a été construite.