MOD-AI-VALIDATION — Валидация ИИ

Лицензия: Платный

Модуль отвечает на вопрос «какому ИИ в этом контуре вообще позволено работать и над чем». Он держит четыре связанных реестра — провайдеры, модели, промпты и агенты проверки — и делает каждое решение об ИИ явной записью, а не настройкой в переменной окружения.

Провайдер языковых моделей заводится карточкой: код, тип, адрес сервиса, состояние. У провайдера свои модели, и у каждой модели признак допуска к персональным данным задаётся ЯВНО — это требование ФЗ-152, а не удобство: «забыл отметить» не должно молча означать «можно отправлять ПДн». Удаление провайдера уносит его модели, поэтому и удаление провайдера, и удаление модели требуют confirm=true (BLK-AI-2).

Промпты живут версиями, а не переписыванием на месте. Новая версия шаблона создаётся ЧЕРНОВИКОМ и не влияет ни на что, пока её не активируют отдельным вызовом; активация переводит предыдущую активную версию в «устаревшая». Поэтому всегда видно, каким именно текстом промпта был получен конкретный результат, и откат — это активация прежней версии, а не восстановление из памяти.

Агенты проверки устроены так же строго. Агент имеет код, тип, состояние, порог уверенности и режим блокировки; новый агент — черновик, он требует проверки человеком и НЕ блокирует ничего автоматически. У агента свои версии (создаются неактивными, активируются отдельно), свои проверки — какие типы сущностей он умеет проверять — и свои инструменты с режимом доступа и списком доступных путей, причём режим по умолчанию «только чтение». Удаление агента уносит версии, проверки и инструменты и тоже требует подтверждения.

Возможности

Реестр провайдеров языковых моделей: код, тип, адрес сервиса, состояние
Модели провайдеров с ЯВНЫМ признаком допуска к персональным данным (ФЗ-152)
Удаление провайдера и модели — деструктив с обязательным confirm=true
Версионируемые шаблоны промптов: новая версия создаётся черновиком
Активация версии промпта переводит предыдущую активную в «устаревшая»; отдельная пометка версии устаревшей
Чтение активной версии промпта без указания номера версии
Реестр ИИ-агентов проверки: код, тип, состояние, порог уверенности, режим блокировки
Новый агент — черновик: требует проверки человеком и не блокирует автоматически
Версии агента: создаются неактивными, активируются отдельным вызовом
Проверки агента: какие проверки он выполняет и для каких типов сущностей
Инструменты агента с режимом доступа и списком доступных путей; режим по умолчанию — только чтение
Удаление агента вместе с версиями, проверками и инструментами — с обязательным confirm=true
Настройки модуля: описание схемы, чтение и запись
Проверка готовности модуля живым соединением с БД

Основные MCP-инструменты

Инструмент	Назначение
`ai-validation__describe_blocks`	Блоки холста для библиотеки MOD-CANVAS
`ai-validation__describe_entities`	Метаданные сущностей модуля без самих данных
`ai-validation__get_canvas_presets`	Пресеты холстов (JSON-DSL) по роли
`ai-validation__check_ready`	Готовность модуля: живое соединение с БД
`ai-validation__provider.list`	Реестр провайдеров языковых моделей
`ai-validation__provider.upsert`	Создать или обновить провайдера по коду
`ai-validation__provider.delete`	Удалить провайдера вместе с моделями (нужен `confirm=true`)
`ai-validation__model.list`	Модели провайдеров с признаком допуска к ПДн
`ai-validation__model.upsert`	Создать или обновить модель провайдера
`ai-validation__model.delete`	Удалить модель провайдера (нужен `confirm=true`)
`ai-validation__prompt.list`	Версии шаблонов промптов с состоянием и связью с набором правил
`ai-validation__prompt.get`	Версия промпта; без номера возвращается активная
`ai-validation__prompt.upsert`	Создать или изменить версию промпта (создаётся черновиком)
`ai-validation__prompt.activate`	Сделать версию промпта активной
`ai-validation__prompt.deprecate`	Пометить версию промпта устаревшей
`ai-validation__agent.list`	Реестр ИИ-агентов проверки
`ai-validation__agent.get`	Получить агента проверки по коду
`ai-validation__agent.upsert`	Создать или обновить агента (новый — черновик)
`ai-validation__agent.delete`	Удалить агента с версиями, проверками и инструментами (нужен `confirm=true`)
`ai-validation__agent_version.list`	Версии агента с признаком активной
`ai-validation__agent_version.create`	Создать версию агента (создаётся неактивной)
`ai-validation__agent_version.activate`	Сделать версию агента активной
`ai-validation__agent_capability.list`	Проверки агента и типы проверяемых сущностей
`ai-validation__agent_capability.set`	Добавить или изменить проверку агента для типа сущности
`ai-validation__agent_tool.list`	Инструменты агента с режимом доступа и путями
`ai-validation__agent_tool.set`	Добавить или изменить инструмент агента
`ai-validation__settings.describe`	Схема настроек модуля
`ai-validation__settings.get`	Текущие настройки модуля
`ai-validation__settings.set`	Изменить настройки модуля

Блоки холста

Блок	Назначение
`aival_providers_table`	Провайдеры ИИ — реестр подключённых провайдеров языковых моделей
`aival_models_table`	Модели ИИ — языковые модели с признаком допуска к персональным данным
`aival_agents_table`	Агенты ИИ — реестр агентов проверки
`aival_prompts_table`	Шаблоны промптов — версии с их состоянием

Связанные модули

MOD-NL — исполнение команд на естественном языке через языковые модели
MOD-RAG — база знаний, из которой ИИ берёт контекст
MOD-ASSISTANT — ИИ-ассистент, оркестрирующий агентов
MOD-PII — персональные данные, допуск к которым отмечается у модели