Como funciona
O nebo-link corre ao lado dos seus agentes e abre duas ligações de saída para o NeboAI: uma que informa que o bot está online e um túnel que transporta os pedidos da aplicação para os agentes. Não abre portas nem precisa de VPN. Cada agente mantém a sua própria sessão iniciada no computador; o NeboAI nunca vê essas credenciais.
Ligar um computador
Obtenha um código na aplicação NeboAI e execute o instalador no computador onde os seus agentes correm. O instalador verifica a assinatura da transferência antes de a executar 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
Isto emparelha o computador com a sua conta como um bot e instala o nebo-link como serviço em segundo plano: um agente launchd no macOS, uma unidade de utilizador systemd no Linux e uma tarefa de início de sessão no Windows. --name define o nome do bot e --label o do primeiro agente.
Adicionar agentes
Todos os outros agentes do computador juntam-se ao mesmo bot. Os agentes que falam o Agent Client Protocol (ACP) podem ser adicionados através do 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 usa a sua própria sessão iniciada. Os pedidos de permissão 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> | Liga este computador como um bot, com o seu primeiro agente. |
nebo-link status | Mostra o que está ligado, os agentes que aloja 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 através do NeboAI ou repõe o fornecedor original. |
nebo-link logs [--lines N] | Mostra o registo recente do serviço. |
nebo-link unlink | Repõe todas as definiçõ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 sozinho todos os dias. |
Cada alteração que o Nebo Link faz à configuração de um agente fica registada com o valor que substituiu, para que models off e unlink a reponham exatamente. Os ficheiros 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 chegar a agentes em qualquer computador: o Agent Client Protocol, tornado acessível, mais uma fina camada de anfitrião. A especificação está publicada em openagent.link sob CC-BY-4.0.
| Parte | Definição |
|---|---|
| Agente | Fala ACP pela entrada e saída padrão. |
| Anfitrião | Um por computador e utilizador; executa agentes e serve-os. O Nebo Link e o Nebo são anfitriões. |
| Cliente | Uma aplicação que comunica com um anfitrião. |
| Retransmissor | Opcional. Reencaminha o tráfego entre clientes e anfitriões que não conseguem chegar um ao outro. |
| Transporte | WebSocket (wss pela internet) com o subprotocolo oal, uma trama JSON por mensagem. As mensagens do anfitrião são métodos JSON-RPC host/*; o tráfego dos agentes é ACP encapsulado como {"agent": "<id>", "acp": <message>}. |
| Emparelhamento | Um código de utilização única com oito caracteres, apresentado como XXXX-XXXX. O retransmissor encaminha com base na primeira metade e nunca vê a segunda. |
O Nebo Link serve todos os agentes que aloja através do OAL, bem como ao NeboAI, e cifra todas as ligações de ponta a ponta, por isso um retransmissor reencaminha 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
Existem SDKs de cliente para TypeScript (@openagentlink/client) e Python (openagentlink). Um retransmissor que pode alojar por conta própria e um conjunto de testes de conformidade fazem parte do projeto Open Agent Link; passar no conjunto de testes de conformidade é o que torna um anfitrião ou cliente compatível.