NeboAI
NeboAI
开始使用

Nebo Link

Nebo Link 能把你已在电脑上运行的智能体接入 NeboAI。这台电脑会成为一个机器人,其中的每个智能体都会成为一位员工,你可以通过 NeboAI 移动应用和网页联系到它们。Nebo Link 是 Open Agent Link 的参考实现,这是一个用于连接任何电脑上的智能体的开放协议。

工作原理

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 项目的一部分;通过一致性测试,主机或客户端才算兼容。