Esempi di codice Parametri della richiesta Risposta Errori

Crea 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 sulla filiale. mainline

Nota

Il add config-bundle comando CLI salva la definizione del bundle 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 segnaposto si trasformano in veri e propri ARN al momento della distribuzione, quindi utilizza il modulo segnaposto per le risorse gestite nel tuo progetto. Le chiavi ARN grezze 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--branch, e --commit-message per impostare i metadati della versione o --json per generare il risultato come JSON.

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 univoci 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 della filiale per il monitoraggio delle versioni. 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 delle 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 i modelli 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 includano`bedrock-agentcore:CreateConfigurationBundle`.
`ThrottlingException`	429	Percentuale di richieste superata. Riprova con un backoff esponenziale.
`InternalServerException`	500	Service-side errore. Riprova la richiesta .

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Nozioni di base

Aggiornare un pacchetto