本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

针对亚马逊 Bedrock AgentCore Runtime V2 优化您的代理

亚马逊 Bedrock AgentCore Runtime V2 通过恢复快照来启动您的代理。这改变了您构造代理代码的方式。您的代理在启动时所做的工作将捕获在快照中，并由每个还原的实例共享。改为在请求处理程序中生成任何在不同请求之间必须不同或可能过期的值。本主题介绍如何围绕启动工作和每个请求的工作来构建代理，以使其在每次还原后保持正确。有关平台版本 V2 的概述，请参阅平台版本。

您的代理有两个执行上下文：

使用一条规则来决定代码属于哪里。如果该值在快照的生命周期内保持不变，则在启动时计算该值。如果它因请求而异或可能过期，请在您的处理程序中进行计算。 AgentCore Runtime 为每个代理版本拍摄一个快照，并在您创建或更新代理之前一直使用该快照，因此快照的生命周期就是该版本的生命周期。

启动时初始化一次

在创建快照之前，在流程启动时进行昂贵的、可重复使用的工作。例如，导入依赖关系、加载模型权重或从部署包中读取静态配置。使用 S AgentCore DK，在调用之前，在模块范围内完成这项工作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 Runtime 从快照恢复实例时，在启动时缓存随机状态的加密库可以在实例间重复使用该状态。您的加密库必须使用快照安全 (snapsafe) 版本，该版本在还原后会重新生成。

Networking