AiHummer доки
v1.0.x
RU EN

Маркетплейс: обзор и тиры

v1.0.x · обновлено 2026-06-26

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

Три тира кратко

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

Tier 1 — отдельные host-native сервисы

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

Доступные сейчас коннекторы каналов: Telegram, MAX (новый российский мессенджер, канал max) и Bitrix24 (внутренний мессенджер для сотрудников, а не клиентский омниканал). В превью и на подходе: Discord, Slack, Teams, Matrix, Signal, Email и WhatsApp.

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

Tier 2 — внутрипроцессные инструменты/навыки

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

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

Tier 3 — zero-code источники

Плагины Tier 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 и другие. Полный разбор — в Zero-code интеграциях.

Каталог и CDN

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

Official и community

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

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

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

Куда дальше