View a markdown version of this page

Buat bundel konfigurasi - Batu Dasar Amazon AgentCore

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

Buat bundel konfigurasi

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

catatan

Perintah CLI add config-bundle 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

Tom --components bol dapat berupa ARN atau placeholder dalam bentuk atau. {{runtime:<name>}} {{gateway:<name>}} Placeholder memutuskan ke ARN nyata pada waktu penerapan, jadi gunakan formulir placeholder untuk sumber daya yang dikelola dalam proyek Anda. Kunci ARN mentah mengharuskan sumber daya 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. Ber name isi (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 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 mundur eksponensial.

InternalServerException

500

Service-side kesalahan. Coba lagi permintaannya.