Guide utilisateur — Assistant d'achat IA

Vérification du code source (2026-07-15) : la conversation, le flux de réponse, l'arrêt de génération, la gestion des sessions et la comparaison de produits passent tous par /bff/ai/* ; le navigateur ne contacte jamais directement l'API IA. Les produits cités doivent provenir des preuves de recherche courantes et du catalogue visible, et les quotas, fonctions du locataire et droits sur la session sont revérifiés par le BFF et l'API.

Ce guide explique comment utiliser l'assistant d'achat alimenté par l'intelligence artificielle sur la plateforme Trelanto. L'assistant vous aide à trouver des produits adaptés à vos besoins grâce à une conversation naturelle, des recommandations personnalisées et une comparaison de produits.

---

Table des matières

1. Présentation de l'assistant IA
2. Accéder à l'assistant IA
3. Interface de l'assistant IA
4. Gestion des sessions
5. Converser avec l'assistant
6. Comprendre les réponses en streaming
7. Recommandations de produits
8. Comparaison de produits
9. Quotas d'utilisation
10. Stratégies de tri des recommandations
11. Ajouter au panier depuis l'IA
12. FAQ

---

1. Présentation de l'assistant IA

1.1 Que peut faire l'assistant IA ?

L'assistant d'achat IA de Trelanto vous permet de :

• Découvrir des produits : Décrivez ce que vous cherchez en langage naturel.
• Obtenir des recommandations : L'assistant analyse le catalogue et suggère les produits les plus pertinents.
• Reconnaître rapidement l'intention : Si vous mentionnez clairement « bientôt disponible », « nouveauté », « n'importe quel produit » ou « seulement les informations produit », le système ajuste le périmètre de recherche avant la récupération.
• Comparer des produits : Comparez jusqu'à 4 produits côte à côte avec une analyse détaillée.
• Poser des questions : Posez des questions sur les produits, les matières, les tailles, etc.
• Affiner les résultats : Ajustez les critères (budget, couleur, marque) dans la même conversation.

1.2 Technologies sous-jacentes

• L'assistant est alimenté par des grands modèles de langage (LLM) tels que DeepSeek, OpenAI ou les modèles Alibaba Cloud, selon la configuration de l'administrateur.
• La recherche de produits utilise des embeddings vectoriels et une recherche sémantique — pas seulement des mots-clés.
• Les réponses sont diffusées en temps réel (streaming SSE) pour une expérience plus fluide.

1.3 Disponibilité de la fonctionnalité

• L'assistant IA peut être activé ou désactivé par les administrateurs via les drapeaux de fonctionnalités.
• Si l'assistant IA n'est pas visible, cette fonctionnalité peut ne pas être activée sur votre plateforme.

---

2. Accéder à l'assistant IA

2.1 Point d'entrée sur le site

1. Cliquez sur l'icône ou le bouton « Assistant IA » dans la barre de navigation.
2. Ou accédez directement via le chemin localisé /ai.

2.2 État de connexion et accès

2.3 Si l'assistant IA n'est pas disponible

• Un message indique que la fonctionnalité est temporairement désactivée.
• Cela est généralement causé par une désactivation administrative ou une interruption du service LLM.

---

3. Interface de l'assistant IA

3.1 Disposition en trois panneaux

L'interface de l'assistant IA est organisée en trois panneaux principaux :

3.2 Panneau gauche — Sessions

• Affiche toutes vos sessions de conversation précédentes.
• Chaque session a un titre (automatiquement généré à partir du premier message ou renommé manuellement).
• Cliquez sur une session pour reprendre la conversation.
• Des actions disponibles pour chaque session : renommer, supprimer.

3.3 Panneau central — Conversation

• Zone de saisie en bas pour envoyer vos messages.
• L'historique de la conversation s'affiche chronologiquement.
• Les réponses de l'assistant s'affichent en streaming en temps réel.
• Un indicateur de « réflexion » s'affiche pendant que l'IA traite votre requête.

