Comment ça marche
nebo-link tourne à côté de vos agents et ouvre deux connexions sortantes vers NeboAI : l'une signale que le bot est en ligne, l'autre est un tunnel qui achemine les requêtes de l'app vers les agents. Il n'ouvre aucun port et ne nécessite aucun VPN. Chaque agent conserve sa propre connexion sur l'ordinateur ; NeboAI ne voit jamais ces identifiants.
Relier un ordinateur
Obtenez un code dans l'app NeboAI, puis lancez le programme d'installation sur l'ordinateur où tournent vos agents. Le programme vérifie la signature du téléchargement avant de l'exécuter et s'arrête si la vérification échoue.
# 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
Cette opération associe l'ordinateur à votre compte en tant que bot et installe nebo-link comme service d'arrière-plan : un agent launchd sur macOS, une unité utilisateur systemd sur Linux et une tâche d'ouverture de session sur Windows. --name définit le nom du bot et --label celui du premier agent.
Ajouter des agents
Tous les autres agents de l'ordinateur rejoignent le même bot. Les agents qui parlent l'Agent Client Protocol (ACP) peuvent être ajoutés avec la commande qui les lance en mode ACP. --dir est le dossier dans lequel travaillent les conversations de l'agent.
nebo-link add --acp-command "example-agent acp" --dir ~/code/site --label "Site agent"
Un agent de code utilise sa propre connexion. Ses demandes d'autorisation arrivent sous forme de cartes dans la discussion et d'éléments dans la boîte de réception du propriétaire, et le mode d'autorisation de l'employé dans NeboAI définit le mode propre de l'agent pour chaque conversation.
Commandes
| Commande | Rôle |
|---|---|
nebo-link <code> | Relie cet ordinateur en tant que bot, avec son premier agent. |
nebo-link status | Indique ce qui est relié, les agents hébergés et s’il est en ligne. |
nebo-link add <agent> [--dir <folder>] [--label <name>] | Ajoute un agent au bot. --acp-command ajoute n’importe quel agent ACP. |
nebo-link remove <agent id> | Retire un agent. |
nebo-link models on|off | Fait passer les modèles d’un agent par NeboAI, ou rétablit son propre fournisseur. |
nebo-link logs [--lines N] | Affiche le journal récent du service. |
nebo-link unlink | Rétablit chaque paramètre modifié, supprime le service et oublie le bot. |
nebo-link update | Installe la dernière version signée. Le service se met aussi à jour chaque jour. |
Chaque modification apportée par Nebo Link à la configuration d'un agent est enregistrée avec la valeur qu'elle a remplacée, si bien que models off et unlink la rétablissent exactement. Les fichiers de chaque bot se trouvent dans ~/Library/Application Support/nebo-link/<bot id> sur macOS, ~/.local/share/nebo-link/<bot id> sur Linux et %APPDATA%\nebo-link\<bot id> sur Windows, ou sous NEBO_LINK_HOME.
Open Agent Link
Open Agent Link (OAL) est un protocole ouvert pour joindre des agents sur n'importe quel ordinateur : l'Agent Client Protocol, rendu joignable, plus une fine couche hôte. La spécification est publiée sur openagent.link sous licence CC-BY-4.0.
| Élément | Définition |
|---|---|
| Agent | Parle ACP via l’entrée et la sortie standard. |
| Hôte | Un par ordinateur et par utilisateur ; exécute les agents et les sert. Nebo Link et Nebo sont des hôtes. |
| Client | Une app qui communique avec un hôte. |
| Relais | Facultatif. Transmet le trafic entre des clients et des hôtes qui ne peuvent pas se joindre directement. |
| Transport | WebSocket (wss sur Internet) avec le sous-protocole oal, une trame JSON par message. Les messages de l’hôte sont des méthodes JSON-RPC host/* ; le trafic des agents est de l’ACP encapsulé sous la forme {"agent": "<id>", "acp": <message>}. |
| Appairage | Un code à usage unique de huit caractères, affiché sous la forme XXXX-XXXX. Le relais route selon la première moitié et ne voit jamais la seconde. |
Nebo Link sert chaque agent qu'il héberge via OAL ainsi qu'à NeboAI, et chiffre chaque connexion de bout en bout, si bien qu'un relais transmet un trafic qu'il ne peut pas lire.
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
Des SDK client sont disponibles pour TypeScript (@openagentlink/client) et Python (openagentlink). Un relais auto-hébergeable et une suite de conformité font partie du projet Open Agent Link ; c'est la réussite de la suite de conformité qui rend un hôte ou un client compatible.