cacheplane/b4run

Ridiculous speed. Readable code.

解決する問題

B4.run は、LangGraph.js を使用した LLM エージェントの構築と出荷のボイラープレートを削減します。ルート、ツールセット、状態型、デプロイ詳細を手動で配線する代わりに、開発者は単一のルートファイルを作成し、B4.run がルーティングを発見し、TypeScript 宣言を生成し、決定論的なローカルテストループを提供します。また、ツール承認、権限、サンドボックス化などのランタイムガードレールも追加します。

仕組み

開発者は src/app/**/ のルートの index.ts に agent、workflow、graph、または chain エントリを 1 つ記述します。共有ツールは src/tools/ にあり、ルートローカルツールはルートの隣に置くことができます。B4.run は typegen とビルド中に TypeScript のルート、パラメータ、状態、ツール宣言を生成します。デフォルトの状態は SQLite を使用し、再起動後も永続化できます。テストはフィクスチャベースです。コミットされた応答を再生し、明示的にライブまたは録音モードに設定されていない限り、一致しないインタラクションで失敗します。ビルドは Node サーバー、Dockerfile、LangSmith グラフアーティファクトを出力します。tools.deny などのツールポリシーはツールを削除し、tools.approve は単回使用の許可を使用して人間の承認のために呼び出しを一時停止します。オプションのサンドボックスはワークスペースツールを分離し、権限はシェルコマンドとファイルパスをゲートします。

対象読者

LangGraph.js でエージェントを構築する TypeScript チームで、手動配線ではなくアプリケーション規約を希望するチーム。ローカル開発とテストループ、永続化、デプロイターゲットを必要とするチームに適しています。LangChain と LangGraph.js を利用可能に保ちながら。Python プロジェクトや、フレームワークの規約なしで生の LangGraph.js を好むチームには向いていません。

ハイライト

  • ファイルシステムルーティング: src/app/**/index.ts にエントリを公開すると、B4.run がルートを発見します。
  • 生成型: ルート、パラメータ、状態、ツール宣言が自動的に生成されます。
  • 決定論的テスト: フィクスチャベースのテストは、API キーなしでオフラインで応答を再生します。
  • ツール承認: tools.approve は単回使用の許可を使用して人間の承認のために呼び出しを一時停止します。
  • セキュリティ制御: 権限はシェルコマンドとファイルパスをゲートします。オプションのサンドボックスはワークスペースツールを分離します。
  • ビルドターゲット: デフォルトのビルドは Node サーバー、Dockerfile、LangSmith アーティファクトを生成します。他のターゲット(edge、Vercel、Kubernetes)はオプトインです。

関連

  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト
  • Dispatch