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