Update a configuration bundle

If you added the bundle with agentcore add config-bundle, change its components in agentcore/agentcore.json and deploy. The deployment creates a new immutable version:

agentcore deploy

To update a configuration bundle that your project does not manage, such as one that you created with agentcore eval config-bundle create, provide the complete replacement component map. The command creates a new immutable version on mainline by default:

agentcore eval config-bundle update \
  --id <configuration-bundle-id> \
  --components file://components.json \
  --commit-message "Switch to Claude Sonnet 4"

To list the versions of either kind of bundle, run the following command. For a bundle in your project, the bundle ID is the last segment of its arn in agentcore status --json:

agentcore eval config-bundle version list --id <configuration-bundle-id>

Update changing the model ID:

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"

# The parent must be the latest version on the branch you update
latest = client.get_configuration_bundle(bundleId="myAgentConfig-a1b2c3d4e5", branchName="mainline")

response = client.update_configuration_bundle(
    bundleId="myAgentConfig-a1b2c3d4e5",
    components={
        RUNTIME_ARN: {
            "configuration": {
                "system_prompt": "You are a helpful customer support assistant.",
                "model_id": "us.anthropic.claude-sonnet-4-20250514-v1:0",
                "temperature": 0.7,
            }
        }
    },
    parentVersionIds=[latest["versionId"]],
    commitMessage="Switch to Claude Sonnet 4",
    clientToken=str(uuid.uuid4()),
)

print(f"New version ID: {response['versionId']}")

Update with a recommended system prompt from a recommendation result:

import time
import boto3
import uuid

cp_client = boto3.client("bedrock-agentcore-control", region_name="us-west-2")
dp_client = boto3.client("bedrock-agentcore", region_name="us-west-2")

RUNTIME_ARN = "arn:aws:bedrock-agentcore:us-west-2:123456789012:runtime/MyAgent-abc123"

# Wait for the recommendation to complete
while True:
    recommendation = dp_client.get_recommendation(recommendationId="myRec-A1B2C3D4E5")
    if recommendation["status"] == "COMPLETED":
        break
    if recommendation["status"] == "FAILED":
        raise RuntimeError("Recommendation failed")
    time.sleep(30)

result = recommendation["recommendationResult"]["systemPromptRecommendationResult"]
recommended_prompt = result["recommendedSystemPrompt"]

# The parent must be the latest version on the branch you update
latest = cp_client.get_configuration_bundle(bundleId="myAgentConfig-a1b2c3d4e5", branchName="mainline")

# Update the bundle with the recommended prompt
response = cp_client.update_configuration_bundle(
    bundleId="myAgentConfig-a1b2c3d4e5",
    components={
        RUNTIME_ARN: {
            "configuration": {
                "system_prompt": recommended_prompt,
                "model_id": "global.anthropic.claude-sonnet-4-5-20250929-v1:0",
                "temperature": 0.7,
            }
        }
    },
    parentVersionIds=[latest["versionId"]],
    commitMessage="Apply recommended system prompt",
    createdBy={"name": "optimization-job", "arn": recommendation["recommendationArn"]},
    clientToken=str(uuid.uuid4()),
)

print(f"New version ID: {response['versionId']}")