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.

Optimisez votre agent pour Amazon Bedrock AgentCore Runtime V2

Amazon Bedrock AgentCore Runtime V2 démarre votre agent en restaurant un instantané. Cela change la façon dont vous structurez votre code d'agent. Le travail effectué par votre agent au démarrage est capturé dans l'instantané et partagé par chaque instance restaurée. Produisez plutôt toute valeur qui doit différer d'une demande à l'autre, ou qui peut expirer, dans votre gestionnaire de requêtes. Cette rubrique explique comment structurer votre agent en fonction du travail de démarrage et du travail par requête afin qu'il reste correct après chaque restauration. Pour un aperçu de la version V2 de la plateforme, voir Versions de la plateforme.

Votre agent dispose de deux contextes d'exécution :

Utilisez une règle pour décider de la place du code. Calculez une valeur au démarrage si elle reste la même pendant toute la durée de vie de l'instantané. Calculez-le dans votre gestionnaire s'il varie d'une demande à l'autre ou s'il peut expirer. AgentCore Runtime prend un instantané par version d'agent et l'utilise jusqu'à ce que vous créiez ou mettiez à jour l'agent. La durée de vie de l'instantané correspond donc à la durée de vie de cette version.

Initialiser une fois au démarrage

Effectuez des tâches coûteuses et réutilisables dès le démarrage de votre processus, avant la capture instantanée. Par exemple, importez des dépendances, chargez les poids des modèles ou lisez la configuration statique à partir de votre bundle de déploiement. Avec le AgentCore SDK, effectuez ce travail dans la portée du module, avant d'appelerapp.run(). Votre agent n'écoute pas sur le port 8080 tant qu'il n'est pas app.run() exécuté. Par conséquent, aucun résultat ne /ping peut réussir et aucun instantané ne peut être pris tant que votre travail de démarrage n'est pas terminé. L'instantané capture un agent entièrement initialisé par construction, et vous n'avez pas besoin de gate/ping. Initialisation complète dans les 120 secondes suivant le démarrage. Si l'état de santé de votre agent n'est pas rétabli à temps, le moteur d'exécution échoue à son contrôle de santé. Pour plus d'informations sur les /invocations points de terminaison /ping et, voir Comprendre le contrat de service AgentCore Runtime.

import json, pathlib

from bedrock_agentcore.runtime import BedrockAgentCoreApp

# Runs once at import, before app.run() starts the server and before the
# snapshot. Every restored instance inherits these objects.
MODEL = load_model_weights()
SETTINGS = json.loads((pathlib.Path(__file__).parent / "agent.json").read_text())

app = BedrockAgentCoreApp()

@app.entrypoint
def invoke(payload):
    # Per-request work runs here on every instance.
    ...

app.run()  # starts listening on 8080; the snapshot is taken after this

Si votre agent exécute son propre serveur HTTP au lieu du AgentCore SDK, signalez un état de santé /ping uniquement une fois l'initialisation terminée, afin que le snapshot capture un agent entièrement initialisé.

Données en lecture seule au démarrage qui sont identiques pour chaque instance et qui n'expirent pas. Gérez les valeurs sensibles au facteur temps, telles que les informations d'identification éphémères, dans votre gestionnaire.

Maintenir à jour l'état de chaque demande

L'instantané est capturé une seule fois et partagé par chaque instance restaurée, de sorte que toute valeur générée par votre agent au démarrage est identique d'une instance à l'autre et corrigée au moment de l'instantané. Gérez les valeurs que le snapshot ne peut pas prendre en charge dans votre /invocations gestionnaire. Le tableau suivant décrit les valeurs à calculer dans votre gestionnaire plutôt qu'au démarrage.

Créez des clients réutilisables au démarrage et calculez les valeurs par demande à chaque appel.

import os, time

# Build reusable clients at startup, before the snapshot. Exercise them here too
# (for example, with a warm-up call) so the setup the client caches — endpoint and
# credential resolution, connection pool — is captured in the snapshot.
client = build_client()
warm_up(client)

@app.entrypoint
def invoke(payload):
    creds = get_credentials()          # refreshed when expired, not read at startup
    request_id = os.urandom(16).hex()  # unique per request
    now = time.time()                  # current time, not snapshot time
    # Handle the request.

Utilisez des bibliothèques cryptographiques sécurisées pour les snapshots

Lorsque AgentCore Runtime restaure une instance à partir d'un instantané, une bibliothèque cryptographique qui a mis en cache un état aléatoire au démarrage peut réutiliser cet état sur plusieurs instances. Vos bibliothèques cryptographiques doivent utiliser une version sécurisée contre les snapshots (snapsafe) qui se réensemence après une restauration.

Mise en réseau