View a markdown version of this page

Buat bundel konfigurasi - Batuan Dasar Amazon AgentCore

Buat bundel konfigurasi

Buat bundel konfigurasi untuk menyimpan snapshot berversi dari konfigurasi dinamis agen Anda. Bundel dibuat dengan versi awal di mainline cabang.

catatan

add config-bundlePerintah CLI menyimpan definisi bundel ke agentcore.json lokal. Untuk benar-benar membuatnya di layanan, Anda harus menjalankannya agentcore deploy setelahnya.

Sampel Kode

contoh
AgentCore CLI

Buat dengan komponen sebaris JSON, lalu terapkan:

agentcore add config-bundle \ --name myAgentConfig \ --description "Initial config" \ --branch mainline \ --commit-message "Initial bundle creation" \ --components '{"arn:aws:bedrock-agentcore:us-west-2:123456789012:runtime/MyAgent-abc123": {"configuration": {"system_prompt": "You are a helpful assistant.", "model_id": "global.anthropic.claude-sonnet-4-5-20250929-v1:0"}}}' agentcore deploy

--componentsKuncinya bisa berupa ARN atau placeholder dalam bentuk atau. {{runtime:<name>}} {{gateway:<name>}} Placeholder menyelesaikan ARN nyata pada waktu penerapan, jadi gunakan formulir placeholder untuk sumber daya yang dikelola dalam proyek Anda. Kunci ARN mentah membutuhkan sumber daya untuk sudah ada:

agentcore add config-bundle \ --name myAgentConfig \ --components '{"{{runtime:MyAgent}}": {"configuration": {"system_prompt": "You are a helpful assistant."}}}' agentcore deploy

Tambahkan--description,--branch, dan --commit-message untuk mengatur metadata versi, atau --json untuk menampilkan hasilnya sebagai JSON.

Buat dari file komponen, lalu terapkan:

agentcore add config-bundle \ --name myAgentConfig \ --components-file ./components.json agentcore deploy

Sampelcomponents.json:

{ "arn:aws:bedrock-agentcore:us-west-2:123456789012:runtime/MyAgent-abc123": { "configuration": { "system_prompt": "You are a helpful customer support assistant for Acme Store. When handling requests: 1) Identify ALL actions needed before starting any. 2) Execute each action in sequence. 3) Before ending any conversation, summarize what was done.", "model_id": "global.anthropic.claude-sonnet-4-5-20250929-v1:0" } } }
AWS SDK (boto3)
import boto3 import uuid client = boto3.client("bedrock-agentcore-control", region_name="us-west-2") RUNTIME_ARN = "arn:aws:bedrock-agentcore:us-west-2:123456789012:runtime/MyAgent-abc123" response = client.create_configuration_bundle( bundleName="myAgentConfig", components={ RUNTIME_ARN: { "configuration": { "system_prompt": "You are a helpful customer support assistant.", "model_id": "global.anthropic.claude-sonnet-4-5-20250929-v1:0", "temperature": 0.7, } } }, description="Initial configuration for MyAgent", branchName="mainline", commitMessage="Initial bundle creation", clientToken=str(uuid.uuid4()), ) print(f"Bundle ID: {response['bundleId']}") print(f"Bundle ARN: {response['bundleArn']}") print(f"Version ID: {response['versionId']}")

Permintaan parameter

Parameter Tipe Diperlukan Deskripsi

bundleName

Tali

Ya

Nama untuk bundel. Harus cocok[a-zA-Z][a-zA-Z0-9_]{0,99}. Nama harus unik dalam akun Anda.

components

Peta

Ya

Peta pengenal komponen ke konfigurasi komponen. Kuncinya biasanya ARN dari AgentCore sumber daya yang dikonfigurasi (misalnya, ARN runtime). Setiap nilai berisi configuration objek dengan pasangan kunci-nilai arbitrer.

description

String

Tidak

Deskripsi bundel. Maksimal 500 karakter.

branchName

String

Tidak

Nama cabang untuk pelacakan versi. Default ke mainline. Harus cocok[a-zA-Z][a-zA-Z0-9_/-]{0,127}.

commitMessage

String

Tidak

Pesan komit untuk versi awal. Maksimal 500 karakter.

createdBy

Objek

Tidak

Sumber yang membuat versi ini. Berisi name (wajib) dan arn (opsional).

clientToken

String

Tidak

Token idempotensi. Jika Anda mencoba lagi dengan token yang sama, layanan mengembalikan bundel yang ada alih-alih membuat yang baru.

tags

Peta

Tidak

Tag sumber daya. Maksimal 50 tag.

Respons

Bidang Tipe Deskripsi

bundleArn

String

ARN dari bundel konfigurasi yang dibuat.

bundleId

String

Pengidentifikasi unik untuk bundel. Format: {name}-{10-char-suffix}.

versionId

String

UUID dari versi awal yang dibuat dengan bundel.

createdAt

Stempel waktu

Saat bundel dibuat.

Kesalahan

Kesalahan Status HTTP Deskripsi

ValidationException

400

Parameter permintaan tidak valid. Periksa batasan bidang dan pola penamaan.

ConflictException

409

Bundel dengan nama atau token klien yang sama sudah ada.

ServiceQuotaExceededException

402

Anda telah mencapai jumlah maksimum bundel konfigurasi untuk akun Anda.

AccessDeniedException

403

Izin tidak mencukupi. Verifikasi kebijakan IAM termasukbedrock-agentcore:CreateConfigurationBundle.

ThrottlingException

429

Tingkat permintaan terlampaui. Coba lagi dengan backoff eksponensial.

InternalServerException

500

Service-side kesalahan. Coba lagi permintaannya.