メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs.qoder.com/llms.txt

Use this file to discover all available pages before exploring further.

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": [
      "postgresql-client",
      "redis-tools",
      "ffmpeg"
    ]
  }
}
コンテナ起動時にリストのパッケージが apt-get install で自動的にインストールされます。
Agent の system prompt 内で、特定の言語パッケージを pip installnpm install でインストールするよう 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 間で保持されます
  • Session 終了時 (archived/deleted) にコンテナとそのファイルは破棄されます
  • 長期保存が必要なファイルは 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 を関連付ける必要があります)。