AegisAI — платформа безопасности ИИ-агентов¶

AegisAI — это платформа безопасности и управления ИИ-агентами корпоративного уровня. Она обеспечивает контроль действий агентов, применение политик, аудит, обнаружение аномалий и согласование критических операций человеком (Human-in-the-Loop, HITL).

О платформе

Текущая версия на main: 1.1.0 (Prompt Guard, Shadow AI, hybrid anomaly). Первый публичный тег: 1.0.0. AegisAI объединяет движок политик на базе Open Policy Agent (OPA) и Rego, машинное обучение для обнаружения аномалий, многофакторную оценку рисков и современную панель управления на Vite.

Ключевые возможности¶

Возможность	Описание
Реестр агентов	Регистрация, мониторинг и управление жизненным циклом ИИ-агентов
Движок политик	OPA + Rego: GDPR, HIPAA, ФЗ-152, HITL и пользовательские правила
Prompt Guard	Проверка промптов на injection / jailbreak / leakage (rules + ML + OPA)
Аудит	Неизменяемый журнал действий с цифровой подписью и экспортом
Аномалии	Supervised / Isolation Forest / ONNX + правила; Shadow AI discovery
HITL	Рабочий процесс согласования критических операций
Панель управления	SPA на Vite с KPI, графиками и управлением политиками
SDK и интеграции	Python SDK, LangChain, OpenAI, Webhooks, WebSocket
SSO / OIDC	Keycloak, Okta, Google Workspace, Microsoft Entra ID
Экспорт в SIEM	Syslog, CEF, LEEF, JSONL → Splunk HEC, ELK

Технологический стек¶

graph TB
    subgraph Frontend
        V[Vite SPA :5173]
    end
    subgraph Backend
        F[FastAPI :8000]
        O[OPA :8181]
    end
    subgraph Data
        P[(PostgreSQL)]
        R[(Redis)]
    end
    V -->|REST / WebSocket| F
    F --> P
    F --> R
    F --> O

Компонент	Технология
API	FastAPI, Uvicorn, Pydantic v2
Фронтенд	Vite 5, Vanilla JS, Tailwind CSS, Chart.js
База данных	PostgreSQL 15, SQLAlchemy 2 (async), Alembic
Кэш / очереди	Redis 7
Политики	Open Policy Agent (OPA), Rego
Аутентификация	JWT, API-ключи, SSO (OIDC)
Развёртывание	Docker Compose

Быстрый старт¶

cp .env.example .env
docker compose up --build

После запуска доступны:

Сервис	URL
Панель управления	http://localhost:5173
API (Swagger)	http://localhost:8000/docs
OPA	http://localhost:8181
Устаревшая панель	http://localhost:8000/dashboard

Демо-данные

docker compose exec app poetry run python scripts/seed_data.py --reset
# или расширенный набор:
./scripts/run_demo_data.sh --reset

Разделы документации¶

Начало работы — установка, первый вход, настройка API-ключа
Архитектура — компоненты, потоки данных, безопасность
Руководство пользователя — работа с панелью управления
Руководство администратора — пользователи, роли, SSO, SIEM, мониторинг
Руководство разработчика — API, SDK, Prompt Guard, Webhooks
Prompt Guard — защита от prompt injection
Развёртывание — Docker, VPS, устранение неполадок

Лицензия¶

Проприетарная лицензия — AegisAI Platform.