View a markdown version of this page

Memulai penerapan kode langsung Amazon Bedrock AgentCore Runtime - Batuan Dasar Amazon AgentCore

Memulai penerapan kode langsung Amazon Bedrock AgentCore Runtime

Penerapan kode langsung memungkinkan Anda membawa agen Anda ke Amazon Bedrock AgentCore Runtime hanya dengan mengemas kode agen dan dependensinya dalam arsip file.zip. Agen Anda masih harus mengikuti persyaratan AgentCore Runtime.

Untuk membuat paket penyebaran Anda sebagai arsip file.zip, Anda dapat menggunakan AgentCore CLI atau mengikuti langkah-langkah dalam panduan khusus bahasa di bawah ini, atau utilitas file.zip lainnya seperti 7zip. Contoh yang ditampilkan di bagian berikut mengasumsikan Anda menggunakan zip alat baris perintah di lingkungan Linux atau macOS. Untuk menggunakan perintah yang sama di Windows, Anda dapat menginstal Subsistem Windows untuk Linux untuk mendapatkan Windows-integrated versi Ubuntu dan Bash.

Perhatikan bahwa AgentCore Runtime menggunakan izin file POSIX, jadi Anda mungkin perlu mengatur izin untuk folder paket penyebaran sebelum membuat arsip file.zip.

Konsep penyebaran kode langsung

Pelajari tentang konsep utama saat menggunakan penerapan kode langsung dengan Amazon Bedrock AgentCore Runtime.

Topik

    Amazon Bedrock AgentCore Runtime dengan penerapan kode langsung menggunakan model tanggung jawab bersama yang mirip dengan Lambda. AWS AgentCore Runtime mengelola lingkungan runtime bahasa dan menerapkan patch keamanan secara otomatis, sementara Anda fokus pada kode agen dan dependensi Anda.

    Jika Anda menggunakan gambar kontainer untuk menyebarkan agen Anda, maka AgentCore Runtime bertanggung jawab untuk hanya menambal kernel komputasi. Dalam hal ini, Anda bertanggung jawab untuk membangun kembali image kontainer agen Anda dari gambar aman terbaru dan menerapkan kembali gambar kontainer.

    Ini dirangkum dalam tabel berikut:

    Mode deployment AgentCore Tanggung jawab runtime Tanggung jawab Anda

    Mode penyebaran langsung

    Publikasikan versi runtime bahasa baru yang berisi tambalan terbaru untuk runtime bahasa. Terapkan patch runtime bahasa ke penerapan langsung AgentCore Runtime yang ada.

    Perbarui kode agen Anda, termasuk dependensi, untuk mengatasi kerentanan keamanan apa pun.

    Gambar kontainer

    Secara otomatis menambal kernel OS komputasi yang mendasarinya dengan versi terbaru.

    Perbarui kode agen Anda, termasuk dependensi, untuk mengatasi kerentanan keamanan apa pun. Buat ulang dan terapkan ulang image container Anda secara teratur menggunakan image dasar terbaru.

    Untuk informasi selengkapnya tentang tanggung jawab bersama AWS, lihat Model Tanggung Jawab Bersama.

    AgentCore Runtime membuat setiap runtime penerapan kode langsung selalu diperbarui dengan pembaruan keamanan, perbaikan bug, fitur baru, peningkatan kinerja, dan dukungan untuk rilis versi minor. Pembaruan runtime ini diterbitkan sebagai versi runtime. AgentCore Runtime menerapkan pembaruan runtime penerapan kode langsung ke agen dengan memigrasikan agen dari versi runtime sebelumnya ke versi runtime baru.

    Untuk runtime penerapan langsung, Runtime menerapkan AgentCore pembaruan runtime secara otomatis. Dengan pembaruan runtime otomatis, AgentCore Runtime menanggung beban operasional untuk menambal versi runtime. Bagi sebagian besar pelanggan, ini harus menjadi pilihan yang aman karena hanya tambalan runtime bahasa yang akan diterapkan secara otomatis dan pelanggan bertanggung jawab untuk membawa dan mengelola dependensi kode mereka. Saat ini AgentCore Runtime tidak mendukung perubahan perilaku penambalan otomatis ini.

    AgentCore Runtime berusaha untuk menyediakan pembaruan runtime yang kompatibel dengan fungsi yang ada. Namun, seperti halnya patching perangkat lunak, ada kasus yang jarang terjadi di mana pembaruan runtime dapat berdampak negatif pada fungsi yang ada. Misalnya, patch keamanan dapat mengekspos masalah mendasar dengan fungsi yang ada yang bergantung pada perilaku tidak aman sebelumnya. Jika dalam kasus yang sangat jarang risiko ini tidak dapat diterima, silakan gunakan gambar kontainer untuk menyebarkan agen Anda.

    Beberapa dimensi perbandingan untuk melihat bagaimana satu opsi berbeda dari yang lain, sehingga membantu untuk memilih opsi yang tepat

    • Proses Deployment: Penyebaran kode langsung menyebarkan agen menggunakan file ZIP alih-alih kontainer, meminjamkan dirinya ke iterasi pengembangan yang lebih cepat.

    • Waktu penyebaran: Meskipun tidak ada banyak perbedaan selama penyebaran pertama agen, pembaruan berikutnya ke agen secara signifikan lebih cepat dengan penyebaran kode langsung.

    • Kustomisasi: Kode langsung mendukung dependensi khusus melalui ZIP-based pengemasan sambil mempertahankan kesederhanaan penerapan sementara berbasis container bergantung pada file Docker.

    • Ukuran paket: Penyebaran kode langsung membatasi ukuran paket hingga 250MB sedangkan paket berbasis kontainer dapat berukuran hingga 2GB.

    • Tingkat pembuatan sesi: Penerapan kode langsung memungkinkan pembuatan sesi yang lebih tinggi dari 25 sesi baru sessions/second dibandingkan dengan 1.6 baru sessions/second dengan penerapan berbasis kontainer.

    Bimbingan umum kami adalah

    • Jika ukuran paket penerapan melebihi 250MB, dan Anda memiliki CI/CD pipeline kontainer yang ada, dan Anda memerlukan dependensi dan pengemasan yang sangat terspesialisasi, maka penerapan berbasis kontainer adalah pilihan yang baik untuk dipilih.

    • Jika ukuran paket penerapan kecil, kode dan paket tidak rumit untuk dibangun dan menggunakan kerangka kerja dan bahasa umum, dan Anda memerlukan pembuatan prototipe dan iterasi yang cepat, maka penerapan kode langsung akan menjadi pilihannya.

    Ada juga opsi hibrida di mana pengembang menggunakan penyebaran kode langsung untuk bereksperimen dengan cepat dan agen prototipe dan kemudian beralih ke penerapan berbasis kontainer (untuk alasan di atas) untuk mengembangkan, menguji, dan menyebarkan ke produksi.