View a markdown version of this page

AgentCore Laufzeitversionierung und Endpunkte - Amazon Grundgestein AgentCore
Wie verweisen Endgeräte auf VersionenVersionierungsszenarienLebenszyklusstatus der EndpunkteListet AgentCore Runtime-Versionen und Endpunkte auf

AgentCore Laufzeitversionierung und Endpunkte

Amazon Bedrock AgentCore implementiert automatische Versionierung für AgentCore Runtimes und ermöglicht Ihnen die Verwaltung verschiedener Konfigurationen mithilfe von Endpunkten.

Jede AgentCore Runtime in Amazon Bedrock AgentCore wird automatisch versioniert:

  • Wenn Sie eine AgentCore Runtime erstellen, erstellt AgentCore Runtime automatisch Version 1 (V1)

  • Bei jedem Update der AgentCore Runtime wird eine neue Version mit einer vollständigen, eigenständigen Konfiguration erstellt

  • Versionen sind unveränderlich, sobald sie erstellt wurden

  • Jede Version enthält die gesamte Konfiguration, die für die Ausführung erforderlich ist

Wie verweisen Endgeräte auf Versionen

Endpunkte bieten eine Möglichkeit, auf bestimmte Versionen Ihrer AgentCore Runtime zu verweisen:

  • Der DEFAULT Endpunkt verweist automatisch auf die neueste Version Ihrer Runtime AgentCore

  • Endpunkte können auf bestimmte Versionen verweisen, sodass Sie unterschiedliche Umgebungen verwalten können (z. B. Entwicklung, Staging, Produktion)

  • Wenn Sie eine AgentCore Runtime aktualisieren, wird der DEFAULT Endpunkt automatisch aktualisiert, sodass er auf die neue Version verweist

  • Endpunkte müssen explizit aktualisiert werden, damit sie auf neue Versionen verweisen

Beispiel: Aktualisierung eines Endpunkts auf eine neue Version 

bedrock_agentcore_client = boto3.client('bedrock-agentcore', region_name='us-west-2')

response = bedrock_agentcore_client.update_agent_runtime_endpoint(
    agentRuntimeId='agent-runtime-12345',
    endpointName='production-endpoint',
    agentRuntimeVersion='v2.1',
    description='Updated production endpoint'
)

print(response)

Versionierungsszenarien

Die folgende Tabelle zeigt, wie Versionierung und Endpunkte während des Lebenszyklus einer Runtime interagieren: AgentCore

Typ ändern Verhalten bei der Versionserstellung Letzte Version Verhalten der Endgeräte

Erste Erstellung

Erstellt Version 1 (V1) automatisch

V1

DEFAULT zeigt auf V1

Änderung des Protokolls

Erstellt eine neue Version mit aktualisierten Protokolleinstellungen

V2

DEFAULT wird automatisch auf V2 aktualisiert

Erstellen Sie einen „PROD“ -Endpunkt mit V2

Es wurde keine neue Version erstellt

V2

Der PROD-Endpunkt zeigt auf V2

Aktualisierung des Container-Images

Erstellt eine neue Version mit neuer Container-Referenz

V3

DEFAULT-Updates auf V3, PROD bleibt auf V2

Aktualisieren Sie „PROD“ auf V3

Es wurde keine neue Version erstellt

V3

PROD aktualisiert auf V3

Änderung der Netzwerkeinstellungen

Erstellt eine neue Version mit aktualisierten Sicherheitsparametern

V4

DEFAULT-Updates auf V4, PROD bleibt auf V3

Lebenszyklusstatus der Endpunkte

AgentCore Runtime-Endpunkte durchlaufen während ihres Lebenszyklus verschiedene Zustände:

WIRD ERSTELLT

Anfangsstatus, wenn ein Endpunkt erstellt wird

CREATE_FAILED

Weist auf einen Fehler bei der Erstellung aufgrund von Berechtigungen, Containern oder anderen Problemen hin

BEREIT

Der Endpunkt ist bereit, Anfragen anzunehmen

WIRD AKTUALISIERT

Der Endpunkt wird auf eine neue Version aktualisiert

UPDATE_FAILED

Zeigt einen Fehler beim Aktualisierungsvorgang an

Listet AgentCore Runtime-Versionen und Endpunkte auf

Sie können alle Versionen einer AgentCore Runtime auflisten, indem Sie den ListAgentRuntimeVersions Vorgang aufrufen. Um die Endpunkte für eine AgentCore Runtime aufzulisten, rufen SieListAgentRuntimeEndpoints.