Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
AgentCore Referensi CLI
Referensi ini mendokumentasikan rilis publik Amazon Bedrock AgentCore CLI.
Topik
Siklus Hidup Proyek
Auto-generated dari @aws/agentcore v0.28.1 - jangan mengedit dengan tangan.
agentcore membuat
agentcore create [options]
Buat AgentCore proyek baru
Parameter
-
--name <name>(opsional) -
Nama sumber daya [non-interaktif]
-
--project-name <name>(opsional) -
Nama proyek (dimulai dengan huruf, hanya alfanumerik, maks 23 karakter) [non-interaktif]
-
--no-agent(opsional) -
Lewati pembuatan agen [non-interaktif]
-
--defaults(opsional) -
Buat proyek harness dengan pengaturan default (ini adalah default) [non-interaktif]
-
--build <type>(opsional) -
Jenis build: CodeZip atau Wadah (default: CodeZip) [non-interaktif]
-
--language <language>(opsional) -
Bahasa target: Python atau TypeScript (default: Python) [non-interaktif]
-
--framework <framework>(opsional) -
Kerangka kerja agen (Strands, LangChain _, GoogleADKLangGraph, openAIAgents, VerceLai) [non-interaktif]
-
--model-provider <provider>(opsional) -
Penyedia model (Bedrock, Anthropic, OpenAI, Gemini) [non-interaktif]
-
--api-key <key>(opsional) -
Kunci API untuk penyedia non-Bedrock [non-interaktif]
-
--memory <option>(opsional) -
Opsi memori (tidak ada, jangka pendek, panjangAndShortTerm) [non-interaktif]
-
--protocol <protocol>(opsional) -
Protokol: HTTP, MCP, A2A, AGUI (default: HTTP) [non-interaktif]
-
--type <type>(opsional) -
Jenis agen: buat atau impor (default: buat) [non-interaktif]
-
--agent-id <id>(opsional) -
ID Agen Bedrock (diperlukan untuk --type import) [non-interaktif]
-
--agent-alias-id <id>(opsional) -
ID Alias Agen Bedrock (diperlukan untuk --type import) [non-interaktif]
-
--region <region>(opsional) -
Wil AWS ayah untuk Agen Bedrock (diperlukan untuk --type import) [non-interaktif]
-
--network-mode <mode>(opsional) -
Mode jaringan (PUBLIK, VPC) [non-interaktif]
-
--subnets <ids>(opsional) -
Comma-separated ID subnet (diperlukan untuk mode VPC) [non-interaktif]
-
--security-groups <ids>(opsional) -
Comma-separated ID grup keamanan (diperlukan untuk mode VPC) [non-interaktif]
-
--vpc-id <id>(opsional) -
ID VPC (diperlukan untuk build Container dengan mode VPC) [non-interaktif]
-
--idle-timeout <seconds>(opsional) -
Waktu tunggu sesi idle dalam detik (60-28800) [non-interaktif]
-
--max-lifetime <seconds>(opsional) -
Masa pakai instance maksimal dalam detik (60-28800) [non-interaktif]
-
--session-storage-mount-path <path>(opsional) -
Jalur pemasangan absolut untuk penyimpanan sistem file sesi di bawah /mnt (misalnya,/mnt/data) [non-interaktif]
-
--efs-access-point-arn <arn>(opsional) -
Titik akses EFS ARN (dapat diulang, dipasangkan dengan --efs-mount-path) [non-interaktif] (default: [])
-
--efs-mount-path <path>(opsional) -
Jalur pemasangan EFS (misalnya,/mnt/tools, dipasangkan dengan --efs-access-point-arn) [non-interaktif] (default: [])
-
--s3-access-point-arn <arn>(opsional) -
S3 Files titik akses ARN (dapat diulang, dipasangkan dengan --s3-mount-path) [non-interaktif] (default: [])
-
--s3-mount-path <path>(opsional) -
Jalur pemasangan File S3 (misalnya,/mnt/datasets, dipasangkan dengan --s3-access-point-arn) [non-interaktif] (default: [])
-
--with-config-bundle(opsional) -
Buat bundel konfigurasi yang terhubung ke template agen [non-interaktif]
-
--output-dir <dir>(opsional) -
Direktori keluaran (default: direktori saat ini) [non-interaktif]
-
--skip-git(opsional) -
Lewati inisialisasi repositori git [non-interaktif]
-
--skip-python-setup(opsional) -
Lewati pengaturan lingkungan virtual Python [non-interaktif]
-
--skip-install(opsional) -
Lewati semua instalasi ketergantungan (npm install, uv sync) [non-interaktif]
-
--dry-run(opsional) -
Pratinjau apa yang akan dibuat tanpa membuat perubahan [non-interaktif]
-
--json(opsional) -
Keluaran sebagai JSON [non-interaktif]
-
--model-id <id>(opsional) -
ID Model untuk harness [non-interaktif]
-
--api-key-arn <arn>(opsional) -
Kunci API ARN untuk penyedia harness non-Bedrock [non-interaktif]
-
--api-base <url>(opsional) -
URL dasar untuk titik akhir API penyedia model harness (lite_llm) [non-interaktif]
-
--additional-params <json>(opsional) -
Provider-specific memanfaatkan params sebagai objek JSON (lite_llm) [non-interaktif]
-
--no-harness-memory(opsional) -
Nonaktifkan memori untuk harness (ini adalah default) [non-interaktif]
-
--max-iterations <n>(opsional) -
Iterasi loop agen maksimum (harness) [non-interaktif]
-
--max-tokens <n>(opsional) -
Token maksimum per iterasi (harness) [non-interaktif]
-
--timeout <seconds>(opsional) -
Durasi eksekusi maksimum dalam detik (harness) [non-interaktif]
-
--truncation-strategy <strategy>(opsional) -
Strategi pemotongan: sliding_window atau ringkasan (harness) [non-interaktif]
-
--container <uri-or-path>(opsional) -
URI gambar kontainer atau jalur Dockerfile (harness) [non-interaktif]
menyebarkan agentcore
agentcore deploy|dp [options]
Menyebarkan infrastruktur proyek ke AWS melalui CDK.
Parameter
-
--target <target>(opsional) -
Nama target penerapan (default: “default”) [non-interaktif]
-
-y, --yes(opsional) -
Auto-confirm meminta, baca kredenSIAL dari env [non-interaktif]
-
-v, --verbose(opsional) -
Tampilkan peristiwa penerapan tingkat sumber daya [non-interaktif]
-
--json(opsional) -
Keluaran sebagai JSON [non-interaktif]
-
--dry-run(opsional) -
Pratinjau penerapan tanpa menerapkan [non-interaktif]
-
--diff(opsional) -
Tampilkan CDK diff tanpa menerapkan [non-interaktif]
agentcore pengembang
agentcore dev|d [options] [prompt]
Luncurkan server dev lokal, atau panggil agen secara lokal.
Parameter
-
prompt -
Kirim prompt ke server dev yang sedang berjalan [non-interaktif]
-
-p, --port <port>(opsional) -
Port untuk server pengembangan. Digunakan apa adanya saat disetel secara eksplisit; defaultnya diimbangi oleh indeks runtime dalam proyek multi-runtime. (default: “8080")
-
-r, --runtime <name>(opsional) -
Runtime untuk dijalankan atau dipanggil (diperlukan jika beberapa runtime)
-
-s, --stream(opsional) -
Respons aliran saat memanggil [non-interaktif]
-
-l, --logs(opsional) -
Jalankan server dev dengan log ke stdout [non-interaktif]
-
--exec(opsional) -
Jalankan perintah shell dalam wadah dev yang sedang berjalan (hanya agen kontainer) [non-interaktif]
-
--tool <name>(opsional) -
Nama alat MCP (digunakan dengan prompt “call-tool”) [non-interaktif]
-
--input <json>(opsional) -
Argumen alat MCP sebagai JSON (digunakan dengan --tool) [non-interaktif]
-
--skip-deploy(opsional) -
Lewati penyebaran sumber daya otomatis sebelum memulai server dev
-
-H, --header <header>(opsional) -
Header khusus untuk diteruskan ke agen (format: “Nama: Nilai”, dapat diulang) [non-interaktif] (default: [])
-
-b, --no-browser(opsional) -
Gunakan terminal TUI alih-alih UI obrolan berbasis web
-
--no-traces(opsional) -
Nonaktifkan koleksi jejak OTEL lokal
agentcore paket
agentcore package|pkg [options]
Paket artefak agen tanpa penerapan.
Parameter
-
-d, --directory <path>(opsional) -
Direktori proyek yang berisi konfigurasi agentcore
-
-r, --runtime <name>(opsional) -
Paket hanya runtime yang ditentukan
agentcore ekspor
agentcore export [options] [command]
Ekspor harness ke agen runtime Strands.
pembaruan agentcore
agentcore update [options] [command]
Periksa dan instal pembaruan CLI
Parameter
-
-c, --check(opsional) -
Periksa pembaruan tanpa menginstal
validasi agentcore
agentcore validate [options]
Validasi file agentcore/config.
Parameter
-
-d, --directory <path>(opsional) -
Direktori proyek yang berisi konfigurasi agentcore
-
--json(opsional) -
Keluaran sebagai JSON [non-interaktif]
Runtime Pemanggilan &
Auto-generated dari @aws/agentcore v0.28.1 - jangan mengedit dengan tangan.
panggil agentcore
agentcore invoke|i [options] [prompt]
Memanggil titik akhir agen yang digunakan.
Parameter
-
prompt -
Permintaan untuk mengirim ke agen. Juga menerima stdin pipa ketika tidak ada prompt yang disediakan dan stdin bukan TTY [non-interaktif]
-
--prompt <text>(opsional) -
Permintaan untuk mengirim ke agen [non-interaktif]
-
--prompt-file <path>(opsional) -
Membaca prompt dari file (untuk muatan panjang atau terstruktur yang melebihi batas arg shell) [non-interaktif]
-
--runtime <name>(opsional) -
Pilih runtime tertentu [non-interaktif]
-
--gateway <name>(opsional) -
Memanggil melalui gateway [non-interaktif]
-
--gateway-target-name <name>(opsional) -
Target runtime HTTP di gateway [non-interaktif]
-
--target <name>(opsional) -
Pilih target penerapan [non-interaktif]
-
--session-id <id>(opsional) -
Gunakan ID sesi tertentu untuk kontinuitas percakapan
-
--user-id <id>(opsional) -
ID Pengguna untuk pemanggilan runtime (default: “default-user”)
-
--api-base <url>(opsional) -
Penggantian URL dasar API LiteLTM untuk pemanggilan harness. Hanya tersedia
lite_llmdalam mode non-interaktif. -
--additional-params <json>(opsional) -
Parameter LiteLTM tambahan, sebagai objek JSON, untuk pemanggilan harness. Hanya tersedia
lite_llmdalam mode non-interaktif. -
--payment-user-id <id>(opsional) -
End-user/wallet-owner identitas (default ke --user-id)
-
--payment-instrument-id <id>(opsional) -
ID alat pembayaran (dompet)
-
--payment-session-id <id>(opsional) -
ID sesi pembayaran untuk pelacakan anggaran
-
--auto-session(opsional) -
Auto-create/reuse sesi pembayaran untuk pengujian
-
--json(opsional) -
Output sebagai JSON
-
--stream(opsional) -
Streaming respons secara real-time
-
--tool <name>(opsional) -
Nama alat MCP (gunakan dengan prompt “call-tool”)
-
--input <json>(opsional) -
Argumen alat MCP sebagai JSON (gunakan dengan --tool)
-
--exec(opsional) -
Jalankan perintah shell dalam wadah runtime
-
--timeout <seconds>(opsional) -
Batas waktu dalam detik untuk perintah --exec
-
-H, --header <header>(opsional) -
Header kustom “Nama: Nilai” (dapat diulang)
-
--bearer-token <token>(opsional) -
Token pembawa untuk autentikasi CUSTOM_JWT (melewati SIGv4)
-
--harness <name>(opsional) -
Pilih harness tertentu untuk dipanggil
-
--harness-arn <arn>(opsional) -
Memanggil harness oleh ARN (tidak diperlukan proyek)
-
--region <region>(opsional) -
Wil AWS ayah (diperlukan dengan --harness-arn)
-
--verbose(opsional) -
Cetak acara JSON streaming yang bertele-tele
-
--model-id <id>(opsional) -
Mengganti model
-
--model-provider <provider>(opsional) -
Penyedia model. Nilai yang valid:
bedrock,open_ai, ataugemini. -
--api-key-arn <arn>(opsional) -
Kunci API ARN untuk open_ai/gemini
-
--tools <tools>(opsional) -
Alat ganti (dipisahkan koma)
-
--allowed-tools <tools>(opsional) -
Mengganti alat yang diizinkan (dipisahkan koma)
-
--skills <paths>(opsional) -
Keterampilan (jalur yang dipisahkan koma)
-
--system-prompt <text>(opsional) -
Mengganti prompt sistem
-
--actor-id <id>(opsional) -
Mengganti ID aktor memori
-
--max-iterations <n>(opsional) -
Mengganti iterasi maksimal
-
--max-tokens <n>(opsional) -
Mengganti token maksimum
-
--harness-timeout <seconds>(opsional) -
Mengganti detik batas waktu
agentcore manager
agentcore exec [options] [command...]
Buka shell interaktif atau jalankan perintah one-shot dalam wadah agen yang digunakan.
Parameter
-
command -
Perintah untuk mengeksekusi (mode one-shot, non-interaktif)
-
--it(opsional) -
Buka sesi shell PTY interaktif
-
--runtime <name|arn>(opsional) -
Nama agen target atau ARN runtime (melewatkan pemilih agen)
-
--harness <name|arn>(opsional) -
Nama harness target atau harness ARN (melewatkan pemilih agen)
-
--session-id <id>(opsional) -
Sematkan ke sesi runtime tertentu/VM
-
--shell-id <id>(opsional) -
Sambungkan kembali ke shell yang ada
-
--region <region>(opsional) -
Wil AWS ayah
-
--bearer-token <token>(opsional) -
Token pembawa untuk otentikasi CUSTOM_JWT (melewatkan SIGv4)
-
--target <name>(opsional) -
Nama target penerapan (dari agentcore.json)
-
--timeout <seconds>(opsional) -
Batas waktu dalam hitungan detik untuk perintah one-shot
-
--json(opsional) -
Hasil keluaran sebagai JSON (hanya mode one-shot, tidak kompatibel dengan --it)
agentcore menjalankan
agentcore run [options] [command]
Jalankan evaluasi, evaluasi batch, atau rekomendasi pengoptimalan.
log agentcore
agentcore logs|l [options] [command]
Streaming atau cari log runtime agen.
Parameter
-
--runtime <name>(opsional) -
Pilih runtime tertentu
-
--since <time>(opsional) -
Waktu mulai - default ke 1 jam yang lalu dalam mode pencarian (misalnya, “1h”, “30m”, “2d”, ISO 8601)
-
--until <time>(opsional) -
Waktu akhir - default sekarang dalam mode pencarian (misalnya, “sekarang”, ISO 8601)
-
--level <level>(opsional) -
Filter berdasarkan tingkat log (kesalahan, peringatan, info, debug)
-
-n, --limit <count>(opsional) -
Jumlah maksimum baris log yang akan dikembalikan
-
--query <text>(opsional) -
Server-side filter teks
-
--json(opsional) -
Keluaran sebagai Garis JSON
jejak agentcore
agentcore traces|t [options] [command]
Lihat dan unduh jejak agen.
status agentcore
agentcore status|s [options]
Tampilkan detail dan status sumber daya yang digunakan.
Parameter
-
--runtime-id <id>(opsional) -
Cari runtime tertentu berdasarkan ID
-
--target <name>(opsional) -
Pilih target penerapan
-
--type <type>(opsional) -
Filter berdasarkan jenis sumber daya (agen, titik akhir runtime-, memori, kredensia, gateway, evaluator, online-eval, pembayaran, mesin kebijakan, kebijakan, bundel konfigurasi, dataset, basis pengetahuan, harness)
-
--state <state>(opsional) -
Filter berdasarkan status penerapan (dikerahkan, khusus lokal, penghapusan gantung)
-
--runtime <name>(opsional) -
Filter ke runtime tertentu
-
--name <name>(opsional) -
Tampilkan detail untuk sumber daya tunggal berdasarkan nama (basis pengetahuan)
-
--json(opsional) -
Output sebagai JSON
agentcore fetch
agentcore fetch [options] [command]
Ambil info akses untuk sumber daya yang digunakan.
tampilan agentcore
agentcore view [options] [command]
Lihat riwayat pekerjaan dan detail
Manajemen Sumber Daya
Auto-generated dari @aws/agentcore v0.28.1 - jangan mengedit dengan tangan.
agentcore menambahkan
agentcore add [options] [command] [subcommand]
Tambahkan sumber daya ke konfigurasi proyek.
agentcore menghapus
agentcore remove [options] [command] [subcommand]
Hapus sumber daya dari konfigurasi proyek.
impor agentcore
agentcore import [options] [command]
Impor runtime, memori, atau alat pemula ke dalam proyek ini.
Parameter
-
--source <path>(opsional) -
Jalur ke file konfigurasi.bedrock_agentcore.yaml
-
--target <target>(opsional) -
Nama target penerapan (hanya diperlukan jika proyek memiliki beberapa target)
-
-y, --yes(opsional) -
Auto-confirm petunjuk
Kum & pulan Data Evaluasi
Auto-generated dari @aws/agentcore v0.28.1 - jangan mengedit dengan tangan.
agentcore evaluations
agentcore evals [options] [command]
Lihat hasil eval dan batch eval yang disimpan dari proses sebelumnya.
evaluasi batch agentcore
agentcore batch-evaluations [options] [command] <id>
Lihat pekerjaan evaluasi batch dan hasilnya.
Parameter
-
id -
ID pekerjaan evaluasi batch untuk dilihat
-
--json(opsional) -
Output sebagai JSON
kumpulan data agentcore
agentcore dataset [options] [command]
Mengelola konten dan versi dataset
Paket & Konfigurasi Optimasi
Auto-generated dari @aws/agentcore v0.28.1 - jangan mengedit dengan tangan.
bundel konfigurasi agentcore
agentcore config-bundle|cb [options] [command]
Kelola bundel konfigurasi (gunakan nama bundel dari agentcore.json, bukan ID)
agentcore mempromosikan
agentcore promote [options] [command]
Promosikan sumber daya
arsip agentcore
agentcore archive [options] [command]
Arsipkan (hapus) evaluasi batch atau rekomendasi pada layanan dan hapus riwayat lokal.
Peng & aturan Operasi
Auto-generated dari @aws/agentcore v0.28.1 - jangan mengedit dengan tangan.
jeda agentcore
agentcore pause [options] [command]
Jeda sumber daya yang digunakan (konfigurasi eval online, A/B test).
agentcore resume
agentcore resume [options] [command]
Lanjutkan sumber daya yang dijeda (konfigurasi eval online, A/B test).
agentcore berhenti
agentcore stop [options] [command]
Hentikan evaluasi atau A/B pengujian batch yang sedang berjalan.
konfigurasi agentcore
agentcore config [options] [key] [value]
Sesuaikan pengaturan konfigurasi global seperti status opt-out telemetri
Parameter
-
key -
Kunci konfigurasi dalam notasi titik (misalnya, telemetry.enabled)
-
value -
Nilai yang harus ditetapkan
telemetri agentcore
agentcore telemetry [options] [command]
Kelola preferensi analisis penggunaan anonim.
umpan balik agentcore
agentcore feedback [options] [message]
Kirim umpan balik tentang AgentCore CLI ke tim.
Parameter
-
message -
Pesan umpan balik [non-interaktif]
-
--screenshot <path>(opsional) -
Jalur ke tangkapan layar PNG atau JPG (maks 100MB) [non-interaktif]
-
--json(opsional) -
Hasil keluaran sebagai JSON [non-interaktif]
