View a markdown version of this page

AgentCore Versionnage d'exécution et 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 terminauxListe des versions AgentCore d'exécution et des points de terminaison

AgentCore Versionnage d'exécution et points de terminaison

Amazon Bedrock AgentCore implémente le versionnement automatique pour les environnements d' AgentCore exécution et vous permet de gérer différentes configurations à l'aide de points de terminaison.

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

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

  • Chaque mise à jour du AgentCore Runtime 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

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 AgentCore environnement d'exécution :

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

  • 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 AgentCore Runtime, 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 

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

response = bedrock_agentcore_client.update_agent_runtime_endpoint(
    agentRuntimeId='agent-runtime-12345',
    endpointName='production-endpoint',
    agentRuntimeVersion='v2.1',
    description='Updated production endpoint'
)

print(response)

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 AgentCore environnement d'exécution :

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

Modification du protocole

Crée une nouvelle version avec des paramètres de protocole mis à jour

V2

DEFAULT passe automatiquement à la version V2

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

Aucune nouvelle version créée

V2

Le point de terminaison PROD pointe vers V2

Mise à jour des images du conteneur

Crée une nouvelle version avec une nouvelle référence de conteneur

V3

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

Mettre à jour « PROD » vers la V3

Aucune nouvelle version créée

V3

Mises à jour PROD vers la V3

Modification des paramètres réseau

Crée une nouvelle version avec des paramètres de sécurité mis à jour

V4

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

États du cycle de vie des terminaux

AgentCore Les points de terminaison d'exécution 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, à un conteneur 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

Liste des versions AgentCore d'exécution et des points de terminaison

Vous pouvez répertorier toutes les versions d'un AgentCore Runtime en appelant l'ListAgentRuntimeVersionsopération. Pour répertorier les points de terminaison d'un AgentCore Runtime, appelezListAgentRuntimeEndpoints.