GET /api/collections/:id/prompts — Промпты коллекции

Сгенерировано из матриц + кода. Правки вносить в источники (docs/matrices/, server/routes/), не здесь.

Поле	Значение
HTTP	`GET /api/collections/:id/prompts`
Auth	`—`
Scope токена	`read`
PG-функции	`api.get_collection_prompts`
Таблицы	`collection_prompt`
SRM	SRM-234
RP (права)	—
Файл роута	`server/routes/collections.js`
Статус	done

Аргументы запроса (best-effort из хендлера; путь-параметры опущены):

аргументов не обнаружено (подтвердить вручную по server/routes/collections.js)

Коды ответов/ошибок (из хендлера): 200 — уточнить причины вручную

Для человека

Как открыть: орг-админ → раздел «Коллекции» → карточка коллекции → редактор → кнопка/меню «Промпты». Открывается окно с промптами — этот запрос заполняет его текущими значениями.

Возвращает промпты всех трёх этапов конвейера генерации этой коллекции:

Подбор блоков — какие типовые блоки коллекции выбрать под задачу.
Описания — что написать о каждом выбранном блоке и какие роли назначить.
Связи — какие причинно-следственные связи провести между блоками.

Для каждого этапа есть системный промпт и шаблон сообщения пользователя. Это позволяет точнее настроить генерацию под конкретный домен коллекции. Здесь промпты только показываются; правка и сохранение — отдельные действия в том же окне.

Кто может. Администратор с доступом к коллекции (орг-админ с доступом к ней либо администратор платформы). Сотруднику и наблюдателю раздел «Коллекции» недоступен.

Для агента

Чтение — достаточно токена со scope read (см. Конвенции). Доступ — read-access к коллекции (site-admin, либо org-admin с доступом к ней); общий guard раздела требует, чтобы владелец токена был администратором хотя бы одной организации. Иначе — 403.

Тела запроса нет; коллекция задаётся в пути (:id).

Пример запроса:

curl https://specbuilder.vnimanie.ai/api/collections/a1b2c3d4-.../prompts \
  -H "Authorization: Bearer tak_..."

Ответ 200: массив записей по этапам (stage — decompose | describe | dependencies), у каждой — системный промпт и шаблон сообщения пользователя.

[
  { "stage": "decompose", "system_prompt": "Ты подбираешь...", "user_template": "{{userPrompt}}{{instructionBlock}}" },
  { "stage": "describe", "system_prompt": "Для каждого блока...", "user_template": "{{userPrompt}}{{instructionBlock}}" },
  { "stage": "dependencies", "system_prompt": "Определи связи...", "user_template": "{{userPrompt}}{{instructionBlock}}" }
]

Сохранение конкретного этапа — через сохранение промпта (PUT .../prompts/{stage}); вариант промпта от LLM — через предложение промпта.

Связанные

Экраны: Редактор коллекции
Конвенции · Роли · Ошибки · Глоссарий