View a markdown version of this page

亚马逊 Bedrock Agents 经典维护模式 - Amazon Bedrock
迁移计划比较能力迁移过程常见问题其他资源

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

亚马逊 Bedrock Agents 经典维护模式

亚马逊 Bedrock Agents（2023 年 11 月推出）现为亚马逊 Bedrock Agents Classic，自 2026 年 7 月 30 日起将不再向新客户开放。要了解与亚马逊 Bedrock Agents Classic 类似的功能，请浏览亚马逊 Bedro AgentCore ck 亚马逊基岩继续可用，但Agents Classic服务将处于维护模式。

本指南为亚马逊 Bedrock Agents Classic 客户提供有关维护模式迁移选项的信息。

注意

亚马逊 Bedrock 将继续得到全力支持。自 2026 年 7 月 30 日起，只有亚马逊 Bedrock Agents Classic 服务不再向新客户开放。您现有的亚马逊基岩模型、知识库和护栏不受影响。

迁移计划

我们建议您将亚马逊 Bedrock Agents Classic 工作负载迁移到亚马逊 Bedro AgentCore ck。 AgentCore 是构建、连接和优化 AI 代理的平台。中的托管工具 AgentCore 提供了基于配置的起点，开发人员可以在其中声明代理的模型、工具和指令。 AgentCore 处理环境、计算、内存、身份和可观测性。

利用托管代理 AgentCore （推荐）

中的托管工具 AgentCore 提供了基于配置的起点，构建者可以在其中声明代理的模型、工具和指令。 AgentCore 处理计算、环境、内存、身份和可观测性。安全带支持：

  • 带有内置工具连接的托管编排循环

  • 通过 AgentCore 网关（REST API、Lambda 函数或代码级 @tools）以 MCP 工具的形式公开的行动组

  • Gateway-fronted 知识库集成

  • 用于恢复控制和人机在环模式的内联函数工具

  • 用于执行沙盒代码的代码解释器

  • Short-term 以及具有可配置策略的长期内存

  • 通过网关进行护栏执法 AgentCore

  • 对所有代理操作进行持续的端到端跟踪

  • 整体代理行为的系统提示配置

Code-defined 代理开启 AgentCore

对于需要工具声明模型之外的功能的工作负载，客户可以直接在上面部署代码定义的代理。 AgentCore此路径支持：

  • 在特定的编排阶段提示覆盖

  • Multi-agent 协作和主管模式

  • 自定义编排逻辑

  • 更广泛的 OpenAI-compatible 终端

  • 任何框架（Strands、 LangChain OpenAI 代理 SDK、Claude Agent SDK 或自定义）

Code-defined 代理仍然可以受益于 AgentCore的托管基础架构，同时让开发人员可以完全控制代理循环。

除非您有特定理由自己拥有该循环（例如，要迁移的现有代理代码库，或者该工具尚未表示高级编排），否则请使用该工具。客户还可以使用 AgentCore CLI 导入现有的 Bedrock Agents 经典配置，以此作为任一路径的起点。

比较能力

