View a markdown version of this page

Création d'un bundle de configuration - Amazon Bedrock AgentCore
Exemples de codeParamètres de demandeRéponseErreurs

Création d'un bundle de configuration

Créez un bundle de configuration pour stocker un instantané versionné de la configuration dynamique de votre agent. Le bundle est créé avec une version initiale sur la mainline branche.

Note

La add config-bundle commande CLI enregistre la définition du bundle agentcore.json localement. Pour le créer réellement sur le service, vous devez l'exécuter agentcore deploy ensuite.

Exemples de code

Exemple
AgentCore CLI

Créez avec des composants en ligne JSON, puis déployez :

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

Les --components clés peuvent être des ARN ou des espaces réservés dans le formulaire {{runtime:<name>}} ou. {{gateway:<name>}} Les espaces réservés se transforment en ARN réels au moment du déploiement. Utilisez donc le formulaire d'espace réservé pour les ressources gérées dans le cadre de votre projet. Les clés ARN brutes nécessitent que la ressource existe déjà :

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

agentcore deploy

Ajoutez --description--branch, et --commit-message pour définir les métadonnées de version ou --json pour afficher le résultat au format JSON.

Créez à partir d'un fichier de composants, puis déployez :

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

agentcore deploy

Échantillon 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']}")

Paramètres de demande

Paramètre Type Obligatoire Description

bundleName

String

Oui

Nom du bundle. Doit correspondre[a-zA-Z][a-zA-Z0-9_]{0,99}. Les noms doivent être uniques au sein de votre compte.

components

Map

Oui

Mappage entre l'identifiant du composant et la configuration du composant. La clé est généralement l'ARN de la AgentCore ressource en cours de configuration (par exemple, un ARN d'exécution). Chaque valeur contient un configuration objet avec des paires clé-valeur arbitraires.

description

String

Non

Description de l'offre groupée. 500 caractères maximum.

branchName

String

Non

Nom de la branche pour le suivi des versions. La valeur par défaut est mainline . Doit correspondre[a-zA-Z][a-zA-Z0-9_/-]{0,127}.

commitMessage

String

Non

Message de validation pour la version initiale. 500 caractères maximum.

createdBy

Objet

Non

Source qui a créé cette version. Contient name (obligatoire) et arn (facultatif).

clientToken

String

Non

Jeton d'impuissance. Si vous réessayez avec le même jeton, le service renvoie le bundle existant au lieu d'en créer un nouveau.

tags

Map

Non

Balises de ressources. 50 étiquettes au maximum.

Réponse

Champ Type Description

bundleArn

String

ARN du bundle de configuration créé.

bundleId

String

Identifiant unique pour le bundle. Format :{name}-{10-char-suffix}.

versionId

String

UUID de la version initiale créée avec le bundle.

createdAt

Horodatage

Quand le bundle a été créé.

Erreurs

Erreur Statut HTTP Description

ValidationException

400

Paramètres de demande non valides. Vérifiez les contraintes de champ et les modèles de dénomination.

ConflictException

409

Un bundle portant le même nom ou le même jeton client existe déjà.

ServiceQuotaExceededException

402

Vous avez atteint le nombre maximum de packs de configuration pour votre compte.

AccessDeniedException

403

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

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.