仕組み
nebo-linkはエージェントの横で動き、NeboAIへの外向きの接続を2つ作ります。1つはボットがオンラインであることを報告する接続、もう1つはアプリからのリクエストをエージェントに運ぶトンネルです。ポートを開くことはなく、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
これにより、そのコンピューターが1つのボットとしてアカウントとペアリングされ、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を到達可能にし、薄いホスト層を加えたものです。仕様はopenagent.linkでCC-BY-4.0のもとに公開されています。
| 要素 | 定義 |
|---|---|
| エージェント | 標準入出力でACPを話します。 |
| ホスト | コンピューターとユーザーごとに1つ。エージェントを動かし、提供します。Nebo LinkとNeboはホストです。 |
| クライアント | ホストとやり取りするアプリ。 |
| リレー | 任意。互いに到達できないクライアントとホストの間で通信を中継します。 |
| トランスポート | サブプロトコルoalのWebSocket(インターネット経由ではwss)で、1メッセージにつき1つのJSONフレーム。ホストのメッセージはJSON-RPCのhost/*メソッドで、エージェントの通信は{"agent": "<id>", "acp": <message>}で包んだACPです。 |
| ペアリング | XXXX-XXXXの形で表示される、1回限りの8文字のコード。リレーは前半を使って振り分け、後半を目にすることはありません。 |
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プロジェクトの一部です。適合性テストスイートに合格したものが、互換性のあるホストまたはクライアントとなります。