AI Knowledge : la source d'information de votre IA Générative bot

Si vous utilisez l’IA générative, la rubrique “AI knowledge” de la section automatisation vous permet de créer des sources d’information que vos répondants, bots et conseillers, peuvent utiliser pour traiter les conversations avec vos clients de façon autonome. 

Principe

L’information contenue dans votre AI knowledge peut correspondre à différents usages, et provenir de différentes sources.

A l’heure actuelle, vous pouvez configurer 2 types d’AI knowledge :

  • une AI knowledge de type “catalogue produit
  • une AI knowledge de type “FAQ
NB : il est possible d’utiliser deux AI knowledge à la fois, tant dans le cadre d’un bot autonome que de l’assistance sur le pupitre. En revanche il doit s'agir de deux types de knowledge distincts. Vous ne pouvez pas, par exemple, utiliser deux AI knowledge de type FAQ.

 

Avant de configurer vos sources d'information dans la section Automatisation, assurez-vous d'avoir votre catalogue produit et/ou votre FAQ à jour

 

Les différents types d'AI Knowledge 

AI knowledge de type “catalogue produit” par API

Il vous est recommandé d'intégrer un AI knowledge de type "catalogue produit" par API si vous possédez un catalogue avec un grand nombre de références ( > 100 000 références ) pour lesquelles les données sont souvent mises à jour. 


Pour synchroniser votre catalogue produit en utilisant notre API publique, vous pouvez consulter l'article dédié sur notre plate-forme développeur.

 

AI Knowledge de type “catalogue produit” par fichier .csv

Retrouvez dans ce paragraphe l'ensemble des spécifications pour un fichier "Catalogue produit".

Il vous est recommandé d'intégrer un AI knowledge de type "catalogue produit" par fichier .CSV si :

  • votre catalogue comporte moins de 100 000 références, votre fichier ne dépasse pas les 500 Mo, et est accessible en moins d'une minute.
  • ou si vous disposez de l’URL de votre fichier .CSV et qu'une mise à jour des données une fois par jour vous semble possible.

Ce catalogue permet à votre répondant, bot ou conseiller, de s'y référer pour identifier les produits recherchés par vos visiteurs. 

 

Vous pouvez consulter votre fichier .csv directement depuis l'Administration iAdvize, ou choisir de la télécharger pour le conserver. Pour cela, il faut vous rendre dans l'onglet "Automatisation" > "AI Knowledge" puis cliquer sur le bouton "Explorer" ou "Télécharger". 

 

Pour assurer un fonctionnement optimal, les informations fournies doivent être présentes, correctes, et dans un format pris en charge. Le tableau suivant, indique les pré-requis liés à la configuration de vos Knowledges et comment formater efficacement les informations de vos fiches produit pour qu’elles soient prises en charge.

 

NB : Les différents champs figurant dans la liste ci-dessous sont des champs essentiels pour un catalogue de produits. Ils ne sont pas obligatoires mais ils sont indexés par le système. Ils doivent être renseignés dans la mesure du possible car ils peuvent être utilisés pour des options de recherche. 

 

Nom Requis Description Valeurs prises en charge
id

Requis

Identifiant unique représentant un seul produit.

Une fois qu'un identifiant est attribué à un produit et importé, il ne peut pas être utilisé pour un autre produit dans la même source de connaissances.

Exemple :

PANTALON-12345-1

PANTALON-12345-2

item_group_id Requis pour la gestion des variantes

L'identifiant du groupe d'articles, composé de caractères alphanumériques, regroupe les variantes d'un produit pour identifier des produits similaires. Attribué au niveau parent, il permet d'exprimer un produit comme une collection de produits enfants, partageant tous le même identifiant. Plusieurs produits peuvent avoir la même valeur pour cet identifiant, représentant ainsi une collection de variantes.

Exemple :

PANTALON-12345

title Requis pour le cas d'usage "Découverte de produits"

