NeboAI
NeboAI
Aan de slag

Nebo Link

Nebo Link brengt agents die je al op een computer draait naar NeboAI. De computer wordt één bot, en elke agent erop wordt een medewerker die je kunt bereiken via de mobiele NeboAI-app en het web. Nebo Link is de referentie-implementatie van Open Agent Link, een open protocol om agents op elke computer te bereiken.

Zo werkt het

nebo-link draait naast je agents en maakt twee uitgaande verbindingen met NeboAI: één die meldt dat de bot online is, en een tunnel die verzoeken van de app naar de agents brengt. Er worden geen poorten geopend en je hebt geen VPN nodig. Elke agent behoudt zijn eigen aanmelding op de computer; NeboAI ziet die inloggegevens nooit.

Een computer koppelen

Haal een code op in de NeboAI-app en voer daarna het installatieprogramma uit op de computer waarop je agents draaien. Het installatieprogramma controleert de handtekening van de download voordat het die uitvoert en stopt als de controle mislukt.

# 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

Hiermee wordt de computer als één bot aan je account gekoppeld en wordt nebo-link geïnstalleerd als achtergrondservice: een launchd-agent op macOS, een systemd-gebruikersunit op Linux en een aanmeldtaak op Windows. --name stelt de naam van de bot in en --label die van de eerste agent.

Agents toevoegen

Elke andere agent op de computer sluit zich aan bij dezelfde bot. Agents die het Agent Client Protocol (ACP) spreken, voeg je toe met de opdracht die ze in ACP-modus start. --dir is de map waarin de gesprekken van de agent werken.

nebo-link add --acp-command "example-agent acp" --dir ~/code/site --label "Site agent"

Een programmeeragent draait op zijn eigen aanmelding. Zijn toestemmingsvragen verschijnen als kaarten in de chat en als items in het Postvak IN van de eigenaar, en de toestemmingsmodus van de medewerker in NeboAI bepaalt per gesprek de eigen modus van de agent.

Opdrachten

OpdrachtDoet
nebo-link <code>Koppelt deze computer als bot, met zijn eerste agent.
nebo-link statusToont wat er gekoppeld is, welke agents het host en of het online is.
nebo-link add <agent> [--dir <folder>] [--label <name>]Voegt een agent toe aan de bot. --acp-command voegt elke ACP-agent toe.
nebo-link remove <agent id>Verwijdert een agent.
nebo-link models on|offLeidt de modellen van een agent via NeboAI, of zet zijn eigen provider terug.
nebo-link logs [--lines N]Toont het recente logboek van de service.
nebo-link unlinkZet elke gewijzigde instelling terug, verwijdert de service en vergeet de bot.
nebo-link updateInstalleert de nieuwste ondertekende release. De service werkt zichzelf ook dagelijks bij.

Elke wijziging die Nebo Link aanbrengt in de configuratie van een agent, wordt vastgelegd met de waarde die werd vervangen, zodat models off en unlink die precies terugzetten. De bestanden van elke bot staan in ~/Library/Application Support/nebo-link/<bot id> op macOS, ~/.local/share/nebo-link/<bot id> op Linux en %APPDATA%\nebo-link\<bot id> op Windows, of onder NEBO_LINK_HOME.

Open Agent Link

Open Agent Link (OAL) is een open protocol om agents op elke computer te bereiken: het Agent Client Protocol, bereikbaar gemaakt, plus een dunne hostlaag. De specificatie is gepubliceerd op openagent.link onder CC-BY-4.0.

OnderdeelDefinitie
AgentSpreekt ACP via standaardinvoer en -uitvoer.
HostEén per computer en gebruiker; draait agents en bedient ze. Nebo Link en Nebo zijn hosts.
ClientEen app die met een host praat.
RelayOptioneel. Stuurt verkeer door tussen clients en hosts die elkaar niet kunnen bereiken.
TransportWebSocket (wss via internet) met subprotocol oal, één JSON-frame per bericht. Hostberichten zijn JSON-RPC-methoden host/*; agentverkeer is ACP, verpakt als {"agent": "<id>", "acp": <message>}.
KoppelenEen eenmalige code van acht tekens, weergegeven als XXXX-XXXX. De relay routeert op de eerste helft en ziet de tweede nooit.

Nebo Link bedient elke agent die het host via OAL en ook voor NeboAI, en versleutelt elke verbinding end-to-end, zodat een relay verkeer doorstuurt dat hij niet kan lezen.

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

Client-SDK's zijn beschikbaar voor TypeScript (@openagentlink/client) en Python (openagentlink). Een relay die je zelf kunt hosten en een conformiteitssuite maken deel uit van het project Open Agent Link; wie voor de conformiteitssuite slaagt, is een compatibele host of client.