View a markdown version of this page

Amazon Bedrock Agents Classic 維護模式 - Amazon Bedrock

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

Amazon Bedrock Agents Classic 維護模式

Amazon Bedrock Agents (2023 年 11 月推出) 現在為 Amazon Bedrock Agents Classic,自 2026 年 7 月 30 日起將不再向新客戶開放。如需類似 Amazon Bedrock Agents Classic 的功能,請探索 Amazon Bedrock AgentCore。Amazon Bedrock 將繼續可用,但 Agents Classic 服務將處於維護模式。

本指南提供 Amazon Bedrock Agents Classic 客戶維護模式遷移選項的相關資訊。

注意

Amazon Bedrock 持續受到完全支援。自 2026 年 7 月 30 日起,僅 Amazon Bedrock Agents Classic 服務不再向新客戶開放。您現有的 Amazon Bedrock 模型、知識庫和護欄不會受到影響。

遷移計劃

建議您將 Amazon Bedrock Agents Classic 工作負載遷移至 Amazon Bedrock AgentCore。AgentCore 是建置、連線和最佳化 AI 代理器的平台。AgentCore 中的受管設備提供以組態為基礎的起點,開發人員可以在其中宣告代理程式的模型、工具和指示。AgentCore 處理環境、運算、記憶體、身分和可觀測性。

AgentCore 中的受管代理程式範圍 (建議)

AgentCore 中的受管安全機制提供以組態為基礎的起點,建置器可以在其中宣告代理程式的模型、工具和指示。AgentCore 處理運算、環境、記憶體、身分和可觀測性。繫帶支援:

  • 具有內建工具連線能力的受管協同運作迴圈

  • 透過 AgentCore 閘道公開為 MCP 工具的動作群組 (REST APIs、Lambda 函數或程式碼層級 @tools)

  • 閘道前端知識庫整合

  • 用於return-of-control和human-in-the-loop內嵌函數工具

  • 沙盒化程式碼執行的程式碼解譯器

  • 具有可設定策略的短期和長期記憶體

  • 透過 AgentCore 閘道強制執行護欄

  • 持續、end-to-end追蹤所有代理程式動作

  • 整體代理程式行為的系統提示組態

AgentCore 上的程式碼定義代理程式

對於需要超出集合宣告模型功能的工作負載,客戶可以直接在 AgentCore 上部署程式碼定義的代理程式。此路徑支援:

  • 在特定協同運作階段的提示覆寫

  • 多客服人員協同合作和主管模式

  • 自訂協同運作邏輯

  • 更廣泛的 OpenAI 相容端點

  • 任何架構 (Strands、LangChain、OpenAI Agents SDK、Claude Agent SDK 或自訂)

程式碼定義的代理程式仍然受益於 AgentCore 的受管基礎設施,同時讓開發人員完全控制代理程式迴圈。

除非您有特定理由自行擁有迴圈 (例如,要遷移的現有代理程式程式碼庫,或尚未表達的進階協同運作),否則請使用該機制。客戶也可以使用 AgentCore CLI 匯入現有的 Bedrock Agents Classic 組態,做為任一路徑的起點。

比較功能

