View a markdown version of this page

AgentCore Versionnage des environnements d'exécution et points de terminaison - Base rocheuse de l'Amazonie AgentCore
Comment les terminaux font référence aux versionsScénarios de gestion des versionsÉtats du cycle de vie des terminauxListe des versions et des points de terminaison d' AgentCore exécution

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

Amazon Bedrock AgentCore met en œuvre la gestion automatique des versions pour les environnements d' AgentCore exécution et vous permet de gérer différentes configurations à l'aide de points de terminaison.

Chaque AgentCore environnement d'exécution 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 terminaux font référence aux 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 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 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 de nouvelles versions

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

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 protocole

Crée une nouvelle version avec des paramètres de protocole mis à 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 images du conteneur

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

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

Modification des paramètres réseau

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

V4

DEFAULT passe à la V4, PROD reste sur la V3

États du cycle de vie des terminaux

AgentCore Les terminaux 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 terminal

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

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.