AWS bedrock documentation change
Summary
Restructured API operation descriptions into bullet points and added new 'Important' section explaining cross-region inference mechanics, data residency, and encryption during transmission
Security assessment
The change adds documentation about encryption in transit and data residency controls, which are security features. However, there's no evidence this addresses a specific security vulnerability or incident.
Diff
diff --git a/bedrock/latest/userguide/knowledge-base-generate-query.md b/bedrock/latest/userguide/knowledge-base-generate-query.md index b43677b06..13f12e7c1 100644 --- a/bedrock/latest/userguide/knowledge-base-generate-query.md +++ b/bedrock/latest/userguide/knowledge-base-generate-query.md @@ -7 +7 @@ -If you connect a structured data store to your knowledge base, your knowledge base can query it by converting the natural language query provided by the user into an SQL query, based on the structure of the data source being queried. When you use [Retrieve](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html), the response returns the result of the SQL query execution. When you use [RetrieveAndGenerate](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html), the generated response is based on the result of the SQL query execution +When you connect a structured data store to your knowledge base, your knowledge base can query it by converting the natural language query provided by the user into an SQL query, based on the structure of the data source being queried. When you use: @@ -9 +9,18 @@ If you connect a structured data store to your knowledge base, your knowledge ba -Amazon Bedrock Knowledge Bases also allows you to decouple the conversion of the query from the retrieval process, by using the [GenerateQuery](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_GenerateQuery.html) API operation to transform a query into SQL. You can use the response with a subsequent `Retrieve` or `RetrieveAndGenerate` action, or insert it into other workflows. `GenerateQuery` allows you to efficiently transform queries into SQL queries by taking into consideration the structure of your knowledge base's data source. + * [Retrieve](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html): The response returns the result of the SQL query execution. + + * [RetrieveAndGenerate](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html): The generated response is based on the result of the SQL query execution. + + * [GenerateQuery](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_GenerateQuery.html): Amazon Bedrock Knowledge Bases decouples the conversion of the query from the retrieval process. You can use this API operation to transform a query into SQL. + + + + +###### Important + +Structured data retrieval uses cross-region inference to select the optimal AWS Region within your geography to process your inference request. This doesn't incur any additional charges, and improves customer experience by maximizing available resources and model availability. + +Cross-inference requests are kept within the AWS Regions that are part of the geography where the data originally resides. Your data remains stored within the source region but the input prompts and output results might move outside of this region. All data will be transmitted encrypted across Amazon’s secure network. + +For more information, see [Increase throughput with cross-region inference](./cross-region-inference.html). + +You can use the response from the `GenerateQuery` API operation with a subsequent `Retrieve` or `RetrieveAndGenerate` action, or insert it into other workflows. `GenerateQuery` allows you to efficiently transform queries into SQL queries by taking into consideration the structure of your knowledge base's data source.