НАЧАЛО >> Документация модуля AI >> Руководство пользователя модуля AI📄 Скачать в DOCX
Модуль AI предоставляет интерфейсы для работы с агентными сценариями, AI-черновиками записей и ручной проверкой результатов. В текущем безопасном срезе модуль по умолчанию отключен для продуктивного выполнения и поддерживает диагностические сценарии без обращения к внешним облачным моделям.
Полный справочник по полям, кнопкам, результатам, правам и безопасному режиму каждой страницы находится в разделе ?id=Help/Show&m=AI/Help/Pages. Краткая карта интерфейсов:
AI/Ask - текстовый runtime-запрос; пользователь вводит prompt, а политика маршрутизации, system prompt и служебные флаги берутся из настроек модуля AI.FT/ShowFT с кнопкой "Спросить AI" - вопрос по открытому FT-документу, источники ответа, переход к странице и явная постановка подготовки текста в очередь.AI/Diagnostics - статус, проверка конфигурации, список allowlist-инструментов, provider/model routing, audit, отчет внешней передачи и инвалидирование производных данных.AI/Reviews - ручная проверка AI-черновиков, approve/reject/correct и применение после approval.AI не изменяет запись сразу. Сначала создается AI-черновик, затем review-задача. Пользователь проверяет результат, источники и diff, после чего выбирает одно из решений:
approve - результат можно применить, если у пользователя есть право EDIT на целевую БД и действие запускается с явным подтверждением.reject - результат отклоняется и не может быть применен.correct - пользователь фиксирует необходимость исправления. Коррекция должна содержать комментарий или исправленный payload/diff.Применение черновика выполняется через ApplyDraft. Кнопка применения на странице AI/Reviews появляется только после решения approve и поддерживает dry-run, чтобы сначала проверить права и параметры без записи в целевую БД.
В АРМ Каталогизатор выберите ИМИДЖ-запись и нажмите "AI-черновик". Действие автоматически получает текущие DBN и MFN и сразу ставит длительный анализ в штатную очередь. В окне прогресса видны текущие этапы: сбор OCR-кандидатов, контролируемая реконструкция текста, определение типа и стандарта, извлечение, независимая проверка, evidence validation, поиск дублей и создание review. Страницу не требуется удерживать в ожидании одного длинного HTTP-запроса; после успешного завершения готовый черновик открывается автоматически. Анализ сопоставляет поле 22, координатный OCR 953 и последние принятые OCR-артефакты. Модель может восстановить пробелы, переносы и пунктуацию, но реконструированный текст хранится только в AI-черновике и не заменяет поле 22; каждое добавляемое значение по-прежнему подтверждается конкретным исходным OCR-кандидатом. В окне проверки исходный и восстановленный тексты показаны отдельно. Для автора отдельно формируются фамилия, инициалы и раскрытие имени: первый автор записывается в неповторяемое поле 700, второй и последующие — в повторения поля 701. Место, издательство, год, объем, единица измерения и иллюстрации также сохраняются раздельно.
Черновик дополняет ту же запись в той же БД и не создает запись в IBIS. В открывшемся ExtJS-окне показаны текущие DBN/MFN, определенный рабочий лист с обоснованием, общая и полевая уверенность, этапы анализа, модель или fallback, исходный фрагмент, зона и номера строк для каждого значения, предупреждения и возможные дубли. Если обязательное значение не подтверждено OCR или уверенность недостаточна, это явно отмечается до утверждения. Кнопка "Исправить поля" открывает редактируемую таблицу добавляемых значений; изменения сохраняются в утверждаемом draft и попадают в журнал обратной связи вместе с исходным предложением. Кнопка "Утвердить и записать" утверждает review-задачу и сразу сохраняет изменения в исходной записи; кнопка "Отклонить" завершает операцию без изменения записи. Кнопка "Пересоздать черновик" после отдельного подтверждения ставит новый анализ текущей версии IMAGE-записи в очередь с forceNew=true; прежнее окно закрывается только после готовности новой review-операции, а прежний черновик остается в истории. Кнопка "Распознать повторно" запускает OCR v2: FT подготавливает изображение, сравнивает несколько PSM/языковых кандидатов отдельно для сторон и учитывает существующие 22/координатное 953. Поле 22 заменяется только при подтвержденном улучшении; низкокачественный оборот пропускается, а прежний текст сохраняется, если новый хуже. Валидный TSV, метрики, решение quality gate и кандидаты сохраняются в служебном артефакте, после чего автоматически ставится новый AI-анализ. Если запись изменилась до или во время OCR/AI-анализа, создание результата из устаревшего текста блокируется.
Тот же процесс доступен как агентный сценарий imageCatalog.toBibDraft: агентная сессия создает шаг преобразования, выполняет его через allowlist-инструмент, формирует AI-черновик и останавливается на review-задаче. Применение результата к исходной записи выполняется только после ручного подтверждения. Если запись изменилась после формирования черновика, применение блокируется и черновик нужно сформировать заново.
Диагностическая страница AI/Tools не входит в обычную пользовательскую навигацию. Администратор открывает ее из карточки записи AITool кнопкой диагностического запуска. Эксплуатационная страница AI/Agent также открывается отдельно: из настроек модуля AI в АРМ Администратор, когда нужно проверить или остановить агентную сессию вручную.
Прямой инструмент imageCatalog.toBibDraft также может создать review-задачу сам, если вызван с autoCreateReview=true. Для неоднозначных записей причины ручной проверки возвращаются в issues и попадают в риск review-задачи; без подтверждения пользователя черновик не применяется.
Вопрос задается непосредственно в просмотрщике FT/ShowFT. Если модуль AI включен и доступен пользователю, в просмотрщике появляется кнопка "Спросить AI". SID текущей FT-записи передается автоматически и не вводится вручную. Политика маршрутизации и служебные runtime-флаги берутся из настроек модуля AI и не показываются в форме.
Thinking-модели используются только для формирования итогового ответа: внутренний reasoning не показывается пользователю и не подменяет ответ. Если поставщик не сформировал итоговый текст, виджет сообщает об управляемой ошибке вместо сообщения об успешном пустом ответе.
Порядок работы:
FT/ShowFT и нажимает "Спросить AI".ft.getText, выбирает несколько релевантных chunk-фрагментов, формирует prompt и выполняет AI::Ask().ft.prepareDocument.Если для документа подготовлены координаты страниц FT/Paged/coord/fullNNNNN.txt, ссылка источника содержит page и squery и открывает соответствующую страницу со словом цитаты. Semantic search по FT использует те же подготовленные chunks и не показывает фрагменты, на которые у пользователя нет права VIEW.
Если FT/idx.txt еще не готов и пользователь подтвердил действие "Подготовить текст", модуль вызывает ft.prepareDocument. Статус такой задачи проверяется через queue.getProgress.