Как это работает
nebo-link работает рядом с вашими агентами и устанавливает два исходящих соединения с NeboAI: одно сообщает, что бот в сети, а второе — туннель, по которому запросы из приложения доходят до агентов. Он не открывает портов и не требует VPN. Каждый агент хранит собственный вход на компьютере; NeboAI никогда не видит эти учётные данные.
Подключите компьютер
Получите код в приложении NeboAI, затем запустите установщик на компьютере, где работают ваши агенты. Перед запуском установщик проверяет подпись загруженного файла и останавливается, если проверка не прошла.
# macOS and Linux curl -fsSL https://neboai.com/link.sh | sh -s -- ABCD-1234 # Windows (PowerShell) & ([scriptblock]::Create((irm https://neboai.com/link.ps1))) ABCD-1234
Так компьютер связывается с вашим аккаунтом как один бот, а nebo-link устанавливается как фоновая служба: агент launchd в macOS, пользовательский юнит systemd в Linux и задача при входе в систему в Windows. --name задаёт имя бота, а --label — имя первого агента.
Добавьте агентов
Все остальные агенты на компьютере присоединяются к тому же боту. Агентов, поддерживающих Agent Client Protocol (ACP), можно добавить командой, которая запускает их в режиме ACP. --dir — папка, в которой работают разговоры агента.
nebo-link add --acp-command "example-agent acp" --dir ~/code/site --label "Site agent"
Агент для программирования работает со своим собственным входом. Его запросы разрешений приходят карточками в чат и пунктами во входящие владельца, а режим разрешений сотрудника в NeboAI задаёт собственный режим агента для каждого разговора.
Команды
| Команда | Что делает |
|---|---|
nebo-link <code> | Подключает этот компьютер как бот вместе с его первым агентом. |
nebo-link status | Показывает, что подключено, каких агентов оно размещает и в сети ли оно. |
nebo-link add <agent> [--dir <folder>] [--label <name>] | Добавляет агента в бот. --acp-command добавляет любого агента ACP. |
nebo-link remove <agent id> | Удаляет агента. |
nebo-link models on|off | Направляет модели агента через NeboAI или возвращает его собственного провайдера. |
nebo-link logs [--lines N] | Выводит недавний журнал службы. |
nebo-link unlink | Восстанавливает все изменённые настройки, удаляет службу и забывает бота. |
nebo-link update | Устанавливает последний подписанный выпуск. Служба также обновляется сама каждый день. |
Каждое изменение, которое Nebo Link вносит в конфигурацию агента, записывается вместе со значением, которое оно заменило, поэтому models off и unlink восстанавливают его в точности. Файлы каждого бота хранятся в ~/Library/Application Support/nebo-link/<bot id> в macOS, ~/.local/share/nebo-link/<bot id> в Linux и %APPDATA%\nebo-link\<bot id> в Windows либо в NEBO_LINK_HOME.
Open Agent Link
Open Agent Link (OAL) — открытый протокол для связи с агентами на любом компьютере: Agent Client Protocol, ставший доступным по сети, плюс тонкий слой хоста. Спецификация опубликована на openagent.link под лицензией CC-BY-4.0.
| Часть | Определение |
|---|---|
| Агент | Общается по ACP через стандартный ввод и вывод. |
| Хост | Один на компьютер и пользователя; запускает агентов и обслуживает их. Nebo Link и Nebo — хосты. |
| Клиент | Приложение, которое общается с хостом. |
| Ретранслятор | Необязателен. Пересылает трафик между клиентами и хостами, которые не могут связаться друг с другом напрямую. |
| Транспорт | WebSocket (wss через интернет) с подпротоколом oal, один JSON-кадр на сообщение. Сообщения хоста — это методы JSON-RPC host/*; трафик агентов — это ACP, обёрнутый как {"agent": "<id>", "acp": <message>}. |
| Сопряжение | Одноразовый восьмизначный код вида XXXX-XXXX. Ретранслятор маршрутизирует по первой половине и никогда не видит вторую. |
Nebo Link обслуживает каждого размещённого агента по OAL, а также для NeboAI, и шифрует каждое соединение сквозным шифрованием, поэтому ретранслятор пересылает трафик, который не может прочитать.
nebo-link relay https://relay.example.com # reach agents through your own relay nebo-link lan on # or directly on this network nebo-link pair # show a one-time code for a device nebo-link unpair "Office tablet" # remove a device
Клиентские SDK доступны для TypeScript (@openagentlink/client) и Python (openagentlink). Ретранслятор, который можно развернуть у себя, и набор тестов на соответствие входят в проект Open Agent Link; именно прохождение тестов на соответствие делает хост или клиент совместимым.