3.4 Panneau droit — Recommandations

• Affiche les produits recommandés par l'assistant pour la session actuelle.
• Chaque fiche produit affiche : image, nom, prix, note.
• Des badges « Gagnant » ou « Finaliste » peuvent être affichés sur les meilleurs produits.
• Les images et titres ouvrent la fiche produit ; les boutons de la fiche représentent uniquement l'action d'achat.
• Les libellés d'action viennent de l'état structuré du produit, pas du texte généré par l'IA : « Ajouter rapidement » si un variant vendable peut être ajouté directement, « Choisir une option » si une variante doit être confirmée, « Indisponible » si le produit ne peut pas être acheté.
• L'ajout au panier utilise la même validation que la boutique ; seuls les produits publiés, disponibles à la vente et avec un variant vendable peuvent poursuivre le checkout normal.

---

4. Gestion des sessions

4.1 Créer une nouvelle session

1. Cliquez sur « Nouvelle conversation » ou « + » dans le panneau gauche.
2. Une nouvelle session vide est créée et sélectionnée automatiquement.
3. Le titre par défaut suit la langue actuelle : « 新的 AI 会话 » en chinois, « New AI Session » en anglais et « Nouvelle session IA » en français.
4. Commencez à taper votre première question dans le panneau central.

4.2 Renommer une session

1. Survolez la session dans le panneau gauche.
2. Cliquez sur l'icône de renommage (crayon).
3. Saisissez le nouveau nom (maximum 60 caractères).
4. Appuyez sur Entrée ou cliquez en dehors pour confirmer.

4.3 Supprimer une session

1. Survolez la session dans le panneau gauche.
2. Cliquez sur l'icône de suppression (corbeille).
3. Confirmez la suppression dans la boîte de dialogue.
4. La session est déplacée vers la corbeille — elle n'est pas immédiatement supprimée définitivement.

4.4 Corbeille — Sessions supprimées

• Les sessions supprimées sont déplacées dans la corbeille.
• Accédez à la corbeille via le lien « Corbeille » dans le panneau gauche.
• Actions possibles dans la corbeille :
  • Restaurer : Remet la session dans la liste active.
  • Supprimer définitivement : Supprime la session et son historique de conversation.
• Vider la corbeille : Supprime définitivement toutes les sessions dans la corbeille à la fois.

---

5. Converser avec l'assistant

5.1 Comment formuler vos demandes

Pour obtenir les meilleures recommandations, soyez précis dans vos descriptions :

Exemples de bonnes formulations :

• « Je cherche un sac à dos pour la randonnée, résistant à l'eau, avec compartiment pour ordinateur, budget 100-200 $ »
• « Quelles chaussures de course conviennent pour les pieds plats ? »
• « Montre-moi les meilleures vestes d'hiver pour le Québec »

Informations utiles à inclure :

• Votre usage prévu.
• Votre budget.
• Vos préférences de couleur ou de style.
• Vos contraintes (allergie à certaines matières, taille, etc.).

5.2 Affiner les résultats dans la même conversation

• Après avoir reçu des recommandations initiales, posez des questions de suivi.
• Exemples : « Montre-moi des options moins chères », « Je préfère en bleu », « Lequel a le meilleur rapport qualité-prix ? ».
• L'assistant maintient le contexte de la conversation pour affiner progressivement les résultats.

5.3 Indicateur de traitement

• Pendant que l'assistant traite votre requête, un indicateur de temps s'affiche.
• La durée typique est de 20 à 60 secondes selon la complexité de la requête.
• Si le traitement dépasse 50 secondes, un message « Traitement plus long que d'habitude » peut s'afficher.

---

6. Comprendre les réponses en streaming

6.1 Qu'est-ce que le streaming ?

