# Shopping Assistant

Shopping Assistant - это AI-помощник для покупателей. Он ведет диалог, уточняет потребность, помогает выбрать подходящие товары из каталога и возвращает результат в структурированном формате для отображения в интерфейсе клиента.

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

Сайт продукта: [shopping.gravityfield.ai](https://shopping.gravityfield.ai/)

## Что делает ассистент

- Помогает пользователю сформулировать потребность.
- Подбирает релевантные товары из каталога.
- Возвращает текстовые ответы, товарные карточки, кнопки действий и быстрые ответы.
- Может работать в интерфейсе сайта, мобильного приложения или другого клиентского канала.

## Что требуется для интеграции

### Товарный фид

Shopping Assistant подбирает товары из каталога Gravity Field. Перед запуском синхронизируйте товарный фид: `sku`, название, цену, изображение, URL, наличие, категории и атрибуты, которые нужны для подбора.

📖 Подробнее: [Синхронизация фида](/Integration/products_catalogues/general_reqs.md)

### Канал подключения

#### Web

Для сайта достаточно стандартной Web-интеграции Gravity Field.

📖 Подробнее: [Web-интеграция](/Integration/web_integration/web_integration.md)

#### API

Для прямой работы с Shopping Assistant используйте API-интеграцию.

📖 Подробнее: [Интеграция Shopping Assistant по API](./integration.md)

#### SDK

SDK-интеграция будет описана позже.

## Основные сценарии

| Сценарий | Пример |
| :--- | :--- |
| Подбор товара | "Помогите выбрать корм для взрослой кошки". |
| Уточнение параметров | Ассистент спрашивает возраст, размер, ограничения по бюджету или особенности питомца. |
| Подбор на карточке товара | Пользователь задает вопрос по текущему SKU или просит похожие варианты. |
| Подбор с товарными карточками | Ассистент возвращает список товаров, а клиентский интерфейс отображает карточки и обрабатывает действия пользователя. |

## Документация

[!ref icon="graph"](./tracking.md)