Penyiapan environment cloud

Environment mendefinisikan konfigurasi sandbox tempat agen Anda berjalan. Anda membuat environment satu kali, lalu mereferensikan ID-nya setiap kali Anda memulai sesi. Beberapa sesi dapat berbagi environment yang sama, tetapi setiap sesi mendapatkan sandbox terisolasinya sendiri (kontainer Linux yang baru).

Halaman ini membahas environment dengan type: cloud. Untuk menjalankan sandbox pada infrastruktur Anda sendiri, lihat Sandbox self-hosted.



Membuat environment

ant beta:environments create < python-dev.environment.yaml

name: python-dev
config:
  type: cloud
  networking:
    type: unrestricted

Gunakan name yang unik dan deskriptif agar Anda dapat membedakan antar environment.



Menggunakan environment dalam sesi

Teruskan ID environment sebagai string saat membuat sesi.

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



Opsi konfigurasi



Packages

Field packages melakukan pra-instalasi paket ke dalam sandbox sebelum agen dimulai. Paket diinstal oleh package manager masing-masing dan di-cache di seluruh sesi yang berbagi environment yang sama. Ketika beberapa package manager ditentukan, mereka dijalankan dalam urutan alfabetis (apt, cargo, gem, go, npm, pip). Anda dapat secara opsional menyematkan versi tertentu. Paket yang tidak disematkan akan menginstal versi terbaru.

ant beta:environments create < environment.yaml

name: data-analysis
config:
  type: cloud
  packages:
    pip:
      - pandas
      - numpy
      - scikit-learn
    npm:
      - express
  networking:
    type: unrestricted

Package manager yang didukung:



Networking

Field networking mengontrol akses jaringan keluar dari sandbox. Field ini tidak memengaruhi alat web_search atau web_fetch, yang berjalan di server Anthropic; untuk membatasi situs yang dapat dijangkau oleh alat-alat tersebut, atur allowed_domains atau blocked_domains pada entri alat tersebut di toolset agen. Lihat Membatasi domain web search dan web fetch.

Contoh berikut membuat environment dengan networking limited:

ant beta:environments create < environment.yaml

name: api-access
config:
  type: cloud
  networking:
    type: limited
    allowed_hosts:
      - api.example.com
    allow_mcp_servers: true
    allow_package_managers: true

Saat menggunakan networking limited:

• allowed_hosts menentukan domain yang dapat dijangkau oleh sandbox. Tentukan hostname polos atau pola wildcard (seperti *.example.com). Jangan sertakan skema URL, port, atau path.
• allow_mcp_servers mengizinkan akses keluar ke endpoint server MCP yang dikonfigurasi pada agen, di luar yang tercantum dalam array allowed_hosts. Default-nya adalah false.
• allow_package_managers mengizinkan akses keluar ke registri paket publik (seperti PyPI dan npm) di luar yang tercantum dalam array allowed_hosts. Default-nya adalah false.



Siklus hidup environment

• Environment tetap ada hingga diarsipkan atau dihapus secara eksplisit.
• Setiap sesi mendapatkan instance sandbox-nya sendiri, bahkan ketika beberapa sesi mereferensikan environment yang sama. Sesi tidak berbagi state filesystem.
• Environment tidak memiliki versi. Jika Anda sering memperbarui environment, simpan catatan perubahan Anda sendiri agar Anda dapat mengetahui konfigurasi mana yang digunakan setiap sesi.



Mengelola environment

# Daftar environment
ant beta:environments list

# Ambil environment tertentu
ant beta:environments retrieve --environment-id "$ENVIRONMENT_ID"

# Arsipkan environment (hanya-baca, sesi yang ada tetap berjalan)
ant beta:environments archive --environment-id "$ENVIRONMENT_ID"

# Hapus environment (hanya jika tidak ada sesi yang mereferensikannya)
ant beta:environments delete --environment-id "$ENVIRONMENT_ID"



Runtime yang sudah terinstal

Sandbox cloud menyertakan runtime umum secara bawaan. Lihat Referensi sandbox cloud untuk daftar lengkap bahasa, database, dan utilitas yang sudah terinstal.



Langkah selanjutnya