Hogyan működik
A nebo-link az ügynökei mellett fut, és két kimenő kapcsolatot létesít a NeboAI felé: az egyik jelzi, hogy a bot online, a másik egy alagút, amely az alkalmazás kéréseit eljuttatja az ügynökökhöz. Nem nyit portot, és nincs szükség VPN-re. Minden ügynök megtartja a saját bejelentkezését a számítógépen; a NeboAI soha nem látja ezeket a hitelesítő adatokat.
Számítógép összekapcsolása
Kérjen egy kódot a NeboAI alkalmazásban, majd futtassa a telepítőt azon a számítógépen, ahol az ügynökei futnak. A telepítő futtatás előtt ellenőrzi a letöltés aláírását, és leáll, ha az ellenőrzés sikertelen.
# 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
Ez a számítógépet egy botként párosítja a fiókjával, és háttérszolgáltatásként telepíti a nebo-link-et: macOS-en launchd ügynökként, Linuxon systemd felhasználói egységként, Windowson pedig bejelentkezéskor induló feladatként. A --name a bot nevét, a --label az első ügynök nevét adja meg.
Ügynökök hozzáadása
A számítógép minden további ügynöke ugyanahhoz a bothoz csatlakozik. Az Agent Client Protocolt (ACP) beszélő ügynökök azzal a paranccsal adhatók hozzá, amely ACP módban indítja őket. A --dir az a mappa, amelyben az ügynök beszélgetései dolgoznak.
nebo-link add --acp-command "example-agent acp" --dir ~/code/site --label "Site agent"
A kódoló ügynök a saját bejelentkezésével fut. Engedélykérései kártyaként jelennek meg a csevegésben és tételként a tulajdonos Beérkezett mappájában, a munkatárs NeboAI-ban beállított engedélyezési módja pedig minden beszélgetésnél meghatározza az ügynök saját módját.
Parancsok
| Parancs | Mit csinál |
|---|---|
nebo-link <code> | Botként összekapcsolja ezt a számítógépet az első ügynökével. |
nebo-link status | Megmutatja, mi van összekapcsolva, milyen ügynököket futtat, és hogy online-e. |
nebo-link add <agent> [--dir <folder>] [--label <name>] | Ügynököt ad a bothoz. A --acp-command bármilyen ACP-ügynököt hozzáad. |
nebo-link remove <agent id> | Eltávolít egy ügynököt. |
nebo-link models on|off | Az ügynök modelljeit a NeboAI-on keresztül irányítja, vagy visszaállítja a saját szolgáltatóját. |
nebo-link logs [--lines N] | Kiírja a szolgáltatás legutóbbi naplóját. |
nebo-link unlink | Visszaállít minden módosított beállítást, eltávolítja a szolgáltatást, és elfelejti a botot. |
nebo-link update | Telepíti a legújabb aláírt kiadást. A szolgáltatás naponta magát is frissíti. |
A Nebo Link minden módosítását, amelyet egy ügynök konfigurációján végez, a felülírt értékkel együtt rögzíti, így a models off és az unlink pontosan visszaállítja. Az egyes botok fájljai macOS-en a ~/Library/Application Support/nebo-link/<bot id>, Linuxon a ~/.local/share/nebo-link/<bot id>, Windowson a %APPDATA%\nebo-link\<bot id> mappában vannak, vagy a NEBO_LINK_HOME alatt.
Open Agent Link
Az Open Agent Link (OAL) nyílt protokoll, amellyel bármely számítógépen elérhetők az ügynökök: az Agent Client Protocol elérhetővé téve, kiegészítve egy vékony gazdaréteggel. A specifikáció az openagent.link oldalon jelent meg CC-BY-4.0 licenccel.
| Elem | Meghatározás |
|---|---|
| Ügynök | A szabványos bemeneten és kimeneten ACP-t beszél. |
| Gazda | Számítógépenként és felhasználónként egy; ügynököket futtat és szolgál ki. A Nebo Link és a Nebo is gazda. |
| Kliens | Gazdával kommunikáló alkalmazás. |
| Relé | Opcionális. Továbbítja a forgalmat azok között a kliensek és gazdák között, amelyek nem érik el egymást. |
| Átvitel | WebSocket (az interneten wss) oal alprotokollal, üzenetenként egy JSON-kerettel. A gazdaüzenetek JSON-RPC host/* metódusok; az ügynökforgalom {"agent": "<id>", "acp": <message>} formába csomagolt ACP. |
| Párosítás | Egyszer használható, nyolckarakteres kód XXXX-XXXX formában. A relé az első fele alapján irányít, a második felét soha nem látja. |
A Nebo Link minden általa futtatott ügynököt OAL-on keresztül is kiszolgál, nem csak a NeboAI felé, és minden kapcsolatot végponttól végpontig titkosít, így a relé olyan forgalmat továbbít, amelyet nem tud elolvasni.
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
Kliens SDK-k érhetők el TypeScripthez (@openagentlink/client) és Pythonhoz (openagentlink). Az Open Agent Link projekt része egy saját üzemeltetésű relé és egy megfelelőségi tesztcsomag is; egy gazda vagy kliens attól kompatibilis, hogy átmegy a megfelelőségi teszteken.