OneTrace.pro Centre d’aide

Recherche par IA

La recherche par IA comprend une requête écrite avec des mots de tous les jours : « chaussures de running imperméables à moins de 100 euros, mais pas Contoso », « un cadeau pour un coureur », « une sacoche pour un ordinateur portable de 15 pouces ». L'IA transforme la requête en filtres du catalogue (catégories, marques, caractéristiques, prix et exclusions), et la recherche de produits affiche les produits selon ces filtres. Au-dessus des produits apparaissent un court conseil de l'IA et des puces pour affiner : « moins cher », « pour femme », « autre couleur ». Les résultats classiques s'affichent immédiatement, comme toujours, et les résultats de l'IA les remplacent dès que l'analyse est prête. Si l'IA ne répond pas, les résultats classiques restent affichés.

La recherche par IA fait partie de la recherche de produits : il faut le traceur, le catalogue et le widget de recherche ou un plugin de boutique. L'IA est facturée à la consommation sur le solde du projet et fonctionne avec un forfait payant, voir Facturation et limites.

Activer la recherche par IA

Sur la page Site → Recherche de produits, dans le bloc Recherche par IA, choisissez Quand utiliser l'IA. Le choix est enregistré immédiatement.

Bloc « Recherche par IA » : mode, réponse au-dessus des produits, vérification de l'apport et analyse de la requête

Mode Quand l'IA analyse la requête
Désactivée jamais : la recherche fonctionne comme d'habitude
Automatique une requête descriptive — trois mots ou plus, ou une question ; les requêtes courtes (« baskets », « nike ») sont recherchées comme d'habitude
Interrupteur uniquement quand le client a cliqué sur « Demander à l'IA »
Toujours chaque requête

Dans les modes Automatique et Interrupteur, le visiteur dispose d'un bouton Demander à l'IA, à côté du tri des résultats et sous forme de ligne dans la couche de suggestions : avec ce bouton, l'IA analyse aussi une requête courte.

  • Courte réponse de l'IA au-dessus des produits : une ou deux phrases sur les produits trouvés : ce qui convient le mieux et la fourchette de prix. Désactivez-la si vous n'avez besoin que des filtres.
  • Vérifier l'apport de l'IA : la moitié des visiteurs reçoit la recherche classique, et le rapport compare les clics et les achats des deux groupes, voir Vérifier l'apport de l'IA.

Vérifier l'analyse

Le champ Vérifier l'analyse montre ce que l'IA a compris de la requête : le texte recherché, les catégories, les marques, les caractéristiques, le prix, les exclusions, le tri et les affinements. Saisissez une requête comme le ferait un client et cliquez sur Analyser. L'analyse est facturée comme sur le site ; une nouvelle analyse de la même requête vient gratuitement du cache, et la mention « Depuis le cache — sans appel au modèle » s'affiche sous le résultat.

Si l'IA n'a rien trouvé du catalogue dans la requête, la recherche portera sur le texte, comme l'indique la mention sous le champ. C'est l'occasion d'ajouter au catalogue les catégories ou caractéristiques que recherchent les clients.

Ce que voit le client

  1. Le client saisit une requête : les résultats classiques s'affichent immédiatement.
  2. Au-dessus des produits s'affiche « L'IA sélectionne des produits… ». Une ou deux secondes plus tard, les résultats de l'IA remplacent les résultats classiques.
  3. La réponse de l'IA s'écrit au fil de la réponse du modèle, sous le titre « Conseil de l'IA ».
  4. Les puces L'IA a compris : montrent les filtres appliqués : catégorie, marques, caractéristiques, prix et exclusions précédées du signe « − ». Une puce peut être retirée : les résultats se mettent à jour immédiatement, sans appel au modèle.
  5. Les affinements : des puces et le champ « Précisez : moins cher, autre couleur… ». Un affinement prolonge la requête précédente : « moins cher » après « chaussures de running Northwind » conserve la marque et baisse le prix.
  6. Demander dans le chat ouvre le chat du site avec la requête du client, si le chat est connecté.
  7. Recherche classique rétablit les résultats classiques jusqu'à ce que la requête change.

Si le catalogue ne contient pas ce qui a été demandé, l'IA assouplit les filtres : elle retire d'abord les caractéristiques et les exclusions, puis le prix, puis recherche le texte d'origine. Au-dessus des produits s'affiche alors « Aucune correspondance exacte : des produits similaires sont affichés. »

