POST /api/elicitation — Запустить элицитацию постановки
Как открыть: «+ Новый проект» → под текстареей описания задачи блок «Уточнение постановки»: галочка «Разрешить веб-поиск по незнакомым терминам» (по умолчанию снята) и кнопка «Уточнить постановку» (активна от 30 знаков). Гостям блок не показывается.
Элицитация помогает превратить размытую постановку в уточнённую: система читает текст задачи, находит в нём непонятные термины и профессиональный сленг и возвращает до 7 вопросов для интервью с заказчиком (не меньше четырёх — про ядро задачи, остальные — про обвязку: роли, безопасность, эксплуатацию).
Если дано согласие на выход в интернет (web_search_consent: true), система
сначала пытается сама разобраться в незнакомых терминах через веб-поиск: ищет,
проверяет, что найденное относится именно к контексту постановки (а не случайный
шум), и использует подтверждённую фактуру, чтобы вопросы были точнее. Без
согласия ни одного сетевого вызова не происходит — непонятные термины
превращаются в прямые вопросы «что вы имеете в виду под …».
Термины сначала сверяются с глоссарием организации (память, раздел терминологии) — знакомый сленг вопросов не порождает. Результаты проверенных поисков запоминаются в кеше организации, поэтому повторные прогоны с теми же терминами проходят быстрее и не ходят в интернет заново.
Полный цикл с поиском занимает до двух минут — для таких прогонов рекомендован
асинхронный режим (?mode=async) с опросом статуса. Ограничения: текст задачи —
до 20 000 символов; частота — общий лимитер генераций.
Связанные
Машинная сводка (HTTP, таблицы, связанные требования)
| Поле | Значение |
|---|---|
| HTTP | POST /api/elicitation |
| Auth | requireAuth — только авторизованный |
| Scope токена | read_write |
| PG-функции | api.create_elicitation_run, api.finish_elicitation_run, api.get_cached_term, api.upsert_cached_term, api.list_terminology_terms |
| Таблицы | elicitation_run, search_term_cache, generation_job |
| SRM | SRM-389 |
| RP (права) | — |
| Файл роута | server/routes/elicitation.js |
| Статус | done |
Аргументы запроса (best-effort из хендлера; путь-параметры опущены):
| Аргумент | Где | Обяз. | Заметка |
|---|---|---|---|
task_text | body | подтвердить | |
web_search_consent | body | подтвердить | |
mode | query | подтвердить |
Коды ответов/ошибок (из хендлера): 202, 400, 429, 500, 502 (+ 200) — уточнить причины вручную