翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon Bedrock AgentCore Runtime V2 のエージェントを最適化する

Amazon Bedrock AgentCore Runtime V2 は、スナップショットを復元してエージェントを開始します。これにより、エージェントコードの構造が変更されます。エージェントが起動時に行う作業はスナップショットにキャプチャされ、復元されたすべてのインスタンスによって共有されます。代わりに、リクエストハンドラーでリクエスト間で異なる値、または期限切れになる可能性のある値を生成します。このトピックでは、起動作業とリクエストごとの作業を中心にエージェントを構造化して、復元のたびに正しい状態を維持する方法について説明します。プラットフォームバージョン V2 の概要については、「プラットフォームバージョン」を参照してください。

エージェントには 2 つの実行コンテキストがあります。

1 つのルールを使用して、コードが属する場所を決定します。スナップショットの存続期間中、値が変わらない場合は、起動時に値を計算します。リクエストごとに異なる場合や期限切れになる可能性がある場合は、ハンドラーで計算します。AgentCore Runtime は、エージェントバージョンごとに 1 つのスナップショットを取得し、エージェントを作成または更新するまで使用します。そのため、スナップショットの有効期間はそのバージョンの存続期間です。

起動時に 1 回初期化する

スナップショットを作成する前に、プロセスの開始時に高価で再利用可能な作業を行います。たとえば、デプロイバンドルから依存関係のインポート、モデルの重みのロード、静的設定の読み取りなどです。AgentCore SDK を使用して、 を呼び出す前に、この作業をモジュールスコープで実行しますapp.run()。エージェントは app.run()が実行されるまでポート 8080 をリッスンしないため、起動作業が完了するまで/ping成功することもスナップショットを作成することもできません。スナップショットは完全に初期化されたエージェントを構造別にキャプチャするため、 をゲートする必要はありません/ping。起動後 120 秒以内に初期化を完了します。エージェントが時間内に正常にならない場合、ランタイムはヘルスチェックに失敗します。/ping および /invocationsエンドポイントの詳細については、AgentCore ランタイムサービス契約の理解」を参照してください。

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

エージェントが AgentCore SDK の代わりに独自の HTTP サーバーを実行している場合は、初期化が完了した後に/pingのみ から正常なステータスを報告し、スナップショットが完全に初期化されたエージェントをキャプチャします。

起動時に、すべてのインスタンスで同じで有効期限のない読み取り専用データ。短期間の認証情報などの時間的制約のある値をハンドラーで処理します。

リクエストごとの状態を最新の状態に保つ

スナップショットは 1 回キャプチャされ、復元されたすべてのインスタンスで共有されるため、起動時にエージェントが生成する値はインスタンス間で同一であり、スナップショットの作成時に固定されます。スナップショットが/invocationsハンドラーに持ち込めない値を処理します。次の表は、起動時ではなくハンドラーで計算する値を示しています。

起動時に再利用可能なクライアントを構築し、呼び出しごとにリクエストごとの値を計算します。

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.

スナップショットセーフな暗号化ライブラリを使用する

AgentCore Runtime がスナップショットからインスタンスを復元すると、起動時にランダム状態をキャッシュした暗号化ライブラリはインスタンス間でその状態を再利用できます。暗号化ライブラリは、復元後に再シードするスナップショットセーフ (スナップセーフ) ビルドを使用する必要があります。

ネットワーク