> 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/ru/concepts/product-similarities.md).

# Схожесть продуктов

Когда продукт новый, у него мало истории спроса или он заменяет другой продукт, прогнозирования только по его данным может быть недостаточно. **Схожесть продуктов (product similarities)** позволяет связывать родственные продукты между собой, чтобы их история спроса учитывалась в прогнозе целевого продукта, — это даёт движку больше данных и приводит к более точным предсказаниям.

### Зачем это нужно

Точное прогнозирование зависит от наличия достаточного исторического спроса. На практике многим продуктам его не хватает:

* **Запуски новых продуктов** — истории спроса ещё нет.
* **Замены продуктов** — история старого продукта очень релевантна для нового.
* **Сезонные или медленно оборачиваемые позиции** — точек данных мало, паттерны выявить сложно.

Привязав похожий продукт, вы переносите его историю спроса на целевой. Forecast Agent затем использует эту обогащённую историю вместе с собственными данными продукта, чтобы сформировать более надёжный вероятностный прогноз.

### Как связываются похожие продукты

Есть два способа установить схожесть продуктов в Flowlity:

#### 1. Рекомендации AI (Product Similarity Agent)

**Product Similarity Agent** автоматически находит наиболее похожие продукты для каждой позиции в вашем каталоге. Он использует три дополняющих друг друга метрики расстояния, настраиваемых на уровне площадки:

* **Сходство по категориям** — сравнивает категориальные атрибуты, такие как название продукта, описание или значения тегов (tag). Продукты с общими атрибутами считаются похожими.
* **Текстовое сходство** — измеряет смысловую близость между текстовыми полями (название, описание) с помощью языковых моделей. Например, «red sports car» и «crimson racing vehicle» получат высокий балл.
* **Числовое сходство** — сравнивает числовые значения (например, среднюю цену) в пределах настраиваемого порога. **Порог штрафа по цене** задаёт допустимый диапазон — продукты вне этого диапазона получают более низкий балл сходства.

Агент объединяет эти метрики и возвращает до **5 рекомендованных продуктов** на позицию, каждый с **коэффициентом сходства** (отображается в процентах). Показываются только рекомендации выше 30 % сходства.

Агент запускается еженедельно и автоматически обновляет рекомендации по мере изменения каталога и данных.

#### 2. Ручная привязка

Похожие продукты можно добавить вручную из **модуля Спрос**, в боковой панели **Стратегия продукта**. Это даёт полный контроль и особенно полезно при замене продуктов.

При ручной привязке можно настроить:

* **Исходный продукт** — продукт, чья история спроса будет использоваться.
* **Коэффициент** — процент, определяющий, какая доля спроса источника переносится. Например, если два продукта объединяются в один, можно задать 50 % для каждого.
* **Дата окончания** (опционально) — делает связь активной только до указанной даты. Полезно, когда замена временная или когда новый продукт уже накопил достаточную собственную историю.
* **Сопоставление клиентов** (опционально) — если ваша площадка использует ось клиентов, можно сопоставить клиентов источника и цели, чтобы контролировать, какие потоки спроса переносятся.

### Просмотр спроса похожих продуктов

В **модуле Спрос** влияние схожести продуктов можно увидеть прямо на графике:

* Откройте **Настройки таблицы** (в правой части экрана).
* Включите линию **Прошлый спрос похожих продуктов**.

Эта линия показывает историю спроса, вклад в которую вносят привязанные похожие продукты. Она отображается рядом с **Очищенный прошлый спрос** (что использует модель) и **Исходный прошлый спрос** (неизменённый сигнал из ваших данных), обеспечивая полную прозрачность того, что подаётся в прогноз.

### Current product ratio

У каждого продукта есть настройка **current product ratio** (по умолчанию 100 %), которая регулирует баланс между собственным спросом продукта и спросом, вносимым похожими продуктами. Снижая это значение, вы увеличиваете вес истории похожих продуктов.

### Где это найти

| Расположение                                       | Что можно сделать                                                                                                                                                                                                              |
| -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Модуль Спрос > боковая панель Product strategy** | Добавлять, редактировать или удалять похожие продукты для конкретной позиции. Просматривать рекомендации AI.                                                                                                                   |
| **Модуль Агенты > Product Similarity Agent**       | Смотреть конфигурацию агента: какие метрики сходства активны, какие атрибуты анализируются, каков price penalty threshold. Используйте функцию «Try it out», чтобы предварительно посмотреть рекомендации для любого продукта. |
| **Модуль Спрос > Table settings**                  | Включить или выключить линию «Similar products past demand» на графике.                                                                                                                                                        |

### Связанные страницы

* [Прогнозирование спроса](/ru/concepts/demand-forecasting.md) — как вероятностный прогнозный движок использует похожие продукты вместе с другими источниками.
* [Прогнозные события и корректировки спроса](/ru/concepts/forecast-events.md) — другие способы уточнить сигнал спроса.
* [Спрос](/ru/modules/demand.md) — где просматривать прогнозы и открывать боковую панель Product strategy.
* [Агенты](/ru/modules/agents.md) — мониторинг Product Similarity Agent и его конфигурации.