View a markdown version of this page

Amazon Bedrock エージェント Classic メンテナンスモード - Amazon Bedrock

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

Amazon Bedrock エージェント 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 ゲートウェイ (REST APIs、Lambda 関数、またはコードレベルの @tools) を介して MCP ツールとして公開されるアクショングループ

  • ゲートウェイベースのナレッジベース統合

  • 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 エージェント Classic AgentCore と同等
マネージドオーケストレーションループ AgentCore ハーネスでout-of-the-boxサポート
OpenAPI / 関数スキーマ + マネージドエージェントから呼び出されるオプションの Lambda エグゼキュターで定義されるアクショングループ REST APIsと Lambda 関数またはコードレベルの @tools をラップする MCP ツールとして AgentCore ゲートウェイを介して公開されるツール。
RAG のエージェント設定での Bedrock ナレッジベースの直接の関連付け AgentCore でのゲートウェイフロントのナレッジベース統合。コードレベルの検索ツールからアクセスできるナレッジベース。
前処理、オーケストレーション、アクショングループの呼び出し、KB クエリ、観測値をend-to-endで表示するトレース 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、または Python 3.10+ と boto3

  • AWS AgentCore ハーネスが利用可能なリージョンの 認証情報。詳細については、AgentCore でサポートされている AWS リージョン」を参照してください。

  • 必要なアクセス許可を持つ IAM 実行ロール

  • (オプション) GitHubウェブサイトの AWS 用エージェントツールキットは、移行を通じて AI エージェントをガイドするための専門的なスキルを提供します。

のエージェントツールキットを使用して移行する AWS (推奨)

GitHub ウェブサイトの AWS 用エージェントツールキットには、AI エージェント (またはコーディングアシスタント) をend-to-endの移行に導くamazon-bedrockスキルが含まれています。既存の Bedrock エージェントを検査し、移行の適格性をチェックし、各コンポーネントを AgentCore ハーネスに相当するものにマッピングします。次に、スキルによって AgentCore CLI がハーネスをスキャフォールドしてデプロイします。ソースエージェントは変更されません。

スキルを使用するには:

  1. AWS 用の エージェントツールキットをインストールします。エージェントツールキットをインストールしてスキルを有効にする手順については、 GitHubウェブサイトの README AWS 用エージェントツールキットを参照してください。

  2. エージェントのamazon-bedrockスキルを有効にします。

  3. (オプション) AWS アクセスを合理化するには、 AWS MCP サーバーを設定します。スキルは CLI AWS および boto3 でも機能します。

  4. AgentCore CLI の最新バージョンをインストールします。スキルは AgentCore CLI を使用してハーネスをスキャフォールドおよびデプロイします。

  5. 「Bedrock Agent を 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 別にスコープします。

よくある質問

Impact

既存のエージェントは機能しなくなりますか?

いいえ。既存のエージェントは引き続き正常に機能します。すべての APIs (UpdateAgent、GetAgent、ListAgents、DeleteAgent、PrepareAgent、InvokeAgent、アクショングループ APIs、ナレッジベース APIs、エイリアス APIs など) は、すべてのお客様が引き続き使用できます。CreateAgent と InvokeInlineAgent のみが、以前に使用されていないアカウントに対して制限されます。

アカウントが影響を受けているかどうかを確認するにはどうすればよいですか?

アカウントに過去 12 か月間に Bedrock エージェントアクティビティがある場合、許可リストに登録され、影響を受けません。これはアカウントごとに適用されます。複数のアカウントがある場合は、Bedrock Agents の以前の使用状況の AWS アカウントのみが許可リストに登録されます。以前に使用していないアカウントは、CreateAgent または InvokeInlineAgent を呼び出すときに AccessDeniedException (HTTP 403) を受け取ります。 InvokeInlineAgent

アカウントが許可リストに登録されていない場合、どのようなエラーが表示されますか?

エラーコード: AccessDeniedException (HTTP 403)

メッセージ:「Bedrock エージェントはメンテナンスモードです。新しいエージェントの作成は、以前のサービスの使用がないアカウントでは使用できません。詳細については、「Amazon Bedrock Agents Classic メンテナンスモード」を参照してください。

アクションを実行する必要がありますか?

すぐにはダメです。既存のワークロードは影響を受けません。ただし、新しい機能は Bedrock Agents Classic に追加されないため、新しいエージェント開発と今後の移行のために AgentCore を評価することをお勧めします。

7 月 30 日以降に新しいアカウントの Bedrock エージェントに例外をリクエストできますか?

いいえ。例外プロセスはありません。 は、アカウントで過去 12 か月間に Bedrock エージェントアクティビティがあったかどうかに基づいて、許可リスト AWS を自動的に決定します。新しいアカウントでエージェント機能が必要な場合は、同等の拡張機能を提供する Amazon Bedrock AgentCore を使用します。

名前が「Bedrock Agents Classic」に変更されました。

これは命名の更新のみです。ユーザー操作は必要はありません。既存の API 名前空間 (bedrock-agent)、SDK クライアント、CloudFormation リソースタイプ、IAM アクションプレフィックスは変更されません。

CloudFormation、CDK、または Terraform テンプレートは引き続き機能しますか?

はい。Bedrock エージェントを作成または管理する既存の IaC テンプレートは、許可リストに登録されたアカウントでも引き続き機能します。Bedrock エージェントを以前に使用していないアカウントで新しい環境をプロビジョニングする場合は、代わりにテンプレートで Amazon Bedrock AgentCore リソースを使用します。