基岩特工经典版 AgentCore 等效
托管编排循环 安全带支持开箱即用 AgentCore
通过 OpenAPI/函数架构 + 可选 Lambda 执行器（从托管代理调用）定义的操作组 通过 AgentCore 网关作为包装 REST API 和 Lambda 函数或代码级 @tools 的 MCP 工具公开的工具。
直接在 RAG 的代理配置中关联基岩知识库 Gateway-fronted 知识库集成到 AgentCore。可通过代码级检索工具访问知识库。
跟踪显示端到端预处理、编排、操作组调用、知识库查询和观察结果的 UI 和 API AgentCore 提供对所有代理操作的持续端到端跟踪。
在特定阶段（预处理、编排、知识库响应生成、后处理）提示覆盖配置 安全带上的系统提示符（--system-prompt）涵盖了代理的整体行为。 Stage-specific 提示覆盖（预处理、KB 响应生成、后处理）不能直接复制。实现等效行为需要将系统提示符与命令执行和自管理脚本相结合。
Built-in AMAZON.UserInput 用于在编排期间自动重新提示用户和提取参数的工具 线束中的内联功能工具。代理调用该工具，暂停并将 tool_use 返回给客户端代码，客户端代码负责处理用户交互并将结果发回。等同于控制权的恢复。需要明确的工具定义，而不是自动引用。
Built-in AMAZON.CodeInterpreter 用于执行沙盒代码的操作组 AgentCore 代码解释器
代理上的会话和内存配置（空闲 TTL、内存类型、跨会话内存） AgentCore 短期和长期记忆（使用不同的记忆策略）
护栏和代理策略以声明方式附加到代理并在协调过程中强制执行 Bedrock 中的护栏配置，在网关上执行策略 AgentCore
Multi-agent 协作角色和路由（例如，主管代理和协调角色） 有限。通过将代理公开为 MCP 工具（代理即工具），可以实现主管模式。如今，路由模式多代理并不简单。全面的多代理协作需要自定义框架代码。
自定义编排器 通过 AgentCore 运行时支持（直接部署自定义编排代码）。不能通过安全带获得。
恢复控制权（代理因外部输入而暂停） 线束中的内联功能工具。代理暂停，将 tool_use 返回给客户端。

迁移过程

迁移到 AgentCore 安全带的先决条件

  • Node.js 20+ 和 AgentCore CLI，或带有 boto3 的 Python 3.10+

  • AWS 在有 AgentCore 安全带的地区提供证书。有关更多信息，请参阅的支持 AWS 区域 AgentCore。

  • 具有所需权限的 IAM 执行角色

  • （可选）GitHub网站上的 AWS https://github.com/aws/agent-toolkit-for-aws 代理工具包提供专业技能，指导您的 AI 代理完成迁移。

使用以下代理工具包进行迁移 AWS （推荐）

GitHub网站上的 AWS 代理工具包包括一项指导您的 AI 代理（或编码助手）完成端到端迁移的amazon-bedrock技能。它会检查您现有的 Bedrock Agent，检查迁移资格，并将每个组件映射到其等效 AgentCore 安全带。然后，该技能驱动 AgentCore CLI 搭建和部署安全带。它永远不会修改您的源代理。

要使用该技能，请执行以下操作：

  1. 安装适用于 AWS 的代理工具包。有关安装代理工具包和启用该技能的说明，请参阅GitHub网站上的 AWS README https://github.com/aws/agent-toolkit-for-aws/blob/main/README.md 代理工具包。

  2. 为您的代理启用该amazon-bedrock技能。

  3. （可选）要简化 AWS 访问，请配置 AWS MCP 服务器。该技能还适用于 AWS CLI 和 boto3。

  4. 安装最新版本的 AgentCore CLI。该技能使用 AgentCore CLI 来搭建和部署安全带。

  5. 提示您的代理人 “帮我将基岩代理迁移到 AgentCore安全带”。当技能要求时，提供代理 ID、姓名或 ARN 以及 AWS 地区和个人资料。

  6. 在每个检查点确认账户、地区和来源代理。该技能提供组件清单、资格评估和书面迁移计划。在部署之前，它会暂停等待您的批准。

您也可以使用该技能来回答迁移问题，而无需执行迁移。如果您的代理使用的功能没有经过验证的工具路径，则该技能将停止并提出替代方案。

手动迁移

如果您更愿意在没有技能的情况下进行迁移，或者您的代理不符合技能驱动的路径，请按照以下步骤使用 CLI 构建安全带。 AgentCore使用最新版本的 AgentCore CLI。

第 1 步：创建和配置

agentcore create --name my-research-agent

如果您要复制现有的 Bedrock Agent，请查看其配置（模型、操作组、KB、提示覆盖），并将每个配置映射到相应的线束参数：

  • model — --model-id

  • action groups— 网关工具

  • KBs— 网关或检索工具

  • prompt — --system-prompt

