Гиды проектного подбора

Гид — это серверная стейт-машина, а не свободный чат. LLM разбирает свободный ответ в факты, но формулы, фильтры каталога, упаковки и корзина исполняются детерминированно. Все методы требуют scope search:read. Связанные опциональные Flow Runtime-сценарии: Commerce-потоки.

Начните сессию:

POST /api/v1/indexes/{slug}/guide/sessions
{"client_id":"visitor-42","tech_map_key":"bathroom-tiling"}

Ответ содержит data.revision и data.question. Передайте ответ вместе с текущей ревизией:

POST /api/v1/indexes/{slug}/guide/sessions/{sessionId}/answers
{"expected_revision":1,"answer":{"value":"full"}}

Когда state.stage станет select, вызовите POST .../recommendations, затем POST .../quotes. Сохраните версионированное состояние проекта через POST .../projects, чтобы покупатель мог вернуться к нему позднее. Для корзины вызовите POST .../cart с quote_id и уникальным idempotency_key. Ответ содержит shopEndpoint и shopRequest; отправьте их на тот же домен Bitrix с действующим sessid, после чего подтвердите результат через POST .../cart/{commitId}/ack.

Конфликт ревизии возвращает 409 GUIDE_REVISION_CONFLICT. Отсутствующее обязательное свойство, маппинг или SKU возвращает 422 GUIDE_INCOMPLETE; ограничения автоматически не ослабляются.