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

環境（environment）は、エージェントが実行されるサンドボックスの構成を定義します。環境は一度作成すれば、セッションを開始するたびにその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"



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

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



次のステップ