Imperal Docs
SDK Reference

ICNLI Quantum SDK v6.0.1

Полноценное руководство по ICNLI Quantum SDK v6.0.1 — универсальный Ambient Context, геодезический роутинг намерений, морфометрический UI и полная изоляция данных.

ICNLI Quantum SDK v6.0.1

ICNLI Quantum SDK v6.0.1 — это квантовый скачок в архитектуре Imperal Cloud OS. Мы создали протокол и SDK, в котором разработчикам больше не нужно писать километры шаблонного кода для авторизации, стейта, очередей и кэшей. Всё работает согласованно, безопасно и с математической гарантией стабильности.

Что изменилось в v6.0.1?

В версии 6.0.1 внедрена полная доменная изоляция Redis (db=0 Финансы, db=1 UI-кэш, db=2 Сессии, db=3 Локи), защита сторонних клиентов (включая WebHostMost), геодезическая маршрутизация намерений без единого лишнего LLM-вызова и универсальный Ambient Context.


1. Человеческий взгляд: как это устроено простыми словами?

Представь, что твоя облачная операционная система — это единый организм:

  1. ICNLI Ядро — мозг и нервная система (Temporal workflows + Redis Streams), которая гарантирует, что ни одна задача не потеряется, даже если сервер перезагрузится прямо во время выполнения.
  2. Webbee 🐝 — агентный интеллект, который понимает живую речь на любом языке и превращает слова в точные действия через зарегистрированные инструменты.
  3. Quantum SDK — мост, через который любое приложение (биллинг, файлы, почта, серверы) мгновенно становится доступным для Webbee и пользователя, получая встроенный интерфейс, строгую безопасность и автоматическое логирование.

2. Ключевые возможности Quantum SDK v6.0.1

2.1 Universal Ambient Context

Больше не нужно вручную прокидывать user_id, tenant_id, billing_tier или токены доступа. Контекст доступен из любого места:

from imperal_sdk import App, Context

app = App("my-service", version="1.0.0")

@app.tool(category="infrastructure", description="Перезагрузить сервер пользователя")
async def restart_server(server_id: str, ctx: Context) -> dict:
    # ctx.user_id, ctx.tenant_id, ctx.scopes уже валидированы и доступны
    print(f"Запрос от пользователя {ctx.user_id} на сервере {server_id}")
    return {"status": "rebooting", "server_id": server_id}

2.2 Доменная изоляция данных (Zero-Leak Redis Architecture)

В ядре действует абсолютный инвариант изоляции:

  • База 0 (Финансовый домен): Кошельки, транзакции, тарифные лимиты. Никогда не инвалидируется при деплое.
  • База 1 (UI-кэш и скелетоны): Мгновенные снимки панелей для ультрабыстрого рендера. Сбрасывается безопасно при релизе.
  • База 2 (Сессионный контекст): Активные диалоги, временная память и контекстные каналы.
  • База 3 (Распределённые замки): Дедупликация idempotency-ключей и блокировки параллельных списаний.

Защита сторонних префиксов

Инвариант I-REDIS-DOMAIN-ISOLATION-AND-WHM-SAFETY гарантирует, что ключи пользователей WebHostMost (whm:*) и системные кошельки защищены на бинарном уровне и никогда не могут быть случайно стёрты или перезаписаны.

2.3 Морфометрический Declarative UI (CLS=0)

Интерфейсы строятся декларативно через Python-компоненты. Никакого CSS-ада и верстки на фронтенде — ядро само рассчитывает гармоничную сетку по правилам Риччи-потоков:

  • Таблицы с автоматической пагинацией и поиском.
  • Карточки метрик со спарклайнами и цветовой индикацией статуса.
  • Модальные оверлеи с двухуровневым подтверждением опасных действий.

3. Системные модули Imperal: простое объяснение

Для обычного пользователя каждый модуль платформы выполняет конкретную, прозрачную задачу:

МодульЗачем он нужен?Что делает для тебя?
Billing (Биллинг)Твой кошелек и тарифПоказывает текущий баланс токенов, расход на AI-модели, активные тарифы (Pro/Business), историю платежей и закрывающие документы.
Admin (Админка)Центр управления платформойУправление пользователями, ролями, доступом к расширениям, мониторингом LLM-провайдеров и состоянием системы.
Developer (Портал разработчика)Твоя фабрика приложенийПозволяет в один клик опубликовать свое расширение из Git, настроить цены за вызовы и монетизировать свои инструменты в маркетплейсе.
Marketplace (Каталог)Магазин расширенийПоиск и установка официальных и сторонних модулей (Google Analytics, WordPress, Proxmox, SEO, Mail и др.).
Automations (Автоматизации)Твой неутомимый роботПравила по расписанию (cron) или по событиям (получил письмо -> создал задачу в Vikunja -> отправил уведомление в Telegram).
Memory & Thoughts (Память и Мысли)Долговременная память WebbeeХранит факты о твоих проектах, директивы, правила работы и архив диалогов на всех устройствах.
Coding Remote (Терминал)Удаленное управление кодомМост между терминалом на твоем ноутбуке и мобильным приложением / панелью Webbee.

4. Быстрый старт на Quantum SDK v6.0.1

  1. Обновите SDK в виртуальном окружении:
    pip install --upgrade imperal-sdk
  2. Укажите в imperal.json:
    {
      "manifest_schema_version": 3,
      "sdk_version": "6.0.1",
      "version": "1.0.0"
    }
  3. Сделайте git push и разверните приложение через Developer Portal одной кнопкой!

On this page