View a markdown version of this page

AgentCore exploiter les versions et les points de terminaison - Amazon Bedrock AgentCore
Comment les points de terminaison référencent les versionsScénarios de gestion des versionsÉtats du cycle de vie des terminauxCréation d’un point de terminaisonListe des versions du harnais et des points de terminaisonRubriques en relation

AgentCore exploiter les versions et les points de terminaison

Amazon Bedrock AgentCore implémente le versionnement automatique des AgentCore harnais et vous permet de gérer différentes configurations à l'aide de points de terminaison. Le versionnement du harnais fonctionne de la même manière que le versionnement du AgentCore runtime (le harnais est une abstraction gérée par rapport à Runtime) mais vous le gérez via les API du plan de contrôle du harnais.

Chaque harnais d'Amazon Bedrock AgentCore est automatiquement versionné :

  • Lorsque vous créez un harnais, la version 1 (V1) est AgentCore automatiquement créée

  • Chaque mise à jour du harnais crée une nouvelle version avec une configuration complète et autonome

  • Les versions sont immuables une fois créées

  • Chaque version contient toutes les configurations nécessaires à l'exécution : modèle, invite système, outils, mémoire, limites et environnement

Comment les points de terminaison référencent les versions

Les points de terminaison permettent de référencer des versions spécifiques de votre harnais :

  • Le DEFAULT point de terminaison pointe automatiquement vers la dernière version de votre harnais

  • Les points de terminaison peuvent pointer vers des versions spécifiques, ce qui vous permet de gérer différents environnements (par exemple, développement, mise en scène, production)

  • Lorsque vous mettez à jour un harnais, le DEFAULT point de terminaison est automatiquement mis à jour pour pointer vers la nouvelle version

  • Les points de terminaison doivent être explicitement mis à jour pour pointer vers les nouvelles versions

Exemple de mise à jour d'un point de terminaison vers une nouvelle version

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

Ou avec 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"

Scénarios de gestion des versions

Le tableau suivant illustre la façon dont le versionnement et les points de terminaison interagissent au cours du cycle de vie d'un harnais :

Type de changement Comportement de création de version Dernière version Comportement des terminaux

Création initiale

Crée automatiquement la version 1 (V1)

V1

DEFAULT pointe vers V1

Changement de modèle

Crée une nouvelle version avec la sélection de modèles mise à jour

V2

DEFAULT passe automatiquement à la version V2

Créez un point de terminaison « PROD » avec la V2

Aucune nouvelle version n'a été créée

V2

Le point de terminaison PROD pointe vers V2

Mise à jour de l'outil ou des compétences

Crée une nouvelle version avec la configuration de l'outil mise à jour

V3

Mises à jour par défaut vers la V3, PROD reste sur la V2

Mettre à jour « PROD » vers la V3

Aucune nouvelle version n'a été créée

V3

Mises à jour PROD vers la V3

Limites ou modification de l'environnement

Crée une nouvelle version avec des paramètres d'exécution mis à jour

V4

Mises à jour par défaut vers la V4, PROD reste sur la V3

États du cycle de vie des terminaux

Les points de terminaison du harnais passent par différents états au cours de leur cycle de vie :

CREAtioN

État initial lors de la création d'un point de terminaison

ÉCHEC DE LA CRÉATION

Indique un échec de création dû à des autorisations, à la configuration ou à d'autres problèmes

PRÊT

Le point de terminaison est prêt à accepter les demandes

MISE À JOUR

Endpoint est en cours de mise à jour vers une nouvelle version

MISE À JOUR ÉCHOUÉE

Indique l'échec de la mise à jour

Création d’un point de terminaison

Créez un point de terminaison nommé pour associer un environnement à une version de harnais spécifique. Si vous ometteztargetVersion, le point de terminaison pointe vers la dernière version au moment de la création.

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

Ou avec 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"

Liste des versions du harnais et des points de terminaison

Vous pouvez répertorier toutes les versions d'un harnais en appelant l'ListHarnessVersionsopération. Pour répertorier les points de terminaison d'un harnais, appelezListHarnessEndpoints.

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

Ou avec 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"

Les deux opérations prennent en charge la pagination via maxResults et. nextToken Pour récupérer la configuration d'un seul point de terminaison, appelez GetHarnessEndpoint ; pour en supprimer un, appelezDeleteHarnessEndpoint.

Rubriques en relation