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