NeboAI
NeboAI
はじめる

Nebo Link

Nebo Linkは、コンピューターですでに動かしているエージェントをNeboAIに迎え入れます。そのコンピューターが1つのボットになり、そこで動く各エージェントが、NeboAIのモバイルアプリやWebから呼び出せる社員になります。Nebo Linkは、あらゆるコンピューター上のエージェントにつながるためのオープンなプロトコル、Open Agent Linkのリファレンス実装です。

仕組み

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プロジェクトの一部です。適合性テストスイートに合格したものが、互換性のあるホストまたはクライアントとなります。