View a markdown version of this page

Mettre à jour un bundle de configuration - Amazon Bedrock AgentCore
Exemples de codeParamètres de demandeRéponseBranchements et fusionsErreurs

Mettre à jour un bundle de configuration

Mettez à jour un bundle de configuration pour créer une nouvelle version immuable avec une configuration modifiée. Chaque mise à jour produit un nouvel identifiant de version ; les versions existantes ne sont jamais modifiées. Les versions forment une chaîne viaparentVersionIds, comme dans le cas des commits git.

Exemples de code

Exemple
AgentCore CLI

Modifiez la configuration agentcore.json et redéployez-la. La CLI détecte le bundle existant et crée parentVersionIds automatiquement une nouvelle version avec le code correct :

# Edit the bundle configuration in agentcore.json (change model_id, system prompt, etc.)
# Then redeploy to create a new version:
agentcore deploy

# After deploying, confirm a new immutable version was created:
agentcore cb versions --name MyBundle

# Inspect what changed between two versions (get IDs from `cb versions`):
agentcore cb diff --name MyBundle --from <v1> --to <v2>
AWS SDK (boto3)

Mise à jour en modifiant l'ID du modèle :

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.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=["12345678-1234-1234-1234-123456789012"],
    commitMessage="Switch to Claude Sonnet 4",
    clientToken=str(uuid.uuid4()),
)

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

Effectuez une mise à jour avec une invite système recommandée à partir d'un résultat de recommandation :

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"

# Get the recommendation result
recommendation = dp_client.get_recommendation(recommendationId="myRec-a1b2c3d4e5")
recommended_prompt = recommendation["result"]["systemPromptRecommendationResult"]["recommendedSystemPrompt"]

# 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=["12345678-1234-1234-1234-123456789012"],
    commitMessage="Apply recommended system prompt",
    createdBy={"name": "optimization-job", "arn": recommendation["recommendationArn"]},
    clientToken=str(uuid.uuid4()),
)

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

Paramètres de demande

Paramètre Type Obligatoire Description

bundleId

String

Oui

ID du bundle de configuration à mettre à jour. Transmis en tant que paramètre de chemin.

bundleName

String

Non

Nom mis à jour pour le bundle.

description

String

Non

Description mise à jour. 500 caractères maximum.

components

Map

Non

Configurations de composants mises à jour. Crée une nouvelle version avec ces composants.

parentVersionIds

Liste de chaînes

Non

Identifiants de version parent pour le suivi du lignage. Requis lors de la mise à jourcomponents. Engagements réguliers : parent célibataire. Fusionner les validations : deux parents (branche cible la plus récente, branche source la plus récente). Si la branche existe déjà, le premier parent doit être la dernière version de cette branche.

branchName

String

Non

Nom de la branche pour cette version. Si ce n'est pas spécifié, hérite de la branche du parent ou prend par défaut la valeur. mainline

commitMessage

String

Non

Message de validation décrivant les modifications. 500 caractères maximum.

createdBy

Objet

Non

Source qui a créé cette version. Contient name (obligatoire) et arn (facultatif). Utilisez-le pour savoir si une version a été créée par un utilisateur, une tâche de recommandation ou une autre automatisation.

clientToken

String

Non

Jeton d'impuissance.

Réponse

Champ Type Description

bundleArn

String

ARN du bundle de configuration.

bundleId

String

ID du bundle de configuration.

versionId

String

UUID de la nouvelle version créée par cette mise à jour.

updatedAt

Horodatage

Date à laquelle la mise à jour a été appliquée.

Branchements et fusions

Les ensembles de configuration prennent en charge les branchements de type git :

  • Commissions linéaires. Omettez parentVersionIds ou transmettez un parent célibataire. La nouvelle version étend la lignée des branches.

  • Nouvelle succursale. Spécifiez un branchName qui n'existe pas encore et un parentVersionIds pointeur vers la version à partir de laquelle vous souhaitez créer une branche.

  • Fusionnez les validations. Étape 2 parentVersionIds : la première est la dernière version de la branche cible, la seconde est la dernière version de la branche source. Cela crée un commit de fusion sur la branche cible.

Erreurs

Erreur Statut HTTP Description

ValidationException

400

Paramètres de demande non valides. Vérifiez les contraintes de champ.

ResourceNotFoundException

404

Le paramètre spécifié bundleId n'existe pas.

ConflictException

409

Conflit de version. La version parent spécifiée n'est pas la plus récente de la branche. Récupérez la dernière version et réessayez.

AccessDeniedException

403

Autorisations insuffisantes. Vérifiez que les politiques IAM incluentbedrock-agentcore:UpdateConfigurationBundle.

ThrottlingException

429

Le taux de demandes a été dépassé. Réessayez avec un recul exponentiel.

InternalServerException

500

Service-side erreur. Réitérez la demande.