クラウド環境のセットアップ

環境は、エージェントが実行されるサンドボックスの構成を定義します。環境を一度作成し、セッションを開始するたびにそのIDを参照します。複数のセッションが同じ環境を共有できますが、各セッションは独自の分離されたサンドボックス（新しいLinuxコンテナ）を取得します。

このページでは type: cloud 環境について説明します。独自のインフラストラクチャでサンドボックスを実行するには、セルフホストサンドボックスを参照してください。



環境の作成

ant beta:environments create \
  --name "python-dev" \
  --config '{type: cloud, networking: {type: unrestricted}}'

環境を区別できるように、一意でわかりやすい name を使用してください。



セッションで環境を使用する

セッションを作成する際に、環境IDを文字列として渡します。

ant beta:sessions create \
  --agent "$AGENT_ID" \
  --environment-id "$ENVIRONMENT_ID"



構成オプション



パッケージ

packages フィールドは、エージェントが起動する前にサンドボックスにパッケージを事前インストールします。パッケージはそれぞれのパッケージマネージャーによってインストールされ、同じ環境を共有するセッション間でキャッシュされます。複数のパッケージマネージャーが指定されている場合、アルファベット順（apt、cargo、gem、go、npm、pip）に実行されます。オプションで特定のバージョンを固定できます。バージョンが固定されていないパッケージは最新バージョンがインストールされます。

ant beta:environments create <<'YAML'
name: data-analysis
config:
  type: cloud
  packages:
    pip:
      - pandas
      - numpy
      - scikit-learn
    npm:
      - express
  networking:
    type: unrestricted
YAML

サポートされているパッケージマネージャー:



ネットワーキング

networking フィールドは、サンドボックスのアウトバウンドネットワークアクセスを制御します。web_search または web_fetch ツールの許可ドメインには影響しません。

次の例では、limited ネットワーキングを使用した環境を作成します:

ant beta:environments create <<'YAML'
name: api-access
config:
  type: cloud
  networking:
    type: limited
    allowed_hosts:
      - api.example.com
    allow_mcp_servers: true
    allow_package_managers: true
YAML

limited ネットワーキングを使用する場合:

• allowed_hosts は、サンドボックスが到達できるドメインを指定します。ホスト名のみ、またはワイルドカードパターン（*.example.com など）を指定します。URLスキーム、ポート、パスは含めないでください。
• allow_mcp_servers は、allowed_hosts 配列にリストされているものに加えて、エージェントに構成されたMCPサーバーエンドポイントへのアウトバウンドアクセスを許可します。デフォルトは false です。
• allow_package_managers は、allowed_hosts 配列にリストされているものに加えて、公開パッケージレジストリ（PyPIやnpmなど）へのアウトバウンドアクセスを許可します。デフォルトは false です。



環境のライフサイクル

• 環境は、明示的にアーカイブまたは削除されるまで保持されます。
• 複数のセッションが同じ環境を参照している場合でも、各セッションは独自のサンドボックスインスタンスを取得します。セッション間でファイルシステムの状態は共有されません。
• 環境はバージョン管理されません。環境を頻繁に更新する場合は、各セッションがどの構成を使用したかを把握できるように、変更の記録を自身で保持してください。



環境の管理

# 環境を一覧表示
ant beta:environments list

# 特定の環境を取得
ant beta:environments retrieve --environment-id "$ENVIRONMENT_ID"

# 環境をアーカイブ（読み取り専用、既存のセッションは継続）
ant beta:environments archive --environment-id "$ENVIRONMENT_ID"

# 環境を削除（参照しているセッションがない場合のみ）
ant beta:environments delete --environment-id "$ENVIRONMENT_ID"



プリインストールされたランタイム

クラウドサンドボックスには、一般的なランタイムが最初から含まれています。プリインストールされた言語、データベース、ユーティリティの完全なリストについては、クラウドサンドボックスリファレンスを参照してください。



次のステップ