tools/

tools/ の下にある @AITool 注釈付き関数はすべて、呼び出し可能なツールになります。

tools/

tools/ の下にある .bx ファイル (tools/nested/Search.bx のようなサブフォルダも動作するよう、再帰的に検索されます) のうち、@AITool 注釈付きの関数を宣言しているものは、エージェントにとって呼び出し可能なツールになります。

// tools/Greeter.bx
class {

	@AITool( "Say hello to someone by name." )
	function sayHello( name ) {
		return "Hello, " & arguments.name & "!";
	}

}

BX Agents は @AITool 注釈自体をスキャンしたり解釈したりはしません - (名前の衝突チェックのために) .bx ファイルごとに 1 エントリを発見し、その後 tools/ フォルダ全体をそのまま生成されたアプリにコピーします。起動時に、生成されたアプリは bx-ai 自身のスキャナーを呼び出します。

aiToolRegistry().scan( "tools" )

これが (コピーされたファイルを走査し、各クラスをインスタンス化し、@AITool 関数を見つける) 実際のリフレクション作業を行います。この文は、プロジェクトが実際に中身のある tools/ フォルダを持っている場合にのみ出力されます。

命名

発見されたエントリ名は、ファイル自身のベース名です (Greeter.bx → Greeter)。同じベース名を持つ 2 つのツールファイル (発見はベース名によるフラットなものなので、異なるサブフォルダにあっても) は、重複名エラーで検証に失敗します。

除外されるもの

• ドットファイル (. で始まるもの) は発見から除外されます。
• tools/ の中の .env/ドットファイルは、存在していてもビルド出力には決してコピーされません - コピー処理が明示的にそれらを除外します。

再ビルド

tools/ は消去してから書き直す方式でコピーされます - 生成されたアプリ自身の tools/ ディレクトリは、build のたびに削除されて書き直されます。そのため、あなたのプロジェクトの tools/ フォルダから削除されたファイルが、以前のビルドの残骸として居残ることはありません。