POST /api/collections/:id/regenerate — (Пере)генерация коллекции
Как открыть: орг-админ → раздел «Коллекции» → карточка коллекции → редактор → форма (пере)генерации. Один и тот же экран и при первом построении коллекции, и при последующих перегенерациях.
Это единая форма, которая строит содержимое коллекции — слои, блоки, специальности и связи между ними — из вашего текстового описания. В форме задают пожелания и рамки по каждой оси: сколько примерно слоёв, блоков, специальностей (можно указать «от» и «до», можно оставить пусто — продукт решит сам). Под капотом — тот же трёхэтапный конвейер, что и для проектов.
Что именно сделать, выбирается режимом:
- С нуля — пересобрать коллекцию, полностью заменив прежнее содержимое.
- Только блоки — пересобрать блоки и связи, оставив слои и специальности.
- С сохранением — перегенерировать, но не трогать отмеченные вами блоки.
- Предпросмотр — показать, что получилось бы, ничего не записывая в коллекцию. Удобно «примерить» параметры до того, как перезапишете содержимое.
Качество: Быстрое — один проход, дешевле и быстрее; Pro — режим повышенного качества (несколько вариантов и выбор лучшего), точнее, но дольше и дороже. Для коллекций по умолчанию включено Pro.
Кроме предпросмотра, все режимы показывают прогресс в реальном времени (потоковая генерация): этапы сменяют друг друга, слои, блоки и связи появляются по мере готовности.
Одновременно для одной коллекции идёт только одна перегенерация: если кто-то уже запустил её (в окне 10 минут), вы получите понятную ошибку и сможете попробовать позже. Если минимум по какой-то оси больше максимума — форма не пропустит. Форма обычно сразу подставляет параметры прошлого успешного прогона (см. последняя применённая генерация).
Кто может. Только администратор-владелец коллекции: орг-админ организации-владельца (или администратор платформы — для глобальных коллекций). Чужой орг-админ, сотрудник или наблюдатель права на перегенерацию не имеют.
Связанные
- Экраны: Редактор коллекции
- Конвенции · Роли · Ошибки · Глоссарий
Машинная сводка (HTTP, таблицы, связанные требования)
| Поле | Значение |
|---|---|
| HTTP | POST /api/collections/:id/regenerate |
| Auth | — |
| Scope токена | read_write |
| PG-функции | api.create_collection_generation_attempt, api.finalize_collection_generation_attempt |
| Таблицы | collection_generation_attempt, collection, collection_block, collection_layer, collection_specialty, collection_edge |
| SRM | SRM-328 |
| RP (права) | — |
| Файл роута | server/routes/collections.js |
| Статус | done |
Аргументы запроса (best-effort из хендлера; путь-параметры опущены):
| Аргумент | Где | Обяз. | Заметка |
|---|---|---|---|
keep_block_ids | body | подтвердить | |
messages | body | подтвердить | |
mode | body | подтвердить | |
params | body | подтвердить | |
quality | body | подтвердить | |
mode | query | подтвердить |
Коды ответов/ошибок (из хендлера): 202, 400, 409, 429, 500 (+ 200) — уточнить причины вручную