View a markdown version of this page

Eksekusi Shell - Batuan Dasar Amazon AgentCore

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, stdout/stderr mengalir 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.

Cangkang interaktif (terminal) - InvokeAgentRuntimeCommandShell

Membuka sesi terminal persisten WebSocket dengan status shell penuh (variabel lingkungan, direktori kerja, riwayat). Mendukung rekoneksi melaluishellId. Terbaik untuk debugging, inspeksi lingkungan, dan UI terminal.

Perbandingan fitur

Fitur One-shot (InvokeAgentRuntimeCommand) Interaktif (InvokeAgentRuntimeCommandShell)

Protokol

HTTP/2 (aliran permintaan-tanggapan)

WebSocket (koneksi persisten)

Status Shell

Stateless - setiap perintah memulai proses baru

Persistent — lingkungan, direktori kerja, dan riwayat membawa seluruh perintah

Format output

Acara terstruktur (contentStart,contentDelta, contentStop dengan kode keluar)

Bingkai biner (terminal mentah I/O - mendukung warna, kontrol kursor, aplikasi layar penuh)

Rekoneksi

Tidak - setiap panggilan bersifat independen

Ya, melalui shellId

Durasi

Batas waktu yang dapat dikonfigurasi (1—3.600 detik)

Maks 1 jam (sambungkan kembali dengan yang sama shellId untuk melanjutkan)

Memilih mode yang tepat

Gunakan eksekusi satu tembakan saat... Gunakan cangkang interaktif saat...

Operasi ini memiliki perintah yang diketahui (npm test,git push)

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 pipa atau gerbang validasi

Anda sedang membangun UI terminal (Kode Claude, Amazon Kiro, OpenAI Codex)

Setiap perintah independen tanpa status bersama

Anda memerlukan dukungan koneksi ulang untuk pekerjaan yang berjalan lama

Anda mem-bootstrap lingkungan sebelum agen memulai

Anda sedang men-debug atau memeriksa agen yang sedang berjalan
Topik