Exemples de code Paramètres de demande Réponse Erreurs

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 en agentcore.json local. 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 JSON en ligne, 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`	Chaîne	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	Carte de l'identifiant du composant à 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`	Chaîne	Non	Description de l'offre groupée. 500 caractères maximum.
`branchName`	Chaîne	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`	Chaîne	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`	Chaîne	Non	Jeton d'idempotence. 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. Maximum de 50 étiquettes.

Réponse

Champ	Type	Description
`bundleArn`	Chaîne	ARN du bundle de configuration créé.
`bundleId`	Chaîne	Identifiant unique pour le bundle. Format :`{name}-{10-char-suffix}`.
`versionId`	Chaîne	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 des champs 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 incluent`bedrock-agentcore:CreateConfigurationBundle`.
`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

Prise en main

Mettre à jour un bundle