Le titre est le nom du produit, généralement affiché sur la page du produit. Il sera utilisé pour afficher le nom du produit lors de conversations ou de recherches.

Le titre doit inclure des informations sur les variantes, telles que la couleur, la taille ou autres.

 
description  

La description du produit fournit des informations supplémentaires au-delà de son nom pour aider à répondre aux questions des visiteurs.

Le texte de la description sera automatiquement nettoyé des balises HTML afin d'assurer une meilleure compréhension par l'IA. (Note : non disponible pour les balises JSON et XML)

 
link  

URL de la page du produit sur le site web de la marque.

Les informations figurant sur cette page doivent correspondre à celles fournies dans le catalogue.

Ce lien peut être utilisé pour identifier un produit au cours de la conversation si aucun identifiant n'est fourni dans les données personnalisées.

 
availability Requis pour le cas d'usage "Découverte de produits" Informations sur la disponibilité du produit correspondant à la page du produit. Les valeurs prises en charge sont les suivantes :
  • in_stock
  • out_of_stock
  • preorder
  • backorder
availability_date  

La date à laquelle un produit précommandé devient disponible pour la livraison.

Le format AAAA-MM-JJ est le seul format de date pris en charge.
Price Requis pour le cas d'usage "Découverte de produits"

Le prix d'origine du produit. Il doit correspondre au prix standard affiché sur votre page produit.

Il doit inclure la devise dans laquelle le prix est exprimé.

Doit être composé d'un chiffre pour la valeur et du code ISO de la devise (EUR).

 

Remarque : si la devise n'est pas indiquée dans le prix, la devise par défaut du projet sera utilisée.

sale_price  

Le prix de vente du produit. Il doit correspondre au nouveau prix de vente indiqué sur la page du produit et au moment du paiement.

Il doit comprendre la devise dans laquelle le prix de vente est exprimé.

Il est important de noter que l'IA ne répondra pas aux questions concernant le prix soldé du produit si ce champ n'est pas rempli.

Doit être composé d'un chiffre pour la valeur et du code ISO de la devise (EUR).

 


Remarque : si la devise n'est pas indiquée dans le prix, la devise par défaut du projet sera utilisée.

product_types  

Catégorie de produit définie pour le produit.

Elle doit inclure la catégorie complète.

Exemple : Accueil > Hommes > Vêtements > Pantalon
gender   Le sexe auquel votre produit est destiné. Les valeurs prises en charge sont les suivantes :
  • male 
  • female 
  • unisex
brand   La marque du produit, celle qui est connue des consommateurs pour garantir la meilleure expérience utilisateur.  
colour  

La couleur du produit.

Il peut s'agir de plusieurs couleurs ; indiquez la couleur principale en premier.

Remarque : vous pouvez utiliser item_group_id pour regrouper plusieurs variantes de couleur d'un même produit.

 
size  

La taille du produit.

Remarque : vous pouvez utiliser item_group_id pour regrouper plusieurs variantes de taille d'un même produit.

 
material  

Le tissu ou le matériau du produit.