Si le visiteur a lui-même choisi des filtres ou un tri dans les résultats, l'IA ne remplace pas son choix : le tri choisi s'applique aux résultats de l'IA, et les filtres du visiteur rétablissent les résultats classiques.

Comment l'IA analyse la requête

  • Uniquement le catalogue. L'IA reçoit les catégories, les marques et les valeurs de caractéristiques de votre catalogue et choisit parmi elles. Tout ce qui n'est pas dans le catalogue est écarté : l'IA n'invente ni marque ni taille.
  • Langue. La requête peut être écrite dans n'importe quelle langue : l'IA traduit le texte recherché dans la langue du catalogue et rédige les affinements dans la langue du client.
  • Cache. L'analyse d'une requête est conservée 7 jours : la même requête dans la même langue est analysée sans le modèle et gratuitement. Chaque nuit, les requêtes populaires du site des 30 derniers jours sont analysées à l'avance (jusqu'à 100 requêtes par projet), si bien que les requêtes fréquentes obtiennent une réponse immédiate.
  • La réponse au-dessus des produits est rédigée uniquement à partir des fiches des produits trouvés : nom, marque, prix, disponibilité et caractéristiques. Une phrase contenant un nombre absent des fiches (prix, remise, délai) est supprimée. Une réponse prête pour la même requête et les mêmes produits est conservée une journée.
  • L'ordre des produits reste celui de la recherche : l'apprentissage sur les clics, les centres d'intérêt du visiteur et la recherche par le sens fonctionnent aussi dans les résultats de l'IA, voir Comment les produits sont recherchés.

Plugins de boutique

Les plugins WooCommerce et Magento 2 et le module 1C-Bitrix en mode recherche de produits affichent les résultats de l'IA sur la page de recherche de la boutique. Le thème de la boutique affiche les produits comme d'habitude, et au-dessus le traceur affiche le bloc de l'IA : le conseil, les puces « L'IA a compris : », les affinements et « Recherche classique ». Retirer une puce ou affiner la requête ouvre la même page de recherche avec de nouveaux paramètres.

Le plugin attend l'analyse 2,5 secondes au maximum. Les requêtes populaires sont analysées la nuit et s'ouvrent immédiatement ; une nouvelle requête descriptive s'ouvre 1 à 2 secondes plus lentement que d'habitude. Si l'analyse n'est pas prête à temps, la boutique affiche les résultats classiques. Nécessite WooCommerce 1.18.0, Magento 2 1.15.0 ou 1C-Bitrix 1.14.0 ou une version ultérieure.

Votre propre page de résultats

Si vous avez votre propre page de résultats, obtenez les résultats de l'IA dans le traceur :

const result = await cdp.searchAi(q, { perPage: 24 });

if (result.ai) {
  // result.items — produits, result.ai.understood — puces « L'IA a compris », result.ai.refinements — affinements,
  // result.ai.relaxed — filtres assouplis, result.ai.state — analyse pour la requête suivante
  await cdp.searchAiAnswer(q, result.items.slice(0, 6).map((item) => item.id), (text) => { answer.textContent = text; });
} else {
  // La requête n'a pas besoin de l'IA, l'IA n'est pas disponible ou n'a pas répondu à temps — affichez les résultats classiques de cdp.search(q)
}

Options de cdp.searchAi : previous — le result.ai.state de la réponse précédente avec la phrase d'affinement (« moins cher »), state — l'analyse sans la puce retirée (résultats sans appel au modèle), asked: true — le visiteur a cliqué sur « Demander à l'IA », ainsi que sort, page, perPage. L'analyse attend la réponse du modèle jusqu'à 8 secondes. Nécessite le traceur 1.37.0.

Les serveurs peuvent effectuer la même requête avec une clé d'écriture : POST https://cdp.onetrace.pro/api/v1/search/ai ; dans le SDK PHP, search()->ai(). La liste complète des paramètres figure dans la référence de l'API : https://cdp.onetrace.pro/api/v1/openapi.json.

Rapport

Tant que la recherche par IA est activée, le rapport Recherche par IA sur la même période s'affiche sous le rapport des requêtes de la page Site → Recherche de produits.

Rapport « Recherche par IA » : part des recherches, cache, rapidité, assouplissement, échecs, coût et apport de l'IA

