Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Eksekusi Shell
Amazon Bedrock AgentCore Runtime memungkinkan Anda menjalankan perintah shell di dalam sesi agen yang sedang berjalan. Dua mode tersedia tergantung pada kasus penggunaan Anda:
- One-shot eksekusi perintah -
InvokeAgentRuntimeCommand -
Menjalankan satu perintah, mengal stdout/stderr irkan HTTP/2, dan mengembalikan kode keluar. Setiap perintah memulai proses shell baru tanpa status persisten. Terbaik untuk jaringan pipa otomatis, CI/CD gerbang, dan operasi deterministik.
- Kerang interaktif (terminal) -
InvokeAgentRuntimeCommandShell -
Membuka sesi terminal persisten WebSocket dengan status shell penuh (variabel lingkungan, direktori kerja, riwayat). Mendukung koneksi ulang melalui
shellId. Terbaik untuk debugging, inspeksi lingkungan, dan UI terminal.
Perbandingan fitur
| Fitur | One-shot (InvokeAgentRuntimeCommand) |
Interaktif (InvokeAgentRuntimeCommandShell) |
|---|---|---|
|
Protokol |
HTTP/2 (aliran permintaan-respons) |
WebSocket (koneksi persisten) |
|
Negara Shell |
Stateless — setiap perintah memulai proses baru |
Persisten - lingkungan, direktori kerja, dan riwayat membawa perintah lintas |
|
Format output |
Peristiwa terstruktur ( |
Bingkai biner (terminal mentah I/O - mendukung warna, kontrol kursor, aplikasi layar penuh) |
|
Koneksi ulang |
Tidak - setiap panggilan independen |
Ya, melalui |
|
Durasi |
Batas waktu yang dapat dikonfigurasi (1—3.600 detik) |
Maks 1 jam (sambungkan kembali dengan yang sama |
Memilih mode yang tepat
| Gunakan eksekusi one-shot saat... | Gunakan cangkang interaktif saat... |
|---|---|
|
Operasi memiliki perintah yang diketahui ( |
Anda memerlukan status shell persisten di beberapa perintah |
|
Anda ingin eksekusi deterministik dengan kode keluar terstruktur |
Anda ingin menjelajahi lingkungan secara interaktif |
|
Anda mengotomatiskan langkah CI/CD pipeline atau gerbang validasi |
Anda sedang membangun UI terminal (Claude Code, Amazon Kiro, OpenAI Codex) |
|
Setiap perintah independen tanpa status bersama |
Anda memerlukan dukungan koneksi ulang untuk pekerjaan yang berjalan lama |
|
Anda melakukan bootstrap lingkungan sebelum agen memulai |
Anda sedang men-debug atau memeriksa agen yang sedang berjalan |
