Penyiapan lingkungan cloud

Lingkungan mendefinisikan konfigurasi kontainer tempat agen Anda berjalan. Anda membuat lingkungan sekali, kemudian mereferensikan ID-nya setiap kali Anda memulai sesi. Beberapa sesi dapat berbagi lingkungan yang sama, tetapi setiap sesi mendapatkan instans kontainer terisolasi sendiri.

Buat lingkungan

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

name harus unik dalam organisasi dan ruang kerja Anda.

Gunakan lingkungan dalam sesi

Teruskan ID lingkungan sebagai string saat membuat sesi.

session = client.beta.sessions.create(
    agent=agent.id,
    environment_id=environment.id,
)

Opsi konfigurasi

Paket

Bidang packages pra-menginstal paket ke dalam kontainer sebelum agen dimulai. Paket diinstal oleh manajer paket masing-masing dan di-cache di seluruh sesi yang berbagi lingkungan yang sama. Ketika beberapa manajer paket ditentukan, mereka berjalan dalam urutan abjad (apt, cargo, gem, go, npm, pip). Anda dapat secara opsional menyematkan versi spesifik; defaultnya adalah terbaru.

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

Manajer paket yang didukung:

Jaringan

Bidang networking mengontrol akses jaringan keluar kontainer. Ini tidak memengaruhi domain yang diizinkan oleh alat web_search atau web_fetch.

config = {
    "type": "cloud",
    "networking": {
        "type": "limited",
        "allowed_hosts": ["api.example.com"],
        "allow_mcp_servers": True,
        "allow_package_managers": True,
    },
}

Saat menggunakan jaringan limited:

• allowed_hosts menentukan domain yang dapat dijangkau kontainer. Ini harus diawali dengan HTTPS.
• allow_mcp_servers memungkinkan akses keluar ke titik akhir server MCP yang dikonfigurasi pada agen, di luar yang tercantum dalam array allowed_hosts. Default ke false.
• allow_package_managers memungkinkan akses keluar ke registri paket publik (PyPI, npm, dll.) di luar yang tercantum dalam array allowed_hosts. Default ke false.

Siklus hidup lingkungan

• Lingkungan bertahan sampai secara eksplisit diarsipkan atau dihapus.
• Beberapa sesi dapat mereferensikan lingkungan yang sama.
• Setiap sesi mendapatkan instans kontainer sendiri. Sesi tidak berbagi status sistem file.
• Lingkungan tidak diversi. Jika Anda sering memperbarui lingkungan Anda, Anda mungkin ingin mencatat pembaruan ini di sisi Anda, untuk memetakan status lingkungan dengan sesi.

Kelola lingkungan

# List environments
ant beta:environments list

# Retrieve a specific environment
ant beta:environments retrieve --environment-id "$ENVIRONMENT_ID"

# Archive an environment (read-only, existing sessions continue)
ant beta:environments archive --environment-id "$ENVIRONMENT_ID"

# Delete an environment (only if no sessions reference it)
ant beta:environments delete --environment-id "$ENVIRONMENT_ID"

Runtime pra-instal

Kontainer cloud menyertakan runtime umum di luar kotak. Lihat Referensi Kontainer untuk daftar lengkap bahasa, database, dan utilitas yang pra-diinstal.