View a markdown version of this page

AgentCore Versionierung und Endpunkte nutzen - Amazon Grundgestein AgentCore
Wie verweisen Endgeräte auf VersionenVersionierungsszenarienLebenszyklusstatus der EndpunkteErstellen eines EndpunktsAuflisten von Harness-Versionen und EndpunktenVerwandte Themen

AgentCore Versionierung und Endpunkte nutzen

Amazon Bedrock AgentCore implementiert automatische Versionierung für AgentCore Kabelbäume und ermöglicht Ihnen die Verwaltung verschiedener Konfigurationen mithilfe von Endpunkten. Die Harness-Versionierung funktioniert genauso wie die AgentCore Runtime-Versionierung — Harness ist eine verwaltete Abstraktion gegenüber Runtime — aber Sie verwalten sie über die APIs der Harness-Steuerungsebene.

Jeder Kabelbaum in Amazon Bedrock AgentCore wird automatisch versioniert:

  • Wenn Sie einen Kabelbaum erstellen, AgentCore wird automatisch Version 1 (V1) erstellt

  • Bei jeder Aktualisierung des Kabelbaums 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 für die Ausführung erforderliche Konfiguration: Modell, Systemaufforderung, Tools, Speicher, Grenzwerte und Umgebung

Wie verweisen Endgeräte auf Versionen

Endpunkte bieten eine Möglichkeit, auf bestimmte Versionen Ihres Kabelbaums zu verweisen:

  • Der DEFAULT Endpunkt verweist automatisch auf die neueste Version Ihres Kabelbaums

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

  • Wenn Sie einen Kabelbaum 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

Beispiel
AWS CLI/boto3
import boto3

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

response = control_client.update_harness_endpoint(
    harnessId='MyHarness-UuFdkQoXSL',
    endpointName='production-endpoint',
    targetVersion='2',
    description='Updated production endpoint'
)

print(response)

Oder mit der AWS CLI:

aws bedrock-agentcore-control update-harness-endpoint \
  --harness-id "MyHarness-UuFdkQoXSL" \
  --endpoint-name "production-endpoint" \
  --target-version "2" \
  --description "Updated production endpoint"

Versionierungsszenarien

Die folgende Tabelle zeigt, wie Versionierung und Endpunkte während des Lebenszyklus eines Kabelbaums interagieren:

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 Modells

Erstellt eine neue Version mit der aktualisierten Modellauswahl

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

Tool- oder Skill-Update

Erstellt eine neue Version mit der aktualisierten Tool-Konfiguration

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

Grenzwerte oder Änderung der Umgebung

Erstellt eine neue Version mit aktualisierten Ausführungsparametern

V4

DEFAULT-Updates auf V4, PROD bleibt auf V3

Lebenszyklusstatus der Endpunkte

Harness-Endgeräte durchlaufen während ihres Lebenszyklus verschiedene Zustände:

WIRD ERSTELLT

Anfangsstatus bei der Erstellung eines Endpunkts

CREATE_FAILED

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

BEREIT

Der Endpunkt ist bereit, Anfragen anzunehmen

WIRD AKTUALISIERT

Der Endpunkt wird auf eine neue Version aktualisiert

UPDATE_FAILED

Weist auf einen Fehler bei der Aktualisierung hin

Erstellen eines Endpunkts

Erstellen Sie einen benannten Endpunkt, um eine Umgebung an eine bestimmte Harness-Version zu binden. Wenn Sie den Wert weglassentargetVersion, verweist der Endpunkt auf die neueste Version zum Zeitpunkt der Erstellung.

Beispiel
AWS CLI/boto3
import boto3

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

response = control_client.create_harness_endpoint(
    harnessId='MyHarness-UuFdkQoXSL',
    endpointName='production-endpoint',
    targetVersion='2',
    description='Production endpoint pinned to V2'
)

print(response)

Oder mit der AWS CLI:

aws bedrock-agentcore-control create-harness-endpoint \
  --harness-id "MyHarness-UuFdkQoXSL" \
  --endpoint-name "production-endpoint" \
  --target-version "2" \
  --description "Production endpoint pinned to V2"

Auflisten von Harness-Versionen und Endpunkten

Sie können alle Versionen eines Kabelbaums auflisten, indem Sie die ListHarnessVersions Operation aufrufen. Rufen ListHarnessEndpoints Sie an, um die Endpunkte für einen Kabelbaum aufzulisten.

Beispiel
AWS CLI/boto3
import boto3

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

# List all versions of a harness
versions = control_client.list_harness_versions(
    harnessId='MyHarness-UuFdkQoXSL'
)
for version in versions['harnessVersions']:
    print(version)

# List all endpoints for a harness
endpoints = control_client.list_harness_endpoints(
    harnessId='MyHarness-UuFdkQoXSL'
)
for endpoint in endpoints['endpoints']:
    print(endpoint)

Oder mit der AWS CLI:

aws bedrock-agentcore-control list-harness-versions \
  --harness-id "MyHarness-UuFdkQoXSL"

aws bedrock-agentcore-control list-harness-endpoints \
  --harness-id "MyHarness-UuFdkQoXSL"

Beide Operationen unterstützen die Paginierung durch maxResults undnextToken. Rufen Sie an, um die Konfiguration eines einzelnen Endpunkts abzurufenGetHarnessEndpoint. Rufen Sie an, um einen zu entfernen. DeleteHarnessEndpoint

Verwandte Themen