Октябрь '26. Shopping Assistant API возвращает выбранный сценарий

В Shopping Assistant API появился контекст текущего ответа: намерение покупателя, выбранный сценарий и режим — уточнение, ответ, передача в поддержку или отказ. Теперь ваш интерфейс может учитывать, какую задачу решает ассистент.

Например, покупатель просит подобрать ноутбук для учёбы. Когда ассистент выбирает сценарий подбора ноутбука, приложение может показать рядом с чатом элементы выбора диагонали и бюджета. Если разговор переходит к другой задаче, интерфейс меняется вслед за новым ответом. Магазин связывает консультацию и элементы подбора в одном интерфейсе; покупатель продолжает выбор в контексте своей задачи.

Что нужно для подключения

В ответе POST /shopping/generate рядом с response приходит поле context:

{
  "intent": "product-selection",
  "scenario": { "id": "laptop-selection", "version": 1 },
  "mode": "clarify"
}

Это пример содержимого context: ID и версия зависят от плейбуков вашей секции. Чтобы связать сценарий с компонентом UI, скопируйте его ID в Настройки ассистента → Сценарии. Там же видны версии и справка по использованию в интерфейсе. Элементы подбора разрабатывает ваша команда.

Контекст приходит и в истории диалога, поэтому приложение может восстановить интерфейс по последнему ответу ассистента. Если сценарий не выбран или метаданных нет, используется обычный чат.

Контракт, значения режимов и правила восстановления собраны в API-справочнике. Для первого подключения начните с гайда по API-интеграции.