Назад

Инструкция по эксплуатации платформы

Платформа НейроВижн™ — это комплекс решений компьютерного зрения для KYC/AML, работы с лицами и видеоаналитики.
Ниже — практическое руководство для операторов и администраторов: от регистрации и статистики до «Работы с лицами», токенов доступа и полного контура KYC.

Для интеграции через API/Web SDK см. ссылки внутри соответствующих разделов.

Личный кабинет

Регистрация и вход

Пользователь регистрируется по e‑mail. Для регистрации требуется *invite‑код* — его выдаёт ваш администратор или представитель компании NeuroVision.

После входа пользователь попадает в личный кабинет.

*Регистрация и вход в платформу*

Раздел «Статистика» (дашборд KYC)

Один из основных разделов ЛК — Статистика. Здесь расположены ключевые показатели, фильтры и настройки. Для новых аккаунтов счётчики нулевые.

*Сводный дашборд*

Состав дашборда KYC:

  1. Процент успешных/отклонённых сессий — за выбранный интервал и по выбранному сценарию.
  2. Распределение ошибок — «пирог» с долями типов ошибок (например, «не видны поля», «экран/распечатка», и т. д.).
  3. Успешность по попыткам — «пирог» с долями сессий, прошедших с 1‑й, 2‑й, 3‑й попытки и т. д.
  4. Динамика по дням — столбчатая диаграмма: количество и доля успешных/неуспешных сессий по датам.

Статистика рассчитана на самостоятельный анализ без сторонних BI‑инструментов: фильтруйте, группируйте данные прямо здесь.

Работа с лицами

Этот блок объединяет три области: Источники данных, Списки персон и История операций (Face search).

Источники данных

Источники — это каналы, через которые платформа НейроВижн™ получает изображения/видеопотоки: камеры видеонаблюдения, фотофайлы, архивные видео.

*Раздел «Источники данных»*

Добавление нового источника

  1. Откройте Источники данных → Добавить новый источник.
  2. Укажите:
  • Название источника
  • Параметры проверки лиц на дополнительные признаки (при необходимости)
  1. Нажмите Create source.

Группы источников

  • Создавайте группы, чтобы объединять источники по локациям/проектам.

Просмотр и статус

  • В списке видны: активность, базовая статистика, состояние.

Списки персон

Раздел Списки персон — ключевой: здесь хранится база людей, которых система распознаёт.

*Списки, карточки и поиск по лицам*

Операции со списками и персонами

  • Добавить персону: загрузите фото (одну или несколько), укажите данные.
  • Импорт из нескольких файлов — массовое добавление.
  • Редактирование карточки: заменить фото, обновить поля, найти похожие, переместить в другой список.
  • Удаление: по одной персоне или батчем.

Аналитика и оповещения

  • Настройте события.
  • Используйте агрегированную аналитику посещаемости и активности.

История операций (Face search)

История операций — это журнал событий распознавания и действий в админ‑панели.

*Журнал распознаваний и действий*

Что доступно

  • Просмотр хронологии с фильтрами по источникам, группам, датам, персоне.
  • Переход в карточку персоны/источника, навигация по связанным объектам.

Токены доступа (Access Tokens)

Токены используются для аутентификации/авторизации запросов к API.

*Раздел «Access Tokens»*

Создать токен

  1. Access Tokens → Создать новый токен.
  2. Укажите название, срок действия (если нужен), права.
  3. Сохранить.

Просмотр/редактирование/удаление

  • Список токенов; по клику — редактирование/удаление.

Как передавать токен Особенность для эндпоинтов: токен можно (и часто удобнее) передавать в теле запроса как поле token. Пример:

# URL конечной точки
url = "https://api.neuro-vision.ru/v1/kyc/process"

# Параметры для KYCDocument
data = {
    "token": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",        # токен передаём в теле
    "schemaId": "ca30efc0-9202-11f0-ad12-90496423b317",
    "mode": "sync",                                    # или "async"
}

Для полной спецификации смотрите соответствующие разделы API. В большинстве эндпоинтов допустим любой вариант (заголовок/тело), но в форме multipart/form-data часто удобнее поле token.

Важно

  • Храните токены как секреты, не делитесь третьим лицам и не публикуйте.

Help Center (Центр помощи)

*Поддержка и уведомления*

  • Support — контакты поддержки, база знаний (FAQ/статьи/видео).
  • Notifications — системные сообщения об обновлениях и регламентных работах.
  • Create Issue — тикеты в поддержку с файлами и отслеживанием статуса.

KYC (Know Your Customer) / AML

Основной раздел для работы с поступающими и поступившими запросами.

*Рабочие разделы KYC/AML*

KYC Logs (онлайн‑журнал)

