So funktioniert es
nebo-link läuft neben deinen Agenten und baut zwei ausgehende Verbindungen zu NeboAI auf: eine, die meldet, dass der Bot online ist, und einen Tunnel, der Anfragen aus der App zu den Agenten bringt. Es öffnet keine Ports und braucht kein VPN. Jeder Agent behält seine eigene Anmeldung auf dem Computer; NeboAI sieht diese Zugangsdaten nie.
Einen Computer verknüpfen
Hol dir einen Code aus der NeboAI-App und führe dann das Installationsprogramm auf dem Computer aus, auf dem deine Agenten laufen. Das Installationsprogramm prüft vor dem Ausführen die Signatur des Downloads und bricht ab, wenn die Prüfung fehlschlägt.
# 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
Damit wird der Computer als ein Bot mit deinem Konto gekoppelt und nebo-link als Hintergrunddienst installiert: als launchd-Agent unter macOS, als systemd-User-Unit unter Linux und als Anmeldeaufgabe unter Windows. --name legt den Namen des Bots fest und --label den des ersten Agenten.
Agenten hinzufügen
Jeder weitere Agent auf dem Computer tritt demselben Bot bei. Agenten, die das Agent Client Protocol (ACP) sprechen, lassen sich über den Befehl hinzufügen, der sie im ACP-Modus startet. --dir ist der Ordner, in dem die Unterhaltungen des Agenten arbeiten.
nebo-link add --acp-command "example-agent acp" --dir ~/code/site --label "Site agent"
Ein Coding-Agent läuft mit seiner eigenen Anmeldung. Seine Berechtigungsabfragen erscheinen als Karten im Chat und als Einträge im Posteingang des Inhabers, und der Berechtigungsmodus des Mitarbeiters in NeboAI bestimmt für jede Unterhaltung den eigenen Modus des Agenten.
Befehle
| Befehl | Funktion |
|---|---|
nebo-link <code> | Verknüpft diesen Computer als Bot, zusammen mit seinem ersten Agenten. |
nebo-link status | Zeigt, was verknüpft ist, welche Agenten es hostet und ob es online ist. |
nebo-link add <agent> [--dir <folder>] [--label <name>] | Fügt dem Bot einen Agenten hinzu. --acp-command fügt einen beliebigen ACP-Agenten hinzu. |
nebo-link remove <agent id> | Entfernt einen Agenten. |
nebo-link models on|off | Leitet die Modelle eines Agenten über NeboAI oder stellt seinen eigenen Anbieter wieder her. |
nebo-link logs [--lines N] | Gibt das aktuelle Log des Dienstes aus. |
nebo-link unlink | Stellt jede geänderte Einstellung wieder her, entfernt den Dienst und vergisst den Bot. |
nebo-link update | Installiert das neueste signierte Release. Der Dienst aktualisiert sich außerdem täglich selbst. |
Jede Änderung, die Nebo Link an der Konfiguration eines Agenten vornimmt, wird mit dem Wert gespeichert, den sie ersetzt hat, sodass models off und unlink ihn exakt wiederherstellen. Die Dateien jedes Bots liegen unter macOS in ~/Library/Application Support/nebo-link/<bot id>, unter Linux in ~/.local/share/nebo-link/<bot id> und unter Windows in %APPDATA%\nebo-link\<bot id> oder unter NEBO_LINK_HOME.
Open Agent Link
Open Agent Link (OAL) ist ein offenes Protokoll, um Agenten auf jedem Computer zu erreichen: das Agent Client Protocol, erreichbar gemacht, plus eine schlanke Host-Schicht. Die Spezifikation ist unter openagent.link unter CC-BY-4.0 veröffentlicht.
| Teil | Definition |
|---|---|
| Agent | Spricht ACP über Standardeingabe und -ausgabe. |
| Host | Einer pro Computer und Benutzer; führt Agenten aus und stellt sie bereit. Nebo Link und Nebo sind Hosts. |
| Client | Eine App, die mit einem Host spricht. |
| Relay | Optional. Leitet Verkehr zwischen Clients und Hosts weiter, die einander nicht erreichen können. |
| Transport | WebSocket (wss über das Internet) mit dem Subprotokoll oal, ein JSON-Frame pro Nachricht. Host-Nachrichten sind JSON-RPC-Methoden host/*; Agentenverkehr ist ACP, verpackt als {"agent": "<id>", "acp": <message>}. |
| Kopplung | Ein Einmalcode aus acht Zeichen, angezeigt als XXXX-XXXX. Das Relay leitet anhand der ersten Hälfte weiter und sieht die zweite nie. |
Nebo Link stellt jeden Agenten, den es hostet, sowohl über OAL als auch für NeboAI bereit und verschlüsselt jede Verbindung Ende-zu-Ende, sodass ein Relay Verkehr weiterleitet, den es nicht lesen kann.
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-SDKs gibt es für TypeScript (@openagentlink/client) und Python (openagentlink). Ein selbst hostbares Relay und eine Konformitätstestsuite gehören zum Projekt Open Agent Link; wer die Konformitätstests besteht, macht einen Host oder Client kompatibel.