Bedrock Agents Classic で新しいモデルバージョンを利用できますか?

いいえ。Bedrock Agents Classic で利用可能なモデルカタログは、メンテナンスモードの発効日 (2026 年 7 月 30 日) の時点で凍結されています。それ以降にリリースされた新しいモデルは、AgentCore から入手できます。Amazon Bedrock 自体 (モデル推論、ナレッジベース、ガードレール) は、引き続き新しいモデルを受け取ります。この制限は Bedrock Agents Classic オーケストレーションレイヤーにのみ適用されます。

Bedrock Agents Classic の料金は変更されますか?

Bedrock Agents Classic 自体には料金はかかりません。基礎となるモデル推論および関連するリソース (ナレッジベース、Lambda 呼び出しなど) に対してのみ、以前と同様に引き続き料金が発生します。

移行

推奨される移行パスは何ですか?

AgentCore が推奨されるプラットフォームです。次の 2 つのパスを使用できます。

  • AgentCore ハーネス — Bedrock Agents Classic のような設定ベースのエクスペリエンス。モデル、ツール、指示を宣言します。AgentCore はコンピューティング、メモリ、アイデンティティ、オブザーバビリティを処理します。これは Bedrock Agents マネージドエクスペリエンスに最も近いアナログです。

  • AgentCore のコード定義エージェント — 高度なオーケストレーション、マルチエージェントコラボレーション、またはカスタムロジックを必要とするワークロード用。AgentCore のマネージドインフラストラクチャにフレームワーク (Strands、LangChain、OpenAI Agents SDK、Claude Agent SDK、またはカスタム) をデプロイします。

自動移行ツールはありますか?

はい。Bedrock Agents Classic を AgentCore ハーネスに直接移行するためのエージェントスキルは、 GitHubウェブサイトの AWS 用エージェントツールキットで入手できます。スキルは AWS MCP サーバーからも使用できます。スキルのインストールと使用の手順については、 GitHubウェブサイトの README AWS 用エージェントツールキットを参照してください。「Help me migrate my Bedrock Agent to AgentCore harness」というプロンプトから始めます。

移行にはどのくらいの時間がかかりますか?

わかりやすいエージェント (モデル + アクショングループ + ナレッジベース) の場合、CLI のインポートまたはハーネスの設定には数時間かかります。主な作業には、生成されたコードの確認または AgentCore ゲートウェイの背後にあるアクショングループの再デプロイが含まれます。カスタムオーケストレーターまたはマルチエージェントコラボレーションを使用する複雑なエージェントには、より重要なコード作業が必要になります。

移行には期限がありますか?

移行期限はありません。Bedrock Agents Classic は、メンテナンスモードで既存のお客様に引き続きご利用いただけます。end-of-lifeは予定されていません。ただし、新機能は計画されていないため、継続的なイノベーションの恩恵を受けるために AgentCore に移行することをお勧めします。

Bedrock ナレッジベースについてはどうですか?

ナレッジベースは引き続き機能し、メンテナンスモードの影響を受けません。AgentCore に移行するときは、AgentCore ゲートウェイ経由で接続します。基盤となるナレッジベースのリソースは変更されません。

Bedrock ガードレールについてはどうですか?

Bedrock モデルで設定されたガードレールは、モデルが AgentCore を介して呼び出された場合でも適用されます。エージェントレベルのガードレールの適用は、AgentCore ゲートウェイポリシーを通じて利用できます。

同じモデルを引き続き使用できますか?

はい。AgentCore は、完全な Bedrock モデルカタログと追加のプロバイダー (OpenAI、Gemini、および OpenAI 互換エンドポイント) をサポートしています。再デプロイすることなく、セッション中にモデルプロバイダーを切り替えることができます。

マルチエージェントコラボレーションについてはどうですか?

サポートされているフレームワークを使用してAgentCore ランタイムでマルチエージェントパターンを構築できます。マネージドハーネスは、よりシンプルなマルチエージェントユースケースのためのagent-as-toolパターンをサポートします。

インラインエージェントについてはどうですか?

過去 12 か月間に InvokeInlineAgent を使用したアカウントは、引き続きインラインエージェントを使用できます。新規開発の場合、AgentCore マネージドハーネスは同等のエフェメラルエージェント機能に加えて、追加機能 (メモリ、ステートフルセッション、ゲートウェイを介したツール接続) を提供します。インラインエージェントの移行ガイダンスが近づいています。

AgentCore はどのリージョンで利用できますか?

AgentCore は、これらのリージョンで使用できます。Bedrock Agents Classic ワークロードが AgentCore がまだ利用できないリージョンで実行されている場合、サポートされているリージョンで新しい開発を AgentCore に移行しながら、それらのリージョンで Bedrock Agents Classic を引き続き使用できます。

料金とサポート

AgentCore のコストはいくらですか?

AgentCore は、その機能 (ランタイム、メモリ、ゲートウェイ) 全体で消費ベースの料金を使用します。個別のハーネスオーケストレーション料金はかかりません。AgentCore のハーネスは Bedrock Agents Classic の内部プロンプトよりもトークン効率が高いため、お客様はモデル推論コストが同等またはより低い場合があります。詳細については、AgentCore の料金」を参照してください。

その他のリソース