Come funziona
nebo-link gira accanto ai tuoi agenti e apre due connessioni in uscita verso NeboAI: una segnala che il bot è online, l'altra è un tunnel che porta le richieste dall'app agli agenti. Non apre porte e non richiede una VPN. Ogni agente mantiene il proprio accesso sul computer; NeboAI non vede mai quelle credenziali.
Collega un computer
Ottieni un codice dall'app NeboAI, poi esegui il programma di installazione sul computer dove girano i tuoi agenti. Il programma di installazione verifica la firma del download prima di eseguirlo e si ferma se la verifica non va a buon fine.
# 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
Questo associa il computer al tuo account come un unico bot e installa nebo-link come servizio in background: un agente launchd su macOS, un'unità utente systemd su Linux e un'attività all'accesso su Windows. --name imposta il nome del bot e --label quello del primo agente.
Aggiungi agenti
Ogni altro agente sul computer si unisce allo stesso bot. Gli agenti che parlano l'Agent Client Protocol (ACP) si possono aggiungere con il comando che li avvia in modalità ACP. --dir è la cartella in cui lavorano le conversazioni dell'agente.
nebo-link add --acp-command "example-agent acp" --dir ~/code/site --label "Site agent"
Un agente di programmazione usa il proprio accesso. Le sue richieste di autorizzazione arrivano come schede nella chat e come elementi nella posta in arrivo del proprietario, e la modalità di autorizzazione del dipendente in NeboAI imposta la modalità dell'agente per ogni conversazione.
Comandi
| Comando | Cosa fa |
|---|---|
nebo-link <code> | Collega questo computer come bot, con il suo primo agente. |
nebo-link status | Mostra cosa è collegato, gli agenti che ospita e se è online. |
nebo-link add <agent> [--dir <folder>] [--label <name>] | Aggiunge un agente al bot. --acp-command aggiunge qualsiasi agente ACP. |
nebo-link remove <agent id> | Rimuove un agente. |
nebo-link models on|off | Instrada i modelli di un agente tramite NeboAI, oppure ripristina il suo provider. |
nebo-link logs [--lines N] | Stampa il log recente del servizio. |
nebo-link unlink | Ripristina ogni impostazione modificata, rimuove il servizio e dimentica il bot. |
nebo-link update | Installa l'ultima versione firmata. Il servizio si aggiorna anche da solo ogni giorno. |
Ogni modifica che Nebo Link apporta alla configurazione di un agente viene registrata insieme al valore che ha sostituito, così models off e unlink lo ripristinano esattamente. I file di ogni bot si trovano in ~/Library/Application Support/nebo-link/<bot id> su macOS, ~/.local/share/nebo-link/<bot id> su Linux e %APPDATA%\nebo-link\<bot id> su Windows, oppure sotto NEBO_LINK_HOME.
Open Agent Link
Open Agent Link (OAL) è un protocollo aperto per raggiungere agenti su qualsiasi computer: l'Agent Client Protocol reso raggiungibile, più un sottile livello host. La specifica è pubblicata su openagent.link con licenza CC-BY-4.0.
| Parte | Definizione |
|---|---|
| Agente | Parla ACP tramite input e output standard. |
| Host | Uno per computer e utente; esegue gli agenti e li serve. Nebo Link e Nebo sono host. |
| Client | Un'app che comunica con un host. |
| Relay | Facoltativo. Inoltra il traffico tra client e host che non possono raggiungersi direttamente. |
| Trasporto | WebSocket (wss su internet) con sottoprotocollo oal, un frame JSON per messaggio. I messaggi dell'host sono metodi JSON-RPC host/*; il traffico degli agenti è ACP incapsulato come {"agent": "<id>", "acp": <message>}. |
| Associazione | Un codice monouso di otto caratteri mostrato come XXXX-XXXX. Il relay instrada in base alla prima metà e non vede mai la seconda. |
Nebo Link serve ogni agente che ospita tramite OAL oltre che a NeboAI, e cifra ogni connessione end-to-end, così un relay inoltra traffico che non può leggere.
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
Sono disponibili SDK client per TypeScript (@openagentlink/client) e Python (openagentlink). Un relay installabile in proprio e una suite di conformità fanno parte del progetto Open Agent Link; superare la suite di conformità è ciò che rende compatibile un host o un client.