CLIツール
agent-substrate/substrate avatar
agent-substrate/substrate

Agent Substrate: 多数のアクターを少数のワーカーにマッピングするランタイム

エージェント基板: コアシステム。 Agent Substrate は、Kubernetes 上に構築されたシステムで、エージェントのようなワークロードを管理して、Kubernetes 単体で提供できるよりも高いスケールと効率を、より低いレイテンシーで実現します。

スター 1,860フォーク 318GoApache-2.0
GitHub

ひと目でわかる

これは何?
Agent SubstrateはGoベースのランタイムで、サブセカンドのサスペンドとレジュームにより、ステートフルなエージェントワークロードを少数のKubernetesワーカーに多重化します。
誰に向いている?
READMEはAgent SubstrateをKubernetes上のエージェント実行基盤と位置づけます。SDKではなく、actorの作成、破棄、停止、再開、worker割り当て、受信トラフィックの経路を管理するシステムです。
商用利用できる?
できます。Apache-2.0 は寛容なライセンスで、著作権表示とライセンス表示を残せば、使用・改変・販売が可能です。
今もメンテナンスされている?
されています。最後のコミットは 1 日前です。
何の言語で書かれている?
主に Go です(GitHub の言語統計による)。

回答はプロジェクトの GitHub データ(最終同期:2026年9月14日)と当サイトの分析に基づくもので、法的助言ではありません。

オープンソース詳細解説

アクターを8つのPodへ載せる設計

READMEはAgent SubstrateをKubernetes上のエージェント実行基盤と位置づけます。SDKではなく、actorの作成、破棄、停止、再開、worker割り当て、受信トラフィックの経路を管理するシステムです。 アクターを8つのPodへ載せる設計では、READMEにある対象と範囲をこの節の論点として読みます。

アクターとワーカー: コアの多重化の考え方。Agent Substrateは、エージェントのようなアプリケーションの大規模デプロイメントのためのランタイムです。各エージェントに専用リソースを割り当てる代わりに、システムは準備済みワーカーのプールを維持し、より大きなアクターのセットをそれらのワーカーにマッピングします。READMEは、エージェントワークロードはほとんどの時間アイドル状態であるため、高密度の多重化が可能であると説明しています。システムは低意見(low-opinion)に設計されており、ワークロードは文字通りのAIエージェントである必要はありませんが、それが主なユースケースです。これはエージェントを構築するためのSDKではなく、大規模に実行するためのシステムであると明示されています。

導入判断ではsubstrateのREADMEに記載された具体的な入口を一つ選び、入力、設定、出力、エラーを同じ記録に残します。資料にない性能や安全性は補いません。READMEはAgent SubstrateをKubernetes上のエージェント実行基盤と位置づけます。SDKではなく、actorの作成、破棄、停止、再開、worker割り当て、受信トラフィックの経路を管理するシステムです。 実行前後の差分を確認し、更新で挙動が変わった箇所だけを切り分けます。 アクターを8つのPodへ載せる設計に関してREADMEが明記していない条件は、未確認のまま採用範囲の外へ置きます。

suspendとresumeで状態を移す経路

READMEはAgent SubstrateをKubernetes上のエージェント実行基盤と位置づけます。SDKではなく、actorの作成、破棄、停止、再開、worker割り当て、受信トラフィックの経路を管理するシステムです。 suspendとresumeで状態を移す経路では、READMEにある対象と範囲をこの節の論点として読みます。

ライフサイクル操作: サスペンド、レジューム、状態保存。コントロールプレーンは、エージェントサンドボックスの完全なライフサイクル管理を提供し、作成、破棄、サスペンド、レジューム操作を含みます。READMEはサブセカンドのレジュームとサスペンドを主張しており、これによりエージェントを同じインフラストラクチャに高密度に多重化できます。複数のサンドボックス技術がサポートされており、マイクロVMやgVisorが含まれます。状態保存には、ハイバネーションサイクル全体で揮発性RAMとファイルシステム状態を保持するフルステートスナップショットを使用します。カウンターデモは、サスペンドとレジュームイベントをまたいでステートフルなHTTPサーバーを保存することでこれを実証しています。READMEはまた、「インスタントアクターテレポート」を、利用可能なワーカーへの高性能なサスペンドとレジュームとして説明しています。