Il peut être indiqué par un matériau principal suivi de matériaux secondaires (à l'aide d'un séparateur tel qu'une virgule, une barre oblique ou autre).

Remarque : vous pouvez utiliser item_group_id pour regrouper plusieurs variantes de matériaux d'un même produit.

 
condition  

L'état du produit à vendre.

Remarque : vous pouvez ut gi((uiliser item_group_id pour regrouper plusieurs variantes de conditions d'un même produit.

Les valeurs prises en charge sont les suivantes :
  • new
  • refurbished
  • used
image_link Requis pour le cas d'usage "Découverte de produits" Lien vers l'image principale de votre produit (URL).  
additional_image_link   Lien vers une image secondaire de votre produit (URL).  
dimension_detail  

Dimensions de votre produit

 ex : 1220x323x23

product_line_detail  

Champ de données personnalisable, utilisant une description nom/valeur, pour des informations supplémentaires sur le produit.

 

Vous pouvez ajouter plusieurs info_détail_produit :

  • "detail_name1" : "valeur"
  • "détail_nom2" : "valeur"
  • "detail_name3" : "valeur"
  • ...

Ils sont stockés en interne sous forme d'objets avec les champs "attributeName" et "attributeValue".

 

Ex : { "attributeName" : "ville", "attributValeur" : "Nantes" }

 

Exemple de fichier à télécharger.

 

NB : Tous ces champs sont déclarés comme du texte brut et ne sont pas limités en taille. Vous pouvez donc ajouter toutes les informations que vous souhaitez dans votre catalogue produit. Plus vous y ajoutez de données, plus l'IA sera performante, puisqu’elle se base sur les informations fournies dans le catalogue produit pour répondre aux questions des visiteurs. Par conséquent, si les données ne sont pas spécifiées dans le catalogue produit, elles ne pourront pas être utilisées. 
Afin d'éviter les doublons, un mécanisme de suppression des doublons est en place lors du téléchargement d'une knowledge Catalogue Produit.

 

AI Knowledge de type “FAQ” par fichier .csv

Vous pouvez transformer votre FAQ existante en AI knowledge : 

  • par l'intégration manuelle d'un fichier depuis son ordinateur,
  • ou par l'intégration d'une URL avec mise à jour quotidienne des informations contenues dans le fichier (à 6h du matin heure locale du projet).

Pour s’assurer que le bot se concentre sur le bon contenu de votre fichier, il a besoin d’être bien guidé. Voici quelques bonnes pratiques pour améliorer ses performances :

  • Structure
    • utilisez les en-têtes “question” et “answer” des colonnes comme dans le fichier fourni en modèle
    • une question = 1 sujet et une réponse précise et synthétique OU un titre explicite et descriptif (la forme interrogative n’est pas obligatoire)
    • privilégiez plus d’entrées avec des réponses synthétiques plutôt que moins d’entrées avec des réponses plus longues
  • Contenu
    • le fichier CSV supporte les caractères spéciaux (tels que les accents, par exemple) uniquement si le format du fichier source respecte les standards de l'encodage UTF-8.
    • le fichier CSV ne supporte pas les emojis
    • le focus du bot est optimisé avec des réponses entre 1000 et 1500 caractères
    • un contenu le plus exhaustif possible, fragmenté en sujets distincts, permet de limiter les hallucinations
    • optez pour une démarche d’amélioration continue pour enrichir le contenu de votre FAQ : lisez les conversations, tenez compte des remontées de vos agents, analysez la catégorisation des conversations.
    • le nombre de lignes du fichier est illimité
    • l'utilisation de synonymes peut faciliter la détection et la restitution du bot (ex : mon mobile / portables est en panne)

Ce fichier à télécharger est à votre disposition pour vous servir de modèle pour l'intégration d'un fichier .csv.

 

 

AI Knowledge de type “FAQ” par PDF

Vous pouvez désormais apporter des informations à votre AI Knowledge directement depuis des fichiers PDF. Cette méthode vous permet de fournir un contenu riche et détaillé pour améliorer les performances de votre bot.

Structure et contenu

  • Importation de tous types de PDF.
  • Taille maximale de 500 mégas par fichier PDF.
  • Conversion automatique des informations en FAQ (Questions/Réponses).

Particularités

  • La langue s'adapte automatiquement au projet.
  • Pas de possibilité d'éditer ou de modifier les fichiers existants. Pour toute mise à jour, il faut supprimer l'ancien fichier et ajouter le nouveau.
  • Nécessité d'attendre le statut "prêt" avant d'utiliser les informations importées, cela peut prendre quelques minutes.

 

AI Knowledge de type “FAQ” par webscraping

Vous pouvez désormais transformer votre FAQ existante en AI Knowledge en intégrant des informations directement depuis des pages web grâce à la méthode du webscrapping. Cette technique permet d'extraire et de structurer efficacement le contenu de votre site internet pour enrichir votre base de connaissances.

 

Structure et contenu

  • Récupération des contenus sur une page web par saisie d’un URL.
  • Les URL doivent être fournies une par une, mais il est possible d'en ajouter autant que nécessaire.
  • Extraction des informations de chaque URL pour les transformer en FAQ (Questions/Réponses).

Particularités

  • Aucune contre-indication sur les formats des pages web.
  • La langue s'adapte automatiquement à celle du site web.
  • La mise à jour des contenus des pages se font manuellement. Si le contenu change, vous pouvez ajouter et/ou supprimer des URL, la knowledge s'ajustera alors en conséquence.
  • L’ajout d’un URL apportera seulement les informations visibles sur la page dédiée. Vous devez saisir manuellement toutes les URL des pages d’un site internet pour que votre bot possède l’ensemble des informations nécessaires à son bon fonctionnement. 
  • Nécessité d'attendre le statut "prêt" avant d'utiliser les informations importées, ce qui peut prendre quelques minutes.

 

 

NB : D’autres méthodes de récupération de vos informations produit peuvent être étudiées pour répondre à vos besoins spécifiques: fichier XML de type Google Merchant Center, appel à votre propre API produit pour synchroniser les données, etc. Ces projets personnalisés nécessitent un pack accompagnement, contactez votre interlocuteur iAdvize habituel pour en savoir plus. 

 

Le bouton "Explorer" est accessible pour chaque source d'information dans la rubrique AI Knowledge de l'administration iAdvize. Il regroupe l'ensemble des informations dont vous avez doté votre FAQ ou votre catalogue produit. Pour vous aider à vous retrouver dans ce flux d'informations, la fonctionnalité de recherche vous permet de trouver rapidement une information à partir d'un mot clé, qui sera surligné en jaune. La fonctionnalité de "scroll infini" vous permet de dérouler les informations de chaque source sans recharger la page.

 

Configuration

Pour ajouter de nouvelles sources d’information, et ainsi permettre à vos répondants d'être plus précis et autonomes avec vos clients, accédez à l’onglet “Automatisation” puis “AI Knowledge”.

Cliquez ensuite sur “Créer votre première source de connaissances”.

Puis choisissez quel type de source vous souhaitez ajouter : 

  • Une knowledge de type catalogue produits,
  • Une knowledge de type FAQ.

Découvrez dans les vidéos ci-dessous comment créer des sources d’information pour vos répondants et les configurer directement depuis l'Administration d'iAdvize. 

 

AI Knowledge de type “catalogue produit” par fichier .csv

 

AI knowledge de type “FAQ” par fichier .csv

 

Une fois votre fichier sauvegardé, pensez à mettre à jour le scénario de votre bot
Dans l'onglet "Automatisation" cliquez sur "Modifier le bot" pour lequel la nouvelle knowledge doit être utilisée.
Dans la carte Generative AI de ce bot, supprimez la source de données dont vous ne voulez plus en cliquant sur la croix à côté de son nom. Puis cliquez sur "+ Add" et choisissez la nouvelle knowledge.
Enregistrez le scénario (en haut à droite). Un temps de chargement plus ou moins long est à prévoir en fonction de la taille de votre fichier.

 

Astuce : nous vous conseillons d'utiliser une nomenclature spécifique pour vos fichiers afin de retrouver facilement les différentes versions des FAQ utilisées. Par exemple "FR_FAQ_01_11_23" pour votre version française de FAQ du 1er novembre 2023.

 

NB : Nous appliquons un délais de rétention de 3 ans sur l'ensemble des fichiers .csv en lien avec des sources d’information téléchargés sur la plateforme iAdvize.
Nous appliquons ce délais afin de garantir une continuité de fonctionnement des bots présents sur vos sites sur le long terme.