Indicateur Ce qu'il montre
Recherches IA et Part de toutes les recherches combien de résultats l'IA a affichés et quelle part des recherches du site cela représente
Depuis le cache la part des résultats sans appel au modèle, gratuits et instantanés
Analyse : p50 / p95 en combien de temps le modèle analyse la requête pour la moitié et pour 95 % des recherches
Premiers mots de la réponse au bout de combien de temps le client voit le début du conseil de l'IA
Assouplies la part des recherches sans correspondance exacte, où l'IA a retiré des filtres
Échecs les analyses auxquelles le modèle n'a pas répondu ; dans ces cas, le client a vu les résultats classiques
Coût pour 1000 recherches le montant débité du solde pour la recherche par IA, ramené à 1000 recherches

Sous les indicateurs : combien d'affinages se sont faits sans le modèle, combien de réponses de l'IA il y a eu et combien a été débité sur la période. Le tableau liste les requêtes analysées par l'IA, avec le nombre de produits trouvés et la part de recherches assouplies : les requêtes souvent assouplies montrent ce qui manque à votre assortiment.

Vérifier l'apport de l'IA

Activez Vérifier l'apport de l'IA pour savoir si l'IA aide à vendre. Les visiteurs qui recevraient l'IA sont répartis à parts égales en deux groupes : l'un reçoit la recherche par IA, l'autre la recherche classique. Un visiteur reste toujours dans son groupe. Ceux qui cliquent eux-mêmes sur « Demander à l'IA » ou affinent leur requête reçoivent l'IA quel que soit leur groupe. Les recherches du groupe recherche classique ne sont pas facturées comme de l'IA.

Dans le rapport, le bloc Apport de l'IA compare les groupes :

  • Clic sur les résultats sous 30 minutes : la part des recherches après lesquelles le visiteur a cliqué sur un produit dans les résultats de cette requête ;
  • Achat sous 7 jours après la recherche : la part des recherches après lesquelles le même client a acheté quelque chose. Affiché si un événement d'achat est défini dans les paramètres des recommandations, voir Recommandations et catalogue de produits.

Le verdict fonctionne comme dans les autres comparaisons de variantes : tant que les données sont insuffisantes, le rapport l'indique ; quand la différence est statistiquement significative, il désigne le gagnant. Si la recherche classique fait mieux, vérifiez l'analyse des requêtes fréquentes dans le champ Vérifier l'analyse. Les clics sur les résultats sont enregistrés par le widget de recherche ; sur la page de recherche des plugins, le thème de la boutique n'enregistre pas les clics, c'est pourquoi seuls les achats y sont comparés. Une fois la vérification désactivée, le rapport affiche les résultats de la période pendant laquelle elle fonctionnait.

Facturation et limites

Chaque analyse et chaque réponse de l'IA coûtent en fonction du volume de texte (tokens) traité par le modèle, plus la marge de la plateforme. Le montant est débité du solde du projet ; dans l'historique du solde, il apparaît sur la ligne « Recherche par IA ». L'analyse depuis le cache, le retrait d'une puce, les pages suivantes et le changement de tri n'utilisent pas le modèle et sont gratuits. Le modèle est choisi par la plateforme ; l'analyse d'une requête coûte généralement une fraction de centime.

  • La recherche par IA fonctionne avec un forfait payant comprenant la recherche de produits. Pendant la période d'essai, sans argent sur le solde ou une fois le plafond de dépenses atteint, l'IA ne s'active pas : les clients voient la recherche classique.
  • Une requête à l'IA est une requête de recherche de plus dans la limite mensuelle du forfait, voir Limite de requêtes. Le widget récupère en même temps les résultats classiques et ceux de l'IA, c'est pourquoi une requête descriptive dans le widget compte deux fois ; dans les plugins de boutique, une seule fois. Les requêtes qui n'ont pas eu besoin de l'IA ou pour lesquelles elle n'était pas disponible, ainsi que les recherches du groupe recherche classique lors de la vérification de l'apport, ne sont pas comptées une seconde fois.
  • Un visiteur peut appeler le modèle au maximum 10 fois par minute et 100 fois par jour ; au-delà, il voit les résultats classiques. Les réponses depuis le cache ne comptent pas dans ces limites.
  • Depuis une même adresse, pas plus de 30 appels du modèle par minute et 300 par jour pour toutes les fonctions IA du site ; le serveur de la boutique avec le plugin et la clé secrète n'est pas concerné. Ce que l'IA du site peut dépenser par jour est fixé par le budget quotidien : une fois épuisé, la recherche habituelle fonctionne jusqu'à minuit.