Маркетплейс: обзор и уровни — AiHummer Документация

Маркетплейс плагинов — это то, как AiHummer расширяется за пределы встроенной среды выполнения. Его каталог синхронизируется из CDN, установка выполняется в один клик из админ-панели, и каждый плагин устанавливается напрямую в Linux под systemd, без Docker. Плагины бывают трёх уровней, различающихся тем, как они исполняются и что умеют.

Три уровня кратко

Уровень	Что это	Как работает	Доступы
Уровень 1 (Tier 1)	Отдельные сервисы (каналы, голос)	Свой sandbox-юнит systemd и порт	Общие (на рабочее пространство)
Уровень 2 (Tier 2)	Встроенные инструменты/навыки	Внутри процесса шлюза	Персональные или общие
Уровень 3 (Tier 3)	Источники без разработки (OpenAPI, MCP)	Синтезируются шлюзом, без кода	Персональные (OAuth на пользователя) или общие

Уровень 1 — отдельные сервисы

Плагины уровня 1 — это полноценные сервисы сами по себе: коннекторы каналов и голосовые компоненты, такие как плагины SIP, Bitrix24, Einstein и iOS-proxy. Каждый разворачивается как свой sandbox-юнит systemd, слушающий собственный порт, а шлюз общается с ним по HTTP. Это и есть принцип «установка напрямую в Linux под systemd, без Docker» в действии — плагин является управляемым системным сервисом, а не контейнером.

Коннекторы каналов в каталоге: Telegram входит в тариф Community; MAX (новый российский мессенджер, канал max), Bitrix24 (внутренний мессенджер для сотрудников, а не клиентский омниканал), а также Discord, Slack, Teams, Matrix, Signal, Email и WhatsApp требуют лицензии — см. заметку ниже.

[!NOTE] На тарифе Community доступен только базовый канал — Telegram. Установка любого другого канального коннектора требует активной лицензии Starter, Business или Enterprise; на Community запрос установки возвращает HTTP 402 «требуется повышение тарифа» (код plan_limit) — см. Лицензирование.

[!NOTE] Плагины уровня 1 не встраиваются в бинарный файл шлюза. Они устанавливаются и контролируются как отдельные службы systemd и доступны по URL — поэтому у каждого свой порт.

Уровень 2 — встроенные инструменты/навыки

Плагины уровня 2 — это инструменты/навыки, скомпилированные в шлюз и выполняющиеся внутри его процесса (in-process). Поскольку они работают встроенно от имени действующего пользователя, они могут использовать персональные или общие доступы: персональный режим привязывает действие к конкретному человеку (его доступ и атрибуция запроса), общий — использует один доступ на всё рабочее пространство.

[!NOTE] Персональные интеграции с внешними аккаунтами (Google, Microsoft, Todoist, Asana, Jira, ClickUp, GitLab, Spotify, Fitbit, Oura, SmartThings и др.) поставляются как интеграции без разработки, уровень 3 — это OAuth-интеграции на пользователя, которые каждый подключает к своему аккаунту.

Уровень 3 — источники без разработки

Плагины уровня 3 не требуют никакого интеграционного кода. Есть два типа источников:

OpenAPI — укажите спецификацию OpenAPI 3.x, совместимую с ограничениями механизма, и AiHummer синтезирует по одному инструменту на операцию.
MCP — подключите любой MCP-сервер по транспорту stdio или HTTP и выставьте его tools/list.

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

Через механизм OpenAPI с OAuth на пользователя уже доступен большой набор персональных интеграций — каждый подключает их к своему аккаунту: Gmail, Google Calendar, Google Contacts, Google Tasks, Google Drive, YouTube, Outlook Mail, Outlook Calendar, OneDrive, Microsoft To Do, Todoist, Asana, Jira Cloud, ClickUp, GitLab, Fitbit, Oura Ring, Spotify, Samsung SmartThings и другие. Полный разбор — в интеграциях без разработки.

Каталог и CDN

Каталог маркетплейса синхронизируется из CDN, поэтому список устанавливаемых плагинов остаётся актуальным без ручной упаковки с вашей стороны. Из админ-панели вы просматриваете каталог, устанавливаете в один клик и позволяете каждой установке автообновляться по своему расписанию.

Official и community

Каталог делится на два реестра, которые не смешиваются:

Official (первопартийный) — модули от AiHummer. Источник закреплён и доверяется по умолчанию (проверка против закреплённого ключа реестра); в веб-интерфейсе такие плагины помечены меткой Official и идут первыми.
Community (сторонний) — плагины внешних разработчиков, опубликованные через личный кабинет («Мои плагины» → загрузка → автоматическая проверка с помощью ИИ → модерация человеком). Подключаются как отдельный источник (community-catalog.json), который не перезаписывает официальный каталог; в списке такие плагины показываются без метки и сортируются по числу загрузок.

Оба реестра используют один и тот же контракт манифеста и один и тот же путь установки; различаются они происхождением и якорем доверия (см. Установку и обновления).

Куда дальше

Установка и обновления — жизненный цикл установки в один клик и sandbox-юниты systemd.
Plugin SDK — соберите свой плагин из одного manifest.json.
Публикация плагина — official и community реестр, два режима публикации.
Интеграции без разработки — OpenAPI и MCP подробно.