Cómo funciona
nebo-link se ejecuta junto a tus agentes y abre dos conexiones salientes hacia NeboAI: una que informa 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 la computadora; NeboAI nunca ve esas credenciales.
Vincular una computadora
Obtén un código en la app de NeboAI y luego ejecuta el instalador en la computadora donde corren tus agentes. El instalador verifica la firma de la descarga antes de ejecutarla y se detiene si la verificació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 vincula la computadora 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.
Agregar agentes
Todos los demás agentes de la computadora se unen al mismo bot. Los agentes que hablan el Agent Client Protocol (ACP) se pueden agregar 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 usa 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 dueño, y el modo de permisos del empleado en NeboAI define el modo propio del agente en cada conversación.
Comandos
| Comando | Qué hace |
|---|---|
nebo-link <code> | Vincula esta computadora como un 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>] | Agrega un agente al bot. --acp-command agrega cualquier agente ACP. |
nebo-link remove <agent id> | Quita un agente. |
nebo-link models on|off | Dirige los modelos de un agente a través de NeboAI o restaura su propio proveedor. |
nebo-link logs [--lines N] | Muestra el registro reciente del servicio. |
nebo-link unlink | Restaura cada ajuste modificado, quita el servicio y olvida el bot. |
nebo-link update | Instala la versión firmada más reciente. El servicio también se actualiza solo todos los días. |
Cada cambio que Nebo Link hace en la configuración de un agente queda registrado junto con el valor que reemplazó, así 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 dentro de NEBO_LINK_HOME.
Open Agent Link
Open Agent Link (OAL) es un protocolo abierto para llegar a agentes en cualquier computadora: el Agent Client Protocol, hecho accesible, más una capa de host ligera. 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 computadora y usuario; ejecuta agentes y los atiende. Nebo Link y Nebo son hosts. |
| Cliente | Una app que se comunica con un host. |
| Relay | Opcional. Reenvía el tráfico entre clientes y hosts que no pueden comunicarse directamente. |
| Transporte | WebSocket (wss por internet) con el subprotocolo oal, un frame JSON por mensaje. Los mensajes del host son métodos JSON-RPC host/*; el tráfico del agente es ACP envuelto como {"agent": "<id>", "acp": <message>}. |
| Vinculación | Un código de un solo uso de ocho caracteres que se muestra como XXXX-XXXX. El relay enruta con la primera mitad y nunca ve la segunda. |
Nebo Link atiende cada agente que aloja por OAL y también para NeboAI, y cifra cada conexión de extremo a extremo, así que un relay 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 relay que puedes alojar tú mismo y una suite de conformidad forman parte del proyecto Open Agent Link; pasar la suite de conformidad es lo que hace compatible a un host o a un cliente.