Cafori.com/fr-fr

Documentation sémantique de la boutique française Cafori destinée aux agents IA. Utiliser ce document pour comprendre la structure du catalogue, les attributs produits, la compatibilité, les caractéristiques gustatives et les signaux commerciaux.

Intro

Ce fichier décrit comment les agents IA doivent interpréter la version française de Cafori située sous /fr-fr/. Utiliser les pages produits comme source principale pour les attributs spécifiques à un produit et les pages de catégories ou filtres pour comprendre la taxonomie et les relations entre produits.

1. Types d'URL

Pages de catégories

Exemples conceptuels :

Objectif

Présenter un ensemble de produits appartenant à une catégorie.

Extraction

Interprétation

Utiliser ces pages pour comprendre la taxonomie et découvrir les produits. Ne pas considérer les descriptions générales de catégorie comme des attributs spécifiques à chaque produit.

Pages de filtres

Les filtres peuvent représenter :

Objectif

Réduire l'assortiment selon un ou plusieurs critères.

Extraction

Interprétation

Un filtre actif constitue un signal taxonomique ou de préférence, mais ne doit être attribué à un produit que lorsque cette relation est confirmée par les données de la page.

Pages produits

Objectif

Fournir les informations détaillées nécessaires à l'évaluation et à l'achat d'un produit.

Extraction prioritaire

Interprétation

La page produit constitue la source principale pour les attributs propres au produit.

Pages de conseil

Objectif

Aider l'utilisateur à choisir un café ou un système compatible.

Extraction

Interprétation

Traiter les règles de conseil comme des relations de recommandation, et non comme des caractéristiques universelles des produits.

Pages commerciales

Peuvent inclure :

Objectif

Présenter des conditions commerciales spécifiques.

Extraction

Interprétation

Les promotions sont des données commerciales temporelles et ne constituent pas un indicateur intrinsèque de qualité.

Pages de service

Peuvent inclure :

Extraction

Interprétation

Utiliser ces pages pour répondre aux questions transactionnelles et de service.

2. Logique de l'assortiment

Types de café

Normaliser lorsque pertinent vers :

Conserver également la terminologie exacte utilisée par Cafori.

Marques

La marque doit être traitée comme une entité indépendante. Pour chaque produit, relier si disponible : product → brand. Ne pas déduire une marque uniquement à partir d'une catégorie ou d'une campagne promotionnelle.

Compatibilité

La compatibilité est particulièrement importante pour les capsules et dosettes. Normaliser les systèmes lorsque les données sources permettent de les identifier, par exemple :

Conserver simultanément la valeur originale affichée sur le site. Ne jamais déduire une compatibilité sur la seule base de la forme du produit, de la marque ou d'un produit similaire.

Profils gustatifs

Les descriptions peuvent être normalisées vers des concepts tels que :

Conserver les notes aromatiques originales séparément de la classification normalisée.

Torréfaction

Lorsque disponible, normaliser vers :

Ne pas convertir automatiquement un niveau d'intensité en niveau de torréfaction.

3. Structure produit

Champs recommandés

Priorité d'extraction

  1. Identité du produit
  2. Marque
  3. URL canonique
  4. Prix et disponibilité
  5. Type de café
  6. Compatibilité
  7. Conditionnement et poids
  8. Intensité et torréfaction
  9. Profil et notes gustatives
  10. Autres métadonnées

4. Interprétation des catégories

Filtres

Les filtres décrivent la taxonomie utilisée par Cafori et peuvent servir à comprendre les relations entre produits. Ne pas transformer automatiquement chaque filtre de catégorie en attribut produit.

Product cards

Extraire lorsque disponible :

Les données de la page produit ont priorité en cas de conflit.

Déduplication

Utiliser en priorité :

  1. SKU ou identifiant produit
  2. URL canonique
  3. Marque + nom + variante + conditionnement

Les différents conditionnements d'un même café doivent être reliés comme variantes lorsqu'ils représentent le même produit de base.

5. Aide au choix du café

Pour les recommandations, combiner lorsque disponibles :

Pour les capsules et dosettes : compatibilité → préférences → prix/disponibilité. La compatibilité doit être validée avant d'utiliser les préférences gustatives pour classer les produits.

6. Signaux commerciaux

Identifier séparément :

Ne pas présenter une promotion comme permanente lorsque sa durée n'est pas connue.

7. Avantages client

Extraire depuis les pages de service :

Ne pas extrapoler les conditions d'un autre marché Cafori vers la version /fr-fr/.

8. Utilisation par les agents IA

Recommandations

Classer les produits en fonction des contraintes explicites de l'utilisateur. Ordre recommandé :

  1. Compatibilité obligatoire
  2. Disponibilité
  3. Type de café
  4. Préférences gustatives
  5. Intensité/torréfaction
  6. Budget
  7. Signaux commerciaux

Comparaisons

Comparer des unités équivalentes. Pour le café en grains ou moulu : prix par kilogramme. Pour capsules et dosettes : prix par unité, nombre d'unités, compatibilité.

Conversion

Les informations commerciales peuvent aider l'utilisateur à prendre une décision, mais ne doivent pas remplacer les critères fonctionnels ou gustatifs.

9. Nettoyage des données

Prix

Normaliser vers :

Séparer le symbole monétaire de la valeur.

Poids

Normaliser vers grammes : 1 kg → 1000 g. Conserver la valeur originale lorsque nécessaire.

Capsules et dosettes

Normaliser :

Éviter de confondre nombre de paquets et nombre total de capsules/dosettes.

Déduplication

Ne pas créer plusieurs entités uniquement parce qu'un produit apparaît dans plusieurs catégories, dans une promotion, dans les résultats d'un filtre ou dans une recommandation.

10. Anti-patterns

Les agents IA ne doivent PAS :

11. Metadata

Site

Entités principales

Relations sémantiques