View a markdown version of this page

AgentCore sfruttare il controllo delle versioni e gli endpoint - Amazon Bedrock AgentCore
In che modo gli endpoint fanno riferimento alle versioniScenari di controllo delle versioniStati del ciclo di vita degli endpointCreazione di un endpointElenco delle versioni e degli endpoint del cablaggioArgomenti correlati

AgentCore sfruttare il controllo delle versioni e gli endpoint

Amazon Bedrock AgentCore implementa il controllo automatico delle versioni per i AgentCore cablaggi e consente di gestire diverse configurazioni utilizzando gli endpoint. Il controllo delle versioni di Harness funziona allo stesso modo del versionamento AgentCore Runtime (harness è un'astrazione gestita rispetto a Runtime), ma lo gestisci tramite le API del piano di controllo di Harness.

A ogni cablaggio in Amazon Bedrock AgentCore viene assegnata automaticamente una versione:

  • Quando crei un cablaggio, crea AgentCore automaticamente la versione 1 (V1)

  • Ogni aggiornamento del cablaggio crea una nuova versione con una configurazione completa e autonoma

  • Le versioni sono immutabili una volta create

  • Ogni versione contiene tutta la configurazione necessaria per l'esecuzione: modello, prompt di sistema, strumenti, memoria, limiti e ambiente

In che modo gli endpoint fanno riferimento alle versioni

Gli endpoint forniscono un modo per fare riferimento a versioni specifiche del sistema Harness:

  • L'DEFAULTendpoint rimanda automaticamente alla versione più recente dell'imbracatura

  • Gli endpoint possono puntare a versioni specifiche, che consentono di mantenere ambienti diversi (ad esempio, sviluppo, gestione temporanea, produzione)

  • Quando si aggiorna un cablaggio, l'DEFAULTendpoint viene aggiornato automaticamente in modo che punti alla nuova versione

  • Gli endpoint devono essere aggiornati in modo esplicito per indicare nuove versioni

Esempio Aggiornamento di un endpoint a una nuova versione

Esempio
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)

Oppure con la AWS CLI:

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

Scenari di controllo delle versioni

La tabella seguente illustra come interagiscono il controllo delle versioni e gli endpoint durante il ciclo di vita di un cablaggio:

Tipo di modifica Comportamento di creazione della versione Versione più recente Comportamento degli endpoint

Creazione iniziale

Crea automaticamente la versione 1 (V1)

V1

DEFAULT punta a V1

Modifica del modello

Crea una nuova versione con la selezione del modello aggiornata

V2

DEFAULT si aggiorna automaticamente alla V2

Crea un endpoint «PROD» con V2

Nessuna nuova versione creata

V2

L'endpoint PROD punta alla V2

Aggiornamento dello strumento o dell'abilità

Crea una nuova versione con la configurazione aggiornata dello strumento

V3

L'impostazione PREDEFINITA si aggiorna alla V3, PROD rimane sulla V2

Aggiorna «PROD» a V3

Nessuna nuova versione creata

V3

PROD si aggiorna alla V3

Limiti o modifiche dell'ambiente

Crea una nuova versione con parametri di esecuzione aggiornati

V4

L'impostazione PREDEFINITA si aggiorna alla V4, PROD rimane sulla V3

Stati del ciclo di vita degli endpoint

Gli endpoint Harness attraversano vari stati durante il loro ciclo di vita:

CREAZIONE IN CORSO

Stato iniziale al momento della creazione di un endpoint

CREATE_FAILED

Indica un errore di creazione dovuto a autorizzazioni, configurazione o altri problemi

PRONTA

L'endpoint è pronto ad accettare le richieste

AGGIORNAMENTO IN CORSO

L'endpoint viene aggiornato a una nuova versione

UPDATE_FAILED

Indica un errore nell'operazione di aggiornamento

Creazione di un endpoint

Crea un endpoint denominato per associare un ambiente a una versione di cablaggio specifica. Se si omettetargetVersion, l'endpoint punta alla versione più recente al momento della creazione.

Esempio
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)

Oppure con la 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"

Elenco delle versioni e degli endpoint del cablaggio

È possibile elencare tutte le versioni di un cablaggio chiamando l'operazione. ListHarnessVersions Per elencare gli endpoint di un cablaggio, chiamate. ListHarnessEndpoints

Esempio
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)

Oppure con la AWS CLI:

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

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

Entrambe le operazioni supportano l'impaginazione tramite maxResults e. nextToken Per recuperare la configurazione di un singolo endpoint, chiamaGetHarnessEndpoint; per rimuoverne uno, chiama. DeleteHarnessEndpoint

Argomenti correlati