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. Человеческий взгляд: как это устроено простыми словами?
Представь, что твоя облачная операционная система — это единый организм:
- ICNLI Ядро — мозг и нервная система (Temporal workflows + Redis Streams), которая гарантирует, что ни одна задача не потеряется, даже если сервер перезагрузится прямо во время выполнения.
- Webbee 🐝 — агентный интеллект, который понимает живую речь на любом языке и превращает слова в точные действия через зарегистрированные инструменты.
- 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
- Обновите SDK в виртуальном окружении:
pip install --upgrade imperal-sdk - Укажите в
imperal.json:{ "manifest_schema_version": 3, "sdk_version": "6.0.1", "version": "1.0.0" } - Сделайте
git pushи разверните приложение через Developer Portal одной кнопкой!
Imperal SDK overview
The Imperal SDK — build federal-grade Python extensions for Webbee: manifest schema v3, typed Pydantic params, runtime quality guarantees & federal validators.
Element Catalog
Browse every element of the Imperal SDK in one place — UI components, decorators, SDL roles, ctx methods and data types, each with a copy-pasteable example.