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; саме проходження цих тестів робить хост або клієнт сумісним.