View a markdown version of this page

AgentCore exploitez la gestion des versions et les points de terminaison - Base rocheuse de l'Amazonie AgentCore
Comment les endpoints font référence aux versionsScénarios de gestion des versionsÉtats du cycle de vie des terminauxCréation d’un point de terminaisonRépertorier les versions de harnais et les terminauxRubriques associées

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

AgentCore exploitez la gestion des versions et les points de terminaison

Amazon Bedrock AgentCore met en œuvre la gestion automatique des versions pour les AgentCore harnais et vous permet de gérer différentes configurations à l'aide de points de terminaison. Le versionnage du harnais fonctionne de la même manière que le contrôle des versions au moment de l'AgentCore exécution (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, crée AgentCore automatiquement la version 1 (V1)

  • 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 endpoints font référence aux versions

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

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

  • Les endpoints 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 de nouvelles versions

Exemple de mise à jour d'un terminal 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 à l'aide de 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 montre comment le versionnage et les points de terminaison interagissent au cours du cycle de vie d'un harnais :

Type de changement Comportement de création de versions 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 V2

Créer un point de terminaison « PROD » avec V2

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

V2

Le point de terminaison PROD pointe vers V2

Mise à jour des outils ou des compétences

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

V3

DEFAULT passe à la V3, PROD reste sur V2

Mettre à jour « PROD » vers la V3

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

V3

Mises à jour de 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

DEFAULT passe à la V4, PROD reste sur la V3

États du cycle de vie des terminaux

Les terminaux Harness passent par différents états au cours de leur cycle de vie :

CREAtioN

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

ÉCHEC DE LA CRÉATION

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

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 à l'aide de 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"

Répertorier les versions de harnais et les terminaux

Vous pouvez répertorier toutes les versions d'un harnais en appelant l'ListHarnessVersionsopération. Pour répertorier les terminaux 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 à l'aide de 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 terminal, appelez GetHarnessEndpoint ; pour en supprimer un, appelezDeleteHarnessEndpoint.

Rubriques associées