> For the complete documentation index, see [llms.txt](https://docs.flowlity.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flowlity.com/fr/concepts/product-similarities.md).

# Similarités produits

Lorsqu'un produit est nouveau, possède un historique de demande limité ou remplace un autre produit, la prévision basée uniquement sur ses propres données peut ne pas suffire. Les **similarités produits** vous permettent de lier des produits apparentés afin que leur historique de demande alimente la prévision du produit cible — offrant au moteur davantage de données et produisant de meilleures prédictions.

### Pourquoi c'est important

Une prévision précise dépend d'un historique de demande suffisant. En pratique, de nombreux produits en manquent :

* **Lancements de nouveaux produits** — Aucune demande passée n'existe encore.
* **Remplacements de produits** — L'historique de l'ancien produit est très pertinent pour le nouveau.
* **Articles saisonniers ou à faible rotation** — Le nombre limité de points de données rend les schémas difficiles à détecter.

En liant un produit similaire, vous transférez son historique de demande au produit cible. L'Agent de prévision utilise ensuite cet historique enrichi en complément des propres données du produit pour générer une prévision probabiliste plus fiable.

### Comment les produits similaires sont liés

Il existe deux façons d'établir des similarités produits dans Flowlity :

#### 1. Recommandations IA (Agent de similarité produits)

L'**Agent de similarité produits** identifie automatiquement les produits les plus similaires pour chaque article de votre catalogue. Il utilise trois métriques de distance complémentaires, configurées au niveau du site :

* **Similarité par catégorie** — Compare les attributs catégoriques tels que le nom du produit, la description ou les valeurs de tags. Les produits partageant les mêmes attributs sont considérés comme similaires.
* **Similarité textuelle** — Mesure la proximité sémantique entre les champs texte (nom, description) en utilisant des modèles de langage. Par exemple, "voiture de sport rouge" et "véhicule de course écarlate" obtiendraient un score élevé.
* **Similarité numérique** — Compare les valeurs numériques (ex. prix moyen) dans un seuil configurable. Un **seuil de pénalité de prix** définit la plage acceptable — les produits en dehors de cette plage reçoivent un score de similarité plus bas.

L'agent combine ces métriques et retourne jusqu'à **5 produits recommandés** par article, chacun avec un **coefficient de similarité** (affiché en pourcentage). Seules les recommandations au-dessus de 30 % de similarité sont affichées.

L'agent s'exécute chaque semaine et met à jour les recommandations automatiquement à mesure que votre catalogue et vos données évoluent.

#### 2. Liaison manuelle

Vous pouvez également ajouter des produits similaires manuellement depuis le **module Demande** en utilisant le panneau latéral **Product strategy**. Cela vous donne un contrôle total et est particulièrement utile pour les remplacements de produits.

Lors de la liaison manuelle de produits, vous pouvez configurer :

* **Produit source** — Le produit dont l'historique de demande sera utilisé.
* **Coefficient** — Un pourcentage qui contrôle quelle part de la demande du produit source est transférée. Par exemple, si deux produits sont consolidés en un seul, vous pourriez définir 50 % pour chacun.
* **Date de fin** (optionnel) — Rend le lien actif uniquement jusqu'à une date spécifique. Utile lorsqu'un remplacement est temporaire ou lorsque le nouveau produit a accumulé suffisamment de son propre historique.
* **Mapping client** (optionnel) — Si votre site utilise l'axe client, vous pouvez mapper les clients source et cible pour contrôler quels flux de demande sont transférés.

### Visualiser la demande des produits similaires

Dans le **module Demande**, vous pouvez visualiser l'impact des similarités produits directement dans le graphique :

* Ouvrez **Paramètres de la table** (côté droit de l'écran).
* Activez la ligne **Demande passée des produits similaires**.

Cette ligne montre l'historique de demande qui est apporté par les produits similaires liés. Elle apparaît à côté de **Cleaned past demand** (ce que le modèle utilise) et **Raw past demand** (le signal non modifié de vos données), vous offrant une transparence totale sur ce qui alimente la prévision.

### Ratio du produit actuel

Chaque produit possède un paramètre de **ratio du produit actuel** (par défaut 100 %) qui contrôle l'équilibre entre la propre demande du produit et la demande apportée par ses produits similaires. Réduire cette valeur donne plus de poids à l'historique des produits similaires.

### Où le trouver

| Emplacement                                           | Ce que vous pouvez faire                                                                                                                                                                                                                                    |
| ----------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Module Demande > Panneau latéral Product strategy** | Ajouter, modifier ou supprimer des produits similaires pour un article spécifique. Voir les recommandations IA.                                                                                                                                             |
| **Module Agents > Agent de similarité produits**      | Voir la configuration de l'agent : quelles métriques de similarité sont actives, quels attributs sont analysés et le seuil de pénalité de prix. Utilisez la fonctionnalité "Essayez-le" pour prévisualiser les recommandations pour n'importe quel produit. |
| **Module Demande > Paramètres de la table**           | Activer/désactiver la ligne "Demande passée des produits similaires" dans le graphique.                                                                                                                                                                     |

### Pages associées

* [Prévision de la demande](/fr/concepts/demand-forecasting.md) — Comment le moteur de prévision probabiliste utilise les produits similaires parmi d'autres entrées.
* [Événements de prévision et ajustements de la demande](/fr/concepts/forecast-events.md) — Autres moyens d'affiner le signal de demande.
* [Demande](/fr/modules/demand.md) — Où vous consultez les prévisions et accédez au panneau latéral Product strategy.
* [Agents](/fr/modules/agents.md) — Surveillez l'Agent de similarité produits et sa configuration.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.flowlity.com/fr/concepts/product-similarities.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