• Les réponses de l'assistant ne sont pas envoyées toutes à la fois — elles apparaissent progressivement, comme si l'assistant tapait en temps réel.
• Cette technique s'appelle le streaming SSE (Server-Sent Events).
• Elle vous permet de lire le début de la réponse avant qu'elle soit complète.

6.2 Pendant le streaming

• Ne fermez pas la fenêtre pendant que l'assistant répond.
• Les recommandations de produits dans le panneau droit peuvent se mettre à jour à mesure que la réponse se complète.

6.3 Si la réponse s'interrompt

• Si la connexion est interrompue pendant le streaming, la réponse peut être incomplète.
• Rechargez la page et reposez votre question dans la même session.

---

7. Recommandations de produits

7.1 Comment les recommandations sont générées

1. Votre message est converti en un vecteur d'embedding sémantique.
2. Le système recherche les produits les plus proches sémantiquement dans la base de données vectorielle.
3. Les résultats sont re-classés par le LLM selon la pertinence avec votre requête.
4. Les meilleurs produits sont présentés dans le panneau de recommandations.

Par défaut, l'assistant privilégie les produits publicationStatus=published, salesStatus=available et avec stock vendable. Si votre message indique que l'achat immédiat n'est pas obligatoire ou que vous voulez seulement consulter des informations, la recherche peut s'élargir au catalogue visible. Si vous demandez des nouveautés, des produits à venir ou en test de marché, elle peut inclure les produits market_test, coming_soon et preorder. Les intentions sensibles liées à la sécurité, comme grossesse, enfants, allergies, contre-indications ou formulation de traitement, ne font qu'augmenter les précautions ; elles ne réduisent jamais le niveau de sécurité.

7.2 Badges de recommandation

7.3 Si aucun produit n'est trouvé

• Si le catalogue ne contient pas de produit correspondant à votre requête, l'assistant génère une réponse consultative.
• Il peut vous suggérer des catégories similaires, des alternatives ou des conseils d'achat généraux.
• Il ne vous présente jamais de produits non pertinents simplement pour remplir la liste.

7.4 Nombre de recommandations

• Le nombre de produits recommandés dépend de la configuration AI_VECTOR_SEARCH_TOP_K définie par l'administrateur.
• En général, entre 5 et 20 produits sont suggérés par requête.

---

8. Comparaison de produits

8.1 Lancer une comparaison

1. Dans le panneau de recommandations, sélectionnez jusqu'à 4 produits en cochant les cases de sélection.
2. Cliquez sur « Comparer les produits sélectionnés ».
3. L'assistant génère une analyse comparative détaillée dans le panneau de conversation.

8.2 Format de la comparaison

• La comparaison est générée au format Markdown structuré.
• Elle inclut typiquement :
  • Tableau comparatif des caractéristiques clés.
  • Avantages et inconvénients de chaque produit.
  • Recommandation finale selon votre usage décrit.

8.3 Nombre maximum de produits pour la comparaison

• Maximum 4 produits peuvent être comparés simultanément.
• Pour une cohérence de l'analyse, il est recommandé de comparer des produits de la même catégorie.

---

9. Quotas d'utilisation

9.1 Système de quotas

Pour assurer un accès équitable à tous les utilisateurs, l'assistant IA est soumis à des quotas hebdomadaires :

9.2 Réinitialisation du quota

• Les quotas se réinitialisent chaque lundi à minuit UTC.
• Après réinitialisation, vous disposez à nouveau du quota complet pour la semaine.

9.3 Que se passe-t-il si le quota est dépassé ?

• Un message d'avertissement s'affiche indiquant que votre quota hebdomadaire est atteint.
• Vous ne pouvez plus créer de nouvelles sessions jusqu'à la réinitialisation du quota.
• Vous pouvez toujours consulter vos sessions existantes et leur historique.
• Si vous êtes un utilisateur invité, connectez-vous pour bénéficier du quota plus élevé.

9.4 Vérifier votre quota restant