導入判断ではsubstrateのREADMEに記載された具体的な入口を一つ選び、入力、設定、出力、エラーを同じ記録に残します。資料にない性能や安全性は補いません。READMEはAgent SubstrateをKubernetes上のエージェント実行基盤と位置づけます。SDKではなく、actorの作成、破棄、停止、再開、worker割り当て、受信トラフィックの経路を管理するシステムです。 実行前後の差分を確認し、更新で挙動が変わった箇所だけを切り分けます。 suspendとresumeで状態を移す経路に関してREADMEが明記していない条件は、未確認のまま採用範囲の外へ置きます。

ateapiからatenetまでの役割分担

READMEはAgent SubstrateをKubernetes上のエージェント実行基盤と位置づけます。SDKではなく、actorの作成、破棄、停止、再開、worker割り当て、受信トラフィックの経路を管理するシステムです。 ateapiからatenetまでの役割分担では、READMEにある対象と範囲をこの節の論点として読みます。

Kubernetes統合とコントロールプレーンアーキテクチャ。Agent Substrateは、インフラストラクチャのプロビジョニングとワーカーのライフサイクル管理にKubernetesを利用しており、具体的にはPodとPod自動スケーリングを使用します。その上に、エージェント固有のスケジューリングと制御を追加し、汎用のKubernetesスケジューリングよりも低いレイテンシーを実現します。コントロールプレーンには、ateapi(gRPCエンドポイントを公開するコアAPIサーバー)、atelet(ワーカーポッドを監督しスナップショットを調整するノードレベルDaemonSet)、atecontroller(WorkerPoolとActorTemplateカスタムリソースを調整する)、atenet(DNSとEnvoyルーティングを提供するネットワークコンポーネント)が含まれます。ateom-gvisorとateom-microvmは、ポッド内ヘルパーで、それぞれrunscチェックポイントとリストアコマンドを実行したり、アクターをcloud-hypervisor VMとして実行します。これらのコンポーネントはdocs/architecture.mdに文書化されています。

導入判断ではsubstrateのREADMEに記載された具体的な入口を一つ選び、入力、設定、出力、エラーを同じ記録に残します。資料にない性能や安全性は補いません。READMEはAgent SubstrateをKubernetes上のエージェント実行基盤と位置づけます。SDKではなく、actorの作成、破棄、停止、再開、worker割り当て、受信トラフィックの経路を管理するシステムです。 実行前後の差分を確認し、更新で挙動が変わった箇所だけを切り分けます。 ateapiからatenetまでの役割分担に関してREADMEが明記していない条件は、未確認のまま採用範囲の外へ置きます。

kindクラスターのQuickstart

READMEはAgent SubstrateをKubernetes上のエージェント実行基盤と位置づけます。SDKではなく、actorの作成、破棄、停止、再開、worker割り当て、受信トラフィックの経路を管理するシステムです。 kindクラスターのQuickstartでは、READMEにある対象と範囲をこの節の論点として読みます。

状態: 初期開発、互換性保証なし。プロジェクトは初期開発段階にあります。READMEは、本番利用には未対応であり、APIはほぼ確実に変更されると明記しています。この段階では後方互換性の保証は一切行われません。Kubernetesサポートは最新の安定版とその前のマイナーリリースに限定されています。リポジトリメタデータでは975スター、200フォーク、284のオープンイシューが示されていますが、READMEには特定のバージョン番号やリリースタイムラインはありません。脅威モデル文書は信頼境界と既知のリスクを説明していますが、READMEにはセキュリティ保証は記載されていません。これは、このシステムの採用を検討する人への明確な警告です。

導入判断ではsubstrateのREADMEに記載された具体的な入口を一つ選び、入力、設定、出力、エラーを同じ記録に残します。資料にない性能や安全性は補いません。READMEはAgent SubstrateをKubernetes上のエージェント実行基盤と位置づけます。SDKではなく、actorの作成、破棄、停止、再開、worker割り当て、受信トラフィックの経路を管理するシステムです。 実行前後の差分を確認し、更新で挙動が変わった箇所だけを切り分けます。 kindクラスターのQuickstartに関してREADMEが明記していない条件は、未確認のまま採用範囲の外へ置きます。

初期開発段階がもたらす制約

READMEはAgent SubstrateをKubernetes上のエージェント実行基盤と位置づけます。SDKではなく、actorの作成、破棄、停止、再開、worker割り当て、受信トラフィックの経路を管理するシステムです。 初期開発段階がもたらす制約では、READMEにある対象と範囲をこの節の論点として読みます。

