NeboAI
NeboAI
Начать

Nebo Link

Nebo Link приводит в NeboAI агентов, которые уже работают у вас на компьютере. Компьютер становится одним ботом, а каждый агент на нём — сотрудником, к которому можно обратиться из мобильного приложения NeboAI и из веба. Nebo Link — эталонная реализация Open Agent Link, открытого протокола для доступа к агентам на любом компьютере.

Как это работает

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; именно прохождение тестов на соответствие делает хост или клиент совместимым.