インストール
BX Agents を実行するマシンに必要な 3 つのもの。
On this page
インストール
BX Agents は BoxLang のモジュールです。これを実行するマシンには、次の 3 つが必要です。
- BoxLang ランタイム。
bx-aiBoxLang モジュール (BX Agents はこれを呼び出すコードを生成しますが、これ自体をバンドルしているわけではありません)。- BX Agents 自体。
serve はさらに、独立した boxlang-miniserver バイナリが PATH 上にある必要があります。build、chat、package、inspect、clean、new にはこれは不要です。
deploy の ftp/sftp ターゲットには、bx-ai/BX Agents と並んで bx-ftp BoxLang モジュールがインストールされている必要があります (install-bx-module bx-ftp) - これはこのモジュールが bx-ai に対して持つのと同じ関係性の、バンドルされていない正真正銘のランタイム依存です。他の動詞やデプロイターゲットではこれは不要です。
公式の BoxLang インストールガイド に従ってください。クイックインストーラーは ~/.boxlang/bin を PATH にも設定します。これは、モジュールが提供する実行ファイル (下記の BX Agents 自身の bxAgents コマンドなど) が置かれる場所です。
install-bx-module bx-ai
install-bx-module bx-agents
これにより、両方のモジュールが BoxLang のモジュールディレクトリ (デフォルトでは ~/.boxlang/modules、--local を指定すると boxlang_modules/) に取得されます。
bxAgents --version
bxAgents --help
--help は、10 個すべての動詞 (new、build、test、serve、chat、invoke、package、deploy、inspect、clean) を、それぞれ 1 行の説明とともに一覧表示します。
bxAgents コマンド
BX Agents は自身の box.json の中でネイティブな実行ファイルを宣言しています。
"boxlang": { "moduleName": "bxagents", "executable": "bxAgents" }
インストーラーはこれを PATH 上の bxAgents ラッパースクリプトに変換するので、次のように実行できます。
bxAgents new my-agent --model=openai/gpt-5
これは、より長い形式の代わりです。
boxlang module:bxagents new my-agent --model=openai/gpt-5
どちらも等価です - どちらの方法でも、すべての動詞は同じ ModuleConfig.bx main(args) エントリーポイントを経由してディスパッチされます。このドキュメントでは全体を通して短い bxAgents <verb> 形式を使用します。
最初のエージェントをスキャフォールドするには クイックスタート を参照してください。