В режиме реального времени в KYC Logs отображаются приходящие сессии. Каждая «плашка» — это сессия, собранная по настроенному сценарию (комбинации шагов: документ(ы), селфи, liveness).

Что видно справа в логах:

  • Результат по документу: распознанный тип, OCR‑поля с уровнями уверенности, статус подлинности.
  • Антифрод‑проверки: MRZ и контрольные суммы, признаки экрана/распечатки/редактирования, печати/подписи и др.
  • Результат по селфи: что это реальное селфи, документ в руке (если нужен), корректная связка с документом шага 1.
  • Face Matching: сравнение лиц между селфи и документами (включая «селфи с документом»); значения схожести.
  • Проверки по базам (если подключены): МВД, ФССП и др.
  • При неуспехе — причина и разбор проблемы.

Результат работы доступен в JSON (структура совпадает с ответом API). Количество разрешённых неудачных попыток съёмки настраивается. Доступна блокировка по чёрным спискам (по лицу).

*Добавление сессии вручную для тестов/ручной проверки*

KYC Reports (отчёты)

История всех сессий без realtime‑обновления — для просмотра, фильтрации и выгрузки (CSV).

Фильтры: по дате, статусу, OCR‑значениям (ФИО/номер/город и т. п.), по ошибкам, по сценарию.

*Фильтрация и экспорт в CSV*

KYC Editor (редактор сценариев)

В редакторе настраиваются сценарии прохождения KYC — любые комбинации документов, селфи и (опционально) liveness.

*Список созданных сценариев*

Общие свойства сценария

  • ID сценария (schemaId) — идентификатор схемы, используйте в API/SDK.
  • Секретный ключ — для шифрования уведомлений/коллбеков.
  • URL мобильного редиректа при успехе — куда перенаправлять после успешной сессии.
  • Список лиц клиентов — список из раздела «Персоны», куда добавлять распознанных клиентов для последующего поиска.
  • Чёрный список лиц — список, совпадение с которым блокирует сессию.
  • Критические ошибки до блокировки — напр., 3. Это защита от «перебора» фродовых изображений (вероятностные модели).
  • Время хранения данных сессии (в днях) — 0 = бесконечно.
  • Время жизни сессии до заморозки (мин.) — по истечении добавлять новые изображения нельзя.
  • Флаги:
  • Блокировать, если в одном шаге попали два разных документа.
  • Блокировать, если одно лицо подавало тот же тип документа с другими данными (поиск фрода по истории).
  • Сопоставлять выдавший орган с базой кодов подразделений (повышение уверенности).
  • Допустимый возраст — диапазон (по дате рождения из документа).

*Настройки уведомлений (callback)*

Callback (уведомления на ваш backend)

  • Backend Callback URL — адрес, на который отправлять уведомления о ходе/итоге сессии.
  • Флаги:
  • Шифровать тело POST секретным ключом;
  • Не отправлять персональные данные (только статусы);
  • Уведомлять только при финализации (без промежуточных статусов);
  • Отправлять проверки по БД по мере готовности.

Шаги проверки (Steps)

*Шаг #1 — документ(ы)*

  • Выберите тип(ы) документа (паспорт/ID/ВУ/… ) и страны.
  • Включите нужные проверки качества/антифрода, например:
  • документ полностью видим;
  • обработка MRZ (не пропускать без MRZ);
  • следы редактирования (isEdited);
  • фото с экрана (isDisplay), мобильное устройство;
  • ксерокопия/распечатка;
  • логические несоответствия полей;
  • блики/размытость/ветхость;
  • подпись/печать/обязательные элементы и пр.
  • Рамка документа для WebSDK на слабых устройствах — вертикальная или горизонтальная.

*Пример настроек шага для документов*

*Шаг #2 — селфи (или селфи с документом)*

  • Проверки:
  • Изображение не модифицировано, не «фото с экрана»;
  • Документ видим на селфи (если требуется);
  • Возраст/пол по лицу (и сопоставление с документом);
  • Deepfake/синтетика — защита от подмены лица;
  • Общие требования к качеству (резкость, освещение и т. п.).

*Пример настроек шага для селфи*

Настройка WebSDK (параметры виджета, clientKey, callbacks) подробно описана в разделе Web SDK; в пользовательскую инструкцию детали не дублируются.

KYC‑ссылки (одноразовые ссылки)

Раздел для генерации одноразовых ссылок на прохождение KYC:

  • Выберите сценарий, временной интервал жизни ссылки, количество ссылок (1…1000).
  • Снизу отобразится список созданных ссылок с индикатором статуса (успех/неуспех/открыта и т. д.).

*Генерация одноразовых ссылок*

Примечание о версиях

Функции и интерфейсы могут отличаться в зависимости от версии платформы и настроек вашего контура. За уточнениями обращайтесь к администратору или в поддержку.