メインコンテンツへスキップ
Agent Session は隔離されたサンドボックスコンテナ上で実行されます。本ドキュメントでは、コンテナの OS、プリインストールツール、リソース制限などの参照情報を一覧します。

オペレーティングシステム

項目
ディストリビューションUbuntu 22.04 LTS (Jammy)
アーキテクチャx86_64 (amd64)
カーネルLinux 5.10.134(LIFSEA コンテナエンジン、Linux 5.10 LTS ベース)

プリインストールツール

システムツール

ツールバージョン説明
git2.34+バージョン管理
curl7.81+HTTP クライアント
wget1.21+ファイルダウンロード
jq1.6+JSON 処理
vim8.2+テキストエディタ
unzip / tarシステム標準圧縮/解凍
sshOpenSSH 8.9+SSH クライアント
make4.3+ビルドツール

言語ランタイム

言語バージョンパッケージマネージャ
Python3.12.xpip 24+
Node.js20.x LTSnpm 10+
Go1.22.xgo mod

パッケージ管理

ツール説明
aptシステムパッケージ管理
pipPython パッケージ
npmNode.js パッケージ

作業ディレクトリ

/app
Agent のデフォルト cwd は /app$HOME/data(別ディレクトリ)を指し、~/ は cwd 配下に展開されません。アップロードファイルのマウントパスは Files ドキュメントを参照。

追加ソフトウェアのインストール

Environment 構成の packages フィールドで追加依存関係をインストールします。
{
  "config": {
    "packages": {
      "apt": ["postgresql-client", "redis-tools", "ffmpeg"]
    }
  }
}
コンテナ起動時、apt/pip/npm キーがそれぞれシステムパッケージ、Python パッケージ、Node.js パッケージをインストールします。
Agent の system prompt 内で、必要に応じて追加の依存関係をインストールするよう Agent に指示することもできます。

ネットワーク構成

ネットワークアクセス能力は Environment の config.networking フィールドで制御します(オブジェクト形式必須)。
タイプ説明
unrestrictedコンテナがパブリックネットワークにアクセス可能 (デフォルト)
limited既知の安全なパブリックサービスとパッケージマネージャーのみアクセス可能
allowed_hosts指定したホスト名のみアクセス可能
構成例:
{
  "config": {
    "networking": {
      "type": "allowed_hosts",
      "allowed_hosts": [
        "api.github.com",
        "registry.npmjs.org"
      ]
    }
  }
}
詳細なフィールド説明は クラウド環境 - ネットワークポリシー を参照してください。

リソース制限

リソースデフォルト制限説明
CPU4 vCPU割り当てられるプロセッサコア数
メモリ8 GB利用可能な RAM
ディスク25 GB(overlay ファイルシステム、約 18 GB 利用可能)作業領域のストレージ
実行時間30 分単一 Turn の最大実行時間
メモリやディスクの制限を超えると、プロセスが OOM Kill されるか書き込みが失敗します。system prompt で Agent にリソース使用量への注意を促してください。

ファイルの永続化

  • 同一 Session 内では、ファイルは Turn 間で保持されます
  • コンテナの一時ストレージの保持期間は 24 時間のみです。 24 時間以上非アクティブな Session では、コンテナディスクが回収される可能性があり、ディスク上のファイルの保持は保証されません
  • ディスク回収後も Session 自体は引き続き利用可能です——プラットフォームはオンデマンドでコンテナ環境を再初期化しますが、以前ディスク上で生成されたファイル(クローンしたリポジトリ、生成した中間成果物など)は失われます
  • Session 終了時 (archived/deleted) にコンテナとそのファイルは即座に破棄されます
  • 長期保存が必要なファイルは Files API でプラットフォームストレージへアップロードします
ディスク回収は Session の終了を意味しません。ワークフローが日をまたいでディスク上の中間ファイルに依存する場合は、各ターンの終了時に重要な成果物を Files API にアップロードし、再開時に再マウントしてください。

実行ユーザー

コンテナ内のすべてのコマンドは root ユーザーとして実行されます。whoamiroot を返しますが、USER 環境変数は注入されていません(空文字列)。 Agent はシステムパッケージのインストールや任意のシステムディレクトリへの書き込みを sudo なしで直接実行できます。制限が必要な場合は、Agent のシステムプロンプトで明示してください。

環境変数

コンテナにプリセットされる環境変数:
変数説明
HOME/dataユーザーホームディレクトリ(~/ はここに展開され、cwd /app とは異なります)
USER(未設定、空文字列)USER 環境変数は注入されていません。実際の身元は whoami で取得でき、root を返します
SHELL/bin/bashデフォルトシェル
LANGen_US.UTF-8ロケール設定
Vault 内の認証情報は環境変数として注入されます (Session 作成時に Vault を関連付ける必要があります)。