PUT /api/collections/:id/prompts/:stage — Сохранить промпт этапа
Как открыть: орг-админ → раздел «Коллекции» → карточка коллекции → редактор → кнопка/меню «Промпты» → отредактировать промпт нужного этапа → «Сохранить».
Сохраняет промпт одного этапа конвейера генерации этой коллекции: «Подбор блоков», «Описания» или «Связи». Если промпта для этапа ещё не было — он создаётся, если был — перезаписывается (upsert). Сохраняются системный промпт и шаблон сообщения пользователя.
С этого момента генерация коллекции (и проектов из неё) использует ваш промпт вместо стандартного. Этап указывается в адресе и должен быть одним из трёх допустимых — иначе сохранение не выполнится.
Кто может. Только владелец коллекции: орг-админ организации-владельца (или администратор платформы — для глобальных коллекций). Администратор другой организации, сотрудник и наблюдатель править промпты не могут.
Связанные
- Экраны: Редактор коллекции
- Конвенции · Роли · Ошибки · Глоссарий
Машинная сводка (HTTP, таблицы, связанные требования)
| Поле | Значение |
|---|---|
| HTTP | PUT /api/collections/:id/prompts/:stage |
| Auth | — |
| Scope токена | read_write |
| PG-функции | api.upsert_collection_prompt |
| Таблицы | collection_prompt |
| SRM | SRM-236 |
| RP (права) | — |
| Файл роута | server/routes/collections.js |
| Статус | done |
Аргументы запроса (best-effort из хендлера; путь-параметры опущены):
| Аргумент | Где | Обяз. | Заметка |
|---|---|---|---|
system_prompt | body | подтвердить | |
user_template | body | подтвердить |
Коды ответов/ошибок (из хендлера): 200 — уточнить причины вручную