Amazon Bedrock AgentCore ランタイムターゲット

Amazon Bedrock AgentCore ランタイムエージェントをゲートウェイターゲットとして追加できます。ゲートウェイは、集約やプロトコル変換を行うことなく、トラフィックをランタイムエージェントに直接送信します。ツール機能を統合仮想 MCP サーバーに結合する MCP ターゲットとは異なり、AgentCore ランタイムターゲットは、クライアントとランタイムエージェントの間でリクエストとレスポンスを変更せずに転送します。

AgentCore ランタイムターゲットをゲートウェイに追加すると、次の場合に便利です。

主な考慮事項と制限事項

AgentCore ランタイムターゲットを使用する場合は、次の考慮事項に注意してください。

ターゲット設定

AgentCore ランタイムターゲットを作成するときは、ランタイム ARN とオプションの修飾子を指定します。ゲートウェイはランタイムエンドポイントを内部で解決するため、ランタイム URL を自分で構築する必要はありません。

AgentCore ランタイムターゲットのターゲット設定では、次の構造を使用します。

{
    "http": {
        "agentcoreRuntime": {
            "arn": "arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/RUNTIME_ID",
            "qualifier": "DEFAULT",
            "schema": {
                "source": {
                    "s3": {
                        "uri": "s3://DOC-EXAMPLE-BUCKET/agent-schema.yaml"
                    }
                }
            }
        }
    }
}

AgentCore ランタイムターゲットの呼び出し

ゲートウェイを介して AgentCore ランタイムターゲットを呼び出すには、ターゲットの呼び出し URL に POST リクエストを送信します。URL 形式は次のとおりです。

https://{gatewayId}.gateway.bedrock-agentcore.{region}.amazonaws.com/{targetName}/invocations

{gatewayId} をゲートウェイ ID、 {region} を AWS リージョン、 をターゲットの名前{targetName}に置き換えます。

次の例では、curl を使用して AgentCore ランタイムターゲットを呼び出します。

curl -X POST https://gateway-id.gateway.bedrock-agentcore.us-west-2.amazonaws.com/my-target/invocations \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <token>" \
    -d '{"input": {"prompt": "Hello"}}'

エンドポイント URL オーバーライドで Amazon Bedrock AgentCore SDK を使用することもできます。

aws bedrock-agentcore invoke-agent-runtime \
    --endpoint-url https://gateway-id.gateway.bedrock-agentcore.us-west-2.amazonaws.com/my-target \
    --runtimeArn arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/RUNTIME_ID

アウトバウンド認可

AgentCore ランタイムターゲットは、次のアウトバウンド認可タイプをサポートしています。

ゲートウェイを介したトラフィックの強制

AgentCore ランタイムを AgentCore Gateway でフロントして、ゲートウェイがランタイムへの単一の管理エントリポイントになるようにできます。これにより、ポリシーベースの認可、Amazon Bedrock ガードレール、リクエストとレスポンスのインターセプター、統合オブザーバビリティが提供され、すべてエージェント独自の環境外で適用されます。完全な理論的根拠については、「Front your runtime with an AgentCore Gateway」を参照してください。ただし、ゲートウェイをバイパスしてランタイムに直接アクセスできない場合にのみ便利です。ランタイムが IAM (SigV4) または OAuth (JWT) のインバウンド認可を使用しているかどうかに関係なく、これを実現できるようになりました。

この制限はランタイムに設定できます。ゲートウェイは転送するすべてのリクエストのソースをスタンプし、ランタイムはそのソースを途中で検証します。特定のメカニズムは、ランタイムのインバウンド認可タイプによって異なります。

MCP ターゲットとの機能の比較

MCP サーバーを Amazon Bedrock AgentCore ゲートウェイと統合するには、集約モードで MCP ターゲットタイプを使用するか、AgentCore ランタイムターゲットタイプを使用します。次の表は、各アプローチの機能を比較したものです。