Cómo funciona
nebo-link se ejecuta junto a tus agentes y abre dos conexiones salientes hacia NeboAI: una que informa de que el bot está en línea y un túnel que lleva las solicitudes de la app a los agentes. No abre puertos ni necesita VPN. Cada agente conserva su propio inicio de sesión en el ordenador; NeboAI nunca ve esas credenciales.
Vincular un ordenador
Consigue un código en la app de NeboAI y ejecuta el instalador en el ordenador donde se ejecutan tus agentes. El instalador comprueba la firma de la descarga antes de ejecutarla y se detiene si la comprobación falla.
# 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
Esto empareja el ordenador con tu cuenta como un bot e instala nebo-link como servicio en segundo plano: un agente de launchd en macOS, una unidad de usuario de systemd en Linux y una tarea de inicio de sesión en Windows. --name define el nombre del bot y --label el del primer agente.
Añadir agentes
Todos los demás agentes del ordenador se unen al mismo bot. Los agentes que hablan el Agent Client Protocol (ACP) se pueden añadir con el comando que los inicia en modo ACP. --dir es la carpeta en la que trabajan las conversaciones del agente.
nebo-link add --acp-command "example-agent acp" --dir ~/code/site --label "Site agent"
Un agente de programación funciona con su propio inicio de sesión. Sus solicitudes de permiso llegan como tarjetas en el chat y como elementos en la bandeja de entrada del propietario, y el modo de permisos del empleado en NeboAI fija el modo del propio agente en cada conversación.
Comandos
| Comando | Qué hace |
|---|---|
nebo-link <code> | Vincula este ordenador como bot, con su primer agente. |
nebo-link status | Muestra qué está vinculado, los agentes que aloja y si está en línea. |
nebo-link add <agent> [--dir <folder>] [--label <name>] | Añade un agente al bot. --acp-command añade cualquier agente ACP. |
nebo-link remove <agent id> | Quita un agente. |
nebo-link models on|off | Hace pasar los modelos de un agente por NeboAI o restaura su propio proveedor. |
nebo-link logs [--lines N] | Muestra el registro reciente del servicio. |
nebo-link unlink | Restaura todos los ajustes modificados, elimina el servicio y olvida el bot. |
nebo-link update | Instala la última versión firmada. El servicio también se actualiza solo cada día. |
Cada cambio que Nebo Link hace en la configuración de un agente queda registrado junto con el valor que sustituyó, de modo que models off y unlink lo restauran exactamente. Los archivos de cada bot están en ~/Library/Application Support/nebo-link/<bot id> en macOS, ~/.local/share/nebo-link/<bot id> en Linux y %APPDATA%\nebo-link\<bot id> en Windows, o bajo NEBO_LINK_HOME.
Open Agent Link
Open Agent Link (OAL) es un protocolo abierto para llegar a agentes en cualquier ordenador: el Agent Client Protocol, hecho accesible, más una fina capa de host. La especificación está publicada en openagent.link bajo CC-BY-4.0.
| Parte | Definición |
|---|---|
| Agente | Habla ACP por la entrada y la salida estándar. |
| Host | Uno por ordenador y usuario; ejecuta agentes y los sirve. Nebo Link y Nebo son hosts. |
| Cliente | Una app que se comunica con un host. |
| Retransmisor | Opcional. Reenvía el tráfico entre clientes y hosts que no pueden comunicarse directamente. |
| Transporte | WebSocket (wss a través de internet) con el subprotocolo oal, un frame JSON por mensaje. Los mensajes del host son métodos JSON-RPC host/*; el tráfico de los agentes es ACP envuelto como {"agent": "<id>", "acp": <message>}. |
| Emparejamiento | Un código de un solo uso de ocho caracteres, mostrado como XXXX-XXXX. El retransmisor enruta según la primera mitad y nunca ve la segunda. |
Nebo Link sirve cada agente que aloja tanto por OAL como a NeboAI, y cifra cada conexión de extremo a extremo, así que un retransmisor reenvía tráfico que no puede leer.
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
Hay SDK de cliente para TypeScript (@openagentlink/client) y Python (openagentlink). Un retransmisor que puedes alojar tú mismo y un conjunto de pruebas de conformidad forman parte del proyecto Open Agent Link; superar esas pruebas es lo que hace compatible a un host o a un cliente.