Loading...
    • Bangun
    • Admin
    • Model & harga
    • Client SDK
    • Referensi API
    Search...
    ⌘K
    Langkah pertama
    Pengenalan ClaudeMulai Cepat
    Membangun dengan Claude
    Ikhtisar fiturMenggunakan Messages APIMenangani alasan berhenti
    Kemampuan model
    Pemikiran mendalamPemikiran adaptifUpayaMode cepat (beta: pratinjau riset)Output terstrukturKutipanStreaming PesanPemrosesan batchHasil pencarianPenolakan streamingDukungan multibahasaEmbeddings
    Alat
    IkhtisarCara kerja penggunaan alatAlat pencarian webAlat pengambilan webAlat eksekusi kodeAlat memoriAlat BashAlat penggunaan komputerAlat editor teks
    Infrastruktur alat
    Pencarian alatPemanggilan alat terprogramStreaming alat terperinci
    Manajemen konteks
    Jendela konteksPemadatanPengeditan konteksCaching promptPenghitungan token
    Bekerja dengan file
    Files APIDukungan PDFGambar dan visi
    Skills
    IkhtisarMulai CepatPraktik terbaikSkills untuk enterpriseSkills di API
    MCP
    Server MCP jarak jauhKonektor MCP
    Rekayasa prompt
    IkhtisarPraktik terbaik promptingAlat prompting Console
    Uji dan evaluasi
    Tentukan keberhasilan dan bangun evaluasiMenggunakan Alat Evaluasi di ConsoleMengurangi latensi
    Perkuat penjaga
    Kurangi halusinasiTingkatkan konsistensi outputMitigasi jailbreakKurangi kebocoran prompt
    Sumber daya
    Glosarium
    Catatan rilis
    Claude Platform
    Console
    Log in
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...

    Solutions

    • AI agents
    • Code modernization
    • Coding
    • Customer support
    • Education
    • Financial services
    • Government
    • Life sciences

    Partners

    • Amazon Bedrock
    • Google Cloud's Vertex AI

    Learn

    • Blog
    • Catalog
    • Courses
    • Use cases
    • Connectors
    • Customer stories
    • Engineering at Anthropic
    • Events
    • Powered by Claude
    • Service partners
    • Startups program

    Company

    • Anthropic
    • Careers
    • Economic Futures
    • Research
    • News
    • Responsible Scaling Policy
    • Security and compliance
    • Transparency

    Learn

    • Blog
    • Catalog
    • Courses
    • Use cases
    • Connectors
    • Customer stories
    • Engineering at Anthropic
    • Events
    • Powered by Claude
    • Service partners
    • Startups program

    Help and security

    • Availability
    • Status
    • Support
    • Discord

    Terms and policies

    • Privacy policy
    • Responsible disclosure policy
    • Terms of service: Commercial
    • Terms of service: Consumer
    • Usage policy
    Konfigurasi lingkungan agen

    Penyiapan lingkungan cloud

    Sesuaikan kontainer cloud untuk sesi Anda.

    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.

    Buat lingkungan

    Was this page helpful?

    • Buat lingkungan
    • Gunakan lingkungan dalam sesi
    • Opsi konfigurasi
    • Paket
    • Jaringan
    • Siklus hidup lingkungan
    • Kelola lingkungan
    • Runtime pra-instal
    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.

    Gunakan lingkungan dalam sesi

    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
    )

    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.

    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:

    BidangManajer paketContoh
    aptPaket sistem (apt-get)"ffmpeg"
    cargoRust (cargo)"[email protected]"
    gemRuby (gem)"rails:7.1.0"
    goModul Go"golang.org/x/tools/cmd/goimports@latest"
    npmNode.js (npm)"[email protected]"
    pipPython (pip)"pandas==2.2.0"

    Jaringan

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

    ModeDeskripsi
    unrestrictedAkses jaringan keluar penuh, kecuali untuk daftar pemblokiran keamanan umum. Ini adalah default.
    limitedMembatasi 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.

    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
    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"

    Runtime pra-instal

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