View a markdown version of this page

Ein Konfigurationspaket aktualisieren - Amazon Grundgestein AgentCore
CodebeispieleAnforderungsparameterAntwortVerzweigung und ZusammenführungFehler

Ein Konfigurationspaket aktualisieren

Aktualisieren Sie ein Konfigurationspaket, um eine neue unveränderliche Version mit geänderter Konfiguration zu erstellen. Jedes Update erzeugt eine neue Versions-ID; bestehende Versionen werden niemals geändert. Versionen bilden eine KetteparentVersionIds, ähnlich wie bei Git-Commits.

Codebeispiele

Beispiel
AgentCore CLI

Bearbeiten Sie die Konfiguration in agentcore.json und stellen Sie sie erneut bereit. Die CLI erkennt das vorhandene Bundle und erstellt parentVersionIds automatisch eine neue Version mit der richtigen:

# Edit the bundle configuration in agentcore.json (change model_id, system prompt, etc.)
# Then redeploy to create a new version:
agentcore deploy

# After deploying, confirm a new immutable version was created:
agentcore cb versions --name MyBundle

# Inspect what changed between two versions (get IDs from `cb versions`):
agentcore cb diff --name MyBundle --from <v1> --to <v2>
AWS SDK (boto3)

Update zur Änderung der Modell-ID:

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.update_configuration_bundle(
    bundleId="myAgentConfig-a1b2c3d4e5",
    components={
        RUNTIME_ARN: {
            "configuration": {
                "system_prompt": "You are a helpful customer support assistant.",
                "model_id": "us.anthropic.claude-sonnet-4-20250514-v1:0",
                "temperature": 0.7,
            }
        }
    },
    parentVersionIds=["12345678-1234-1234-1234-123456789012"],
    commitMessage="Switch to Claude Sonnet 4",
    clientToken=str(uuid.uuid4()),
)

print(f"New version ID: {response['versionId']}")

Update mit einer empfohlenen Systemaufforderung aus einem Empfehlungsergebnis:

import boto3
import uuid

cp_client = boto3.client("bedrock-agentcore-control", region_name="us-west-2")
dp_client = boto3.client("bedrock-agentcore", region_name="us-west-2")

RUNTIME_ARN = "arn:aws:bedrock-agentcore:us-west-2:123456789012:runtime/MyAgent-abc123"

# Get the recommendation result
recommendation = dp_client.get_recommendation(recommendationId="myRec-a1b2c3d4e5")
recommended_prompt = recommendation["result"]["systemPromptRecommendationResult"]["recommendedSystemPrompt"]

# Update the bundle with the recommended prompt
response = cp_client.update_configuration_bundle(
    bundleId="myAgentConfig-a1b2c3d4e5",
    components={
        RUNTIME_ARN: {
            "configuration": {
                "system_prompt": recommended_prompt,
                "model_id": "global.anthropic.claude-sonnet-4-5-20250929-v1:0",
                "temperature": 0.7,
            }
        }
    },
    parentVersionIds=["12345678-1234-1234-1234-123456789012"],
    commitMessage="Apply recommended system prompt",
    createdBy={"name": "optimization-job", "arn": recommendation["recommendationArn"]},
    clientToken=str(uuid.uuid4()),
)

print(f"New version ID: {response['versionId']}")

Anforderungsparameter

Parameter Typ Erforderlich Beschreibung

bundleId

Zeichenfolge

Ja

Die ID des zu aktualisierenden Konfigurationspakets. Als Pfadparameter übergeben.

bundleName

Zeichenfolge

Nein

Der Name für das Bundle wurde aktualisiert.

description

Zeichenfolge

Nein

Beschreibung aktualisiert. Maximal 500 Zeichen.

components

Zuordnung

Nein

Die Komponentenkonfigurationen wurden aktualisiert. Erstellt eine neue Version mit diesen Komponenten.

parentVersionIds

Liste von Zeichenfolgen

Nein

IDs der übergeordneten Version für die Nachverfolgung der Herkunft. Bei der Aktualisierung components erforderlich. Reguläre Commits: Alleinerziehend. Commits zusammenführen: zwei übergeordnete Elemente (letzter Ziel-Branch, letzter Quell-Branch). Wenn der Zweig bereits existiert, muss der erste übergeordnete Zweig die neueste Version dieses Zweigs sein.

branchName

Zeichenfolge

Nein

Zweigname für diese Version. Falls nicht angegeben, erbt er den Zweig des übergeordneten Elements oder ist standardmäßig auf. mainline

commitMessage

Zeichenfolge

Nein

Commit-Nachricht, in der die Änderungen beschrieben werden. Maximal 500 Zeichen.

createdBy

Objekt

Nein

Quelle, die diese Version erstellt hat. Enthält name (erforderlich) und arn (optional). Verwenden Sie diese Option, um nachzuverfolgen, ob eine Version von einem Benutzer, einem Empfehlungsjob oder einer anderen Automatisierung erstellt wurde.

clientToken

Zeichenfolge

Nein

Idempotenz-Token.

Antwort

Feld Typ Description

bundleArn

Zeichenfolge

ARN des Konfigurationspakets.

bundleId

Zeichenfolge

ID des Konfigurationspakets.

versionId

Zeichenfolge

UUID der neuen Version, die durch dieses Update erstellt wurde.

updatedAt

Zeitstempel

Wann das Update angewendet wurde.

Verzweigung und Zusammenführung

Konfigurationspakete unterstützen Git-ähnliche Verzweigungen:

  • Lineare Commits. Ein alleinerziehendes Elternteil weglassen parentVersionIds oder übergeben. Die neue Version erweitert die Branch-Linie.

  • Neuer Zweig. Geben Sie einen anbranchName, der noch nicht existiert, und einen, der auf die Version parentVersionIds verweist, von der aus Sie verzweigen möchten.

  • Commits zusammenführen. Schritt zweiparentVersionIds: Die erste ist die neueste Version im Ziel-Branch, die zweite ist die neueste Version im Quell-Branch. Dadurch wird ein Merge-Commit auf dem Ziel-Branch erstellt.

Fehler

Fehler HTTP-Status Description

ValidationException

400

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

ResourceNotFoundException

404

Das angegebene bundleId Objekt ist nicht vorhanden.

ConflictException

409

Versionskonflikt. Die angegebene übergeordnete Version ist nicht die neueste Version der Branche. Rufen Sie die neueste Version ab und versuchen Sie es erneut.

AccessDeniedException

403

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

ThrottlingException

429

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

InternalServerException

500

Service-side Fehler. Wiederholen Sie die Anforderung.