Knowledge base chatbot Shopify : comment structurer ses documents pour un RAG vraiment utile

Un assistant IA n'est aussi bon que les documents qu'on lui donne à lire. Pourtant, la majorité des marchands qui branchent un chatbot sur leur boutique Shopify commettent la même erreur : ils uploadent un PDF fourre-tout de 40 pages et s'étonnent que les réponses soient floues, incomplètes ou hors sujet.

Le problème n'est pas l'IA. C'est la structure des sources.

Cet article explique pourquoi la qualité du chunking dépend directement de la façon dont vous organisez vos documents, et vous donne un template concret de 5 fichiers à préparer avant de brancher un assistant IA sur votre boutique.

Pourquoi un PDF mal structuré sabote votre RAG

Le RAG (Retrieval-Augmented Generation) est la technique qui permet à un assistant IA de chercher dans vos propres documents avant de répondre. Concrètement : le système découpe vos fichiers en morceaux (les "chunks"), les vectorise, les stocke dans une base de données spécialisée, puis récupère les plus pertinents au moment où un visiteur pose une question.

Le point critique : la qualité du chunk détermine la qualité de la réponse.

Si votre document mélange la politique de retour, les délais de livraison, les matières de vos produits et vos CGV dans un seul bloc de texte, le système va découper ce bloc de façon arbitraire. Un chunk peut se retrouver à cheval entre deux sujets sans lien. Résultat : quand un client demande "combien de temps j'ai pour retourner mon article ?", le système récupère un chunk qui parle à moitié de retours et à moitié de délais d'expédition. La réponse sera confuse.

À l'inverse, un document dédié à la politique de retour, avec des sections courtes et des formulations directes, produit des chunks cohérents. La réponse est précise, complète, et formulée dans le ton de votre marque.

comment fonctionne un assistant IA pour Shopify

La différence entre un document RAG utile et un document RAG inutile

Ce qui ne fonctionne pas

• Un PDF de CGV de 30 pages avec du jargon juridique dense

• Une FAQ copiée-collée depuis votre back-office, sans mise en forme

• Un document Word avec des tableaux imbriqués, des images et des notes de bas de page

• Un fichier qui répond à 15 questions différentes dans le même paragraphe

Ce qui fonctionne

• Un fichier par intention client (retours, livraison, tailles, matières, paiement)

• Des phrases courtes, à la voix active, sans tournures passives

• Des formulations proches de ce que le client va taper dans le chat

• Des titres de section explicites ("Délai de retour", pas "Article 4.2 - Conditions de renvoi")

• Des listes à puces pour les conditions et les étapes

La règle d'or : un document = une intention client. Si vous hésitez à séparer deux sujets, séparez-les.

Les 5 documents à préparer avant de brancher votre chatbot

Voici un template minimal pour une boutique Shopify dans les verticales mode, beauté ou maison. Ces 5 fichiers couvrent 80% des questions posées en SAV selon les benchmarks sectoriels rapport WISMO 2023 – LateShipment.com.

Document 1 : Politique de retour

Contenu attendu :

• Délai pour initier un retour (ex : "Vous avez 30 jours à compter de la réception de votre commande.")

• Conditions d'éligibilité (état de l'article, étiquettes, hygiène pour la lingerie, etc.)

• Processus étape par étape ("1. Connectez-vous à votre espace client. 2. Sélectionnez la commande concernée. 3...")

• Délai de remboursement

• Exceptions (articles soldés, personnalisés, etc.)

Formulation à privilégier :

"Vous pouvez retourner votre article dans un délai de 30 jours. L'article doit être non porté, non lavé, avec son étiquette d'origine. Le remboursement est effectué sous 5 à 7 jours ouvrés après réception du colis."

Document 2 : Livraison et délais

Contenu attendu :

• Délais par transporteur et par zone géographique

• Délai de préparation avant expédition

• Politique de livraison offerte (seuil, conditions)

• Que faire si le colis est en retard ou perdu

• Numéro de suivi : comment le trouver

Formulation à privilégier :

"La livraison en France métropolitaine prend entre 2 et 4 jours ouvrés après expédition. Votre commande est expédiée sous 24h (jours ouvrés). Vous recevez un email avec votre numéro de suivi dès l'expédition."