添加工具：

agentcore add tool --harness my-research-agent \
  --type agentcore_browser --name browser
agentcore add tool --harness my-research-agent \
  --type agentcore_code_interpreter --name code-interpreter

要通过网关连接现有操作组，请执行以下操作：

agentcore add tool --harness my-research-agent \
  --type agentcore_gateway --name my-gateway \
  --gateway-arn arn:aws:bedrock-agentcore:us-west-2:123456789012:gateway/my-gw

第 2 步：配置模型和系统提示符

agentcore add harness \
  --name my-research-agent \
  --model-id us.anthropic.claude-sonnet-4-6-20250514-v1:0 \
  --system-prompt "You are a research assistant." \
  --tools agentcore-browser,code-interpreter

第 3 步：部署和调用

agentcore deploy
agentcore invoke --harness my-research-agent \
  --session-id "$(uuidgen)" \
  "Research tropical vacation options under $3k"

无需重新部署即可在任何调用中覆盖模型：

agentcore invoke --harness my-research-agent \
  --model-id us.anthropic.claude-opus-4-5-20251101-v1:0 \
  "Summarize this research paper"
内存

默认情况下启用。要将内存范围限定为个人用户，请传递--actor-id：

agentcore invoke --harness my-research-agent \
  --session-id "$(uuidgen)" --actor-id alice \
  "What did we discuss about the Portugal trip?"

每个演员都有独立的记忆。 Long-term 策略范围通过参与者 ID 提取知识。

常见问题

影响

我现有的代理会停止工作吗？

不。现有代理继续正常运行。所有 API（UpdateAgent、 GetAgent、 ListAgents、 DeleteAgent PrepareAgent、 InvokeAgent、操作组 API、知识库 API、别名 API 等）仍可供所有客户使用。仅限 CreateAgent InvokeInlineAgent 且仅限于未事先使用的帐户。

我怎么知道我的账户是否受到影响？

如果你的账户在过去 12 个月内有 Bedrock Agents 活动，那么你将被列入许可名单且不受影响。这适用于每个账户。如果您有多个 AWS 账户，则只有之前使用过 Bedrock Agents 的账户才会被列入许可名单。未事先使用过的账户在拨打 CreateAgent 或 InvokeInlineAgent时将收到 AccessDeniedException (HTTP 403)。

如果我的账户未被列入许可名单，我会看到什么错误？

错误代码: AccessDeniedException (HTTP 403)

消息：“基岩代理处于维护模式。未使用服务的帐户无法创建新代理。要了解更多信息，请参阅亚马逊 Bedrock Agents 经典维护模式。”

我需要采取行动吗？

不是立即。您的现有工作负载不受影响。但是，我们建议评估新代理 AgentCore 的开发和未来的迁移，因为Bedrock Agents Classic不会添加任何新功能。

我能否在 7 月 30 日之后在新账户中申请 Bedrock Agents 例外情况？

不。没有例外程序。 AWS 根据您的账户在过去 12 个月内是否有 Bedrock Agents 活动自动确定许可名单。如果您在新账户中需要代理功能，请使用提供同等和扩展功能的 Amazon Bedrock AgentCore 。

改名为 “Bedrock Agents Classic” 怎么样？

这只是命名更新。您无需执行任何操作。现有 API 命名空间（基岩代理）、软件开发工具包客户端、 CloudFormation资源类型和 IAM 操作前缀保持不变。

我的 CloudFormation、CDK 或 Terraform 模板还能用吗？

可以。创建或管理 Bedrock Agents 的现有 IaC 模板将继续适用于列入许可名单的账户。如果您在未事先使用 Bedrock 代理的情况下在账户中预置新环境，请在模板中改用 Amazon Bedrock AgentCore 资源。

Bedrock Agents Classic 中会有新的模型版本吗？