デモ: 現在のシステムが示せるもの。リポジトリには6つのデモが含まれており、それぞれ異なる機能を示しています。カウンターデモは、サスペンドとレジュームをまたいで状態を保持し、動的CRDルーティングを示すステートフルなGo HTTPサーバーです。サンドボックスデモはAlpine Linuxを実行し、セッション間でファイルシステム状態を保持しながら任意のシェル実行を可能にします。Claude Code Multiplexデモは、複数のClaude Codeエージェントを限られたワーカープールに多重化します。Multi-Templateは、異なるバイナリを実行する2つのActorTemplateが3つの名前空間にわたって1つのWorkerPoolを共有することを示します。Request Parkingは、ワーカープールの一時的な飽和時にルーターが受信リクエストを保持し、503を返さないことを示します。Autoscaled WorkerPoolは、割り当てられたワーカー数に基づいてWorkerPoolをスケーリングし、prometheus-adapterを使用したHPAを使用します。

導入判断ではsubstrateのREADMEに記載された具体的な入口を一つ選び、入力、設定、出力、エラーを同じ記録に残します。資料にない性能や安全性は補いません。READMEはAgent SubstrateをKubernetes上のエージェント実行基盤と位置づけます。SDKではなく、actorの作成、破棄、停止、再開、worker割り当て、受信トラフィックの経路を管理するシステムです。 実行前後の差分を確認し、更新で挙動が変わった箇所だけを切り分けます。 初期開発段階がもたらす制約に関してREADMEが明記していない条件は、未確認のまま採用範囲の外へ置きます。

採用判断とCounter Demoの確認

READMEはAgent SubstrateをKubernetes上のエージェント実行基盤と位置づけます。SDKではなく、actorの作成、破棄、停止、再開、worker割り当て、受信トラフィックの経路を管理するシステムです。 採用判断とCounter Demoの確認では、READMEにある対象と範囲をこの節の論点として読みます。

クイックスタートとプロジェクト構成。ローカル開発では、READMEがスクリプト化されたセットアップを提供しています。前提条件はGo、kubectl、dockerであり、スクリプトはkindなどの他の依存関係を管理します。手順は、hack/create-kind-cluster.shでkindクラスターとローカルレジストリを作成し、hack/install-ate-kind.sh --deploy-ate-systemと--deploy-demo-counterでateシステムとデモをインストールし、go install ./cmd/kubectl-ateでkubectl-ate CLIをインストールします。atespaceとカウンターアクターを作成した後、ネットワークルーターをポートフォワードしてHTTPリクエストを送信できます。GKEクイックスタートもあり、tools/setup-gcpを使用してGCPリソースをプロビジョニングします。主要コンポーネントはcmd/の下にあり、ateapi、atelet、atecontroller、atenet、ateom-gvisor、ateom-microvm、kubectl-ateが含まれます。貢献は歓迎されますが、READMEはプロジェクトが非常に若く、コアシステムとデモに焦点を当てていると述べています。

導入判断ではsubstrateのREADMEに記載された具体的な入口を一つ選び、入力、設定、出力、エラーを同じ記録に残します。資料にない性能や安全性は補いません。READMEはAgent SubstrateをKubernetes上のエージェント実行基盤と位置づけます。SDKではなく、actorの作成、破棄、停止、再開、worker割り当て、受信トラフィックの経路を管理するシステムです。 実行前後の差分を確認し、更新で挙動が変わった箇所だけを切り分けます。 採用判断とCounter Demoの確認に関してREADMEが明記していない条件は、未確認のまま採用範囲の外へ置きます。

Substrate READMEが示さない運用保証

README取得時点のメタデータ(スター数、フォーク数、未解決issue件数)はREADME本文に含まれず、GitHubリポジトリページから得た補助情報です。これらの数値は採用判断の唯一の根拠にはなりません。評価では必ず公式ドキュメント、リリースノート、LICENSEファイルを参照し、READMEがリンクする一次資料と照合してください。

agent-substrate-substrate-deep-analysisのREADMEは、上記各節で引用した機能説明と手順以外の運用保証(SLA、性能数値、セキュリティ監査結果)を提供していません。

編集部の結論

READMEはAgent SubstrateをKubernetes上のエージェント実行基盤と位置づけます。SDKではなく、actorの作成、破棄、停止、再開、worker割り当て、受信トラフィックの経路を管理するシステムです。 向いているのはREADMEの対象環境と入力形式を管理できる利用者です。本番の保証や性能をREADMEだけで決めたい利用者には向きません。 最初に確認する対象は`hack/create-kind-cluster.sh`からCounter Demoまでの状態遷移です。

公式情報源

  1. Official README
  2. Project repository
  3. Release notes
コミュニティノート

コミュニティノート