View a markdown version of this page

Creare un pacchetto di configurazione - Amazon Bedrock AgentCore
Esempi di codiceParametri della richiestaRispostaErrori

Creare un pacchetto di configurazione

Crea un pacchetto di configurazione per archiviare un'istantanea con versione della configurazione dinamica del tuo agente. Il pacchetto viene creato con una versione iniziale sul ramo. mainline

Nota

Il add config-bundle comando CLI salva la definizione del pacchetto in locale. agentcore.json Per crearlo effettivamente sul servizio, è necessario eseguirlo agentcore deploy in seguito.

Esempi di codice

Esempio
AgentCore CLI

Crea con componenti in linea JSON, quindi distribuisci:

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

Le --components chiavi possono essere ARN o segnaposto nel modulo o. {{runtime:<name>}} {{gateway:<name>}} I segnaposti si trasformano in ARN reali al momento dell'implementazione, quindi utilizza il modulo segnaposto per le risorse gestite nel progetto. Le chiavi ARN non elaborate richiedono che la risorsa esista già:

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

agentcore deploy

Aggiungi --description e imposta --commit-message i metadati della versione o restituisci --json il risultato come JSON. --branch

Crea da un file di componenti, quindi distribuisci:

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

agentcore deploy

Esempiocomponents.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']}")

Parametri della richiesta

Parametro Tipo Campo obbligatorio Descrizione

bundleName

Stringa

Sì

Nome del pacchetto. Deve corrispondere[a-zA-Z][a-zA-Z0-9_]{0,99}. I nomi devono essere unici all'interno del tuo account.

components

Eseguire la mappatura

Sì

Mappa dell'identificatore del componente alla configurazione del componente. La chiave è in genere l'ARN della AgentCore risorsa da configurare (ad esempio, un ARN di runtime). Ogni valore contiene un configuration oggetto con coppie chiave-valore arbitrarie.

description

Stringa

No

Descrizione del pacchetto. Massimo 500 caratteri.

branchName

Stringa

No

Nome del ramo per il tracciamento della versione. L’impostazione predefinita è mainline. Deve corrispondere[a-zA-Z][a-zA-Z0-9_/-]{0,127}.

commitMessage

Stringa

No

Messaggio di commit per la versione iniziale. Massimo 500 caratteri.

createdBy

Oggetto

No

Fonte che ha creato questa versione. Contiene name (obbligatorio) e arn (opzionale).

clientToken

Stringa

No

Token di idempotenza. Se riprovi con lo stesso token, il servizio restituisce il pacchetto esistente invece di crearne uno nuovo.

tags

Eseguire la mappatura

No

Tag di risorse. Massimo 50 tag.

Risposta

Campo Tipo Description

bundleArn

Stringa

ARN del pacchetto di configurazione creato.

bundleId

Stringa

Identificatore univoco per il pacchetto. Formato:. {name}-{10-char-suffix}

versionId

Stringa

UUID della versione iniziale creata con il pacchetto.

createdAt

Time stamp

Quando è stato creato il pacchetto.

Errori

Errore Stato HTTP Description

ValidationException

400

Parametri di richiesta non validi. Controlla i vincoli dei campi e gli schemi di denominazione.

ConflictException

409

Esiste già un pacchetto con lo stesso nome o token client.

ServiceQuotaExceededException

402

Hai raggiunto il numero massimo di pacchetti di configurazione per il tuo account.

AccessDeniedException

403

Autorizzazioni insufficienti. Verifica che le politiche IAM includanobedrock-agentcore:CreateConfigurationBundle.

ThrottlingException

429

Frequenza di richiesta superata. Riprova con backoff esponenziale.

InternalServerException

500

Service-side errore. Riprova la richiesta .