Компьютеры и машины

Машина — сервер или ноутбук, на котором запускаются ходы агентов. Ход — одна сессия агента от запуска до конца или до ожидания. Серверные машины держит админ инстанса, свой компьютер вы подключаете сами.

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

Где идёт ход

У хода три места:

Место выбирается на уровне треда, а не только агента:

• До первого хода место задают в строке ввода, в поле «Где выполнять». Если не задали, берётся умолчание: чаты и каналы идут «Без компьютера», задачи и автоматизации на сервере. Умолчание меняет админ пространства (Настройки → Исполнение) или организации.
• После первого хода место закрепляется за работой агента в треде. С ноутбука и из «Без компьютера» можно перейти только на сервер кнопкой «Продолжить на сервере»: агент начнёт новую сессию со сводкой треда. Обратно нельзя.
• Если «Без компьютера» упёрся в то, чего у него нет (оболочка, пакеты, таблица, скилл со скриптами), он сам передаёт тред на сервер и пишет причину. Дальше тред остаётся на сервере.
• Ноутбук доступен не всегда: админ инстанса должен включить ноутбуки, агент должен быть привязан к вашему компьютеру, а харнесс на нём должен принимать модель. Агент без машины работает на сервере.

Привязать агента к компьютеру можно при создании: в поле «Где выполнять» выберите машину. Строка «Песочница на сервере, машина не нужна» оставляет агента на сервере.

Подключить свой компьютер

Подключение явное: демон сам к пространству не подключается. Компьютер подключается к одному пространству за раз, и в каждом пространстве у него свой пропуск. Для второго пространства подключение повторяют.

Основной путь: строка установки

1. Откройте Настройки → Мой компьютер. В карточке Подключить компьютер нажмите Получить строку установки.
2. Выполните строку в терминале на том компьютере, который подключаете. Она скачает Баунс, запустит его службой (systemd в Linux, launchd в macOS) и подключит компьютер к пространству.
3. Компьютер появится в списке Подключённые компьютеры со статусом «В сети», а его харнессы на странице Машины.

Код в строке срабатывает один раз и живёт 15 минут. Если не успели, получите новую строку. Строка рассчитана на Linux и macOS; на Windows идите запасным путём.

На компьютере должен стоять хотя бы один харнесс: opencode, Claude Code, Codex, Qwen Code, Goose, Hermes Agent или pi. Демон ищет их в PATH, и без них не запускается.

Запасной путь: через CLI

Он нужен, когда строка не подходит: нет доступа к браузеру на том компьютере, Windows, нужно подключить уже установленный CLI.

1. Выпустите персональный токен

Если на компьютере есть браузер, токен не нужен: bounc login откроет вход в браузере. Без браузера откройте Настройки → API-токены и создайте токен: название (например, «Рабочий ноутбук») и срок действия. Скопируйте значение сразу — оно начинается с bnp_ и показывается один раз.

Токен действует от вашего имени во всех ваших пространствах, поэтому храните его как пароль. Подробнее — в разделе Токены.

2. Установите Баунс CLI

Скачайте CLI со страницы /download веб-приложения: она подберёт сборку под вашу операционную систему. Это один файл без зависимостей. Положите его в каталог из PATH и сделайте исполняемым:

mkdir -p ~/.local/bin
mv ~/Downloads/bounc ~/.local/bin/bounc
chmod +x ~/.local/bin/bounc
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc   # для bash — ~/.bashrc
exec $SHELL -l
bounc --help

На Windows скачивается bounc.exe, и шаг с правами на исполнение не нужен.

3. Войдите

Укажите адрес сервера и адрес веб-приложения, затем войдите по токену. Для облачного Баунса оба адреса одинаковы:

bounc config set server_url https://app.bounc.ai
bounc config set app_url https://app.bounc.ai
bounc login --token bnp_…

CLI проверит токен, сохранит его в локальный профиль и выберет рабочее пространство по умолчанию — первое из ваших. Если пространств несколько, переключитесь командой bounc workspace switch <id>.

Проверьте вход — команды должны вернуть данные вашего пространства:

bounc auth status
bounc issue list
bounc project list
bounc team list

На этом этапе компьютер ещё не подключён: CLI читает и меняет данные пространства, но агенты на нём не запускаются.

4. Подключите компьютер и запустите демон

bounc daemon connect
bounc daemon start
bounc daemon status

daemon connect подключает компьютер к пространству профиля по умолчанию и просит у сервера пропуск. Для другого пространства добавьте --workspace <id>, для своего имени компьютера в списке — --device-name: его рантаймы носят это имя («Opencode (Ноутбук Анны)») и меняют его вместе с компьютером.

Демон работает в фоне и обслуживает все пространства, к которым подключён этот компьютер. Он делает только исходящие подключения — входящие порты не нужны. Без подключения daemon start пишет «this computer is not connected to a workspace» и не запускается.

bounc daemon logs -f показывает журнал, bounc daemon stop останавливает демон, bounc daemon start запускает снова. Компьютер при этом остаётся в списке и вернётся в сеть при следующем запуске.

