本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

針對 Amazon Bedrock AgentCore 執行期 V2 最佳化您的代理程式

Amazon Bedrock AgentCore 執行期 V2 會透過還原快照來啟動您的代理程式。這會變更您建構代理程式程式碼的方式。您的代理程式在啟動時執行的工作會在快照中擷取，並由每個還原的執行個體共用。改為在請求處理常式中產生請求之間必須不同或可能過期的任何值。本主題說明如何根據啟動工作和每個請求工作來建構代理程式，以便在每次還原後保持正確。如需平台版本 V2 的概觀，請參閱平台版本。

您的代理程式有兩個執行內容：

使用一個規則來決定程式碼的所屬位置。如果在快照的生命週期內保持不變，請在啟動時計算值。如果每個請求各有不同或可能過期，請在處理常式中運算。AgentCore 執行期會為每個代理程式版本拍攝一個快照，並用到您建立或更新代理程式為止，因此快照的生命週期是該版本的生命週期。

啟動時初始化一次

在快照之前，在程序開始時執行昂貴、可重複使用的工作。例如，從部署套件匯入相依性、載入模型權重或讀取靜態組態。使用 AgentCore 開發套件，在呼叫 之前，在模組範圍內執行此工作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

如果您的代理程式執行自己的 HTTP 伺服器，而不是 AgentCore SDK，/ping則只有在初始化完成後，才從 報告運作狀態良好，以便快照擷取完全初始化的代理程式。

每個執行個體在啟動時只讀取相同且不會過期的資料。在您的處理常式中處理時間敏感值，例如短期憑證。

保持每個請求狀態為新

快照會擷取一次，並由每個還原的執行個體共用，因此您的代理程式在啟動時產生的任何值在執行個體之間都相同，並在快照時修正。處理快照無法在/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 執行期從快照還原執行個體時，在啟動時快取隨機狀態的密碼編譯程式庫可以在執行個體之間重複使用該狀態。您的密碼編譯程式庫必須使用還原後複寫的快照安全 （快照安全） 建置。

聯網