Удалённая отладка — самый быстрый способ дорабатывать плагин. Вы запускаете процесс плагина на своём ноутбуке, а Интеллос работает с ним так, как будто он установлен в рабочем пространстве. Сохранения, правки и перезапуски вступают в силу сразу.

​
Предварительные требования

  • Рабочее пространство Интеллос, в котором вам доступен пункт Плагины в правом верхнем углу.
  • Сгенерированный каркас проекта плагина (см. CLI, если вы ещё не создали его).
  • Установленные Python 3.12 и зависимости плагина (pip install -r requirements.txt).

​
Шаг 1. Получите URL и ключ для отладки

Откройте страницу Плагины в Интеллос и нажмите значок отладки (небольшой значок жучка рядом с Установить плагин). В диалоговом окне отображаются хост:порт для удалённой установки и API-ключ.
Удалённая отладка плагина
По умолчанию хост — 127.0.0.1:5003; он задаётся переменными PLUGIN_REMOTE_INSTALLING_HOST / PLUGIN_REMOTE_INSTALLING_PORT в окружении демона плагинов. Убедитесь, что порт 5003 доступен с вашей машины разработки. Если Интеллос работает в Docker на том же хосте, используйте bridge-IP контейнера демона (или откройте порт наружу). Ключ уникален для вашего рабочего пространства; любой, у кого есть ключ, может подключить плагин, поэтому не передавайте его никому.

​
Шаг 2. Настройте файл .env плагина

В проекте плагина скопируйте .env.example в .env и заполните значения:
REMOTE_INSTALL_URL — это объединённая строка host:port из шага 1, а не две отдельные переменные.

​
Шаг 3. Запустите плагин

Из каталога проекта плагина:
Процесс остаётся на переднем плане и пишет в лог входящие вызовы. Отредактируйте код и перезапустите процесс, чтобы применить изменения.

​
Шаг 4. Проверьте установку

Вернитесь на страницу Плагины в Интеллос. Плагин появляется в списке с пометкой отладки. Другие участники рабочего пространства тоже видят его и могут им пользоваться.
Плагин установлен в рабочее пространство
На плитке плагина отображается индикатор отладки, а в локальном терминале фиксируется первое рукопожатие регистрации. Плагин подключён.
Вызывайте плагин так же, как любой другой: обращайтесь к нему из узла workflow, запускайте как инструмент внутри Агента или обращайтесь к URL эндпоинта. Вызовы поступают в ваш локальный процесс, и вы можете подключить отладчик.

​
Устранение неполадок

Демон не слушает адрес, указанный вами в REMOTE_INSTALL_URL. Убедитесь, что у контейнера демона задано PLUGIN_REMOTE_INSTALLING_ENABLED=true и порт 5003 открыт наружу, и ещё раз проверьте, что вы скопировали host:port точно так, как показано в диалоге отладки.
Самая частая причина — устаревший или неверный REMOTE_INSTALL_KEY. Сгенерируйте ключ заново в диалоге отладки и снова выполните python -m main. Также убедитесь, что в логе демона видна входящая регистрация.
Поле author в manifest.yaml или в provider/*.yaml не совпадает со значением, которое принимает демон. Укажите в нём ваш GitHub-хэндл, затем перезапустите процесс.
Процесс плагина нужно перезапускать после каждой правки — горячей перезагрузки нет. Остановите его сочетанием Ctrl+C и снова выполните python -m main.

​
Связанные материалы

Редактировать эту страницу | Сообщить о проблеме