View a markdown version of this page

AgentCore sfruttare il controllo delle versioni e gli endpoint - Fondamento Amazon 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 di HarnessArgomenti correlati

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

AgentCore sfruttare il controllo delle versioni e gli endpoint

Amazon Bedrock AgentCore implementa il controllo automatico delle versioni per gli AgentCore harness e consente di gestire diverse configurazioni utilizzando gli endpoint. Il controllo delle versioni di Harness funziona allo stesso modo del controllo delle versioni di AgentCore Runtime: harness è un'astrazione gestita su Runtime, ma è possibile gestirlo tramite le API di Harness Control Plane.

Ogni harness in Amazon Bedrock ha una versione automatica: AgentCore

  • Quando crei un'imbracatura, 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 dell'imbracatura:

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

  • Gli endpoint possono puntare a versioni specifiche, consentendoti di gestire ambienti diversi (ad esempio, sviluppo, staging, produzione)

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

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

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

O 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 il controllo delle versioni e gli endpoint interagiscono 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 a 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» alla V3

Nessuna nuova versione creata

V3

Aggiornamenti PROD 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

Endpoint è pronto ad accettare le richieste

AGGIORNAMENTO IN CORSO

Endpoint è in fase di aggiornamento a una nuova versione

UPDATE_FAILED

Indica un errore nell'operazione di aggiornamento

Creazione di un endpoint

Crea un endpoint denominato per collegare un ambiente a una versione specifica del cablaggio. Se omettitargetVersion, 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 CLI: AWS 

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 di Harness

È possibile elencare tutte le versioni di un cablaggio chiamando l'operazione. ListHarnessVersions Per elencare gli endpoint di un cablaggio, chiama. 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 CLI: AWS 

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