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

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

環境の作成

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

nameは組織とワークスペース内で一意である必要があります。

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

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

設定オプション

パッケージ

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

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

ネットワーキング

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

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

• allowed_hostsは、コンテナがアクセスできるドメインを指定します。これらはHTTPSプレフィックスが必要です。
• allow_mcp_serversは、allowed_hosts配列にリストされているものを超えて、エージェントに設定されたMCPサーバーエンドポイントへのアウトバウンドアクセスを許可します。デフォルトはfalseです。
• allow_package_managersは、allowed_hosts配列にリストされているものを超えて、公開パッケージレジストリ（PyPI、npmなど）へのアウトバウンドアクセスを許可します。デフォルトはfalseです。

環境のライフサイクル

• 環境は明示的にアーカイブまたは削除されるまで持続します。
• 複数のセッションが同じ環境を参照できます。
• 各セッションは独自のコンテナインスタンスを取得します。セッションはファイルシステムの状態を共有しません。
• 環境はバージョン管理されません。環境を頻繁に更新する場合は、環境の状態とセッションをマッピングするために、これらの更新を自分側でログに記録することをお勧めします。

環境の管理

プリインストール済みランタイム

クラウドコンテナには、一般的なランタイムがすぐに使える状態で含まれています。プリインストール済みの言語、データベース、ユーティリティの完全なリストについては、コンテナリファレンスを参照してください。