Repolode
google

google/ax

AXは、Kubernetesクラスター上で多数のサンドボックス化された自律型エージェントタスクを実行するオープンソースの宣言型オーケストレーターです。

スター
13,963
フォーク
723
未解決の Issue
91
最終コミット
18 時間前

これは何?

AXでは、Task、Workspace、Modelの3種類のリソースを使い、エージェントタスクをYAMLで定義できます。TaskはCPUとメモリの制限が設定された分離サンドボックスで実行されます。WorkspaceはGitリポジトリ、MCPサーバー、スキルパッケージをあらかじめ設定し、エージェントが必要なツールを利用できる状態で起動できるようにします。Modelではプラットフォームが使用するLLMを設定し、認証情報はKubernetesのSecretから取得します。マニフェストはax.io/v1alpha1 APIを使用し、kubectl風の動詞に従うax CLIで適用します。

AXはサンドボックスでの実行にAgent Substrateを使用します。アイドル状態のタスクをチェックポイント付きで一時停止し、後から再開できます。また、デバッグ用にax sshで実行中のサンドボックスへシェル接続できます。CLIはgRPC経由でコントロールプレーンと通信し、アクティブなkubectlコンテキストからクラスターを特定します。

このプロジェクトは開発が活発に進められており、安定版のリリース前に、コンセプト、プロトコル、APIが互換性を損なう形で変更される可能性があります。インストールには、Agent Substrateがすでに稼働しているKubernetesクラスターが必要です。

主な機能

  • 01Task、Workspace、Modelのマニフェストを宣言的に定義し、1つのコマンドで適用できます。
  • 02CPUとメモリの制限を設けたサンドボックス内でタスクを実行できます。
  • 03チェックポイントを使って、実行中のエージェントタスクを一時停止・再開できます。
  • 04ax sshで実行中のサンドボックスに対話型シェルで接続できます。
  • 05アクティブなKubernetesコンテキストに従う、kubectl風のCLIを提供します。

ユースケース

  • 信頼できない、または自律型のエージェントワークロードを、Kubernetesクラスター内で分離して多数実行する。
  • GitリポジトリやMCPツールサーバーを事前設定し、エージェントが必要なコンテキストを備えた状態で起動できるようにする。
  • 長時間アイドル状態のエージェントを一時停止し、状態を失わずに後から再開する。

クイックスタート

  1. 1

    Kubernetes クラスターに Agent Substrate をインストールし、API サービスを確認します

    kubectl get svc api -n ate-system
  2. 2

    ax CLI をインストールします

    go install github.com/google/ax/cmd/ax@latest
  3. 3

    コンテナレジストリを使って AX コントロールプレーンをデプロイします

    make deploy AX_IMAGE_REPO=<your-registry>
  4. 4

    サンプルタスクを適用し、ステータスを確認します

    ax apply -f examples/task.yaml

使う前に知っておきたいこと

  • AX を実行するには、事前に Agent Substrate をインストールした Kubernetes クラスターが必要です。
  • このプロジェクトは活発に開発中のため、安定版のリリース前に大幅な破壊的変更が加わる可能性があります。

トピック

よくある質問

ax とは?
AXは、Kubernetesクラスター上で多数のサンドボックス化された自律型エージェントタスクを実行するオープンソースの宣言型オーケストレーターです。 AXでは、Task、Workspace、Modelの3種類のリソースを使い、エージェントタスクをYAMLで定義できます。TaskはCPUとメモリの制限が設定された分離サンドボックスで実行されます。WorkspaceはGitリポジトリ、MCPサーバー、スキルパッケージをあらかじめ設定し、エージェントが必要なツールを利用できる状態で起動できるようにします。Modelではプラットフォームが使用するLLMを設定し、認証情報はKubernetesのSecretから取得します。マニフェストはax.io/v1alpha1 APIを使用し、kubectl風の動詞に従うax CLIで適用します。
ax は無料で使えますか?ライセンスは?
ax は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
ax は今もメンテナンスされていますか?
活発にメンテナンス中。ax の最終コミットは 2026年10月18日 です。
ax は何に使えますか?
信頼できない、または自律型のエージェントワークロードを、Kubernetesクラスター内で分離して多数実行する。 GitリポジトリやMCPツールサーバーを事前設定し、エージェントが必要なコンテキストを備えた状態で起動できるようにする。 長時間アイドル状態のエージェントを一時停止し、状態を失わずに後から再開する。
ax のインストール方法は?
Kubernetes クラスターに Agent Substrate をインストールし、API サービスを確認します: kubectl get svc api -n ate-system ax CLI をインストールします: go install github.com/google/ax/cmd/ax@latest コンテナレジストリを使って AX コントロールプレーンをデプロイします: make deploy AX_IMAGE_REPO=<your-registry> サンプルタスクを適用し、ステータスを確認します: ax apply -f examples/task.yaml
ax はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/google/ax

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト