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

Когда продукт новый, у него мало истории спроса или он заменяет другой продукт, прогнозирования только по его данным может быть недостаточно. **Схожесть продуктов (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 и его конфигурации.


---

# Agent Instructions: 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/ru/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.