不。自维护模式生效之日（2026年7月30日）起，Bedrock Agents Classic中可用的模型目录已冻结。在此日期之后发布的新型号将通过以下方式上市 AgentCore. 亚马逊 Bedrock 本身（模型推断、知识库、Guardrails）继续获得新的模型。此限制仅适用于 Bedrock Agents 经典编排层。

Bedrock Agents Classic 的价格会发生变化吗？

Bedrock Agents Classic 本身不收取任何费用。与以前一样，您继续只为基础模型推理和任何相关资源（知识库、Lambda 调用等）付费。

迁移

推荐的迁移路径是什么？

AgentCore 是推荐的平台。有两种路径可用：

  • AgentCore harnes s — 基于配置的体验，类似于 Bedrock Agents Classic。声明您的模型、工具和指令； AgentCore 处理计算、内存、身份和可观测性。这是最接近基岩特工管理体验的模拟。

  • Code-defined 代理开启 AgentCore -适用于需要高级编排、多代理协作或自定义逻辑的工作负载。在托管基础设施上部署任何框架（Strands LangChain、OpenAI Agent SDK、Claude Agent SDK 或自定义）。 AgentCore

有自动迁移工具吗？

可以。GitHub网站上的 AWS 代理工具包中提供了代理技能，可指导您直接将 AgentCore Bedrock A gents Classic 迁移到哈萨克斯坦。该技能也可以通过 AWS MCP 服务器获得。有关安装和使用该技能的说明，请参阅GitHub网站上的 AWS README 代理工具包。首先提示 “帮我将基岩代理迁移到 AgentCore 安全带”。

迁移需要多长时间？

对于简单的代理（模型 + 操作组 + 知识库），CLI 导入或工具设置需要几个小时。主要工作包括审查生成的代码或在 AgentCore网关后面重新部署操作组。具有自定义协调器或多代理协作的复杂代理将需要更大量的代码工作。

有迁移的最后期限吗？

没有迁移截止日期。Bedrock Agents Classic 在维护模式下仍可供现有客户使用，没有计划的生命周期终止日期。但是，由于未计划新功能，我们建议迁移 AgentCore 到以受益于持续创新。

那我的基岩知识库呢？

知识库可以继续运行，不受维护模式的影响。迁移到时 AgentCore，通过 AgentCore 网关将它们连接。基础知识库资源保持不变。

那我的基岩护栏呢？

通过调用该模型时，在 Bedrock 模型上配置的护栏仍然适用。 AgentCore Agent-level 可以通过 AgentCore 网关策略强制执行护栏。

我还能使用相同的型号吗？

是的。 AgentCore 支持完整的 Bedrock 模型目录以及其他提供商（OpenAI、Gemini 和任何 OpenAI-compatible 端点）。您可以在会话中途在模型提供者之间切换，而无需重新部署。

那么多代理协作呢？

您可以使用任何支持的框架在 AgentCore 运行时构建多代理模式。托管工具支持代理即工具模式，用于更简单的多代理用例。

那在线代理呢？

在过去 12 个月内 InvokeInlineAgent 使用过的账户可以继续使用内联代理。对于新开发， AgentCore 托管工具提供了等效的临时代理功能以及其他功能（内存、状态会话、通过网关进行工具连接）。在线代理的迁移指南即将发布。

在哪些地区可 AgentCore 用？

AgentCore 在这些地区可用。如果您的 Bedrock Agents Classic 工作负载在尚不可用的区域运行，则可以继续在这些区域使用 Bedrock Agents Classic，同时将新开发迁移到 AgentCore 支持的区域。 AgentCore

定价和支持

要 AgentCore 花多少钱？

AgentCore 在其所有功能（运行时间、内存、网关）中使用基于消耗的定价。没有单独的线束编排费用。 AgentCore与 Bedrock Agents Classic 的内部提示相比，其代币效率更高，因此客户可能会看到相当或更低的模型推理成本。详情请参阅AgentCore定价。

其他资源