Jak to działa
nebo-link działa obok Twoich agentów i nawiązuje dwa połączenia wychodzące z NeboAI: jedno zgłasza, że bot jest online, a drugie to tunel, który przenosi żądania z aplikacji do agentów. Nie otwiera żadnych portów i nie wymaga VPN. Każdy agent zachowuje na komputerze własne logowanie; NeboAI nigdy nie widzi tych danych logowania.
Połącz komputer
Pobierz kod z aplikacji NeboAI, a następnie uruchom instalator na komputerze, na którym działają Twoje agenty. Przed uruchomieniem instalator sprawdza podpis pobranego pliku i przerywa pracę, jeśli weryfikacja się nie powiedzie.
# 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
To paruje komputer z Twoim kontem jako jeden bot i instaluje nebo-link jako usługę działającą w tle: agenta launchd w macOS, jednostkę użytkownika systemd w Linuksie i zadanie uruchamiane przy logowaniu w Windows. --name ustawia nazwę bota, a --label nazwę pierwszego agenta.
Dodaj agentów
Każdy kolejny agent na komputerze dołącza do tego samego bota. Agentów obsługujących Agent Client Protocol (ACP) można dodać poleceniem, które uruchamia je w trybie ACP. --dir to folder, w którym pracują rozmowy agenta.
nebo-link add --acp-command "example-agent acp" --dir ~/code/site --label "Site agent"
Agent programistyczny działa na własnym logowaniu. Jego prośby o uprawnienia pojawiają się jako karty w czacie i pozycje w skrzynce odbiorczej właściciela, a tryb uprawnień pracownika w NeboAI ustawia własny tryb agenta dla każdej rozmowy.
Polecenia
| Polecenie | Działanie |
|---|---|
nebo-link <code> | Łączy ten komputer jako bota z jego pierwszym agentem. |
nebo-link status | Pokazuje, co jest połączone, jakie agenty obsługuje i czy jest online. |
nebo-link add <agent> [--dir <folder>] [--label <name>] | Dodaje agenta do bota. --acp-command dodaje dowolnego agenta ACP. |
nebo-link remove <agent id> | Usuwa agenta. |
nebo-link models on|off | Kieruje modele agenta przez NeboAI albo przywraca jego własnego dostawcę. |
nebo-link logs [--lines N] | Wyświetla najnowszy dziennik usługi. |
nebo-link unlink | Przywraca każde zmienione ustawienie, usuwa usługę i zapomina bota. |
nebo-link update | Instaluje najnowsze podpisane wydanie. Usługa aktualizuje się też sama codziennie. |
Każda zmiana, jaką Nebo Link wprowadza w konfiguracji agenta, jest zapisywana razem z zastąpioną wartością, dzięki czemu models off i unlink przywracają ją dokładnie. Pliki każdego bota znajdują się w ~/Library/Application Support/nebo-link/<bot id> w macOS, ~/.local/share/nebo-link/<bot id> w Linuksie i %APPDATA%\nebo-link\<bot id> w Windows albo w NEBO_LINK_HOME.
Open Agent Link
Open Agent Link (OAL) to otwarty protokół do łączenia się z agentami na dowolnym komputerze: Agent Client Protocol udostępniony przez sieć, plus cienka warstwa hosta. Specyfikacja jest opublikowana na openagent.link na licencji CC-BY-4.0.
| Element | Definicja |
|---|---|
| Agent | Komunikuje się przez ACP na standardowym wejściu i wyjściu. |
| Host | Jeden na komputer i użytkownika; uruchamia agentów i je udostępnia. Nebo Link i Nebo są hostami. |
| Klient | Aplikacja, która komunikuje się z hostem. |
| Przekaźnik | Opcjonalny. Przekazuje ruch między klientami a hostami, które nie mogą połączyć się ze sobą bezpośrednio. |
| Transport | WebSocket (wss przez internet) z podprotokołem oal, jedna ramka JSON na wiadomość. Wiadomości hosta to metody JSON-RPC host/*; ruch agentów to ACP opakowane jako {"agent": "<id>", "acp": <message>}. |
| Parowanie | Jednorazowy ośmioznakowy kod wyświetlany jako XXXX-XXXX. Przekaźnik kieruje ruch według pierwszej połowy i nigdy nie widzi drugiej. |
Nebo Link udostępnia każdego obsługiwanego agenta przez OAL, a także dla NeboAI, i szyfruje każde połączenie od końca do końca, więc przekaźnik przesyła ruch, którego nie może odczytać.
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
Pakiety SDK klienta są dostępne dla TypeScript (@openagentlink/client) i Pythona (openagentlink). Przekaźnik, który możesz hostować samodzielnie, i zestaw testów zgodności są częścią projektu Open Agent Link; host lub klient jest zgodny, gdy przejdzie testy zgodności.