Исследовательский конвейер Adminica разбивает задачу на семь этапов с русскими именами и короткими кодами. Порядок жёсткий: от постановки цели до итоговой сборки. Внутри этапа модель свободна в тактике, но артефакты каждого шага описаны контрактом — так проще проверять качество и показывать прогресс в UI.
Карта этапов
| Код | Этап | Что фиксируется |
|---|---|---|
| ПР | Поручение | Цель, scope, аудитория, формат ответа (≤7 строк) |
| РЗ | Разведка | Известное, неизвестное, риски, зоны поиска |
| ПК | План и критерии | Блоки работ + КГ на каждый блок |
| ПРБ | Проработка | Гипотеза → наблюдение → вывод по блокам |
| СВ | Промежуточные сводки | Сжатый итог блока + статус КГ |
| ИС | Учёт источников | Факты с cite_id; без источника — «не подтверждено» |
| СБ | Итоговая сборка | Финальный markdown только из сводок и подтверждённых фактов |
КГ — критерии готовности
В проекте используется термин КГ (критерии готовности), не «Definition of Done». На этапе ПК у каждого блока плана поле kriterii_gotovnosti — проверяемое условие: «все тезисы имеют cite», «сравнена таблица из главы 3». На этапе СВ поле kg_status: done, partial или blocked. Это не бюрократия ради бюрократии: финальная сборка (СБ) не должна включать факты, которые не прошли учёт источников (ИС).
Глобальное правило scope
Если в разведке или проработке выяснилось, что цель сместилась, конвейер требует явный delta к Поручению и обновление Плана (ПК). Локальные шаги сверяются с архитектурой ответа, зафиксированной на ПР: структура заголовков, глубина, тон. При развилке агент (и модель в бэкенде) кратко сравнивает варианты A/B с рекомендацией.
Два режима выполнения
| Режим | Когда | Вызовы LLM |
|---|---|---|
| two-pass | Gather (ПР–ИС) одним проходом + present (СБ) | 2 |
| orchestrated | Отдельный вызов на этап; РЗ может быть skipped для короткого запроса | 3–7 |
В чате исследование обычно идёт по полной цепочке этапов. Простые запросы с одним файлом могут пропустить Разведку — это видно в степпере серым статусом «пропущено».
Иерархия контекста L0–L4
- L0 — Поручение (меняется только через delta).
- L1 — План и критерии (replan).
- L2 — рабочая память с фактами и cite на проработке.
- L3 — промежуточные сводки после блоков.
- L4 — черновики gather; в финал не попадают.
Финальный present (СБ) получает материалы как === TRUSTED: материалы исследования === — без сырого ненадёжного RAG-контекста в последнем проходе.
Итог: семь этапов ПР–СБ задают дисциплину исследования; КГ на каждом блоке и учёт источников защищают финал от «уверенных» галлюцинаций.