• Le quota restant peut être affiché dans l'interface de l'assistant IA.
• L'interface indique le nombre de sessions restantes pour la semaine en cours.

---

10. Stratégies de tri des recommandations

10.1 Options de tri disponibles

Les recommandations peuvent être triées selon différentes stratégies :

10.2 Changer la stratégie de tri

• Selon l'interface, un menu déroulant de tri peut être disponible dans le panneau de recommandations.
• Ou formulez votre préférence dans le chat : « Montre-les par prix croissant ».

---

11. Ajouter au panier depuis l'IA

11.1 Ajouter un produit recommandé au panier

1. Dans le panneau de recommandations, trouvez le produit que vous souhaitez.
2. Si le bouton indique « Ajouter rapidement », cliquez dessus pour ajouter le variant vendable direct ; le serveur vérifie encore la disponibilité au moment du clic.
3. Si le bouton indique « Choisir une option », ouvrez la sélection et confirmez le variant avant l'ajout.
4. Si le bouton indique « Indisponible », le produit sert seulement de référence ou de consultation.
5. Le produit est ajouté à votre panier si son statut est publicationStatus=published, salesStatus=available et si un variant vendable existe.
6. Un message de confirmation s'affiche.

Les produits de recherche, à venir ou en précommande affichés grâce à la reconnaissance rapide d'intention servent surtout à la consultation et à la comparaison ; ils ne sont pas garantis comme immédiatement ajoutables ou achetables.

11.2 Voir le produit avant d'acheter

1. Cliquez sur « Voir le produit » ou sur l'image du produit dans la fiche de recommandation.
2. La page de détail du produit s'ouvre (dans un nouvel onglet ou dans le même onglet selon la configuration).
3. Vous pouvez y obtenir toutes les informations détaillées avant de décider.

11.3 Comportement pour les utilisateurs non connectés

• Les utilisateurs non connectés peuvent ajouter des produits au panier.
• Le panier invité est stocké localement.
• Lors de la connexion, le panier invité est automatiquement fusionné avec le panier du compte.

---

12. FAQ

Q1 : L'assistant recommande des produits qui ne correspondent pas à ma demande — comment améliorer les résultats ?

Soyez plus spécifique dans votre description. Incluez votre usage prévu, votre budget et vos préférences. Si les résultats restent inadéquats, essayez de reformuler différemment ou d'utiliser des termes plus courants. L'assistant améliore ses résultats au fil de la conversation via les questions de suivi.

Q2 : Ma session a disparu — comment la retrouver ?

Les sessions supprimées sont dans la corbeille. Accédez à la corbeille via le panneau gauche et restaurez la session si elle n'a pas encore été supprimée définitivement.

Q3 : L'assistant dit « Je ne trouve pas de produits correspondants » — cela signifie-t-il que le produit n'existe pas ?

Cela signifie que le catalogue actuel ne contient pas de produit correspondant précisément à votre requête, ou que le catalogue n'est pas encore vectorisé pour ce type de produit. Essayez des termes plus généraux ou explorez les catégories de produits manuellement.

Q4 : Combien de temps dure une session ?

Les sessions sont persistantes tant qu'elles ne sont pas supprimées. L'historique complet de la conversation est conservé. Il n'y a pas d'expiration automatique des sessions actives.

Q5 : Puis-je utiliser l'assistant IA en anglais et en français ?

Oui. L'assistant répond dans la langue configurée pour le site (ou selon votre paramètre de langue). Si vous posez des questions en français, il répondra généralement en français. La qualité des réponses dépend du modèle LLM configuré par l'administrateur.

Q6 : Mes conversations sont-elles privées ?

Vos conversations sont associées à votre compte et ne sont pas partagées avec d'autres utilisateurs. Elles peuvent cependant être utilisées de manière agrégée et anonymisée pour améliorer le service. Consultez la politique de confidentialité de la plateforme pour plus de détails.