Плагин
Для чего нужен этот тип
Выбирайте «Плагин», когда приложение должно добавить агенту новые действия, шаги автоматизаций, встроенный интерфейс или совместить несколько сценариев. Например, агент может создавать платёжную ссылку или искать заказ во внешней CRM, а на встроенной странице пользователь подключает CRM, выбирает аккаунт и управляет интеграцией.
Какие возможности можно включить
- Конструктор HTTP-инструментов — несколько действий с отдельными URL, параметрами, режимами выполнения и подписями запросов.
- MCP-сервер — один MCP endpoint, с которого Senler загружает доступные инструменты.
- Встроенная страница — интерфейс внутри кабинета, в котором пользователь настраивает функции установленного плагина и работает с ними.
- Действия приложения — явно отмеченные методы backend, которые становятся доступны AI через MCP для работы со страницей приложения и настройки его инструментов или шагов.
- Настраиваемый экземпляр инструмента — форма, которая открывается при добавлении действия агенту и сохраняет обычные и закрытые параметры конкретного подключения.
- Шаги автоматизаций — действия приложения, которые пользователь добавляет в схему автоматизации, настраивает и связывает с её следующими блоками.
Инструменты, шаги автоматизаций и встроенная страница настраиваются независимо. Приложение может использовать одну из этих возможностей или сочетать их.
Действия приложения также включаются отдельно. Они не заменяют инструменты агента и шаги автоматизаций: пользователь не добавляет их в агента или схему вручную. AI получает эти методы через MCP только в проекте, где плагин установлен и активен.
Как приложение появляется в проекте
Пользователь устанавливает приложение из каталога плагинов. Установка подключает его возможности к проекту, но не добавляет все действия каждому агенту: нужный инструмент выбирается отдельно в настройках агента. Если приложению требуется читать или менять данные проекта через API, оно дополнительно проводит обычную OAuth-авторизацию.
Пользовательский сценарий установки описан в статье «Плагины».
Инструменты агента
В разделе «Инструменты агента» выберите один способ подключения для всего приложения: конструктор или MCP-сервер. Для HTTP-действия задайте системное имя, понятные названия и описания на русском и английском языках, endpoint, параметры, таймаут и режим выполнения. Обработчик обязан проверять подпись запроса и использовать event_id как ключ идемпотентности.
Если пользователю нужно выбрать аккаунт или передать секрет при добавлении действия, включите настраиваемый экземпляр и реализуйте форму через Senler Bridge. Закрытые данные не должны возвращаться в открытый API или записываться в логи.
Если AI должен работать с данными встроенной страницы или собирать настройки инструмента и шага по запросу пользователя, дополнительно опубликуйте действия приложения.
Шаги автоматизаций
В разделе «Шаги автоматизаций» приложение может опубликовать собственные действия для редактора автоматизаций. Разработчик задаёт входные параметры, поля результата, webhook и один из вариантов продолжения: один выход, фиксированные ветки или ветки, которые формирует встроенная страница при настройке шага.
Шаги автоматизаций не являются инструментами агента: пользователь добавляет их в схему процесса, а результат может сохранить в переменные автоматизации. Для настраиваемого шага та же встроенная страница открывается с типом запуска automation_step_configurator.
Встроенная страница
Встроенная страница открывает пользовательский интерфейс плагина прямо в кабинете. На ней можно разместить настройку подключения и аккаунта, данные, отчёты и другие элементы работы с плагином. Точное содержимое определяет разработчик приложения.
Одна и та же страница может работать в двух сценариях: как общий интерфейс установленного плагина и как форма настройки отдельного экземпляра инструмента при добавлении в агента. В контексте Senler Bridge эти сценарии различаются по context.launch.type: embedded_page и tool_configurator.
В разделе «Встроенная страница» укажите основной HTTPS URL. Отдельный developer URL можно использовать для локального или тестового окружения участников приложения. Сервер страницы проверяет одноразовый launch_code; query-параметры senler_* помогают отобразить интерфейс, но сами по себе не подтверждают доступ.
Через Senler Bridge страница получает проверенный контекст запуска и может поддерживать подсветку и разрешённые действия с элементами интерфейса. Для одинаковой работы документации и интерфейса используйте стабильные data-ai-context-id в пространстве app.*.
Само встраивание страницы не даёт приложению доступ к данным или настройкам проекта. Для их чтения и изменения используйте OAuth и API Senler AI с правами, которые подтвердил пользователь.
Перед публикацией
Проверьте установку в тестовом проекте, подписи HTTP-запросов или доступность MCP endpoint, обработку таймаутов, работу встроенной страницы во фрейме, OAuth-права при их наличии и публичную документацию. Затем отправьте приложение на модерацию из раздела публикации.