View a markdown version of this page

Erstellen Sie ein Konfigurationspaket - Amazon Grundgestein AgentCore
CodebeispieleAnforderungsparameterAntwortFehler

Erstellen Sie ein Konfigurationspaket

Erstellen Sie ein Konfigurationspaket, um einen versionierten Snapshot der dynamischen Konfiguration Ihres Agenten zu speichern. Das Paket wird mit einer ersten Version in der mainline Filiale erstellt.

Anmerkung

Der add config-bundle CLI-Befehl speichert die Bundle-Definition agentcore.json lokal. Um es tatsächlich auf dem Service zu erstellen, müssen Sie es agentcore deploy anschließend ausführen.

Codebeispiele

Beispiel
AgentCore CLI

Erstellen Sie mit den Inline-Komponenten JSON und stellen Sie dann Folgendes bereit:

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

Die --components Schlüssel können ARNs oder Platzhalter in der Form {{runtime:<name>}} oder sein. {{gateway:<name>}} Platzhalter werden bei der Bereitstellung in echte ARNs umgewandelt. Verwenden Sie daher das Platzhalterformular für Ressourcen, die in Ihrem Projekt verwaltet werden. Für ARN-Rohschlüssel muss die Ressource bereits vorhanden sein:

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

agentcore deploy

Fügen Sie --description--branch, und hinzu, --commit-message um Versionsmetadaten festzulegen oder --json das Ergebnis als JSON auszugeben.

Erstellen Sie aus einer Komponentendatei und stellen Sie dann Folgendes bereit:

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

agentcore deploy

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

Anforderungsparameter

Parameter Typ Erforderlich Beschreibung

bundleName

Zeichenfolge

Ja

Name für das Bundle. Muss übereinstimmen[a-zA-Z][a-zA-Z0-9_]{0,99}. Namen müssen in Ihrem Konto eindeutig sein.

components

Zuordnung

Ja

Zuordnung der Komponenten-ID zur Komponentenkonfiguration. Der Schlüssel ist normalerweise der ARN der AgentCore Ressource, die konfiguriert wird (z. B. ein Runtime-ARN). Jeder Wert enthält ein configuration Objekt mit beliebigen Schlüssel-Wert-Paaren.

description

Zeichenfolge

Nein

Beschreibung des Bundles. Maximal 500 Zeichen.

branchName

Zeichenfolge

Nein

Name der Filiale für die Versionsverfolgung. Standardeinstellung: mainline. Muss übereinstimmen[a-zA-Z][a-zA-Z0-9_/-]{0,127}.

commitMessage

Zeichenfolge

Nein

Commit-Nachricht für die ursprüngliche Version. Maximal 500 Zeichen.

createdBy

Objekt

Nein

Quelle, die diese Version erstellt hat. Enthält name (erforderlich) und arn (optional).

clientToken

Zeichenfolge

Nein

Idempotenz-Token. Wenn Sie es mit demselben Token erneut versuchen, gibt der Dienst das vorhandene Paket zurück, anstatt ein neues zu erstellen.

tags

Zuordnung

Nein

Ressourcen-Tags. Maximal 50 Tags.

Antwort

Feld Typ Description

bundleArn

Zeichenfolge

ARN des erstellten Konfigurationspakets.

bundleId

Zeichenfolge

Eindeutiger Bezeichner für das Bundle. Format:{name}-{10-char-suffix}.

versionId

Zeichenfolge

UUID der ersten Version, die mit dem Bundle erstellt wurde.

createdAt

Zeitstempel

Wann das Bundle erstellt wurde.

Fehler

Fehler HTTP-Status Description

ValidationException

400

Ungültige Anforderungsparameter. Überprüfen Sie die Feldbeschränkungen und Benennungsmuster.

ConflictException

409

Ein Bundle mit demselben Namen oder Client-Token ist bereits vorhanden.

ServiceQuotaExceededException

402

Sie haben die maximale Anzahl an Konfigurationspaketen für Ihr Konto erreicht.

AccessDeniedException

403

Unzureichende Berechtigungen. Stellen Sie sicher, dass die IAM-Richtlinien Folgendes beinhalten: bedrock-agentcore:CreateConfigurationBundle

ThrottlingException

429

Die Anforderungsrate wurde überschritten. Versuchen Sie es erneut mit exponentiellem Backoff.

InternalServerException

500

Service-side Fehler. Wiederholen Sie die Anforderung.