Como funciona
nebo-link roda ao lado dos seus agentes e abre duas conexões de saída com o NeboAI: uma que informa que o bot está online e um túnel que leva as solicitações do app até os agentes. Ele não abre nenhuma porta e não precisa de VPN. Cada agente mantém o próprio login no computador; o NeboAI nunca vê essas credenciais.
Vincular um computador
Gere um código no app NeboAI e execute o instalador no computador onde seus agentes rodam. O instalador verifica a assinatura do download antes de executá-lo e para se a verificação falhar.
# 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
Isso pareia o computador com a sua conta como um bot e instala o nebo-link como um serviço em segundo plano: um agente do launchd no macOS, uma unidade de usuário do systemd no Linux e uma tarefa de logon no Windows. --name define o nome do bot e --label, o do primeiro agente.
Adicionar agentes
Todos os outros agentes do computador entram no mesmo bot. Agentes que falam o Agent Client Protocol (ACP) podem ser adicionados pelo comando que os inicia no modo ACP. --dir é a pasta em que as conversas do agente trabalham.
nebo-link add --acp-command "example-agent acp" --dir ~/code/site --label "Site agent"
Um agente de programação roda com o próprio login. Os pedidos de permissão dele chegam como cartões no chat e como itens na caixa de entrada do proprietário, e o modo de permissão do funcionário no NeboAI define o modo do próprio agente em cada conversa.
Comandos
| Comando | O que faz |
|---|---|
nebo-link <code> | Vincula este computador como um bot, com o primeiro agente. |
nebo-link status | Mostra o que está vinculado, os agentes que ele hospeda e se está online. |
nebo-link add <agent> [--dir <folder>] [--label <name>] | Adiciona um agente ao bot. --acp-command adiciona qualquer agente ACP. |
nebo-link remove <agent id> | Remove um agente. |
nebo-link models on|off | Encaminha os modelos de um agente pelo NeboAI ou restaura o provedor original dele. |
nebo-link logs [--lines N] | Mostra o log recente do serviço. |
nebo-link unlink | Restaura todas as configurações alteradas, remove o serviço e esquece o bot. |
nebo-link update | Instala a versão assinada mais recente. O serviço também se atualiza diariamente. |
Cada alteração que o Nebo Link faz na configuração de um agente é registrada junto com o valor que ela substituiu, para que models off e unlink a restaurem exatamente. Os arquivos de cada bot ficam em ~/Library/Application Support/nebo-link/<bot id> no macOS, ~/.local/share/nebo-link/<bot id> no Linux e %APPDATA%\nebo-link\<bot id> no Windows, ou em NEBO_LINK_HOME.
Open Agent Link
O Open Agent Link (OAL) é um protocolo aberto para acessar agentes em qualquer computador: o Agent Client Protocol, tornado acessível, mais uma camada fina de host. A especificação está publicada em openagent.link sob a licença CC-BY-4.0.
| Parte | Definição |
|---|---|
| Agente | Fala ACP pela entrada e saída padrão. |
| Host | Um por computador e usuário; executa agentes e os disponibiliza. O Nebo Link e o Nebo são hosts. |
| Cliente | Um app que conversa com um host. |
| Relay | Opcional. Encaminha o tráfego entre clientes e hosts que não conseguem se alcançar. |
| Transporte | WebSocket (wss pela internet) com o subprotocolo oal, um frame JSON por mensagem. As mensagens do host são métodos JSON-RPC host/*; o tráfego dos agentes é ACP encapsulado como {"agent": "<id>", "acp": <message>}. |
| Pareamento | Um código de uso único com oito caracteres, exibido como XXXX-XXXX. O relay faz o roteamento pela primeira metade e nunca vê a segunda. |
O Nebo Link disponibiliza cada agente que hospeda via OAL e também para o NeboAI, e criptografa cada conexão de ponta a ponta, então um relay encaminha um tráfego que não consegue ler.
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
Há SDKs de cliente para TypeScript (@openagentlink/client) e Python (openagentlink). Um relay que você mesmo pode hospedar e uma suíte de conformidade fazem parte do projeto Open Agent Link; passar na suíte de conformidade é o que torna um host ou cliente compatível.