Bedrock 代理程式傳統 AgentCore 對等
受管協同運作迴圈 支援out-of-the-box AgentCore 架構
透過 OpenAPI/函數結構描述 + 選用 Lambda 執行器定義的動作群組,從受管代理程式呼叫 透過 AgentCore 閘道公開為包裝 REST APIs和 Lambda 函數或程式碼層級 @tools 的 MCP 工具。
Bedrock 知識庫直接與 RAG 代理程式組態的關聯 AgentCore 中的閘道前端知識庫整合。知識庫可透過程式碼層級擷取工具存取。
追蹤顯示end-to-end預先處理、協同運作、動作群組呼叫、KB 查詢和觀察的 UI 和 APIs AgentCore 提供所有代理程式動作的持久end-to-end追蹤。
在特定階段的提示覆寫組態 (預先處理、協同運作、產生 KB 回應、後製處理) 繫帶上的系統提示 (--system-prompt) 涵蓋了整體代理程式行為。階段特定的提示覆寫 (預先處理、產生 KB 回應、後製處理) 不會直接複寫。實現同等行為需要結合系統提示與命令執行和自我管理指令碼。
內建 AMAZON.UserInput 工具,可在協同運作期間自動使用者重新提示和參數引動 繫帶中的內嵌函數工具。代理程式會呼叫工具,將 tool_use 暫停並傳回用戶端程式碼,以處理使用者互動並傳回結果。等同於return-of-control。需要明確的工具定義,而不是自動引出。
沙盒化程式碼執行的內建 AMAZON.CodeInterpreter 動作群組 AgentCore 程式碼解譯器
代理程式上的工作階段和記憶體組態 (閒置 TTL、記憶體類型、跨工作階段記憶體) 短期和長期的 AgentCore 記憶體 (使用不同的記憶體策略)
以宣告方式連接到代理程式並在協同運作期間強制執行的護欄和代理程式政策 Bedrock 中的護欄組態,在 AgentCore 閘道上強制執行政策
多客服人員協作角色和轉接 (例如,主管客服人員和協同運作角色) 有限。主管模式可以透過將客服人員公開為 MCP 工具 (agent-as-tool來實現。路由模式多代理程式目前並不簡單。完整的多代理程式協同合作需要自訂架構程式碼。
自訂協調器 透過 AgentCore 執行時間支援 (直接部署自訂協同運作程式碼)。無法透過繫帶取得。
傳回控制項 (外部輸入的客服人員暫停) 繫帶中的內嵌函數工具。客服人員暫停,將 tool_use 傳回用戶端。

遷移程序

遷移至 AgentCore 機制的先決條件

  • Node.js 20+ 和 AgentCore CLI,或使用 boto3 的 Python 3.10+

  • AWS AgentCore harness 可用區域中的 登入資料。如需詳細資訊,請參閱 AgentCore 支援的 AWS 區域

  • 具有必要許可的 IAM 執行角色

  • (選用) GitHub網站上的 AWS 代理程式工具組提供專門的技能,引導您的 AI 代理程式完成遷移。

使用適用於 的代理程式工具組遷移 AWS (建議)

GitHub 網站上的 AWS 代理程式工具組包含一項amazon-bedrock技能,引導您的 AI 代理程式 (或編碼助理) end-to-end遷移。它會檢查您現有的 Bedrock 代理程式、檢查遷移資格,並將每個元件映射至其 AgentCore 繫帶對等項目。然後,這項技能會驅動 AgentCore CLI 來堆疊和部署繫帶。它永遠不會修改您的來源代理程式。

若要使用技能:

  1. 安裝適用於 AWS 的 代理程式工具組。如需安裝代理程式工具組和啟用技能的指示,請參閱 GitHub 網站上的適用於 AWS README 的代理程式工具組

  2. 為您的代理程式啟用amazon-bedrock技能。

  3. (選用) 若要簡化 AWS 存取,請設定 AWS MCP 伺服器。此技能也適用於 AWS CLI 和 boto3。

  4. 安裝最新版本的 AgentCore CLI。技能使用 AgentCore CLI 來堆疊和部署繫帶。

  5. 使用「協助我將 Bedrock 代理程式遷移至 AgentCore 機制」提示代理程式。在技能要求時,提供客服人員 ID、名稱或 ARN,以及 AWS 區域和設定檔。

  6. 在每個檢查點確認帳戶、區域和來源代理程式。此技能提供元件庫存、資格評估和書面遷移計劃。在部署之前,它會暫停等待您的核准。

您也可以使用 技能來回答遷移問題,而無需執行遷移。如果您的代理程式使用沒有經過驗證的繫帶路徑的功能,則技能會停止並建議替代方案。

手動遷移

如果您偏好在沒有技能的情況下進行遷移,或者您的代理程式不符合技能驅動型路徑的資格,請依照下列步驟使用 AgentCore CLI 建置工具。使用最新版本的 AgentCore CLI。

步驟 1:建立和設定

agentcore create --name my-research-agent

如果您有要複寫的現有 Bedrock 代理程式,請檢閱其組態 (模型、動作群組、KBs、提示覆寫),並將每個對應到對應的繫帶參數:

  • 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?"

每個演員都會取得隔離的記憶體。長期策略會依演員 ID 範圍擷取知識。

常見問答集

影響

我現有的客服人員是否會停止運作?

否。現有的客服人員會繼續正常運作。所有 APIs(UpdateAgent、GetAgent、ListAgentsDeleteAgent、 PrepareAgent、InvokeAgent、動作群組 APIs、知識庫 APIs、別名 APIs等) 仍可供所有客戶使用。只有 CreateAgent 和 InvokeInlineAgent 僅限於沒有先前使用的帳戶。

如何知道我的帳戶是否受到影響?

如果您的帳戶在過去 12 個月內曾有 Bedrock 代理程式活動,則會允許您列出且不受影響。這適用於每個帳戶。如果您有多個 AWS 帳戶,則僅允許列出先前使用 Bedrock 代理程式的帳戶。沒有先前用量的帳戶在呼叫 CreateAgent 或 InvokeInlineAgent 時,會收到 AccessDeniedException (HTTP 403)。

如果我的帳戶未列入允許清單,會看到什麼錯誤?

錯誤代碼:AccessDeniedException (HTTP 403)

訊息:「Bedrock Agents 處於維護模式。新代理程式建立不適用於沒有先前服務用量的帳戶。若要進一步了解,請參閱 Amazon Bedrock Agents Classic 維護模式。」

我需要採取動作嗎?

不立即。您現有的工作負載不會受到影響。不過,我們建議您評估 AgentCore 是否有新的代理程式開發和未來的遷移,因為 Bedrock Agents Classic 不會新增任何新功能。

我可以在 7 月 30 日之後向新帳戶中的 Bedrock 代理程式請求例外嗎?

否。沒有例外狀況程序。根據您的帳戶在過去 12 個月內是否有 Bedrock 代理程式活動, AWS 自動決定允許清單。如果您需要新帳戶中的代理程式功能,請使用 Amazon Bedrock AgentCore,它提供同等且擴展的功能。

名稱會變更為「Bedrock Agents Classic」嗎?

這只是命名更新。您不需要執行任何操作。現有的 API 命名空間 (bedrock-agent)、SDK 用戶端、CloudFormation 資源類型和 IAM 動作字首保持不變。

我的 CloudFormation、CDK 或 Terraform 範本是否仍然有效?

是。建立或管理 Bedrock 代理程式的現有 IaC 範本將繼續適用於允許清單的帳戶。如果您在沒有先前 Bedrock Agents 使用量的帳戶中佈建新環境,請改為在範本中使用 Amazon Bedrock AgentCore 資源。

Bedrock Agents Classic 是否會提供新的模型版本?

否。Batrock Agents Classic 中可用的模型目錄自維護模式生效日期 (2026 年 7 月 30 日) 起凍結。在該日期之後發行的新模型將透過 AgentCore 提供。Amazon Bedrock 本身 (模型推論、知識庫、護欄) 會繼續接收新模型。此限制僅適用於 Bedrock Agents Classic 協同運作層。

Bedrock Agents Classic 定價是否會變更?

Bedrock Agents Classic 本身無需付費。您繼續像以前一樣僅支付基礎模型推論和任何相關資源 (知識基礎、Lambda 調用等) 的費用。

移轉

什麼是建議的遷移路徑?

AgentCore 是建議的平台。有兩個可用的路徑:

  • AgentCore 繫帶 — 類似 Bedrock Agents Classic 的組態型體驗。宣告您的模型、工具和指示;AgentCore 會處理運算、記憶體、身分和可觀測性。這是 Bedrock 代理程式受管體驗最接近的類比。

  • AgentCore 上的程式碼定義代理程式 — 適用於需要進階協同運作、多重代理程式協同合作或自訂邏輯的工作負載。在 AgentCore 的受管基礎設施上部署任何架構 (Strands、LangChain、OpenAI Agents SDK、Claude Agent SDK 或自訂)。

是否有自動遷移工具?

是。您可以在 GitHub 網站的 AWS 代理工具組中找到引導您直接遷移 Bedrock Agents Classic 到 AgentCore 的代理程式技能。 https://github.com/aws/agent-toolkit-for-aws技能也可以透過 AWS MCP 伺服器取得。如需安裝和使用技能的指示,請參閱 GitHub 網站上的適用於 AWS README 的 代理程式工具組。從提示開始「協助我將 Bedrock Agent 遷移至 AgentCore 繫帶」。

遷移需要多長時間?

對於直接的客服人員 (模型 + 動作群組 + 知識庫),CLI 匯入或工具設定需要數小時。主要工作包括檢閱產生的程式碼,或在 AgentCore 閘道後方重新部署動作群組。具有自訂協調器或多代理協同合作的複雜代理程式需要更重要的程式碼工作。

遷移是否有截止日期?

沒有遷移截止日期。Bedrock Agents Classic 仍然可供維護模式中的現有客戶使用,沒有計劃的end-of-life。不過,由於未規劃新功能,我們建議您遷移至 AgentCore,以受益於持續創新。

我的 Bedrock 知識庫呢?

知識庫會繼續運作,不受維護模式影響。遷移至 AgentCore 時,請透過 AgentCore 閘道連接它們。基礎知識庫資源保持不變。

我的 Bedrock 護欄呢?

透過 AgentCore 叫用模型時,在 Bedrock 模型上設定的護欄仍然適用。代理程式層級護欄強制執行可透過 AgentCore 閘道政策取得。

我是否仍然可以使用相同的模型?

是。AgentCore 支援完整的 Bedrock 模型目錄和其他供應商 (OpenAI、Gemini 和任何與 OpenAI 相容的端點)。您可以在工作階段中切換模型提供者,無需重新部署。

多代理程式協同合作呢?

您可以使用任何支援的架構,在 AgentCore 執行時間上建置多代理程式模式。受管繫帶支援agent-as-tool模式,適用於更簡單的多代理程式使用案例。

內嵌客服人員呢?

在過去 12 個月內使用 InvokeInlineAgent 的帳戶可以繼續使用內嵌代理程式。對於新開發,AgentCore 受管設備提供同等暫時性代理程式功能和其他功能 (記憶體、具狀態工作階段、透過閘道的工具連線)。內嵌客服人員的遷移指引即將推出。

AgentCore 可在哪些區域中使用?

AgentCore 可在這些區域使用。如果您的 Bedrock Agents Classic 工作負載在尚未提供 AgentCore 的區域中執行,您可以在這些區域中繼續使用 Bedrock Agents Classic,同時將支援區域中的新開發遷移至 AgentCore。

定價和支援

AgentCore 的費用是多少?

AgentCore 在其功能 (執行期、記憶體、閘道) 中使用以耗用為基礎的定價。沒有個別的繫帶協調費用。AgentCore 的架構比 Bedrock Agents Classic 的內部提示更具字符效率,因此客戶可能會看到相當或較低的模型推論成本。如需詳細資訊,請參閱 AgentCore 定價

其他資源