AWS bedrock-agentcore documentation change
Summary
Added section on creating gateways with semantic search, including required permissions and configuration
Security assessment
Introduces documentation for a new semantic search feature with security considerations (required permissions for SynchronizeGatewayTargets). Enhances security documentation but does not fix vulnerabilities.
Diff
diff --git a/bedrock-agentcore/latest/devguide/create-gateway-methods.md b/bedrock-agentcore/latest/devguide/create-gateway-methods.md index f96a0d347..80f34eef5 100644 --- a//bedrock-agentcore/latest/devguide/create-gateway-methods.md +++ b//bedrock-agentcore/latest/devguide/create-gateway-methods.md @@ -4,0 +5,2 @@ +Create gateway with semantic search + @@ -70 +72,3 @@ Console - 1. Open the Amazon Bedrock AgentCore console at [https://console.aws.amazon.com/bedrock/home](https://console.aws.amazon.com/bedrock/home), and choose **Gateways**. + 1. Open the AgentCore console at [https://console.aws.amazon.com/bedrock-agentcore/](https://console.aws.amazon.com/bedrock-agentcore/). + + 2. Choose **Gateways**. @@ -72 +76 @@ Console - 2. Choose **Create gateway**. + 3. Choose **Create gateway**. @@ -74 +78 @@ Console - 3. In the **Gateway details** section: + 4. In the **Gateway details** section: @@ -86 +90 @@ Console - 4. In the **Inbound Identity** section, configure authentication for users accessing your gateway: + 5. In the **Inbound Identity** section, configure authentication for users accessing your gateway: @@ -92 +96 @@ Console - 5. In the **Permissions** section: + 6. In the **Permissions** section: @@ -98 +102 @@ Console - 6. In the **Target configuration** section: + 7. In the **Target configuration** section: @@ -128 +132 @@ Console - 7. To add more targets, choose **Add another target** and repeat the target configuration steps. + 8. To add more targets, choose **Add another target** and repeat the target configuration steps. @@ -130 +134 @@ Console - 8. Choose **Create gateway**. + 9. Choose **Create gateway**. @@ -218,0 +223,22 @@ This example creates a target using an OpenAPI schema for a product catalog serv +## Create gateway with semantic search + +Semantic search enables intelligent tool discovery so that we are not limited by typical list tools limits (typically 100 or so). Our semantic search capability delivers contextually relevant tool subsets, significantly improving tool selection accuracy through focused, relevant results, inference performance with reduced token processing and overall orchestration efficiency and response times. + +To enable it, add `"searchType": "SEMANTIC"` to the `CreateGateway` request in the top-level `protocolConfiguration` field: + + + "protocolConfiguration": { + "mcp": { + "searchType": "SEMANTIC" + } + } + +###### Note + +You can only enable it during create, you cannot update a gateway later to be able to support search. + +When creating a gateway with semantic search, ensure your management permissions have: + + + "Action": "SynchronizeGatewayTargets" +