AIエージェントがコード、コマンド、ファイル、ブラウザーを実行できる、独自インフラ上のオープンソース・サンドボックスランタイム。
kubernetes-sigs/agent-sandbox
AIエージェントのランタイムや強化学習ワークロード向けに、分離されたステートフルな単一Podサンドボックスを管理するKubernetesコントローラーとCRD。
- スター
- 4,543
- フォーク
- 607
- 未解決の Issue
- 177
- 最終コミット
- 22 時間前
これは何?
agent-sandboxは、安定したホスト名とネットワークID、必要に応じた永続ストレージを備えた、長時間稼働する単一コンテナのワークロードを実行するため、SandboxカスタムリソースとコントローラーをKubernetesに追加します。ステートレスで複製されるDeploymentと、番号付きPodのセットを管理するStatefulSetの間にある機能のギャップを埋めます。本プロジェクトはSIG Appsのもとで開発されています。
オプションの拡張モジュールでは、再利用可能なサンドボックス定義のためのSandboxTemplate、事前に起動したサンドボックスを割り当て可能な状態で維持するSandboxWarmPool、完全な設定を扱わずにプールからサンドボックスを要求するSandboxClaimを追加します。Sandbox PodはRuntimeClassを通じてgVisorやKata Containersなどのランタイムで実行するよう設定でき、コントローラーがオーケストレーションを担い、ランタイムが分離を提供します。
GoおよびPython SDKに加えて、クライアントからSandbox Podへトラフィックを転送するHTTPリバースプロキシ、Sandbox Routerも提供します。インストールにはkubectlマニフェストまたはHelmを使用します。
主な機能
- 01Sandbox CRDにより、安定したホスト名とネットワークIDを持つステートフルな単一Podを利用できます。
- 02永続ストレージはPodの再起動後も保持できます。
- 03ライフサイクル管理では、作成、スケジュールに基づく削除、一時停止、再開に対応します。
- 04SandboxWarmPoolにより、事前に起動したサンドボックスをすばやく割り当てられる状態で維持できます。
- 05SandboxClaimを使うと、完全な設定を管理せずにプールからサンドボックスを要求できます。
- 06RuntimeClassを介してgVisorまたはKata Containersを利用できます。
- 07GoおよびPython SDKを利用できます。
ユースケース
- AIエージェント向けに、LLMが生成したコードや信頼できないコードを分離環境で実行する。
- 強化学習や評価のループ向けに、すぐ起動できるサンドボックスを提供する。
- 永続的なクラウド開発環境やJupyter形式のセッションをホストする。
- StatefulSetのオーバーヘッドを避けつつ、安定したIDを必要とする単一インスタンスのサービスを実行する。
クイックスタート
- 1
kubectl でコアと拡張機能をインストールします(最新リリース)
kubectl apply -f https://github.com/kubernetes-sigs/agent-sandbox/releases/latest/download/sandbox-with-extensions.yaml - 2
Sandbox CRD がインストールされていることを確認します
kubectl get crd sandboxes.agents.x-k8s.io - 3
コンテナイメージを指定して Sandbox マニフェストを適用します
使う前に知っておきたいこと
- agent-sandbox コントローラーがインストールされた Kubernetes クラスターが必要です。
- Sandbox の分離には、gVisor や Kata Containers などの別途用意されたランタイムが必要です。
収録されている特集
トピック
よくある質問
- agent-sandbox とは?
- AIエージェントのランタイムや強化学習ワークロード向けに、分離されたステートフルな単一Podサンドボックスを管理するKubernetesコントローラーとCRD。 agent-sandboxは、安定したホスト名とネットワークID、必要に応じた永続ストレージを備えた、長時間稼働する単一コンテナのワークロードを実行するため、SandboxカスタムリソースとコントローラーをKubernetesに追加します。ステートレスで複製されるDeploymentと、番号付きPodのセットを管理するStatefulSetの間にある機能のギャップを埋めます。本プロジェクトはSIG Appsのもとで開発されています。
- agent-sandbox は無料で使えますか?ライセンスは?
- agent-sandbox は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
- agent-sandbox は今もメンテナンスされていますか?
- 活発にメンテナンス中。agent-sandbox の最終コミットは 2026年11月7日 です。
- agent-sandbox は何に使えますか?
- AIエージェント向けに、LLMが生成したコードや信頼できないコードを分離環境で実行する。 強化学習や評価のループ向けに、すぐ起動できるサンドボックスを提供する。 永続的なクラウド開発環境やJupyter形式のセッションをホストする。 StatefulSetのオーバーヘッドを避けつつ、安定したIDを必要とする単一インスタンスのサービスを実行する。
- agent-sandbox のインストール方法は?
- kubectl でコアと拡張機能をインストールします(最新リリース): kubectl apply -f https://github.com/kubernetes-sigs/agent-sandbox/releases/latest/download/sandbox-with-extensions.yaml Sandbox CRD がインストールされていることを確認します: kubectl get crd sandboxes.agents.x-k8s.io コンテナイメージを指定して Sandbox マニフェストを適用します
- agent-sandbox はどこで入手できますか?
- ソースコードとインストール手順は GitHub にあります:https://github.com/kubernetes-sigs/agent-sandbox
概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。
関連プロジェクト
bashと約100行のコアPythonだけで、GitHub issueを解決したりCLIで支援したりする、最小構成のAIソフトウェアエンジニアリングエージェント。
Claude Codeエージェントを搭載した、IM連携とサンドボックス実行に対応するセルフホスト型Web UIパーソナルAIコワーカー。
KubernetesコントローラーやOperatorの構築に使うGoライブラリ群。KubebuilderとOperator SDKの基盤です。
アイドル状態のアクターをスナップショットし、少数のワーカーで多数のステートフルAIエージェントを動かす、Kubernetes上のゼロトラスト・サンドボックスランタイム。
Microsoftが提供する軽量なエージェント向けRLフレームワーク。実際のツールやハーネスをそのまま使いながら、既存のAIエージェントを強化学習でトレーニングできます。