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.
Semua permintaan Managed Agents API memerlukan header beta managed-agents-2026-04-01. SDK menetapkan header beta secara otomatis.
Was this page helpful?
environment=$(curl -fsS https://api.anthropic.com/v1/environments \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "anthropic-beta: managed-agents-2026-04-01" \
-H "content-type: application/json" \
--data @- <<'EOF'
{
"name": "python-dev",
"config": {
"type": "cloud",
"networking": {"type": "unrestricted"}
}
}
EOF
)
environment_id=$(jq -r '.id' <<< "$environment")
echo "Environment ID: $environment_id"name harus unik dalam organisasi dan ruang kerja Anda.
Teruskan ID lingkungan sebagai string saat membuat sesi.
session=$(curl -fsS https://api.anthropic.com/v1/sessions \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "anthropic-beta: managed-agents-2026-04-01" \
-H "content-type: application/json" \
--data @- <<EOF
{
"agent": "$agent_id",
"environment_id": "$environment_id"
}
EOF
)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.
environment=$(curl -fsS https://api.anthropic.com/v1/environments \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "anthropic-beta: managed-agents-2026-04-01" \
-H "content-type: application/json" \
--data @- <<'EOF'
{
"name": "data-analysis",
"config": {
"type": "cloud",
"packages": {
"pip": ["pandas", "numpy", "scikit-learn"],
"npm": ["express"]
},
"networking": {"type": "unrestricted"}
}
}
EOF
)Manajer paket yang didukung:
| Bidang | Manajer paket | Contoh |
|---|---|---|
apt | Paket sistem (apt-get) | "ffmpeg" |
cargo | Rust (cargo) | "[email protected]" |
gem | Ruby (gem) | "rails:7.1.0" |
go | Modul Go | "golang.org/x/tools/cmd/goimports@latest" |
npm | Node.js (npm) | "[email protected]" |
pip | Python (pip) | "pandas==2.2.0" |
Bidang networking mengontrol akses jaringan keluar kontainer. Ini tidak memengaruhi domain yang diizinkan oleh alat web_search atau web_fetch.
| Mode | Deskripsi |
|---|---|
unrestricted | Akses jaringan keluar penuh, kecuali untuk daftar pemblokiran keamanan umum. Ini adalah default. |
limited | Membatasi akses jaringan kontainer ke daftar allowed_hosts. Akses lebih lanjut diaktifkan melalui bool allow_package_managers dan allow_mcp_servers. |
config=$(cat <<'EOF'
{
"type": "cloud",
"networking": {
"type": "limited",
"allowed_hosts": ["api.example.com"],
"allow_mcp_servers": true,
"allow_package_managers": true
}
}
EOF
)Untuk penerapan produksi, gunakan jaringan limited dengan daftar allowed_hosts eksplisit. Ikuti prinsip hak istimewa minimal dengan memberikan hanya akses jaringan minimum yang diperlukan agen Anda, dan audit domain yang diizinkan secara teratur.
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.# List environments
environments=$(curl -fsS https://api.anthropic.com/v1/environments \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "anthropic-beta: managed-agents-2026-04-01")
# Retrieve a specific environment
env=$(curl -fsS "https://api.anthropic.com/v1/environments/$environment_id" \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "anthropic-beta: managed-agents-2026-04-01")
# Archive an environment (read-only, existing sessions continue)
curl -fsS -X POST "https://api.anthropic.com/v1/environments/$environment_id/archive" \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "anthropic-beta: managed-agents-2026-04-01"
# Delete an environment (only if no sessions reference it)
curl -fsS -X DELETE "https://api.anthropic.com/v1/environments/$environment_id" \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "anthropic-beta: managed-agents-2026-04-01"Kontainer cloud menyertakan runtime umum di luar kotak. Lihat Referensi Kontainer untuk daftar lengkap bahasa, database, dan utilitas yang pra-diinstal.