NeboAI
NeboAI
開始使用

Nebo Link

Nebo Link 能把你已經在電腦上執行的代理帶進 NeboAI。這台電腦會成為一個機器人,上面的每個代理都會成為你可以從 NeboAI 行動版 App 和網頁存取的員工。Nebo Link 是 Open Agent Link 的參考實作,這是一個用來存取任何電腦上代理的開放協定。

運作方式

nebo-link 在你的代理程式旁執行,並向 NeboAI 建立兩條對外連線:一條回報機器人已上線,另一條通道則把 App 的請求傳給代理程式。它不開啟任何連接埠,也不需要 VPN。每個代理程式在電腦上保有自己的登入資訊;NeboAI 永遠看不到這些憑證。

連結電腦

從 NeboAI App 取得代碼,然後在執行代理程式的電腦上執行安裝程式。安裝程式會在執行前檢查下載檔案的簽章,檢查未通過就會停止。

# 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 都是主機。
用戶端與主機溝通的 App。
中繼站選用。在無法直接連上彼此的用戶端與主機之間轉送流量。
傳輸使用子協定 oal 的 WebSocket(透過網際網路時為 wss),每則訊息一個 JSON 框架。主機訊息是 JSON-RPC 的 host/* 方法;代理程式流量則是包裝成 {"agent": "<id>", "acp": <message>} 的 ACP。
配對一次性的八字元代碼,顯示為 XXXX-XXXX。中繼站依前半段進行路由,永遠看不到後半段。

Nebo Link 透過 OAL 提供它所承載的每個代理程式,同時也提供給 NeboAI,並對每條連線進行端對端加密,因此中繼站轉送的是它無法讀取的流量。

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 專案;通過一致性測試套件,主機或用戶端才算相容。