Работа AI-агента с отзывами и вопросами

Связь этого раздела с задачей

Задача: Прочитать отзывы/вопросы или подготовить пользовательскую публикацию.

Что нужно на входе: Точный товар. Публичное чтение и подтверждаемая отправка текста/медиа — разные действия.

Результат: Опубликованные материалы либо подтверждённая отправка на модерацию, не обещание немедленной публикации.

Другая цель? Карта всех задач и режимов. Права личного доступа — auth.md; это не обязательный шаг для публичного чтения.

Следующий раздел по теме: Данные карточки товара — вернуться к характеристикам · Поддерживаемые возможности — выбрать доступный browser-инструмент для записи · Корзина и оформление — продолжить покупку после выбора.

Публичное чтение отзывов через API

GET /api/v1/products/{product_id}/reviews возвращает опубликованные и одобренные отзывы без внутренних пользовательских ID и контактных данных. Контракт чтения: Public API. Публичный REST не предоставляет запись отзывов, вопросов, реакций или загрузку медиа; для этих действий остаются браузерные инструменты и пользовательское подтверждение. Далее описан browser-интерфейс, а не REST schema.

Чтение

Карточка товара содержит:

• количество и средний рейтинг отзывов;
• количество вопросов;
• вкладки отзывов и вопросов;
• опубликованный текст, автора, дату, оценку и медиа;
• кнопки подгрузки и фильтры.

Опубликованные отзывы имеют семантические элементы и идентификаторы. Дополнительные записи подгружаются AJAX.

Отправка

На карточке есть HTML-формы с именованными полями для отзыва и вопроса, однако их отправка в текущей реализации зависит от JavaScript: JS добавляет action-флаг и CSRF, отправляет multipart POST и обрабатывает JSON-ответ.

Отзыв может включать имя, контакт, рейтинг 1–5, достоинства, недостатки, комментарий и фото/видео. Вопрос может включать имя, контакт, текст и медиа. Материалы проходят серверную валидацию и модерацию.

Оценки и реакции

Сортировка, фильтрация, подгрузка, реакции и комментарии используют отдельные AJAX-действия и session rate limits. Они не представлены стабильными публичными HTML-формами или URL.

Статус для агента

• Чтение первоначально отрендеренных отзывов/вопросов: поддерживается HTML.
• Публичный REST предоставляет постраничное чтение опубликованных отзывов по указанному выше контракту. Интерактивные фильтры, вопросы и browser UI не следует считать тем же REST-интерфейсом.
• Создание отзыва/вопроса: declarative WebMCP-формы без auto-submit; пользователь проверяет содержимое до модерации.
• Комментарии и ответы: контекстные declarative WebMCP-формы без auto-submit.
• Реакции: react_to_review и react_to_comment; повтор той же реакции снимает её.

Не отправляйте пользовательский текст или медиа без явного подтверждения содержимого.