Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# AgentCore Referensi CLI
<a name="agentcore-cli-reference"></a>

Referensi ini mendokumentasikan rilis publik Amazon Bedrock AgentCore CLI.

**Topics**
+ [Siklus Hidup Proyek](#cli-project-lifecycle)
+ [Runtime Pemanggilan &amp;](#cli-invocation)
+ [Manajemen Sumber Daya](#cli-resources)
+ [Kum &amp; pulan Data Evaluasi](#cli-evaluation)
+ [Paket &amp; Konfigurasi Optimasi](#cli-optimization)
+ [Peng &amp; aturan Operasi](#cli-operations)

## Siklus Hidup Proyek
<a name="cli-project-lifecycle"></a>

 *Auto-generated dari `@aws/agentcore` v0.28.1 - jangan mengedit dengan tangan. * 

### agentcore membuat
<a name="_agentcore_create"></a>

```
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
<a name="_agentcore_deploy"></a>

```
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
<a name="_agentcore_dev"></a>

```
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
<a name="_agentcore_package"></a>

```
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
<a name="_agentcore_export"></a>

```
agentcore export [options] [command]
```

Ekspor harness ke agen runtime Strands.

### pembaruan agentcore
<a name="_agentcore_update"></a>

```
agentcore update [options] [command]
```

Periksa dan instal pembaruan CLI

 **Parameter** 

 `-c, --check`*(opsional) *   
Periksa pembaruan tanpa menginstal

### validasi agentcore
<a name="_agentcore_validate"></a>

```
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 &amp;
<a name="cli-invocation"></a>

 *Auto-generated dari `@aws/agentcore` v0.28.1 - jangan mengedit dengan tangan. * 

### panggil agentcore
<a name="_agentcore_invoke"></a>

```
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_llm` dalam mode non-interaktif.

 `--additional-params <json>`*(opsional) *   
Parameter LiteLTM tambahan, sebagai objek JSON, untuk pemanggilan harness. Hanya tersedia `lite_llm` dalam 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`, atau`gemini`.

 `--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
<a name="_agentcore_exec"></a>

```
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
<a name="_agentcore_run"></a>

```
agentcore run [options] [command]
```

Jalankan evaluasi, evaluasi batch, atau rekomendasi pengoptimalan.

### log agentcore
<a name="_agentcore_logs"></a>

```
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
<a name="_agentcore_traces"></a>

```
agentcore traces|t [options] [command]
```

Lihat dan unduh jejak agen.

### status agentcore
<a name="_agentcore_status"></a>

```
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
<a name="_agentcore_fetch"></a>

```
agentcore fetch [options] [command]
```

Ambil info akses untuk sumber daya yang digunakan.

### tampilan agentcore
<a name="_agentcore_view"></a>

```
agentcore view [options] [command]
```

Lihat riwayat pekerjaan dan detail

## Manajemen Sumber Daya
<a name="cli-resources"></a>

 *Auto-generated dari `@aws/agentcore` v0.28.1 - jangan mengedit dengan tangan. * 

### agentcore menambahkan
<a name="_agentcore_add"></a>

```
agentcore add [options] [command] [subcommand]
```

Tambahkan sumber daya ke konfigurasi proyek.

### agentcore menghapus
<a name="_agentcore_remove"></a>

```
agentcore remove [options] [command] [subcommand]
```

Hapus sumber daya dari konfigurasi proyek.

### impor agentcore
<a name="_agentcore_import"></a>

```
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 &amp; pulan Data Evaluasi
<a name="cli-evaluation"></a>

 *Auto-generated dari `@aws/agentcore` v0.28.1 - jangan mengedit dengan tangan. * 

### agentcore evaluations
<a name="_agentcore_evals"></a>

```
agentcore evals [options] [command]
```

Lihat hasil eval dan batch eval yang disimpan dari proses sebelumnya.

### evaluasi batch agentcore
<a name="_agentcore_batch_evaluations"></a>

```
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
<a name="_agentcore_dataset"></a>

```
agentcore dataset [options] [command]
```

Mengelola konten dan versi dataset

## Paket &amp; Konfigurasi Optimasi
<a name="cli-optimization"></a>

 *Auto-generated dari `@aws/agentcore` v0.28.1 - jangan mengedit dengan tangan. * 

### bundel konfigurasi agentcore
<a name="_agentcore_config_bundle"></a>

```
agentcore config-bundle|cb [options] [command]
```

Kelola bundel konfigurasi (gunakan nama bundel dari agentcore.json, bukan ID)

### agentcore mempromosikan
<a name="_agentcore_promote"></a>

```
agentcore promote [options] [command]
```

Promosikan sumber daya

### arsip agentcore
<a name="_agentcore_archive"></a>

```
agentcore archive [options] [command]
```

Arsipkan (hapus) evaluasi batch atau rekomendasi pada layanan dan hapus riwayat lokal.

## Peng &amp; aturan Operasi
<a name="cli-operations"></a>

 *Auto-generated dari `@aws/agentcore` v0.28.1 - jangan mengedit dengan tangan. * 

### jeda agentcore
<a name="_agentcore_pause"></a>

```
agentcore pause [options] [command]
```

Jeda sumber daya yang digunakan (konfigurasi eval online, A/B test).

### agentcore resume
<a name="_agentcore_resume"></a>

```
agentcore resume [options] [command]
```

Lanjutkan sumber daya yang dijeda (konfigurasi eval online, A/B test).

### agentcore berhenti
<a name="_agentcore_stop"></a>

```
agentcore stop [options] [command]
```

Hentikan evaluasi atau A/B pengujian batch yang sedang berjalan.

### konfigurasi agentcore
<a name="_agentcore_config"></a>

```
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
<a name="_agentcore_telemetry"></a>

```
agentcore telemetry [options] [command]
```

Kelola preferensi analisis penggunaan anonim.

### umpan balik agentcore
<a name="_agentcore_feedback"></a>

```
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]