AWS cli documentation change
Summary
Added documentation for the 'memoryRecordSchema' structure and '--add-indexed-keys' option, enabling metadata schema definition and additional key indexing for Bedrock AgentCore Control memories. This includes metadata field definitions, extraction configurations, and validation rules.
Security assessment
The changes introduce validation constraints (allowedValues, maxItems, minValue/maxValue) and input sanitization patterns that enforce data integrity and prevent malformed inputs. While this improves security through input validation, there's no explicit reference to patching a vulnerability or addressing a specific security incident.
Diff
diff --git a/cli/latest/reference/bedrock-agentcore-control/update-memory.md b/cli/latest/reference/bedrock-agentcore-control/update-memory.md index 100675a99..6dc17a7c6 100644 --- a//cli/latest/reference/bedrock-agentcore-control/update-memory.md +++ b//cli/latest/reference/bedrock-agentcore-control/update-memory.md @@ -15 +15 @@ - * [AWS CLI 2.34.38 Command Reference](../../index.html) » + * [AWS CLI 2.34.40 Command Reference](../../index.html) » @@ -72,0 +73 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/bedroc + [--add-indexed-keys <value>] @@ -234,0 +236,158 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/bedroc +>>>> +>>>> memoryRecordSchema -> (structure) +>>>> +>>>>> Schema for metadata on memory records generated by a strategy. +>>>>> +>>>>> metadataSchema -> (list) +>>>>> +>>>>>> The metadata field definitions for this strategy. +>>>>>> +>>>>>> Constraints: +>>>>>> +>>>>>> * min: `1` +>>>>>> * max: `20` +>>>>>> + +>>>>>> +>>>>>> (structure) +>>>>>> +>>>>>>> A metadata field definition within a strategy’s schema. +>>>>>>> +>>>>>>> key -> (string) [required] +>>>>>>> +>>>>>>>> The metadata field name. Must match an indexed key to be queryable via metadata filters. +>>>>>>>> +>>>>>>>> Constraints: +>>>>>>>> +>>>>>>>> * min: `1` +>>>>>>>> * max: `128` +>>>>>>>> * pattern: `[a-zA-Z0-9\s._:/=+@-]*` +>>>>>>>> + +>>>>>>> +>>>>>>> type -> (string) +>>>>>>> +>>>>>>>> The MetadataValueType. +>>>>>>>> +>>>>>>>> Possible values: +>>>>>>>> +>>>>>>>> * `STRING` +>>>>>>>> * `STRINGLIST` +>>>>>>>> * `NUMBER` +>>>>>>>> + +>>>>>>> +>>>>>>> extractionConfig -> (tagged union structure) +>>>>>>> +>>>>>>>> Configuration for extracting this metadata value from conversational content. +>>>>>>>> +>>>>>>>> ### Note +>>>>>>>> +>>>>>>>> This is a Tagged Union structure. Only one of the following top level keys can be set: `llmExtractionConfig`. +>>>>>>>> +>>>>>>>> llmExtractionConfig -> (structure) +>>>>>>>> +>>>>>>>>> Model-based extraction using a definition and instructions. +>>>>>>>>> +>>>>>>>>> llmExtractionInstruction -> (string) +>>>>>>>>> +>>>>>>>>>> Instructions for extraction. Supports built-in operators like LATEST_VALUE or custom natural-language instructions. +>>>>>>>>>> +>>>>>>>>>> Constraints: +>>>>>>>>>> +>>>>>>>>>> * min: `1` +>>>>>>>>>> * max: `1000` +>>>>>>>>>> + +>>>>>>>>> +>>>>>>>>> definition -> (string) [required] +>>>>>>>>> +>>>>>>>>>> Description of what this metadata field represents. +>>>>>>>>>> +>>>>>>>>>> Constraints: +>>>>>>>>>> +>>>>>>>>>> * min: `1` +>>>>>>>>>> * max: `1000` +>>>>>>>>>> + +>>>>>>>>> +>>>>>>>>> validation -> (tagged union structure) +>>>>>>>>> +>>>>>>>>>> Validation rules to constrain extracted values. +>>>>>>>>>> +>>>>>>>>>> ### Note +>>>>>>>>>> +>>>>>>>>>> This is a Tagged Union structure. Only one of the following top level keys can be set: `stringValidation`, `stringListValidation`, `numberValidation`. +>>>>>>>>>> +>>>>>>>>>> stringValidation -> (structure) +>>>>>>>>>> +>>>>>>>>>>> Validation for STRING fields. +>>>>>>>>>>> +>>>>>>>>>>> allowedValues -> (list) [required] +>>>>>>>>>>> +>>>>>>>>>>>> Allowed values for this STRING field. +>>>>>>>>>>>> +>>>>>>>>>>>> Constraints: +>>>>>>>>>>>> +>>>>>>>>>>>> * min: `1` +>>>>>>>>>>>> * max: `10` +>>>>>>>>>>>> + +>>>>>>>>>>>> +>>>>>>>>>>>> (string) +>>>>>>>>>>>> +>>>>>>>>>>>>> Constraints: +>>>>>>>>>>>>> +>>>>>>>>>>>>> * min: `1` +>>>>>>>>>>>>> * max: `256` +>>>>>>>>>>>>> * pattern: `[a-zA-Z0-9\s._:/=+@-]*` +>>>>>>>>>>>>> + +>>>>>>>>>> +>>>>>>>>>> stringListValidation -> (structure) +>>>>>>>>>> +>>>>>>>>>>> Validation for STRINGLIST fields. +>>>>>>>>>>> +>>>>>>>>>>> allowedValues -> (list) +>>>>>>>>>>> +>>>>>>>>>>>> Allowed values for items in this STRINGLIST field. +>>>>>>>>>>>> +>>>>>>>>>>>> Constraints: +>>>>>>>>>>>> +>>>>>>>>>>>> * min: `1` +>>>>>>>>>>>> * max: `10` +>>>>>>>>>>>> + +>>>>>>>>>>>> +>>>>>>>>>>>> (string) +>>>>>>>>>>>> +>>>>>>>>>>>>> Constraints: +>>>>>>>>>>>>> +>>>>>>>>>>>>> * min: `1` +>>>>>>>>>>>>> * max: `64` +>>>>>>>>>>>>> * pattern: `[a-zA-Z0-9\s._:/=+@-]*` +>>>>>>>>>>>>> + +>>>>>>>>>>> +>>>>>>>>>>> maxItems -> (integer) +>>>>>>>>>>> +>>>>>>>>>>>> Maximum number of items in the string list. +>>>>>>>>>>>> +>>>>>>>>>>>> Constraints: +>>>>>>>>>>>> +>>>>>>>>>>>> * min: `1` +>>>>>>>>>>>> * max: `5` +>>>>>>>>>>>> + +>>>>>>>>>> +>>>>>>>>>> numberValidation -> (structure) +>>>>>>>>>> +>>>>>>>>>>> Validation for NUMBER fields. +>>>>>>>>>>> +>>>>>>>>>>> minValue -> (double) +>>>>>>>>>>> +>>>>>>>>>>>> Minimum allowed value. +>>>>>>>>>>> +>>>>>>>>>>> maxValue -> (double) +>>>>>>>>>>> +>>>>>>>>>>>> Maximum allowed value. @@ -301,0 +461,158 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/bedroc +>>>> +>>>> memoryRecordSchema -> (structure) +>>>> +>>>>> Schema for metadata fields on records generated by this strategy. +>>>>> +>>>>> metadataSchema -> (list) +>>>>> +>>>>>> The metadata field definitions for this strategy. +>>>>>> +>>>>>> Constraints: +>>>>>> +>>>>>> * min: `1` +>>>>>> * max: `20` +>>>>>> + +>>>>>> +>>>>>> (structure) +>>>>>> +>>>>>>> A metadata field definition within a strategy’s schema. +>>>>>>> +>>>>>>> key -> (string) [required] +>>>>>>> +>>>>>>>> The metadata field name. Must match an indexed key to be queryable via metadata filters. +>>>>>>>> +>>>>>>>> Constraints: +>>>>>>>> +>>>>>>>> * min: `1` +>>>>>>>> * max: `128` +>>>>>>>> * pattern: `[a-zA-Z0-9\s._:/=+@-]*` +>>>>>>>> +