Маркетплейс плагинов — это то, как 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» в действии — плагин является управляемым
системным сервисом, а не контейнером.
Коннекторы каналов в каталоге: В Community доступны Telegram и MAX.
MAX (новый российский мессенджер, канал max).
Bitrix24 (внутренний
мессенджер для сотрудников, а не клиентский омниканал), а также Discord, Slack,
Teams, Matrix, Signal, Email и WhatsApp требуют лицензии — см. заметку ниже.
[!NOTE]
В Community доступны Telegram и MAX. Установка любого другого канального коннектора требует активной
лицензии 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), который не
перезаписывает официальный каталог; в списке такие плагины показываются без
метки и сортируются по числу загрузок.
Оба реестра используют один и тот же контракт манифеста и один и тот же путь
установки; различаются они происхождением и якорем доверия (см.
Установку и обновления).
**Маркетплейс плагинов** — это то, как 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» в действии — плагин является управляемым
системным сервисом, а не контейнером.
**Коннекторы каналов в каталоге:** В Community доступны Telegram и MAX.
- MAX (новый российский мессенджер, канал `max`).
- Bitrix24 (внутренний
мессенджер для сотрудников, а не клиентский омниканал), а также Discord, Slack,
Teams, Matrix, Signal, Email и WhatsApp требуют лицензии — см. заметку ниже.
> [!NOTE]
> В Community доступны Telegram и MAX. Установка любого другого канального коннектора требует активной
> лицензии **Starter**, **Business** или **Enterprise**; на Community запрос
> установки возвращает **HTTP 402 «требуется повышение тарифа»** (код `plan_limit`) —
> см. [Лицензирование](/v1.6/commercial/licensing/).
> [!NOTE]
> Плагины уровня 1 не встраиваются в бинарный файл шлюза. Они устанавливаются и
> контролируются как отдельные службы systemd и доступны по URL — поэтому у
> каждого свой порт.
## Уровень 2 — встроенные инструменты/навыки
Плагины уровня 2 — это **инструменты/навыки, скомпилированные в шлюз и
выполняющиеся внутри его процесса (in-process)**. Поскольку они работают
встроенно от имени действующего пользователя, они могут использовать
[персональные или общие доступы](/v1.6/access/personal-vs-shared/): персональный
режим привязывает действие к конкретному человеку (его доступ и атрибуция
запроса), общий — использует один доступ на всё рабочее пространство.
> [!NOTE]
> Персональные интеграции с внешними аккаунтами (Google, Microsoft, Todoist,
> Asana, Jira, ClickUp, GitLab, Spotify, Fitbit, Oura, SmartThings и др.)
> поставляются как [интеграции без разработки, уровень 3](/v1.6/marketplace/zero-code/)
> — это 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 и другие. Полный
разбор — в [интеграциях без разработки](/v1.6/marketplace/zero-code/).
## Каталог и CDN
Каталог маркетплейса **синхронизируется из CDN**, поэтому список устанавливаемых
плагинов остаётся актуальным без ручной упаковки с вашей стороны. Из
админ-панели вы
просматриваете каталог, устанавливаете в один клик и позволяете каждой установке
автообновляться по своему расписанию.
## Official и community
Каталог делится на два реестра, которые **не смешиваются**:
- **Official (первопартийный)** — модули от AiHummer. Источник закреплён и
доверяется по умолчанию (проверка против закреплённого ключа реестра); в
веб-интерфейсе такие плагины помечены меткой **Official** и идут первыми.
- **Community (сторонний)** — плагины внешних разработчиков, опубликованные через
[личный кабинет](/v1.6/marketplace/submit-plugin/) («Мои плагины» → загрузка →
автоматическая проверка с помощью ИИ → модерация человеком). Подключаются как
**отдельный источник** (`community-catalog.json`), который **не
перезаписывает** официальный каталог; в списке такие плагины показываются без
метки и сортируются по числу загрузок.
Оба реестра используют один и тот же контракт манифеста и один и тот же путь
установки; различаются они **происхождением и якорем доверия** (см.
[Установку и обновления](/v1.6/marketplace/install-updates/#модель-доверия-и-закреплённый-ключ)).
## Куда дальше
- [Установка и обновления](/v1.6/marketplace/install-updates/) — жизненный цикл
установки в один клик и sandbox-юниты systemd.
- [Plugin SDK](/v1.6/marketplace/sdk/) — соберите свой плагин из одного
`manifest.json`.
- [Публикация плагина](/v1.6/marketplace/publishing/) — official и community
реестр, два режима публикации.
- [Интеграции без разработки](/v1.6/marketplace/zero-code/) — OpenAPI и MCP подробно.