View a markdown version of this page

設定バンドルを作成する - Amazon Bedrock AgentCore

設定バンドルを作成する

設定バンドルを作成して、エージェントの動的設定のバージョニングされたスナップショットを保存します。バンドルは、mainlineブランチの初期バージョンで作成されます。

注記

CLI add config-bundle コマンドは、バンドル定義をagentcore.jsonローカルに に保存します。実際にサービスで作成するには、agentcore deploy後で を実行する必要があります。

コードサンプル

AgentCore CLI

インラインコンポーネント JSON を使用して を作成し、以下をデプロイします。

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

--components キーは、 または の形式で ARNs {{runtime:<name>}}またはプレースホルダーにすることができます{{gateway:<name>}}。プレースホルダーはデプロイ時に実際の ARNs に解決されるため、プロジェクトで管理されるリソースにはプレースホルダーフォームを使用します。Raw ARN キーでは、リソースがすでに存在している必要があります。

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

--description--branch、 を追加してバージョンメタデータ--commit-messageを設定するか、結果を JSON として--json出力します。

コンポーネントファイルから を作成し、以下をデプロイします。

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

サンプル components.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']}")

リクエストパラメータ

パラメータ タイプ 必須 説明

bundleName

文字列

はい

バンドルの名前。と一致する必要があります[a-zA-Z][a-zA-Z0-9_]{0,99}。名前はアカウント内で一意である必要があります。

components

マッピング

はい

コンポーネント識別子のコンポーネント設定へのマップ。キーは通常、設定されている AgentCore リソースの ARN (ランタイム ARN など) です。各値には、任意のキーと値のペアを持つconfigurationオブジェクトが含まれます。

description

String

いいえ

バンドルの説明。最大 500 文字。

branchName

String

いいえ

バージョン追跡用のブランチ名。デフォルトは mainline です。と一致する必要があります[a-zA-Z][a-zA-Z0-9_/-]{0,127}

commitMessage

String

いいえ

初期バージョンのメッセージをコミットします。最大 500 文字。

createdBy

オブジェクト

いいえ

このバージョンを作成したソース。(name必須) と arn (オプション) が含まれます。

clientToken

String

いいえ

べき等性トークン。同じトークンで再試行すると、サービスは新しいバンドルを作成する代わりに既存のバンドルを返します。

tags

マッピング

いいえ

リソースタグ。最大 50 タグ。

[応答]

フィールド タイプ 説明

bundleArn

文字列

作成された設定バンドルの ARN。

bundleId

String

バンドルの一意の識別子。形式: {name}-{10-char-suffix}

versionId

String

バンドルで作成された初期バージョンの UUID。

createdAt

タイムスタンプ

バンドルが作成された日時。

エラー

エラー HTTP ステータス 説明

ValidationException

400

リクエストパラメータが無効です。フィールドの制約と命名パターンを確認します。

ConflictException

409

同じ名前またはクライアントトークンのバンドルが既に存在します。

ServiceQuotaExceededException

402

アカウントの設定バンドルの最大数に達しました。

AccessDeniedException

403

アクセス許可が不十分です。IAM ポリシーに が含まれていることを確認しますbedrock-agentcore:CreateConfigurationBundle

ThrottlingException

429

リクエストレートを超えました。エクスポネンシャルバックオフを使用して再試行してください。

InternalServerException

500

サービス側のエラー。リクエストを再試行します。