Exemples de code Paramètres de demande Réponse Branchement et fusions Erreurs

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 génère un nouvel identifiant de version ; les versions existantes ne sont jamais modifiées. Les versions forment une chaîne viaparentVersionIds, comme les git commits.

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 bon :


# 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)

Mettre à 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 la mise à jour à l'aide d'une invite système recommandée à partir du résultat d'une 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`	Chaîne	Oui	L'ID du bundle de configuration à mettre à jour. Transmis en tant que paramètre de chemin.
`bundleName`	Chaîne	Non	Nom mis à jour pour le bundle.
`description`	Chaîne	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 parente pour le suivi de la généalogie. Requis lors de la mise à jour`components`. Engagements réguliers : parent célibataire. Commissions de fusion : 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`	Chaîne	Non	Nom de branche pour cette version. S'il n'est pas spécifié, hérite de la branche du parent ou prend par défaut. `mainline`
`commitMessage`	Chaîne	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`	Chaîne	Non	Jeton d'idempotence.

Réponse

Champ	Type	Description
`bundleArn`	Chaîne	ARN du bundle de configuration.
`bundleId`	Chaîne	ID du bundle de configuration.
`versionId`	Chaîne	UUID de la nouvelle version créée par cette mise à jour.
`updatedAt`	Horodatage	Date à laquelle la mise à jour a été appliquée.

Branchement et fusions

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

Commits linéaires. Omettre parentVersionIds ou transmettre 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 effectuer une branche.
Fusionnez les commits. Étape 2 parentVersionIds : la première est la dernière version sur la branche cible, la seconde est la dernière sur 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 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 incluent`bedrock-agentcore:UpdateConfigurationBundle`.
`ThrottlingException`	429	Taux de demandes dépassé. Réessayez avec un backoff exponentiel.
`InternalServerException`	500	Service-side erreur. Réitérez la demande.

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Création d'un bundle

Obtenez un forfait