Jak to funguje
nebo-link běží vedle vašich agentů a navazuje dvě odchozí spojení s NeboAI: jedno hlásí, že je bot online, a druhé je tunel, kterým putují požadavky z aplikace k agentům. Neotevírá žádné porty a nepotřebuje VPN. Každý agent si na počítači ponechává vlastní přihlášení; NeboAI tyto přihlašovací údaje nikdy nevidí.
Propojení počítače
Získejte kód v aplikaci NeboAI a pak spusťte instalační program na počítači, kde běží vaši agenti. Instalační program před spuštěním ověří podpis staženého souboru, a pokud ověření selže, skončí.
# 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
Tím se počítač spáruje s vaším účtem jako jeden bot a nebo-link se nainstaluje jako služba na pozadí: jako agent launchd v macOS, uživatelská jednotka systemd v Linuxu a úloha při přihlášení ve Windows. --name nastavuje název bota a --label název prvního agenta.
Přidání agentů
Každý další agent na počítači se připojí ke stejnému botovi. Agenty, kteří používají Agent Client Protocol (ACP), lze přidat příkazem, který je spouští v režimu ACP. --dir je složka, ve které probíhají konverzace agenta.
nebo-link add --acp-command "example-agent acp" --dir ~/code/site --label "Site agent"
Agent pro programování běží pod vlastním přihlášením. Jeho žádosti o oprávnění přicházejí jako karty v chatu a jako položky v doručené poště vlastníka a režim oprávnění zaměstnance v NeboAI určuje vlastní režim agenta pro každou konverzaci.
Příkazy
| Příkaz | Co dělá |
|---|---|
nebo-link <code> | Propojí tento počítač jako bota s jeho prvním agentem. |
nebo-link status | Ukáže, co je propojeno, které agenty hostuje a zda je online. |
nebo-link add <agent> [--dir <folder>] [--label <name>] | Přidá agenta k botovi. --acp-command přidá libovolného agenta ACP. |
nebo-link remove <agent id> | Odebere agenta. |
nebo-link models on|off | Směruje modely agenta přes NeboAI, nebo obnoví jeho vlastního poskytovatele. |
nebo-link logs [--lines N] | Vypíše nedávný protokol služby. |
nebo-link unlink | Obnoví každé změněné nastavení, odebere službu a zapomene bota. |
nebo-link update | Nainstaluje nejnovější podepsané vydání. Služba se navíc každý den aktualizuje sama. |
Každá změna, kterou Nebo Link provede v konfiguraci agenta, se zaznamená spolu s hodnotou, kterou nahradila, takže ji models off a unlink obnoví přesně. Soubory každého bota jsou uložené v ~/Library/Application Support/nebo-link/<bot id> v macOS, v ~/.local/share/nebo-link/<bot id> v Linuxu a v %APPDATA%\nebo-link\<bot id> ve Windows, případně v NEBO_LINK_HOME.
Open Agent Link
Open Agent Link (OAL) je otevřený protokol pro přístup k agentům na libovolném počítači: Agent Client Protocol zpřístupněný na dálku a k tomu tenká hostitelská vrstva. Specifikace je zveřejněna na openagent.link pod licencí CC-BY-4.0.
| Část | Definice |
|---|---|
| Agent | Komunikuje pomocí ACP přes standardní vstup a výstup. |
| Hostitel | Jeden na počítač a uživatele; spouští agenty a obsluhuje je. Nebo Link a Nebo jsou hostitelé. |
| Klient | Aplikace, která komunikuje s hostitelem. |
| Přenosový server | Volitelné. Přeposílá provoz mezi klienty a hostiteli, kteří se navzájem nemohou spojit. |
| Přenos | WebSocket (wss přes internet) se subprotokolem oal, jeden rámec JSON na zprávu. Zprávy hostitele jsou metody JSON-RPC host/*; provoz agentů je ACP zabalené jako {"agent": "<id>", "acp": <message>}. |
| Párování | Jednorázový osmiznakový kód ve tvaru XXXX-XXXX. Přenosový server směruje podle první poloviny a druhou nikdy nevidí. |
Nebo Link obsluhuje každého agenta, kterého hostuje, přes OAL i pro NeboAI a každé spojení šifruje end-to-end, takže přenosový server přeposílá provoz, který nedokáže přečíst.
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
Klientské sady SDK jsou k dispozici pro TypeScript (@openagentlink/client) a Python (openagentlink). Součástí projektu Open Agent Link je přenosový server, který můžete hostovat sami, a sada testů shody; hostitel nebo klient je kompatibilní, když touto sadou projde.