工作原理
nebo-link 运行在你的智能体旁边,并向 NeboAI 建立两条出站连接:一条报告机器人在线,另一条是隧道,负责把应用发出的请求送到智能体。它不开放任何端口,也不需要 VPN。每个智能体在这台电脑上保留自己的登录;NeboAI 永远看不到这些凭据。
关联一台电脑
在 NeboAI 应用中获取一个代码,然后在运行智能体的电脑上运行安装程序。安装程序会在运行前检查下载文件的签名,检查不通过就会停止。
# 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
这会把这台电脑作为一个机器人与你的账户配对,并把 nebo-link 安装为后台服务:在 macOS 上是 launchd 代理,在 Linux 上是 systemd 用户单元,在 Windows 上是登录任务。--name 设置机器人的名称,--label 设置第一个智能体的名称。
添加智能体
这台电脑上的其他所有智能体都会加入同一个机器人。支持 Agent Client Protocol(ACP)的智能体,可以通过以 ACP 模式启动它的命令来添加。--dir 是该智能体的对话所使用的工作文件夹。
nebo-link add --acp-command "example-agent acp" --dir ~/code/site --label "Site agent"
编程智能体使用它自己的登录运行。它的权限提示会以卡片形式出现在聊天中,并作为条目出现在所有者的收件箱里;NeboAI 中该员工的权限模式,决定了智能体在每次对话中使用的模式。
命令
| 命令 | 作用 |
|---|---|
nebo-link <code> | 将这台电脑关联为机器人,并附带它的第一个智能体。 |
nebo-link status | 显示已关联的内容、它承载的智能体,以及是否在线。 |
nebo-link add <agent> [--dir <folder>] [--label <name>] | 向机器人添加一个智能体。--acp-command 可添加任意 ACP 智能体。 |
nebo-link remove <agent id> | 移除一个智能体。 |
nebo-link models on|off | 让智能体的模型通过 NeboAI 调用,或恢复它原来的提供商。 |
nebo-link logs [--lines N] | 输出服务最近的日志。 |
nebo-link unlink | 恢复所有改动过的设置,移除服务,并忘记该机器人。 |
nebo-link update | 安装最新的已签名版本。服务每天也会自动更新。 |
Nebo Link 对智能体配置所做的每一项更改,都会连同被替换的原值一起记录下来,因此 models off 和 unlink 能够原样恢复。每个机器人的文件位于:macOS 上的 ~/Library/Application Support/nebo-link/<bot id>、Linux 上的 ~/.local/share/nebo-link/<bot id>、Windows 上的 %APPDATA%\nebo-link\<bot id>,或 NEBO_LINK_HOME 之下。
Open Agent Link
Open Agent Link(OAL)是一个开放协议,用于连接任何电脑上的智能体:它让 Agent Client Protocol 可以被远程访问,再加上一层轻量的主机层。规范以 CC-BY-4.0 许可发布在 openagent.link。
| 组成部分 | 定义 |
|---|---|
| 智能体 | 通过标准输入和标准输出使用 ACP 通信。 |
| 主机 | 每台电脑、每个用户一个;运行智能体并对外提供服务。Nebo Link 和 Nebo 都是主机。 |
| 客户端 | 与主机通信的应用。 |
| 中继 | 可选。在无法直接互通的客户端和主机之间转发流量。 |
| 传输 | WebSocket(在互联网上使用 wss),子协议为 oal,每条消息一个 JSON 帧。主机消息是 JSON-RPC host/* 方法;智能体流量是封装成 {"agent": "<id>", "acp": <message>} 的 ACP。 |
| 配对 | 一个一次性的八位代码,显示为 XXXX-XXXX。中继按前半部分路由,永远看不到后半部分。 |
Nebo Link 既把它承载的每个智能体提供给 NeboAI,也通过 OAL 对外提供,并对每条连接进行端到端加密,因此中继转发的是它无法读取的流量。
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
客户端 SDK 支持 TypeScript(@openagentlink/client)和 Python(openagentlink)。可自托管的中继和一致性测试套件也是 Open Agent Link 项目的一部分;通过一致性测试,主机或客户端才算兼容。