Если демон работает службой (его поставила строка установки), bounc daemon stop и bounc daemon start останавливают и запускают саму службу; при следующем входе в систему она запустится снова. bounc daemon uninstall снимает службу совсем. Подключение к пространствам и сам Баунс в ~/.bounc остаются: удалить компьютер из пространства — bounc daemon disconnect, вернуть службу — строка установки. Когда компьютер удалён или отозван во всех пространствах, служба останавливается сама и ждёт, пока его подключат снова.

Поручить подключение ИИ-ассистенту

Шаги 2–4 запасного пути — рутинная работа в терминале, и её можно отдать ИИ-ассистенту на вашей машине, например Claude Code. Токен выпускаете вы сами; ассистенту передайте путь к скачанному файлу и текст задания:

Настрой соединение с Баунс.

1. CLI скачан сюда: ~/Downloads/bounc. Положи его в каталог из PATH,
   сделай исполняемым и сними карантин macOS.
2. Подключись к рабочему пространству https://app.bounc.ai:
   bounc config set server_url и app_url — оба https://app.bounc.ai;
   вход — bounc login --token, мой токен: bnp_…
3. Подключи компьютер: bounc daemon connect.
4. Демон пока не запускай.
5. Для проверки покажи список задач, проектов и команд.

Когда соединение проверено, запуск демона (bounc daemon start) — отдельная команда, её тоже можно поручить ассистенту.

Что решает админ инстанса

Подключение компьютеров управляется политикой на странице «Ноутбуки» в консоли инстанса. Участник эти настройки не меняет, но видит их следы в Мой компьютер.

Правило «по одобрению»

Участник нажимает «Попросить подключить». Админам пространства приходит карточка в «Ждут меня», они нажимают «Одобрить» или «Отклонить». Одобрение пускает один новый компьютер и тратится им. Админы пространства подключают компьютер без запроса.

Что происходит на компьютере

• Действия Баунса. Глаголы Баунса и коннекторы на компьютере идут по режиму доступа, как на сервере: в «Спрашивать» агент спросит на карточке доступа.

• Заголовок и сводка треда. Их считает сервер через свой шлюз, с маскированием, даже когда ход идёт на компьютере на вашем ключе.

• Чужой компьютер. Если агент привязан к машине другого участника, его инструкции и треды, в которых он работает, попадают на эту машину при каждом ходе. Секреты коннекторов остаются на платформе. Перед созданием такого агента Баунс предупреждает об этом.

• Компьютер спит или выключен. Ход ждёт: в треде видно «Ждёт свободную машину», и работа продолжается сама, когда компьютер снова в сети. Через минуты, заданные политикой, тред предлагает «Продолжить на сервере»: работа переедет в песочницу сервера с новой сессией.

• Компьютер пропал посреди хода. Если демон молчит 90 секунд, ход встаёт на паузу с причиной «Машина пропала». Когда компьютер вернётся, нажмите «Продолжить» в треде.

Список машин

Страница Машины показывает машины, которые видите вы: переключатель «Мои» / «Все», разделы «Локальные», «Удалённые» и «Облачные», фильтр «Все / В сети / Проблемы». По каждой машине видно, сколько на ней харнессов и сколько из них в сети, состояние, нагрузку (сколько ходов выполняется и сколько в очереди) и какой харнесс там стоит. Список обновляется в реальном времени.

У каждой машины есть карточка: владелец, устройство, агенты, которых она обслуживает, и диагностика. Кнопка «Добавить машину» открывает диалог с командами установки CLI и подключения (bounc login, bounc daemon connect, bounc daemon start) и подставленными адресами.

Состояния

Кто может пользоваться машиной

У машины есть видимость:

• Публичная — создавать на ней агентов может любой участник рабочего пространства.
• Приватная — только её владелец и админы пространства.

Отозвать доступ и удалить

Здесь три разных действия, и последствия у них разные.

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

Если компьютер не берёт работу

Пройдите по списку сверху вниз.

1. Компьютер подключён? В Мой компьютер он должен быть в списке «Подключённые компьютеры» со статусом «В сети». Пусто, «Не в сети» или «Доступ отозван» — подключите заново. bounc daemon status и bounc daemon logs -f покажут, что видит демон.
2. Ноутбуки включены? «Компьютеры в этой установке выключены» — решает админ инстанса.
3. В этом пространстве? «В этом пространстве компьютеры выключены» — админ инстанса разрешил компьютеры не во всех пространствах.
4. Вы вправе подключать? «Подключать компьютеры могут не все» — вы не в нужной группе IdP. «Попросить подключить» — ждёт одобрения админа пространства.
5. Версия демона. Ниже минимальной компьютер не берёт ходы: нажмите «Обновить до …».
6. Модели на ноутбуке. «Ходы на компьютерах пока не запускаются: админ инстанса разрешил модели только через шлюз» — решает админ инстанса.
7. Место хода. Тред закреплён за сервером или идёт «Без компьютера». Ноутбук выбирается до первого хода, и только если агент привязан к вашему компьютеру, а его харнесс принимает модель. Админ инстанса мог также разрешить ноутбуки не для всех видов тредов (чаты, задачи, автоматизации).
8. Агент. Он не в архиве и привязан к нужной машине.

Далее

• Провайдеры — ИИ-инструменты, на которых работают агенты.
• Агенты — как агента привязывают к машине.
• Задачи — работа, которую берут агенты.
• Токены — токен для запасного пути.