Repo-lab
AIツール

agent-composeとは?AIエージェントを隔離実行するGo製コントロールプレーンの使い方

⭐ 169 stars GitHub →

agent-composeはAIエージェントをDocker/BoxLite/Microsandboxで隔離実行するGo製のコントロールプレーンです。CLIとAPI、Jupyter統合で複雑なエージェントワークフローを安全に管理できます。セルフホスト型で実験・ローカル開発に最適なツールです。

GitHubリポジトリ: chaitin/agent-compose(⭐ 169)


agent-composeの概要 — AIエージェント隔離実行とは

agent-composeは、AIエージェントセッションを安全に隔離して実行するためのコントロールプレーンです。長期稼働デーモン、CLIツール、Connect API、複数のランタイムドライバ(Docker・BoxLite・Microsandbox)、ワークスペースプロビジョニング、スケジューラ自動化、イベント履歴、Jupyterプロキシを提供します。docker-composeに似た宣言的な設定ファイル(agent-compose.yml)でエージェントプロジェクトを定義でき、Svelteフロントエンドを通じてブラウザからも操作できます。

現代のAI開発では、エージェントを安全に隔離して実行することがセキュリティ上の重要課題です。agent-composeはこの課題に対し、Docker・BoxLite・Microsandboxの3種類のランタイムドライバを提供し、エージェントが意図せずホスト環境に干渉するリスクを排除します。


AIエージェント 隔離実行 Docker — 主要機能5選

agent-composeが提供する主な機能を紹介します。

1. 隔離ランタイムドライバ Docker、BoxLite、Microsandboxの3種類の隔離環境から選択できます。セキュリティ要件や実行速度に応じて使い分けることが可能です。

2. 宣言的設定ファイル(agent-compose.yml) docker-compose.ymlと似た感覚でエージェントプロジェクトを定義できます。設定をコードとして管理し、再現性の高い環境を構築できます。

3. CLIコマンド一式 uprunlogspsdownなどのCLIコマンドでエージェントセッションのライフサイクルを完全管理できます。

4. Connect API(v1/v2) セッション指向のv1 APIとプロジェクト/ラン/イメージ管理のv2 APIを提供。外部システムとの統合が容易です。

5. Jupyter Notebook統合 Jupyterプロキシを内蔵しており、ノートブック形式でのエージェント開発・デバッグが可能です。


エージェントコントロールプレーン Go 使い方 — セットアップと基本的な使い方

Goツールチェーン・Node.js・Task・Dockerが必要です。

# ビルド
task build

# デーモン起動
agent-compose daemon

# HTTP エンドポイント公開(ローカル開発)
agent-compose daemon --http-addr=127.0.0.1:8080

# プロジェクト起動
agent-compose up

設定は agent-compose.yml に記述します。ランタイムはDocker/BoxLite/Microsandboxから選択できます。

agent-compose.yml 設定例

# agent-compose.yml の例(公式ドキュメント参照)
version: "1"
project:
  name: my-agent
runtime:
  driver: docker
workspace:
  source: .

agent-compose の活用例

以下の場面で特に威力を発揮します。

活用例1: AIコーディングエージェント(Claude・GPT等)をDockerで隔離してセキュアに実行したいMLエンジニアが、サンドボックス環境を素早く構築するケース

活用例2: 複数のAIエージェントセッションをスケジューラで並列管理し、ジョブ履歴をAPIで記録・監視したいDevOpsチームが使うケース

エンジニア向け活用

AIエージェントを本番相当の隔離環境でテスト・デプロイしたいバックエンドエンジニアやMLエンジニア向け。DockerとGoの知識があれば導入できます。


まとめ — agent-compose はこんなエンジニアにおすすめ

agent-composeはAIエージェントの安全な隔離実行を手軽に実現するGo製ツールです。現時点はパブリックプレビューですが、将来的な本番利用も視野に入れた設計です。AIエージェントをセキュアな環境で動かしたいエンジニア、特にDocker環境でのエージェント管理を自動化したい方に強くおすすめします。

  • ✅ AIエージェントをセキュアなサンドボックス環境で実行したい
  • ✅ docker-compose感覚でエージェントを宣言的に管理したい
  • ✅ Jupyter + エージェント統合開発環境が欲しい

現在パブリックプレビュー段階ですが、GitHubのドキュメントとissueが充実しており、活発に開発が進んでいます。


関連ツール・おすすめサービス

  • Perplexity AI — AIエージェント開発の調査・技術情報収集に最適なAI検索ツール
  • DigitalOcean — agent-composeのセルフホストに最適な開発者向けクラウド・App Platform

この技術を学ぶ

AIに興味を持った方には、UdemyのオンラインAIコースもおすすめです。

毎日更新のGitHubツール情報

LINEで受け取って最新情報をキャッチアップしよう

友達追加する(無料)

関連記事

この記事が役に立ったらシェアしてください