Document 3 : Guide des tailles

C'est le document le plus souvent négligé, et pourtant l'un des plus consultés en pré-achat.

Contenu attendu :

• Tableau de correspondance tailles FR / EU / UK / US

• Comment prendre ses mesures (tour de poitrine, tour de taille, longueur d'entrejambe)

• Conseils de coupe par gamme de produits ("La coupe de notre jean est slim : si vous hésitez entre deux tailles, prenez la taille au-dessus.")

• Informations sur l'élasticité des matières si pertinent

À éviter : un tableau en image. Le RAG ne lit pas les images. Convertissez en texte brut ou en tableau Markdown.

Document 4 : Matières et entretien

Particulièrement utile pour la mode, la maison et la beauté.

Contenu attendu :

• Composition des principales gammes de produits

• Instructions d'entretien par matière

• Engagements qualité ou écoresponsabilité si c'est un argument de marque

• Allergènes ou ingrédients pour la beauté

Formulation à privilégier :

"Nos pulls en laine mérinos se lavent à la main à 30°C ou en machine avec le programme laine. Ne pas essorer. Sécher à plat."

Document 5 : Paiement et sécurité

Contenu attendu :

• Moyens de paiement acceptés

• Sécurité des transactions (HTTPS, 3D Secure)

• Politique de paiement en plusieurs fois si disponible

• Que faire en cas de problème de paiement

• Facturation et TVA pour les professionnels

Formulation à privilégier :

"Nous acceptons les cartes Visa, Mastercard, American Express, PayPal et Apple Pay. Toutes les transactions sont sécurisées par le protocole 3D Secure."

automatiser le SAV Shopify avec un assistant IA

Conseils de mise en forme pour optimiser le chunking

La structure interne de chaque document compte autant que son contenu. Quelques règles pratiques :

• Utilisez des titres H2/H3 explicites : le système de chunking s'appuie souvent sur les séparateurs sémantiques pour délimiter les blocs.

• Préférez le Markdown ou le texte brut aux fichiers Word avec mise en forme complexe. Un fichier .md ou .txt est parsé plus proprement qu'un .docx avec styles personnalisés.

• Gardez les paragraphes courts : 3 à 5 phrases maximum. Un chunk de 150 mots bien ciblé vaut mieux qu'un bloc de 500 mots qui mélange tout.

• Répétez le contexte clé en début de section : ne supposez pas que le système sait de quoi parle la section précédente. Chaque section doit être compréhensible seule.

• Évitez les pronoms ambigus : "il", "elle", "ce dernier" n'ont pas de contexte dans un chunk isolé. Répétez le sujet explicitement.

Best practices for RAG with Claude – Anthropic

Comment Navi exploite votre knowledge base

Navi utilise pgvector pour stocker et interroger les vecteurs de votre knowledge base. Concrètement : quand un visiteur pose une question sur votre boutique, l'assistant effectue une recherche sémantique dans vos documents avant de formuler sa réponse. Ce n'est pas une recherche par mots-clés : c'est une recherche par sens, ce qui signifie qu'une question formulée différemment peut quand même trouver le bon chunk.

Mais cette recherche ne peut récupérer que ce qui existe dans les documents. Si votre politique de retour n'est pas uploadée, ou si elle est noyée dans un PDF illisible, le système répondra par défaut ou renverra vers votre service client, ce qui annule l'intérêt de l'automatisation.

La bonne nouvelle : préparer ces 5 documents ne prend pas plus d'une demi-journée si vous partez de ce template. Et l'impact sur la pertinence des réponses est immédiat.

présentation de Navi, l'assistant IA pour Shopify

Conclusion

Un chatbot IA mal alimenté est pire qu'une FAQ statique : il donne l'illusion de répondre sans vraiment le faire, ce qui frustre le client et nuit à la confiance envers votre marque.

Structurer sa knowledge base par intentions client, avec un fichier par sujet et des formulations proches du langage naturel, c'est le travail préparatoire qui fait toute la différence entre un assistant qui déflecte vraiment les tickets SAV et un chatbot qui répond à côté.

Si vous préparez l'intégration d'un assistant IA sur votre boutique Shopify, commencez par ces 5 documents. Le reste, Navi s'en charge.