2026/06/11 - Amazon Bedrock AgentCore Control - 5 updated api methods
Changes Adds support to perform cross account data plane actions on an AgentCore Memory resource
{'memoryStrategies': {'customMemoryStrategy': {'configuration': {'episodicOverride': {'reflection': {'memoryRecordSchema': {'metadataSchema': {'extractionType': 'LLM_INFERRED '
'| '
'STRICTLY_CONSISTENT'}}}}},
'memoryRecordSchema': {'metadataSchema': {'extractionType': 'LLM_INFERRED '
'| '
'STRICTLY_CONSISTENT'}}},
'episodicMemoryStrategy': {'memoryRecordSchema': {'metadataSchema': {'extractionType': 'LLM_INFERRED '
'| '
'STRICTLY_CONSISTENT'}},
'reflectionConfiguration': {'memoryRecordSchema': {'metadataSchema': {'extractionType': 'LLM_INFERRED '
'| '
'STRICTLY_CONSISTENT'}}}},
'semanticMemoryStrategy': {'memoryRecordSchema': {'metadataSchema': {'extractionType': 'LLM_INFERRED '
'| '
'STRICTLY_CONSISTENT'}}},
'summaryMemoryStrategy': {'memoryRecordSchema': {'metadataSchema': {'extractionType': 'LLM_INFERRED '
'| '
'STRICTLY_CONSISTENT'}}},
'userPreferenceMemoryStrategy': {'memoryRecordSchema': {'metadataSchema': {'extractionType': 'LLM_INFERRED '
'| '
'STRICTLY_CONSISTENT'}}}}}
Response {'memory': {'status': {'UPDATING'},
'strategies': {'configuration': {'reflection': {'customReflectionConfiguration': {'episodicReflectionOverride': {'memoryRecordSchema': {'metadataSchema': {'extractionType': 'LLM_INFERRED '
'| '
'STRICTLY_CONSISTENT'}}}},
'episodicReflectionConfiguration': {'memoryRecordSchema': {'metadataSchema': {'extractionType': 'LLM_INFERRED '
'| '
'STRICTLY_CONSISTENT'}}}}},
'memoryRecordSchema': {'metadataSchema': {'extractionType': 'LLM_INFERRED '
'| '
'STRICTLY_CONSISTENT'}}}}}
Creates a new Amazon Bedrock AgentCore Memory resource.
See also: AWS API Documentation
Request Syntax
client.create_memory(
clientToken='string',
name='string',
description='string',
encryptionKeyArn='string',
memoryExecutionRoleArn='string',
eventExpiryDuration=123,
memoryStrategies=[
{
'semanticMemoryStrategy': {
'name': 'string',
'description': 'string',
'namespaces': [
'string',
],
'namespaceTemplates': [
'string',
],
'memoryRecordSchema': {
'metadataSchema': [
{
'key': 'string',
'type': 'STRING'|'STRINGLIST'|'NUMBER',
'extractionType': 'LLM_INFERRED'|'STRICTLY_CONSISTENT',
'extractionConfig': {
'llmExtractionConfig': {
'llmExtractionInstruction': 'string',
'definition': 'string',
'validation': {
'stringValidation': {
'allowedValues': [
'string',
]
},
'stringListValidation': {
'allowedValues': [
'string',
],
'maxItems': 123
},
'numberValidation': {
'minValue': 123.0,
'maxValue': 123.0
}
}
}
}
},
]
}
},
'summaryMemoryStrategy': {
'name': 'string',
'description': 'string',
'namespaces': [
'string',
],
'namespaceTemplates': [
'string',
],
'memoryRecordSchema': {
'metadataSchema': [
{
'key': 'string',
'type': 'STRING'|'STRINGLIST'|'NUMBER',
'extractionType': 'LLM_INFERRED'|'STRICTLY_CONSISTENT',
'extractionConfig': {
'llmExtractionConfig': {
'llmExtractionInstruction': 'string',
'definition': 'string',
'validation': {
'stringValidation': {
'allowedValues': [
'string',
]
},
'stringListValidation': {
'allowedValues': [
'string',
],
'maxItems': 123
},
'numberValidation': {
'minValue': 123.0,
'maxValue': 123.0
}
}
}
}
},
]
}
},
'userPreferenceMemoryStrategy': {
'name': 'string',
'description': 'string',
'namespaces': [
'string',
],
'namespaceTemplates': [
'string',
],
'memoryRecordSchema': {
'metadataSchema': [
{
'key': 'string',
'type': 'STRING'|'STRINGLIST'|'NUMBER',
'extractionType': 'LLM_INFERRED'|'STRICTLY_CONSISTENT',
'extractionConfig': {
'llmExtractionConfig': {
'llmExtractionInstruction': 'string',
'definition': 'string',
'validation': {
'stringValidation': {
'allowedValues': [
'string',
]
},
'stringListValidation': {
'allowedValues': [
'string',
],
'maxItems': 123
},
'numberValidation': {
'minValue': 123.0,
'maxValue': 123.0
}
}
}
}
},
]
}
},
'customMemoryStrategy': {
'name': 'string',
'description': 'string',
'namespaces': [
'string',
],
'namespaceTemplates': [
'string',
],
'configuration': {
'semanticOverride': {
'extraction': {
'appendToPrompt': 'string',
'modelId': 'string'
},
'consolidation': {
'appendToPrompt': 'string',
'modelId': 'string'
}
},
'summaryOverride': {
'consolidation': {
'appendToPrompt': 'string',
'modelId': 'string'
}
},
'userPreferenceOverride': {
'extraction': {
'appendToPrompt': 'string',
'modelId': 'string'
},
'consolidation': {
'appendToPrompt': 'string',
'modelId': 'string'
}
},
'episodicOverride': {
'extraction': {
'appendToPrompt': 'string',
'modelId': 'string'
},
'consolidation': {
'appendToPrompt': 'string',
'modelId': 'string'
},
'reflection': {
'appendToPrompt': 'string',
'modelId': 'string',
'namespaces': [
'string',
],
'namespaceTemplates': [
'string',
],
'memoryRecordSchema': {
'metadataSchema': [
{
'key': 'string',
'type': 'STRING'|'STRINGLIST'|'NUMBER',
'extractionType': 'LLM_INFERRED'|'STRICTLY_CONSISTENT',
'extractionConfig': {
'llmExtractionConfig': {
'llmExtractionInstruction': 'string',
'definition': 'string',
'validation': {
'stringValidation': {
'allowedValues': [
'string',
]
},
'stringListValidation': {
'allowedValues': [
'string',
],
'maxItems': 123
},
'numberValidation': {
'minValue': 123.0,
'maxValue': 123.0
}
}
}
}
},
]
}
}
},
'selfManagedConfiguration': {
'triggerConditions': [
{
'messageBasedTrigger': {
'messageCount': 123
},
'tokenBasedTrigger': {
'tokenCount': 123
},
'timeBasedTrigger': {
'idleSessionTimeout': 123
}
},
],
'invocationConfiguration': {
'topicArn': 'string',
'payloadDeliveryBucketName': 'string'
},
'historicalContextWindowSize': 123
}
},
'memoryRecordSchema': {
'metadataSchema': [
{
'key': 'string',
'type': 'STRING'|'STRINGLIST'|'NUMBER',
'extractionType': 'LLM_INFERRED'|'STRICTLY_CONSISTENT',
'extractionConfig': {
'llmExtractionConfig': {
'llmExtractionInstruction': 'string',
'definition': 'string',
'validation': {
'stringValidation': {
'allowedValues': [
'string',
]
},
'stringListValidation': {
'allowedValues': [
'string',
],
'maxItems': 123
},
'numberValidation': {
'minValue': 123.0,
'maxValue': 123.0
}
}
}
}
},
]
}
},
'episodicMemoryStrategy': {
'name': 'string',
'description': 'string',
'namespaces': [
'string',
],
'namespaceTemplates': [
'string',
],
'reflectionConfiguration': {
'namespaces': [
'string',
],
'namespaceTemplates': [
'string',
],
'memoryRecordSchema': {
'metadataSchema': [
{
'key': 'string',
'type': 'STRING'|'STRINGLIST'|'NUMBER',
'extractionType': 'LLM_INFERRED'|'STRICTLY_CONSISTENT',
'extractionConfig': {
'llmExtractionConfig': {
'llmExtractionInstruction': 'string',
'definition': 'string',
'validation': {
'stringValidation': {
'allowedValues': [
'string',
]
},
'stringListValidation': {
'allowedValues': [
'string',
],
'maxItems': 123
},
'numberValidation': {
'minValue': 123.0,
'maxValue': 123.0
}
}
}
}
},
]
}
},
'memoryRecordSchema': {
'metadataSchema': [
{
'key': 'string',
'type': 'STRING'|'STRINGLIST'|'NUMBER',
'extractionType': 'LLM_INFERRED'|'STRICTLY_CONSISTENT',
'extractionConfig': {
'llmExtractionConfig': {
'llmExtractionInstruction': 'string',
'definition': 'string',
'validation': {
'stringValidation': {
'allowedValues': [
'string',
]
},
'stringListValidation': {
'allowedValues': [
'string',
],
'maxItems': 123
},
'numberValidation': {
'minValue': 123.0,
'maxValue': 123.0
}
}
}
}
},
]
}
}
},
],
indexedKeys=[
{
'key': 'string',
'type': 'STRING'|'STRINGLIST'|'NUMBER'
},
],
streamDeliveryResources={
'resources': [
{
'kinesis': {
'dataStreamArn': 'string',
'contentConfigurations': [
{
'type': 'MEMORY_RECORDS',
'level': 'METADATA_ONLY'|'FULL_CONTENT'
},
]
}
},
]
},
tags={
'string': 'string'
}
)
string
A unique, case-sensitive identifier to ensure that the operation completes no more than one time. If this token matches a previous request, Amazon Bedrock ignores the request but does not return an error.
This field is autopopulated if not provided.
string
[REQUIRED]
The name of the memory. The name must be unique within your account.
string
The description of the memory.
string
The Amazon Resource Name (ARN) of the KMS key used to encrypt the memory data.
string
The Amazon Resource Name (ARN) of the IAM role that provides permissions for the memory to access Amazon Web Services services.
integer
[REQUIRED]
The duration after which memory events expire. Specified as an ISO 8601 duration.
list
The memory strategies to use for this memory. Strategies define how information is extracted, processed, and consolidated.
(dict) --
Contains input information for creating a memory strategy.
semanticMemoryStrategy (dict) --
Input for creating a semantic memory strategy.
name (string) -- [REQUIRED]
The name of the semantic memory strategy.
description (string) --
The description of the semantic memory strategy.
namespaces (list) --
This is a legacy parameter, use namespaceTemplates. The namespaces associated with the semantic memory strategy.
(string) --
namespaceTemplates (list) --
The namespaceTemplates associated with the semantic memory strategy.
(string) --
memoryRecordSchema (dict) --
Schema for metadata on memory records generated by a strategy.
metadataSchema (list) --
The metadata field definitions for this strategy.
(dict) --
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.
type (string) --
The MetadataValueType.
extractionType (string) --
Specifies whether the metadata value is extracted by the LLM or passed through deterministically from the event.
extractionConfig (dict) --
Configuration for extracting this metadata value from conversational content. Applicable only if extractionType is LLM inferred.
llmExtractionConfig (dict) --
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.
definition (string) -- [REQUIRED]
Description of what this metadata field represents.
validation (dict) --
Validation rules to constrain extracted values.
stringValidation (dict) --
Validation for STRING fields.
allowedValues (list) -- [REQUIRED]
Allowed values for this STRING field.
(string) --
stringListValidation (dict) --
Validation for STRINGLIST fields.
allowedValues (list) --
Allowed values for items in this STRINGLIST field.
(string) --
maxItems (integer) --
Maximum number of items in the string list.
numberValidation (dict) --
Validation for NUMBER fields.
minValue (float) --
Minimum allowed value.
maxValue (float) --
Maximum allowed value.
summaryMemoryStrategy (dict) --
Input for creating a summary memory strategy.
name (string) -- [REQUIRED]
The name of the summary memory strategy.
description (string) --
The description of the summary memory strategy.
namespaces (list) --
This is a legacy parameter, use namespaceTemplates. The namespaces associated with the summary memory strategy.
(string) --
namespaceTemplates (list) --
The namespaceTemplates associated with the summary memory strategy.
(string) --
memoryRecordSchema (dict) --
Schema for metadata fields on records generated by this strategy.
metadataSchema (list) --
The metadata field definitions for this strategy.
(dict) --
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.
type (string) --
The MetadataValueType.
extractionType (string) --
Specifies whether the metadata value is extracted by the LLM or passed through deterministically from the event.
extractionConfig (dict) --
Configuration for extracting this metadata value from conversational content. Applicable only if extractionType is LLM inferred.
llmExtractionConfig (dict) --
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.
definition (string) -- [REQUIRED]
Description of what this metadata field represents.
validation (dict) --
Validation rules to constrain extracted values.
stringValidation (dict) --
Validation for STRING fields.
allowedValues (list) -- [REQUIRED]
Allowed values for this STRING field.
(string) --
stringListValidation (dict) --
Validation for STRINGLIST fields.
allowedValues (list) --
Allowed values for items in this STRINGLIST field.
(string) --
maxItems (integer) --
Maximum number of items in the string list.
numberValidation (dict) --
Validation for NUMBER fields.
minValue (float) --
Minimum allowed value.
maxValue (float) --
Maximum allowed value.
userPreferenceMemoryStrategy (dict) --
Input for creating a user preference memory strategy.
name (string) -- [REQUIRED]
The name of the user preference memory strategy.
description (string) --
The description of the user preference memory strategy.
namespaces (list) --
This is a legacy parameter, use namespaceTemplates. The namespaces associated with the user preference memory strategy.
(string) --
namespaceTemplates (list) --
The namespaceTemplates associated with the user preference memory strategy.
(string) --
memoryRecordSchema (dict) --
Schema for metadata fields on records generated by this strategy.
metadataSchema (list) --
The metadata field definitions for this strategy.
(dict) --
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.
type (string) --
The MetadataValueType.
extractionType (string) --
Specifies whether the metadata value is extracted by the LLM or passed through deterministically from the event.
extractionConfig (dict) --
Configuration for extracting this metadata value from conversational content. Applicable only if extractionType is LLM inferred.
llmExtractionConfig (dict) --
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.
definition (string) -- [REQUIRED]
Description of what this metadata field represents.
validation (dict) --
Validation rules to constrain extracted values.
stringValidation (dict) --
Validation for STRING fields.
allowedValues (list) -- [REQUIRED]
Allowed values for this STRING field.
(string) --
stringListValidation (dict) --
Validation for STRINGLIST fields.
allowedValues (list) --
Allowed values for items in this STRINGLIST field.
(string) --
maxItems (integer) --
Maximum number of items in the string list.
numberValidation (dict) --
Validation for NUMBER fields.
minValue (float) --
Minimum allowed value.
maxValue (float) --
Maximum allowed value.
customMemoryStrategy (dict) --
Input for creating a custom memory strategy.
name (string) -- [REQUIRED]
The name of the custom memory strategy.
description (string) --
The description of the custom memory strategy.
namespaces (list) --
This is a legacy parameter, use namespaceTemplates. The namespaces associated with the custom memory strategy.
(string) --
namespaceTemplates (list) --
The namespaceTemplates associated with the custom memory strategy.
(string) --
configuration (dict) --
The configuration for the custom memory strategy.
semanticOverride (dict) --
The semantic override configuration for a custom memory strategy.
extraction (dict) --
The extraction configuration for a semantic override.
appendToPrompt (string) -- [REQUIRED]
The text to append to the prompt for semantic extraction.
modelId (string) -- [REQUIRED]
The model ID to use for semantic extraction.
consolidation (dict) --
The consolidation configuration for a semantic override.
appendToPrompt (string) -- [REQUIRED]
The text to append to the prompt for semantic consolidation.
modelId (string) -- [REQUIRED]
The model ID to use for semantic consolidation.
summaryOverride (dict) --
The summary override configuration for a custom memory strategy.
consolidation (dict) --
The consolidation configuration for a summary override.
appendToPrompt (string) -- [REQUIRED]
The text to append to the prompt for summary consolidation.
modelId (string) -- [REQUIRED]
The model ID to use for summary consolidation.
userPreferenceOverride (dict) --
The user preference override configuration for a custom memory strategy.
extraction (dict) --
The extraction configuration for a user preference override.
appendToPrompt (string) -- [REQUIRED]
The text to append to the prompt for user preference extraction.
modelId (string) -- [REQUIRED]
The model ID to use for user preference extraction.
consolidation (dict) --
The consolidation configuration for a user preference override.
appendToPrompt (string) -- [REQUIRED]
The text to append to the prompt for user preference consolidation.
modelId (string) -- [REQUIRED]
The model ID to use for user preference consolidation.
episodicOverride (dict) --
The episodic memory strategy override configuration for a custom memory strategy.
extraction (dict) --
Contains configurations for overriding the extraction step of the episodic memory strategy.
appendToPrompt (string) -- [REQUIRED]
The text to append to the prompt for the extraction step of the episodic memory strategy.
modelId (string) -- [REQUIRED]
The model ID to use for the extraction step of the episodic memory strategy.
consolidation (dict) --
Contains configurations for overriding the consolidation step of the episodic memory strategy.
appendToPrompt (string) -- [REQUIRED]
The text to append to the prompt for the consolidation step of the episodic memory strategy.
modelId (string) -- [REQUIRED]
The model ID to use for the consolidation step of the episodic memory strategy.
reflection (dict) --
Contains configurations for overriding the reflection step of the episodic memory strategy.
appendToPrompt (string) -- [REQUIRED]
The text to append to the prompt for reflection step of the episodic memory strategy.
modelId (string) -- [REQUIRED]
The model ID to use for the reflection step of the episodic memory strategy.
namespaces (list) --
This is a legacy parameter, use namespaceTemplates. The namespaces to use for episodic reflection. Can be less nested than the episodic namespaces.
(string) --
namespaceTemplates (list) --
The namespaceTemplates to use for episodic reflection. Can be less nested than the episodic namespaces.
(string) --
memoryRecordSchema (dict) --
Schema for metadata fields on records generated by this reflection override.
metadataSchema (list) --
The metadata field definitions for this strategy.
(dict) --
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.
type (string) --
The MetadataValueType.
extractionType (string) --
Specifies whether the metadata value is extracted by the LLM or passed through deterministically from the event.
extractionConfig (dict) --
Configuration for extracting this metadata value from conversational content. Applicable only if extractionType is LLM inferred.
llmExtractionConfig (dict) --
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.
definition (string) -- [REQUIRED]
Description of what this metadata field represents.
validation (dict) --
Validation rules to constrain extracted values.
stringValidation (dict) --
Validation for STRING fields.
allowedValues (list) -- [REQUIRED]
Allowed values for this STRING field.
(string) --
stringListValidation (dict) --
Validation for STRINGLIST fields.
allowedValues (list) --
Allowed values for items in this STRINGLIST field.
(string) --
maxItems (integer) --
Maximum number of items in the string list.
numberValidation (dict) --
Validation for NUMBER fields.
minValue (float) --
Minimum allowed value.
maxValue (float) --
Maximum allowed value.
selfManagedConfiguration (dict) --
The self managed configuration for a custom memory strategy.
triggerConditions (list) --
A list of conditions that trigger memory processing.
(dict) --
Condition that triggers memory processing.
messageBasedTrigger (dict) --
Message based trigger configuration.
messageCount (integer) --
The number of messages that trigger memory processing.
tokenBasedTrigger (dict) --
Token based trigger configuration.
tokenCount (integer) --
Number of tokens that trigger memory processing.
timeBasedTrigger (dict) --
Time based trigger configuration.
idleSessionTimeout (integer) --
Idle session timeout (seconds) that triggers memory processing.
invocationConfiguration (dict) -- [REQUIRED]
Configuration to invoke a self-managed memory processing pipeline with.
topicArn (string) -- [REQUIRED]
The ARN of the SNS topic for job notifications.
payloadDeliveryBucketName (string) -- [REQUIRED]
The S3 bucket name for event payload delivery.
historicalContextWindowSize (integer) --
Number of historical messages to include in processing context.
memoryRecordSchema (dict) --
Schema for metadata fields on records generated by this strategy.
metadataSchema (list) --
The metadata field definitions for this strategy.
(dict) --
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.
type (string) --
The MetadataValueType.
extractionType (string) --
Specifies whether the metadata value is extracted by the LLM or passed through deterministically from the event.
extractionConfig (dict) --
Configuration for extracting this metadata value from conversational content. Applicable only if extractionType is LLM inferred.
llmExtractionConfig (dict) --
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.
definition (string) -- [REQUIRED]
Description of what this metadata field represents.
validation (dict) --
Validation rules to constrain extracted values.
stringValidation (dict) --
Validation for STRING fields.
allowedValues (list) -- [REQUIRED]
Allowed values for this STRING field.
(string) --
stringListValidation (dict) --
Validation for STRINGLIST fields.
allowedValues (list) --
Allowed values for items in this STRINGLIST field.
(string) --
maxItems (integer) --
Maximum number of items in the string list.
numberValidation (dict) --
Validation for NUMBER fields.
minValue (float) --
Minimum allowed value.
maxValue (float) --
Maximum allowed value.
episodicMemoryStrategy (dict) --
Input for creating an episodic memory strategy
name (string) -- [REQUIRED]
The name of the episodic memory strategy.
description (string) --
The description of the episodic memory strategy.
namespaces (list) --
This is a legacy parameter, use namespaceTemplates. The namespaces for which to create episodes.
(string) --
namespaceTemplates (list) --
The namespaceTemplates for which to create episodes.
(string) --
reflectionConfiguration (dict) --
The configuration for the reflections created with the episodic memory strategy.
namespaces (list) --
This is a legacy parameter, use namespaceTemplates. The namespaces over which to create reflections. Can be less nested than episode namespaces.
(string) --
namespaceTemplates (list) --
The namespaceTemplates over which to create reflections. Can be less nested than episode namespaces.
(string) --
memoryRecordSchema (dict) --
Schema for metadata fields on records generated by reflections.
metadataSchema (list) --
The metadata field definitions for this strategy.
(dict) --
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.
type (string) --
The MetadataValueType.
extractionType (string) --
Specifies whether the metadata value is extracted by the LLM or passed through deterministically from the event.
extractionConfig (dict) --
Configuration for extracting this metadata value from conversational content. Applicable only if extractionType is LLM inferred.
llmExtractionConfig (dict) --
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.
definition (string) -- [REQUIRED]
Description of what this metadata field represents.
validation (dict) --
Validation rules to constrain extracted values.
stringValidation (dict) --
Validation for STRING fields.
allowedValues (list) -- [REQUIRED]
Allowed values for this STRING field.
(string) --
stringListValidation (dict) --
Validation for STRINGLIST fields.
allowedValues (list) --
Allowed values for items in this STRINGLIST field.
(string) --
maxItems (integer) --
Maximum number of items in the string list.
numberValidation (dict) --
Validation for NUMBER fields.
minValue (float) --
Minimum allowed value.
maxValue (float) --
Maximum allowed value.
memoryRecordSchema (dict) --
Schema for metadata fields on records generated by this strategy.
metadataSchema (list) --
The metadata field definitions for this strategy.
(dict) --
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.
type (string) --
The MetadataValueType.
extractionType (string) --
Specifies whether the metadata value is extracted by the LLM or passed through deterministically from the event.
extractionConfig (dict) --
Configuration for extracting this metadata value from conversational content. Applicable only if extractionType is LLM inferred.
llmExtractionConfig (dict) --
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.
definition (string) -- [REQUIRED]
Description of what this metadata field represents.
validation (dict) --
Validation rules to constrain extracted values.
stringValidation (dict) --
Validation for STRING fields.
allowedValues (list) -- [REQUIRED]
Allowed values for this STRING field.
(string) --
stringListValidation (dict) --
Validation for STRINGLIST fields.
allowedValues (list) --
Allowed values for items in this STRINGLIST field.
(string) --
maxItems (integer) --
Maximum number of items in the string list.
numberValidation (dict) --
Validation for NUMBER fields.
minValue (float) --
Minimum allowed value.
maxValue (float) --
Maximum allowed value.
list
Metadata keys to index for filtering. Once declared, indexed keys cannot be removed.
(dict) --
A metadata key indexed for filtering.
key (string) -- [REQUIRED]
The metadata key name to index.
type (string) -- [REQUIRED]
The data type of the indexed key.
dict
Configuration for streaming memory record data to external resources.
resources (list) -- [REQUIRED]
List of stream delivery resource configurations.
(dict) --
Supported stream delivery resource types.
kinesis (dict) --
Kinesis Data Stream configuration.
dataStreamArn (string) -- [REQUIRED]
ARN of the Kinesis Data Stream.
contentConfigurations (list) -- [REQUIRED]
Content configurations for stream delivery.
(dict) --
Defines what content to stream and at what level of detail.
type (string) -- [REQUIRED]
Type of content to stream.
level (string) --
Level of detail for streamed content.
dict
A map of tag keys and values to assign to an AgentCore Memory. Tags enable you to categorize your resources in different ways, for example, by purpose, owner, or environment.
(string) --
(string) --
dict
Response Syntax
{
'memory': {
'arn': 'string',
'id': 'string',
'name': 'string',
'description': 'string',
'encryptionKeyArn': 'string',
'memoryExecutionRoleArn': 'string',
'eventExpiryDuration': 123,
'status': 'CREATING'|'ACTIVE'|'FAILED'|'DELETING'|'UPDATING',
'failureReason': 'string',
'createdAt': datetime(2015, 1, 1),
'updatedAt': datetime(2015, 1, 1),
'strategies': [
{
'strategyId': 'string',
'name': 'string',
'description': 'string',
'configuration': {
'type': 'SEMANTIC_OVERRIDE'|'SUMMARY_OVERRIDE'|'USER_PREFERENCE_OVERRIDE'|'SELF_MANAGED'|'EPISODIC_OVERRIDE',
'extraction': {
'customExtractionConfiguration': {
'semanticExtractionOverride': {
'appendToPrompt': 'string',
'modelId': 'string'
},
'userPreferenceExtractionOverride': {
'appendToPrompt': 'string',
'modelId': 'string'
},
'episodicExtractionOverride': {
'appendToPrompt': 'string',
'modelId': 'string'
}
}
},
'consolidation': {
'customConsolidationConfiguration': {
'semanticConsolidationOverride': {
'appendToPrompt': 'string',
'modelId': 'string'
},
'summaryConsolidationOverride': {
'appendToPrompt': 'string',
'modelId': 'string'
},
'userPreferenceConsolidationOverride': {
'appendToPrompt': 'string',
'modelId': 'string'
},
'episodicConsolidationOverride': {
'appendToPrompt': 'string',
'modelId': 'string'
}
}
},
'reflection': {
'customReflectionConfiguration': {
'episodicReflectionOverride': {
'appendToPrompt': 'string',
'modelId': 'string',
'namespaces': [
'string',
],
'namespaceTemplates': [
'string',
],
'memoryRecordSchema': {
'metadataSchema': [
{
'key': 'string',
'type': 'STRING'|'STRINGLIST'|'NUMBER',
'extractionType': 'LLM_INFERRED'|'STRICTLY_CONSISTENT',
'extractionConfig': {
'llmExtractionConfig': {
'llmExtractionInstruction': 'string',
'definition': 'string',
'validation': {
'stringValidation': {
'allowedValues': [
'string',
]
},
'stringListValidation': {
'allowedValues': [
'string',
],
'maxItems': 123
},
'numberValidation': {
'minValue': 123.0,
'maxValue': 123.0
}
}
}
}
},
]
}
}
},
'episodicReflectionConfiguration': {
'namespaces': [
'string',
],
'namespaceTemplates': [
'string',
],
'memoryRecordSchema': {
'metadataSchema': [
{
'key': 'string',
'type': 'STRING'|'STRINGLIST'|'NUMBER',
'extractionType': 'LLM_INFERRED'|'STRICTLY_CONSISTENT',
'extractionConfig': {
'llmExtractionConfig': {
'llmExtractionInstruction': 'string',
'definition': 'string',
'validation': {
'stringValidation': {
'allowedValues': [
'string',
]
},
'stringListValidation': {
'allowedValues': [
'string',
],
'maxItems': 123
},
'numberValidation': {
'minValue': 123.0,
'maxValue': 123.0
}
}
}
}
},
]
}
}
},
'selfManagedConfiguration': {
'triggerConditions': [
{
'messageBasedTrigger': {
'messageCount': 123
},
'tokenBasedTrigger': {
'tokenCount': 123
},
'timeBasedTrigger': {
'idleSessionTimeout': 123
}
},
],
'invocationConfiguration': {
'topicArn': 'string',
'payloadDeliveryBucketName': 'string'
},
'historicalContextWindowSize': 123
}
},
'type': 'SEMANTIC'|'SUMMARIZATION'|'USER_PREFERENCE'|'CUSTOM'|'EPISODIC',
'namespaces': [
'string',
],
'namespaceTemplates': [
'string',
],
'createdAt': datetime(2015, 1, 1),
'updatedAt': datetime(2015, 1, 1),
'status': 'CREATING'|'ACTIVE'|'DELETING'|'FAILED',
'memoryRecordSchema': {
'metadataSchema': [
{
'key': 'string',
'type': 'STRING'|'STRINGLIST'|'NUMBER',
'extractionType': 'LLM_INFERRED'|'STRICTLY_CONSISTENT',
'extractionConfig': {
'llmExtractionConfig': {
'llmExtractionInstruction': 'string',
'definition': 'string',
'validation': {
'stringValidation': {
'allowedValues': [
'string',
]
},
'stringListValidation': {
'allowedValues': [
'string',
],
'maxItems': 123
},
'numberValidation': {
'minValue': 123.0,
'maxValue': 123.0
}
}
}
}
},
]
}
},
],
'indexedKeys': [
{
'key': 'string',
'type': 'STRING'|'STRINGLIST'|'NUMBER'
},
],
'streamDeliveryResources': {
'resources': [
{
'kinesis': {
'dataStreamArn': 'string',
'contentConfigurations': [
{
'type': 'MEMORY_RECORDS',
'level': 'METADATA_ONLY'|'FULL_CONTENT'
},
]
}
},
]
}
}
}
Response Structure
(dict) --
memory (dict) --
The details of the created memory, including its ID, ARN, name, description, and configuration settings.
arn (string) --
The Amazon Resource Name (ARN) of the memory.
id (string) --
The unique identifier of the memory.
name (string) --
The name of the memory.
description (string) --
The description of the memory.
encryptionKeyArn (string) --
The ARN of the KMS key used to encrypt the memory.
memoryExecutionRoleArn (string) --
The ARN of the IAM role that provides permissions for the memory.
eventExpiryDuration (integer) --
The number of days after which memory events will expire.
status (string) --
The current status of the memory.
failureReason (string) --
The reason for failure if the memory is in a failed state.
createdAt (datetime) --
The timestamp when the memory was created.
updatedAt (datetime) --
The timestamp when the memory was last updated.
strategies (list) --
The list of memory strategies associated with this memory.
(dict) --
Contains information about a memory strategy.
strategyId (string) --
The unique identifier of the memory strategy.
name (string) --
The name of the memory strategy.
description (string) --
The description of the memory strategy.
configuration (dict) --
The configuration of the memory strategy.
type (string) --
The type of override for the strategy configuration.
extraction (dict) --
The extraction configuration for the memory strategy.
customExtractionConfiguration (dict) --
The custom extraction configuration.
semanticExtractionOverride (dict) --
The semantic extraction override configuration.
appendToPrompt (string) --
The text to append to the prompt for semantic extraction.
modelId (string) --
The model ID to use for semantic extraction.
userPreferenceExtractionOverride (dict) --
The user preference extraction override configuration.
appendToPrompt (string) --
The text to append to the prompt for user preference extraction.
modelId (string) --
The model ID to use for user preference extraction.
episodicExtractionOverride (dict) --
The configurations to override the default extraction step for the episodic memory strategy.
appendToPrompt (string) --
The text appended to the prompt for the extraction step of the episodic memory strategy.
modelId (string) --
The model ID used for the extraction step of the episodic memory strategy.
consolidation (dict) --
The consolidation configuration for the memory strategy.
customConsolidationConfiguration (dict) --
The custom consolidation configuration.
semanticConsolidationOverride (dict) --
The semantic consolidation override configuration.
appendToPrompt (string) --
The text to append to the prompt for semantic consolidation.
modelId (string) --
The model ID to use for semantic consolidation.
summaryConsolidationOverride (dict) --
The summary consolidation override configuration.
appendToPrompt (string) --
The text to append to the prompt for summary consolidation.
modelId (string) --
The model ID to use for summary consolidation.
userPreferenceConsolidationOverride (dict) --
The user preference consolidation override configuration.
appendToPrompt (string) --
The text to append to the prompt for user preference consolidation.
modelId (string) --
The model ID to use for user preference consolidation.
episodicConsolidationOverride (dict) --
The configurations to override the default consolidation step for the episodic memory strategy.
appendToPrompt (string) --
The text appended to the prompt for the consolidation step of the episodic memory strategy.
modelId (string) --
The model ID used for the consolidation step of the episodic memory strategy.
reflection (dict) --
The reflection configuration for the memory strategy.
customReflectionConfiguration (dict) --
The configuration for a custom reflection strategy.
episodicReflectionOverride (dict) --
The configuration for a reflection strategy to override the default one.
appendToPrompt (string) --
The text appended to the prompt for the reflection step of the episodic memory strategy.
modelId (string) --
The model ID used for the reflection step of the episodic memory strategy.
namespaces (list) --
This is a legacy parameter. The namespaces over which reflections were created. Can be less nested than the episodic namespaces.
(string) --
namespaceTemplates (list) --
The namespaceTemplates over which reflections were created. Can be less nested than the episodic namespaces.
(string) --
memoryRecordSchema (dict) --
Schema for metadata fields on records generated by this reflection override.
metadataSchema (list) --
The metadata field definitions for this strategy.
(dict) --
A metadata field definition within a strategy's schema.
key (string) --
The metadata field name. Must match an indexed key to be queryable via metadata filters.
type (string) --
The MetadataValueType.
extractionType (string) --
Specifies whether the metadata value is extracted by the LLM or passed through deterministically from the event.
extractionConfig (dict) --
Configuration for extracting this metadata value from conversational content. Applicable only if extractionType is LLM inferred.
llmExtractionConfig (dict) --
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.
definition (string) --
Description of what this metadata field represents.
validation (dict) --
Validation rules to constrain extracted values.
stringValidation (dict) --
Validation for STRING fields.
allowedValues (list) --
Allowed values for this STRING field.
(string) --
stringListValidation (dict) --
Validation for STRINGLIST fields.
allowedValues (list) --
Allowed values for items in this STRINGLIST field.
(string) --
maxItems (integer) --
Maximum number of items in the string list.
numberValidation (dict) --
Validation for NUMBER fields.
minValue (float) --
Minimum allowed value.
maxValue (float) --
Maximum allowed value.
episodicReflectionConfiguration (dict) --
The configuration for the episodic reflection strategy.
namespaces (list) --
This is a legacy parameter, use namespaceTemplates. The namespaces for which to create reflections. Can be less nested than the episodic namespaces.
(string) --
namespaceTemplates (list) --
The namespaceTemplates for which to create reflections. Can be less nested than the episodic namespaces.
(string) --
memoryRecordSchema (dict) --
"Schema for metadata fields on records generated by reflections.
metadataSchema (list) --
The metadata field definitions for this strategy.
(dict) --
A metadata field definition within a strategy's schema.
key (string) --
The metadata field name. Must match an indexed key to be queryable via metadata filters.
type (string) --
The MetadataValueType.
extractionType (string) --
Specifies whether the metadata value is extracted by the LLM or passed through deterministically from the event.
extractionConfig (dict) --
Configuration for extracting this metadata value from conversational content. Applicable only if extractionType is LLM inferred.
llmExtractionConfig (dict) --
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.
definition (string) --
Description of what this metadata field represents.
validation (dict) --
Validation rules to constrain extracted values.
stringValidation (dict) --
Validation for STRING fields.
allowedValues (list) --
Allowed values for this STRING field.
(string) --
stringListValidation (dict) --
Validation for STRINGLIST fields.
allowedValues (list) --
Allowed values for items in this STRINGLIST field.
(string) --
maxItems (integer) --
Maximum number of items in the string list.
numberValidation (dict) --
Validation for NUMBER fields.
minValue (float) --
Minimum allowed value.
maxValue (float) --
Maximum allowed value.
selfManagedConfiguration (dict) --
Self-managed configuration settings.
triggerConditions (list) --
A list of conditions that trigger memory processing.
(dict) --
Condition that triggers memory processing.
messageBasedTrigger (dict) --
Message based trigger configuration.
messageCount (integer) --
The number of messages that trigger memory processing.
tokenBasedTrigger (dict) --
Token based trigger configuration.
tokenCount (integer) --
Number of tokens that trigger memory processing.
timeBasedTrigger (dict) --
Time based trigger configuration.
idleSessionTimeout (integer) --
Idle session timeout (seconds) that triggers memory processing.
invocationConfiguration (dict) --
The configuration to use when invoking memory processing.
topicArn (string) --
The ARN of the SNS topic for job notifications.
payloadDeliveryBucketName (string) --
The S3 bucket name for event payload delivery.
historicalContextWindowSize (integer) --
The number of historical messages to include in processing context.
type (string) --
The type of the memory strategy.
namespaces (list) --
This is a legacy parameter. The namespaces associated with the memory strategy.
(string) --
namespaceTemplates (list) --
The namespaceTemplates associated with the memory strategy.
(string) --
createdAt (datetime) --
The timestamp when the memory strategy was created.
updatedAt (datetime) --
The timestamp when the memory strategy was last updated.
status (string) --
The current status of the memory strategy.
memoryRecordSchema (dict) --
Schema for metadata fields on records generated by this strategy.
metadataSchema (list) --
The metadata field definitions for this strategy.
(dict) --
A metadata field definition within a strategy's schema.
key (string) --
The metadata field name. Must match an indexed key to be queryable via metadata filters.
type (string) --
The MetadataValueType.
extractionType (string) --
Specifies whether the metadata value is extracted by the LLM or passed through deterministically from the event.
extractionConfig (dict) --
Configuration for extracting this metadata value from conversational content. Applicable only if extractionType is LLM inferred.
llmExtractionConfig (dict) --
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.
definition (string) --
Description of what this metadata field represents.
validation (dict) --
Validation rules to constrain extracted values.
stringValidation (dict) --
Validation for STRING fields.
allowedValues (list) --
Allowed values for this STRING field.
(string) --
stringListValidation (dict) --
Validation for STRINGLIST fields.
allowedValues (list) --
Allowed values for items in this STRINGLIST field.
(string) --
maxItems (integer) --
Maximum number of items in the string list.
numberValidation (dict) --
Validation for NUMBER fields.
minValue (float) --
Minimum allowed value.
maxValue (float) --
Maximum allowed value.
indexedKeys (list) --
The indexed metadata keys for this memory. Only indexed keys can be used in metadata filters.
(dict) --
A metadata key indexed for filtering.
key (string) --
The metadata key name to index.
type (string) --
The data type of the indexed key.
streamDeliveryResources (dict) --
Configuration for streaming memory record data to external resources.
resources (list) --
List of stream delivery resource configurations.
(dict) --
Supported stream delivery resource types.
kinesis (dict) --
Kinesis Data Stream configuration.
dataStreamArn (string) --
ARN of the Kinesis Data Stream.
contentConfigurations (list) --
Content configurations for stream delivery.
(dict) --
Defines what content to stream and at what level of detail.
type (string) --
Type of content to stream.
level (string) --
Level of detail for streamed content.
{'status': {'UPDATING'}}
Deletes an Amazon Bedrock AgentCore Memory resource.
See also: AWS API Documentation
Request Syntax
client.delete_memory(
clientToken='string',
memoryId='string'
)
string
A client token is used for keeping track of idempotent requests. It can contain a session id which can be around 250 chars, combined with a unique AWS identifier.
This field is autopopulated if not provided.
string
[REQUIRED]
The unique identifier of the memory to delete.
dict
Response Syntax
{
'memoryId': 'string',
'status': 'CREATING'|'ACTIVE'|'FAILED'|'DELETING'|'UPDATING'
}
Response Structure
(dict) --
memoryId (string) --
The unique identifier of the deleted AgentCore Memory resource.
status (string) --
The current status of the AgentCore Memory resource deletion.
{'memory': {'status': {'UPDATING'},
'strategies': {'configuration': {'reflection': {'customReflectionConfiguration': {'episodicReflectionOverride': {'memoryRecordSchema': {'metadataSchema': {'extractionType': 'LLM_INFERRED '
'| '
'STRICTLY_CONSISTENT'}}}},
'episodicReflectionConfiguration': {'memoryRecordSchema': {'metadataSchema': {'extractionType': 'LLM_INFERRED '
'| '
'STRICTLY_CONSISTENT'}}}}},
'memoryRecordSchema': {'metadataSchema': {'extractionType': 'LLM_INFERRED '
'| '
'STRICTLY_CONSISTENT'}}}}}
Retrieve an existing Amazon Bedrock AgentCore Memory resource.
See also: AWS API Documentation
Request Syntax
client.get_memory(
memoryId='string',
view='full'|'without_decryption'
)
string
[REQUIRED]
The unique identifier of the memory to retrieve.
string
The level of detail to return for the memory.
dict
Response Syntax
{
'memory': {
'arn': 'string',
'id': 'string',
'name': 'string',
'description': 'string',
'encryptionKeyArn': 'string',
'memoryExecutionRoleArn': 'string',
'eventExpiryDuration': 123,
'status': 'CREATING'|'ACTIVE'|'FAILED'|'DELETING'|'UPDATING',
'failureReason': 'string',
'createdAt': datetime(2015, 1, 1),
'updatedAt': datetime(2015, 1, 1),
'strategies': [
{
'strategyId': 'string',
'name': 'string',
'description': 'string',
'configuration': {
'type': 'SEMANTIC_OVERRIDE'|'SUMMARY_OVERRIDE'|'USER_PREFERENCE_OVERRIDE'|'SELF_MANAGED'|'EPISODIC_OVERRIDE',
'extraction': {
'customExtractionConfiguration': {
'semanticExtractionOverride': {
'appendToPrompt': 'string',
'modelId': 'string'
},
'userPreferenceExtractionOverride': {
'appendToPrompt': 'string',
'modelId': 'string'
},
'episodicExtractionOverride': {
'appendToPrompt': 'string',
'modelId': 'string'
}
}
},
'consolidation': {
'customConsolidationConfiguration': {
'semanticConsolidationOverride': {
'appendToPrompt': 'string',
'modelId': 'string'
},
'summaryConsolidationOverride': {
'appendToPrompt': 'string',
'modelId': 'string'
},
'userPreferenceConsolidationOverride': {
'appendToPrompt': 'string',
'modelId': 'string'
},
'episodicConsolidationOverride': {
'appendToPrompt': 'string',
'modelId': 'string'
}
}
},
'reflection': {
'customReflectionConfiguration': {
'episodicReflectionOverride': {
'appendToPrompt': 'string',
'modelId': 'string',
'namespaces': [
'string',
],
'namespaceTemplates': [
'string',
],
'memoryRecordSchema': {
'metadataSchema': [
{
'key': 'string',
'type': 'STRING'|'STRINGLIST'|'NUMBER',
'extractionType': 'LLM_INFERRED'|'STRICTLY_CONSISTENT',
'extractionConfig': {
'llmExtractionConfig': {
'llmExtractionInstruction': 'string',
'definition': 'string',
'validation': {
'stringValidation': {
'allowedValues': [
'string',
]
},
'stringListValidation': {
'allowedValues': [
'string',
],
'maxItems': 123
},
'numberValidation': {
'minValue': 123.0,
'maxValue': 123.0
}
}
}
}
},
]
}
}
},
'episodicReflectionConfiguration': {
'namespaces': [
'string',
],
'namespaceTemplates': [
'string',
],
'memoryRecordSchema': {
'metadataSchema': [
{
'key': 'string',
'type': 'STRING'|'STRINGLIST'|'NUMBER',
'extractionType': 'LLM_INFERRED'|'STRICTLY_CONSISTENT',
'extractionConfig': {
'llmExtractionConfig': {
'llmExtractionInstruction': 'string',
'definition': 'string',
'validation': {
'stringValidation': {
'allowedValues': [
'string',
]
},
'stringListValidation': {
'allowedValues': [
'string',
],
'maxItems': 123
},
'numberValidation': {
'minValue': 123.0,
'maxValue': 123.0
}
}
}
}
},
]
}
}
},
'selfManagedConfiguration': {
'triggerConditions': [
{
'messageBasedTrigger': {
'messageCount': 123
},
'tokenBasedTrigger': {
'tokenCount': 123
},
'timeBasedTrigger': {
'idleSessionTimeout': 123
}
},
],
'invocationConfiguration': {
'topicArn': 'string',
'payloadDeliveryBucketName': 'string'
},
'historicalContextWindowSize': 123
}
},
'type': 'SEMANTIC'|'SUMMARIZATION'|'USER_PREFERENCE'|'CUSTOM'|'EPISODIC',
'namespaces': [
'string',
],
'namespaceTemplates': [
'string',
],
'createdAt': datetime(2015, 1, 1),
'updatedAt': datetime(2015, 1, 1),
'status': 'CREATING'|'ACTIVE'|'DELETING'|'FAILED',
'memoryRecordSchema': {
'metadataSchema': [
{
'key': 'string',
'type': 'STRING'|'STRINGLIST'|'NUMBER',
'extractionType': 'LLM_INFERRED'|'STRICTLY_CONSISTENT',
'extractionConfig': {
'llmExtractionConfig': {
'llmExtractionInstruction': 'string',
'definition': 'string',
'validation': {
'stringValidation': {
'allowedValues': [
'string',
]
},
'stringListValidation': {
'allowedValues': [
'string',
],
'maxItems': 123
},
'numberValidation': {
'minValue': 123.0,
'maxValue': 123.0
}
}
}
}
},
]
}
},
],
'indexedKeys': [
{
'key': 'string',
'type': 'STRING'|'STRINGLIST'|'NUMBER'
},
],
'streamDeliveryResources': {
'resources': [
{
'kinesis': {
'dataStreamArn': 'string',
'contentConfigurations': [
{
'type': 'MEMORY_RECORDS',
'level': 'METADATA_ONLY'|'FULL_CONTENT'
},
]
}
},
]
}
}
}
Response Structure
(dict) --
memory (dict) --
The retrieved AgentCore Memory resource details.
arn (string) --
The Amazon Resource Name (ARN) of the memory.
id (string) --
The unique identifier of the memory.
name (string) --
The name of the memory.
description (string) --
The description of the memory.
encryptionKeyArn (string) --
The ARN of the KMS key used to encrypt the memory.
memoryExecutionRoleArn (string) --
The ARN of the IAM role that provides permissions for the memory.
eventExpiryDuration (integer) --
The number of days after which memory events will expire.
status (string) --
The current status of the memory.
failureReason (string) --
The reason for failure if the memory is in a failed state.
createdAt (datetime) --
The timestamp when the memory was created.
updatedAt (datetime) --
The timestamp when the memory was last updated.
strategies (list) --
The list of memory strategies associated with this memory.
(dict) --
Contains information about a memory strategy.
strategyId (string) --
The unique identifier of the memory strategy.
name (string) --
The name of the memory strategy.
description (string) --
The description of the memory strategy.
configuration (dict) --
The configuration of the memory strategy.
type (string) --
The type of override for the strategy configuration.
extraction (dict) --
The extraction configuration for the memory strategy.
customExtractionConfiguration (dict) --
The custom extraction configuration.
semanticExtractionOverride (dict) --
The semantic extraction override configuration.
appendToPrompt (string) --
The text to append to the prompt for semantic extraction.
modelId (string) --
The model ID to use for semantic extraction.
userPreferenceExtractionOverride (dict) --
The user preference extraction override configuration.
appendToPrompt (string) --
The text to append to the prompt for user preference extraction.
modelId (string) --
The model ID to use for user preference extraction.
episodicExtractionOverride (dict) --
The configurations to override the default extraction step for the episodic memory strategy.
appendToPrompt (string) --
The text appended to the prompt for the extraction step of the episodic memory strategy.
modelId (string) --
The model ID used for the extraction step of the episodic memory strategy.
consolidation (dict) --
The consolidation configuration for the memory strategy.
customConsolidationConfiguration (dict) --
The custom consolidation configuration.
semanticConsolidationOverride (dict) --
The semantic consolidation override configuration.
appendToPrompt (string) --
The text to append to the prompt for semantic consolidation.
modelId (string) --
The model ID to use for semantic consolidation.
summaryConsolidationOverride (dict) --
The summary consolidation override configuration.
appendToPrompt (string) --
The text to append to the prompt for summary consolidation.
modelId (string) --
The model ID to use for summary consolidation.
userPreferenceConsolidationOverride (dict) --
The user preference consolidation override configuration.
appendToPrompt (string) --
The text to append to the prompt for user preference consolidation.
modelId (string) --
The model ID to use for user preference consolidation.
episodicConsolidationOverride (dict) --
The configurations to override the default consolidation step for the episodic memory strategy.
appendToPrompt (string) --
The text appended to the prompt for the consolidation step of the episodic memory strategy.
modelId (string) --
The model ID used for the consolidation step of the episodic memory strategy.
reflection (dict) --
The reflection configuration for the memory strategy.
customReflectionConfiguration (dict) --
The configuration for a custom reflection strategy.
episodicReflectionOverride (dict) --
The configuration for a reflection strategy to override the default one.
appendToPrompt (string) --
The text appended to the prompt for the reflection step of the episodic memory strategy.
modelId (string) --
The model ID used for the reflection step of the episodic memory strategy.
namespaces (list) --
This is a legacy parameter. The namespaces over which reflections were created. Can be less nested than the episodic namespaces.
(string) --
namespaceTemplates (list) --
The namespaceTemplates over which reflections were created. Can be less nested than the episodic namespaces.
(string) --
memoryRecordSchema (dict) --
Schema for metadata fields on records generated by this reflection override.
metadataSchema (list) --
The metadata field definitions for this strategy.
(dict) --
A metadata field definition within a strategy's schema.
key (string) --
The metadata field name. Must match an indexed key to be queryable via metadata filters.
type (string) --
The MetadataValueType.
extractionType (string) --
Specifies whether the metadata value is extracted by the LLM or passed through deterministically from the event.
extractionConfig (dict) --
Configuration for extracting this metadata value from conversational content. Applicable only if extractionType is LLM inferred.
llmExtractionConfig (dict) --
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.
definition (string) --
Description of what this metadata field represents.
validation (dict) --
Validation rules to constrain extracted values.
stringValidation (dict) --
Validation for STRING fields.
allowedValues (list) --
Allowed values for this STRING field.
(string) --
stringListValidation (dict) --
Validation for STRINGLIST fields.
allowedValues (list) --
Allowed values for items in this STRINGLIST field.
(string) --
maxItems (integer) --
Maximum number of items in the string list.
numberValidation (dict) --
Validation for NUMBER fields.
minValue (float) --
Minimum allowed value.
maxValue (float) --
Maximum allowed value.
episodicReflectionConfiguration (dict) --
The configuration for the episodic reflection strategy.
namespaces (list) --
This is a legacy parameter, use namespaceTemplates. The namespaces for which to create reflections. Can be less nested than the episodic namespaces.
(string) --
namespaceTemplates (list) --
The namespaceTemplates for which to create reflections. Can be less nested than the episodic namespaces.
(string) --
memoryRecordSchema (dict) --
"Schema for metadata fields on records generated by reflections.
metadataSchema (list) --
The metadata field definitions for this strategy.
(dict) --
A metadata field definition within a strategy's schema.
key (string) --
The metadata field name. Must match an indexed key to be queryable via metadata filters.
type (string) --
The MetadataValueType.
extractionType (string) --
Specifies whether the metadata value is extracted by the LLM or passed through deterministically from the event.
extractionConfig (dict) --
Configuration for extracting this metadata value from conversational content. Applicable only if extractionType is LLM inferred.
llmExtractionConfig (dict) --
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.
definition (string) --
Description of what this metadata field represents.
validation (dict) --
Validation rules to constrain extracted values.
stringValidation (dict) --
Validation for STRING fields.
allowedValues (list) --
Allowed values for this STRING field.
(string) --
stringListValidation (dict) --
Validation for STRINGLIST fields.
allowedValues (list) --
Allowed values for items in this STRINGLIST field.
(string) --
maxItems (integer) --
Maximum number of items in the string list.
numberValidation (dict) --
Validation for NUMBER fields.
minValue (float) --
Minimum allowed value.
maxValue (float) --
Maximum allowed value.
selfManagedConfiguration (dict) --
Self-managed configuration settings.
triggerConditions (list) --
A list of conditions that trigger memory processing.
(dict) --
Condition that triggers memory processing.
messageBasedTrigger (dict) --
Message based trigger configuration.
messageCount (integer) --
The number of messages that trigger memory processing.
tokenBasedTrigger (dict) --
Token based trigger configuration.
tokenCount (integer) --
Number of tokens that trigger memory processing.
timeBasedTrigger (dict) --
Time based trigger configuration.
idleSessionTimeout (integer) --
Idle session timeout (seconds) that triggers memory processing.
invocationConfiguration (dict) --
The configuration to use when invoking memory processing.
topicArn (string) --
The ARN of the SNS topic for job notifications.
payloadDeliveryBucketName (string) --
The S3 bucket name for event payload delivery.
historicalContextWindowSize (integer) --
The number of historical messages to include in processing context.
type (string) --
The type of the memory strategy.
namespaces (list) --
This is a legacy parameter. The namespaces associated with the memory strategy.
(string) --
namespaceTemplates (list) --
The namespaceTemplates associated with the memory strategy.
(string) --
createdAt (datetime) --
The timestamp when the memory strategy was created.
updatedAt (datetime) --
The timestamp when the memory strategy was last updated.
status (string) --
The current status of the memory strategy.
memoryRecordSchema (dict) --
Schema for metadata fields on records generated by this strategy.
metadataSchema (list) --
The metadata field definitions for this strategy.
(dict) --
A metadata field definition within a strategy's schema.
key (string) --
The metadata field name. Must match an indexed key to be queryable via metadata filters.
type (string) --
The MetadataValueType.
extractionType (string) --
Specifies whether the metadata value is extracted by the LLM or passed through deterministically from the event.
extractionConfig (dict) --
Configuration for extracting this metadata value from conversational content. Applicable only if extractionType is LLM inferred.
llmExtractionConfig (dict) --
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.
definition (string) --
Description of what this metadata field represents.
validation (dict) --
Validation rules to constrain extracted values.
stringValidation (dict) --
Validation for STRING fields.
allowedValues (list) --
Allowed values for this STRING field.
(string) --
stringListValidation (dict) --
Validation for STRINGLIST fields.
allowedValues (list) --
Allowed values for items in this STRINGLIST field.
(string) --
maxItems (integer) --
Maximum number of items in the string list.
numberValidation (dict) --
Validation for NUMBER fields.
minValue (float) --
Minimum allowed value.
maxValue (float) --
Maximum allowed value.
indexedKeys (list) --
The indexed metadata keys for this memory. Only indexed keys can be used in metadata filters.
(dict) --
A metadata key indexed for filtering.
key (string) --
The metadata key name to index.
type (string) --
The data type of the indexed key.
streamDeliveryResources (dict) --
Configuration for streaming memory record data to external resources.
resources (list) --
List of stream delivery resource configurations.
(dict) --
Supported stream delivery resource types.
kinesis (dict) --
Kinesis Data Stream configuration.
dataStreamArn (string) --
ARN of the Kinesis Data Stream.
contentConfigurations (list) --
Content configurations for stream delivery.
(dict) --
Defines what content to stream and at what level of detail.
type (string) --
Type of content to stream.
level (string) --
Level of detail for streamed content.
{'memories': {'status': {'UPDATING'}}}
Lists the available Amazon Bedrock AgentCore Memory resources in the current Amazon Web Services Region.
See also: AWS API Documentation
Request Syntax
client.list_memories(
maxResults=123,
nextToken='string'
)
integer
The maximum number of results to return in a single call. The default value is 10. The maximum value is 50.
string
The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.
dict
Response Syntax
{
'memories': [
{
'arn': 'string',
'id': 'string',
'status': 'CREATING'|'ACTIVE'|'FAILED'|'DELETING'|'UPDATING',
'createdAt': datetime(2015, 1, 1),
'updatedAt': datetime(2015, 1, 1)
},
],
'nextToken': 'string'
}
Response Structure
(dict) --
memories (list) --
The list of AgentCore Memory resource summaries.
(dict) --
Contains summary information about a memory resource.
arn (string) --
The Amazon Resource Name (ARN) of the memory.
id (string) --
The unique identifier of the memory.
status (string) --
The current status of the memory.
createdAt (datetime) --
The timestamp when the memory was created.
updatedAt (datetime) --
The timestamp when the memory was last updated.
nextToken (string) --
A token to retrieve the next page of results.
{'memoryStrategies': {'addMemoryStrategies': {'customMemoryStrategy': {'configuration': {'episodicOverride': {'reflection': {'memoryRecordSchema': {'metadataSchema': {'extractionType': 'LLM_INFERRED '
'| '
'STRICTLY_CONSISTENT'}}}}},
'memoryRecordSchema': {'metadataSchema': {'extractionType': 'LLM_INFERRED '
'| '
'STRICTLY_CONSISTENT'}}},
'episodicMemoryStrategy': {'memoryRecordSchema': {'metadataSchema': {'extractionType': 'LLM_INFERRED '
'| '
'STRICTLY_CONSISTENT'}},
'reflectionConfiguration': {'memoryRecordSchema': {'metadataSchema': {'extractionType': 'LLM_INFERRED '
'| '
'STRICTLY_CONSISTENT'}}}},
'semanticMemoryStrategy': {'memoryRecordSchema': {'metadataSchema': {'extractionType': 'LLM_INFERRED '
'| '
'STRICTLY_CONSISTENT'}}},
'summaryMemoryStrategy': {'memoryRecordSchema': {'metadataSchema': {'extractionType': 'LLM_INFERRED '
'| '
'STRICTLY_CONSISTENT'}}},
'userPreferenceMemoryStrategy': {'memoryRecordSchema': {'metadataSchema': {'extractionType': 'LLM_INFERRED '
'| '
'STRICTLY_CONSISTENT'}}}},
'modifyMemoryStrategies': {'configuration': {'reflection': {'customReflectionConfiguration': {'episodicReflectionOverride': {'memoryRecordSchema': {'metadataSchema': {'extractionType': 'LLM_INFERRED '
'| '
'STRICTLY_CONSISTENT'}}}},
'episodicReflectionConfiguration': {'memoryRecordSchema': {'metadataSchema': {'extractionType': 'LLM_INFERRED '
'| '
'STRICTLY_CONSISTENT'}}}}},
'memoryRecordSchema': {'metadataSchema': {'extractionType': 'LLM_INFERRED '
'| '
'STRICTLY_CONSISTENT'}}}}}
Response {'memory': {'status': {'UPDATING'},
'strategies': {'configuration': {'reflection': {'customReflectionConfiguration': {'episodicReflectionOverride': {'memoryRecordSchema': {'metadataSchema': {'extractionType': 'LLM_INFERRED '
'| '
'STRICTLY_CONSISTENT'}}}},
'episodicReflectionConfiguration': {'memoryRecordSchema': {'metadataSchema': {'extractionType': 'LLM_INFERRED '
'| '
'STRICTLY_CONSISTENT'}}}}},
'memoryRecordSchema': {'metadataSchema': {'extractionType': 'LLM_INFERRED '
'| '
'STRICTLY_CONSISTENT'}}}}}
Update an Amazon Bedrock AgentCore Memory resource memory.
See also: AWS API Documentation
Request Syntax
client.update_memory(
clientToken='string',
memoryId='string',
description='string',
eventExpiryDuration=123,
memoryExecutionRoleArn='string',
memoryStrategies={
'addMemoryStrategies': [
{
'semanticMemoryStrategy': {
'name': 'string',
'description': 'string',
'namespaces': [
'string',
],
'namespaceTemplates': [
'string',
],
'memoryRecordSchema': {
'metadataSchema': [
{
'key': 'string',
'type': 'STRING'|'STRINGLIST'|'NUMBER',
'extractionType': 'LLM_INFERRED'|'STRICTLY_CONSISTENT',
'extractionConfig': {
'llmExtractionConfig': {
'llmExtractionInstruction': 'string',
'definition': 'string',
'validation': {
'stringValidation': {
'allowedValues': [
'string',
]
},
'stringListValidation': {
'allowedValues': [
'string',
],
'maxItems': 123
},
'numberValidation': {
'minValue': 123.0,
'maxValue': 123.0
}
}
}
}
},
]
}
},
'summaryMemoryStrategy': {
'name': 'string',
'description': 'string',
'namespaces': [
'string',
],
'namespaceTemplates': [
'string',
],
'memoryRecordSchema': {
'metadataSchema': [
{
'key': 'string',
'type': 'STRING'|'STRINGLIST'|'NUMBER',
'extractionType': 'LLM_INFERRED'|'STRICTLY_CONSISTENT',
'extractionConfig': {
'llmExtractionConfig': {
'llmExtractionInstruction': 'string',
'definition': 'string',
'validation': {
'stringValidation': {
'allowedValues': [
'string',
]
},
'stringListValidation': {
'allowedValues': [
'string',
],
'maxItems': 123
},
'numberValidation': {
'minValue': 123.0,
'maxValue': 123.0
}
}
}
}
},
]
}
},
'userPreferenceMemoryStrategy': {
'name': 'string',
'description': 'string',
'namespaces': [
'string',
],
'namespaceTemplates': [
'string',
],
'memoryRecordSchema': {
'metadataSchema': [
{
'key': 'string',
'type': 'STRING'|'STRINGLIST'|'NUMBER',
'extractionType': 'LLM_INFERRED'|'STRICTLY_CONSISTENT',
'extractionConfig': {
'llmExtractionConfig': {
'llmExtractionInstruction': 'string',
'definition': 'string',
'validation': {
'stringValidation': {
'allowedValues': [
'string',
]
},
'stringListValidation': {
'allowedValues': [
'string',
],
'maxItems': 123
},
'numberValidation': {
'minValue': 123.0,
'maxValue': 123.0
}
}
}
}
},
]
}
},
'customMemoryStrategy': {
'name': 'string',
'description': 'string',
'namespaces': [
'string',
],
'namespaceTemplates': [
'string',
],
'configuration': {
'semanticOverride': {
'extraction': {
'appendToPrompt': 'string',
'modelId': 'string'
},
'consolidation': {
'appendToPrompt': 'string',
'modelId': 'string'
}
},
'summaryOverride': {
'consolidation': {
'appendToPrompt': 'string',
'modelId': 'string'
}
},
'userPreferenceOverride': {
'extraction': {
'appendToPrompt': 'string',
'modelId': 'string'
},
'consolidation': {
'appendToPrompt': 'string',
'modelId': 'string'
}
},
'episodicOverride': {
'extraction': {
'appendToPrompt': 'string',
'modelId': 'string'
},
'consolidation': {
'appendToPrompt': 'string',
'modelId': 'string'
},
'reflection': {
'appendToPrompt': 'string',
'modelId': 'string',
'namespaces': [
'string',
],
'namespaceTemplates': [
'string',
],
'memoryRecordSchema': {
'metadataSchema': [
{
'key': 'string',
'type': 'STRING'|'STRINGLIST'|'NUMBER',
'extractionType': 'LLM_INFERRED'|'STRICTLY_CONSISTENT',
'extractionConfig': {
'llmExtractionConfig': {
'llmExtractionInstruction': 'string',
'definition': 'string',
'validation': {
'stringValidation': {
'allowedValues': [
'string',
]
},
'stringListValidation': {
'allowedValues': [
'string',
],
'maxItems': 123
},
'numberValidation': {
'minValue': 123.0,
'maxValue': 123.0
}
}
}
}
},
]
}
}
},
'selfManagedConfiguration': {
'triggerConditions': [
{
'messageBasedTrigger': {
'messageCount': 123
},
'tokenBasedTrigger': {
'tokenCount': 123
},
'timeBasedTrigger': {
'idleSessionTimeout': 123
}
},
],
'invocationConfiguration': {
'topicArn': 'string',
'payloadDeliveryBucketName': 'string'
},
'historicalContextWindowSize': 123
}
},
'memoryRecordSchema': {
'metadataSchema': [
{
'key': 'string',
'type': 'STRING'|'STRINGLIST'|'NUMBER',
'extractionType': 'LLM_INFERRED'|'STRICTLY_CONSISTENT',
'extractionConfig': {
'llmExtractionConfig': {
'llmExtractionInstruction': 'string',
'definition': 'string',
'validation': {
'stringValidation': {
'allowedValues': [
'string',
]
},
'stringListValidation': {
'allowedValues': [
'string',
],
'maxItems': 123
},
'numberValidation': {
'minValue': 123.0,
'maxValue': 123.0
}
}
}
}
},
]
}
},
'episodicMemoryStrategy': {
'name': 'string',
'description': 'string',
'namespaces': [
'string',
],
'namespaceTemplates': [
'string',
],
'reflectionConfiguration': {
'namespaces': [
'string',
],
'namespaceTemplates': [
'string',
],
'memoryRecordSchema': {
'metadataSchema': [
{
'key': 'string',
'type': 'STRING'|'STRINGLIST'|'NUMBER',
'extractionType': 'LLM_INFERRED'|'STRICTLY_CONSISTENT',
'extractionConfig': {
'llmExtractionConfig': {
'llmExtractionInstruction': 'string',
'definition': 'string',
'validation': {
'stringValidation': {
'allowedValues': [
'string',
]
},
'stringListValidation': {
'allowedValues': [
'string',
],
'maxItems': 123
},
'numberValidation': {
'minValue': 123.0,
'maxValue': 123.0
}
}
}
}
},
]
}
},
'memoryRecordSchema': {
'metadataSchema': [
{
'key': 'string',
'type': 'STRING'|'STRINGLIST'|'NUMBER',
'extractionType': 'LLM_INFERRED'|'STRICTLY_CONSISTENT',
'extractionConfig': {
'llmExtractionConfig': {
'llmExtractionInstruction': 'string',
'definition': 'string',
'validation': {
'stringValidation': {
'allowedValues': [
'string',
]
},
'stringListValidation': {
'allowedValues': [
'string',
],
'maxItems': 123
},
'numberValidation': {
'minValue': 123.0,
'maxValue': 123.0
}
}
}
}
},
]
}
}
},
],
'modifyMemoryStrategies': [
{
'memoryStrategyId': 'string',
'description': 'string',
'namespaces': [
'string',
],
'namespaceTemplates': [
'string',
],
'configuration': {
'extraction': {
'customExtractionConfiguration': {
'semanticExtractionOverride': {
'appendToPrompt': 'string',
'modelId': 'string'
},
'userPreferenceExtractionOverride': {
'appendToPrompt': 'string',
'modelId': 'string'
},
'episodicExtractionOverride': {
'appendToPrompt': 'string',
'modelId': 'string'
}
}
},
'consolidation': {
'customConsolidationConfiguration': {
'semanticConsolidationOverride': {
'appendToPrompt': 'string',
'modelId': 'string'
},
'summaryConsolidationOverride': {
'appendToPrompt': 'string',
'modelId': 'string'
},
'userPreferenceConsolidationOverride': {
'appendToPrompt': 'string',
'modelId': 'string'
},
'episodicConsolidationOverride': {
'appendToPrompt': 'string',
'modelId': 'string'
}
}
},
'reflection': {
'episodicReflectionConfiguration': {
'namespaces': [
'string',
],
'namespaceTemplates': [
'string',
],
'memoryRecordSchema': {
'metadataSchema': [
{
'key': 'string',
'type': 'STRING'|'STRINGLIST'|'NUMBER',
'extractionType': 'LLM_INFERRED'|'STRICTLY_CONSISTENT',
'extractionConfig': {
'llmExtractionConfig': {
'llmExtractionInstruction': 'string',
'definition': 'string',
'validation': {
'stringValidation': {
'allowedValues': [
'string',
]
},
'stringListValidation': {
'allowedValues': [
'string',
],
'maxItems': 123
},
'numberValidation': {
'minValue': 123.0,
'maxValue': 123.0
}
}
}
}
},
]
}
},
'customReflectionConfiguration': {
'episodicReflectionOverride': {
'appendToPrompt': 'string',
'modelId': 'string',
'namespaces': [
'string',
],
'namespaceTemplates': [
'string',
],
'memoryRecordSchema': {
'metadataSchema': [
{
'key': 'string',
'type': 'STRING'|'STRINGLIST'|'NUMBER',
'extractionType': 'LLM_INFERRED'|'STRICTLY_CONSISTENT',
'extractionConfig': {
'llmExtractionConfig': {
'llmExtractionInstruction': 'string',
'definition': 'string',
'validation': {
'stringValidation': {
'allowedValues': [
'string',
]
},
'stringListValidation': {
'allowedValues': [
'string',
],
'maxItems': 123
},
'numberValidation': {
'minValue': 123.0,
'maxValue': 123.0
}
}
}
}
},
]
}
}
}
},
'selfManagedConfiguration': {
'triggerConditions': [
{
'messageBasedTrigger': {
'messageCount': 123
},
'tokenBasedTrigger': {
'tokenCount': 123
},
'timeBasedTrigger': {
'idleSessionTimeout': 123
}
},
],
'invocationConfiguration': {
'topicArn': 'string',
'payloadDeliveryBucketName': 'string'
},
'historicalContextWindowSize': 123
}
},
'memoryRecordSchema': {
'metadataSchema': [
{
'key': 'string',
'type': 'STRING'|'STRINGLIST'|'NUMBER',
'extractionType': 'LLM_INFERRED'|'STRICTLY_CONSISTENT',
'extractionConfig': {
'llmExtractionConfig': {
'llmExtractionInstruction': 'string',
'definition': 'string',
'validation': {
'stringValidation': {
'allowedValues': [
'string',
]
},
'stringListValidation': {
'allowedValues': [
'string',
],
'maxItems': 123
},
'numberValidation': {
'minValue': 123.0,
'maxValue': 123.0
}
}
}
}
},
]
}
},
],
'deleteMemoryStrategies': [
{
'memoryStrategyId': 'string'
},
]
},
addIndexedKeys=[
{
'key': 'string',
'type': 'STRING'|'STRINGLIST'|'NUMBER'
},
],
streamDeliveryResources={
'resources': [
{
'kinesis': {
'dataStreamArn': 'string',
'contentConfigurations': [
{
'type': 'MEMORY_RECORDS',
'level': 'METADATA_ONLY'|'FULL_CONTENT'
},
]
}
},
]
}
)
string
A client token is used for keeping track of idempotent requests. It can contain a session id which can be around 250 chars, combined with a unique AWS identifier.
This field is autopopulated if not provided.
string
[REQUIRED]
The unique identifier of the memory to update.
string
The updated description of the AgentCore Memory resource.
integer
The number of days after which memory events will expire, between 7 and 365 days.
string
The ARN of the IAM role that provides permissions for the AgentCore Memory resource.
dict
The memory strategies to add, modify, or delete.
addMemoryStrategies (list) --
The list of memory strategies to add.
(dict) --
Contains input information for creating a memory strategy.
semanticMemoryStrategy (dict) --
Input for creating a semantic memory strategy.
name (string) -- [REQUIRED]
The name of the semantic memory strategy.
description (string) --
The description of the semantic memory strategy.
namespaces (list) --
This is a legacy parameter, use namespaceTemplates. The namespaces associated with the semantic memory strategy.
(string) --
namespaceTemplates (list) --
The namespaceTemplates associated with the semantic memory strategy.
(string) --
memoryRecordSchema (dict) --
Schema for metadata on memory records generated by a strategy.
metadataSchema (list) --
The metadata field definitions for this strategy.
(dict) --
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.
type (string) --
The MetadataValueType.
extractionType (string) --
Specifies whether the metadata value is extracted by the LLM or passed through deterministically from the event.
extractionConfig (dict) --
Configuration for extracting this metadata value from conversational content. Applicable only if extractionType is LLM inferred.
llmExtractionConfig (dict) --
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.
definition (string) -- [REQUIRED]
Description of what this metadata field represents.
validation (dict) --
Validation rules to constrain extracted values.
stringValidation (dict) --
Validation for STRING fields.
allowedValues (list) -- [REQUIRED]
Allowed values for this STRING field.
(string) --
stringListValidation (dict) --
Validation for STRINGLIST fields.
allowedValues (list) --
Allowed values for items in this STRINGLIST field.
(string) --
maxItems (integer) --
Maximum number of items in the string list.
numberValidation (dict) --
Validation for NUMBER fields.
minValue (float) --
Minimum allowed value.
maxValue (float) --
Maximum allowed value.
summaryMemoryStrategy (dict) --
Input for creating a summary memory strategy.
name (string) -- [REQUIRED]
The name of the summary memory strategy.
description (string) --
The description of the summary memory strategy.
namespaces (list) --
This is a legacy parameter, use namespaceTemplates. The namespaces associated with the summary memory strategy.
(string) --
namespaceTemplates (list) --
The namespaceTemplates associated with the summary memory strategy.
(string) --
memoryRecordSchema (dict) --
Schema for metadata fields on records generated by this strategy.
metadataSchema (list) --
The metadata field definitions for this strategy.
(dict) --
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.
type (string) --
The MetadataValueType.
extractionType (string) --
Specifies whether the metadata value is extracted by the LLM or passed through deterministically from the event.
extractionConfig (dict) --
Configuration for extracting this metadata value from conversational content. Applicable only if extractionType is LLM inferred.
llmExtractionConfig (dict) --
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.
definition (string) -- [REQUIRED]
Description of what this metadata field represents.
validation (dict) --
Validation rules to constrain extracted values.
stringValidation (dict) --
Validation for STRING fields.
allowedValues (list) -- [REQUIRED]
Allowed values for this STRING field.
(string) --
stringListValidation (dict) --
Validation for STRINGLIST fields.
allowedValues (list) --
Allowed values for items in this STRINGLIST field.
(string) --
maxItems (integer) --
Maximum number of items in the string list.
numberValidation (dict) --
Validation for NUMBER fields.
minValue (float) --
Minimum allowed value.
maxValue (float) --
Maximum allowed value.
userPreferenceMemoryStrategy (dict) --
Input for creating a user preference memory strategy.
name (string) -- [REQUIRED]
The name of the user preference memory strategy.
description (string) --
The description of the user preference memory strategy.
namespaces (list) --
This is a legacy parameter, use namespaceTemplates. The namespaces associated with the user preference memory strategy.
(string) --
namespaceTemplates (list) --
The namespaceTemplates associated with the user preference memory strategy.
(string) --
memoryRecordSchema (dict) --
Schema for metadata fields on records generated by this strategy.
metadataSchema (list) --
The metadata field definitions for this strategy.
(dict) --
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.
type (string) --
The MetadataValueType.
extractionType (string) --
Specifies whether the metadata value is extracted by the LLM or passed through deterministically from the event.
extractionConfig (dict) --
Configuration for extracting this metadata value from conversational content. Applicable only if extractionType is LLM inferred.
llmExtractionConfig (dict) --
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.
definition (string) -- [REQUIRED]
Description of what this metadata field represents.
validation (dict) --
Validation rules to constrain extracted values.
stringValidation (dict) --
Validation for STRING fields.
allowedValues (list) -- [REQUIRED]
Allowed values for this STRING field.
(string) --
stringListValidation (dict) --
Validation for STRINGLIST fields.
allowedValues (list) --
Allowed values for items in this STRINGLIST field.
(string) --
maxItems (integer) --
Maximum number of items in the string list.
numberValidation (dict) --
Validation for NUMBER fields.
minValue (float) --
Minimum allowed value.
maxValue (float) --
Maximum allowed value.
customMemoryStrategy (dict) --
Input for creating a custom memory strategy.
name (string) -- [REQUIRED]
The name of the custom memory strategy.
description (string) --
The description of the custom memory strategy.
namespaces (list) --
This is a legacy parameter, use namespaceTemplates. The namespaces associated with the custom memory strategy.
(string) --
namespaceTemplates (list) --
The namespaceTemplates associated with the custom memory strategy.
(string) --
configuration (dict) --
The configuration for the custom memory strategy.
semanticOverride (dict) --
The semantic override configuration for a custom memory strategy.
extraction (dict) --
The extraction configuration for a semantic override.
appendToPrompt (string) -- [REQUIRED]
The text to append to the prompt for semantic extraction.
modelId (string) -- [REQUIRED]
The model ID to use for semantic extraction.
consolidation (dict) --
The consolidation configuration for a semantic override.
appendToPrompt (string) -- [REQUIRED]
The text to append to the prompt for semantic consolidation.
modelId (string) -- [REQUIRED]
The model ID to use for semantic consolidation.
summaryOverride (dict) --
The summary override configuration for a custom memory strategy.
consolidation (dict) --
The consolidation configuration for a summary override.
appendToPrompt (string) -- [REQUIRED]
The text to append to the prompt for summary consolidation.
modelId (string) -- [REQUIRED]
The model ID to use for summary consolidation.
userPreferenceOverride (dict) --
The user preference override configuration for a custom memory strategy.
extraction (dict) --
The extraction configuration for a user preference override.
appendToPrompt (string) -- [REQUIRED]
The text to append to the prompt for user preference extraction.
modelId (string) -- [REQUIRED]
The model ID to use for user preference extraction.
consolidation (dict) --
The consolidation configuration for a user preference override.
appendToPrompt (string) -- [REQUIRED]
The text to append to the prompt for user preference consolidation.
modelId (string) -- [REQUIRED]
The model ID to use for user preference consolidation.
episodicOverride (dict) --
The episodic memory strategy override configuration for a custom memory strategy.
extraction (dict) --
Contains configurations for overriding the extraction step of the episodic memory strategy.
appendToPrompt (string) -- [REQUIRED]
The text to append to the prompt for the extraction step of the episodic memory strategy.
modelId (string) -- [REQUIRED]
The model ID to use for the extraction step of the episodic memory strategy.
consolidation (dict) --
Contains configurations for overriding the consolidation step of the episodic memory strategy.
appendToPrompt (string) -- [REQUIRED]
The text to append to the prompt for the consolidation step of the episodic memory strategy.
modelId (string) -- [REQUIRED]
The model ID to use for the consolidation step of the episodic memory strategy.
reflection (dict) --
Contains configurations for overriding the reflection step of the episodic memory strategy.
appendToPrompt (string) -- [REQUIRED]
The text to append to the prompt for reflection step of the episodic memory strategy.
modelId (string) -- [REQUIRED]
The model ID to use for the reflection step of the episodic memory strategy.
namespaces (list) --
This is a legacy parameter, use namespaceTemplates. The namespaces to use for episodic reflection. Can be less nested than the episodic namespaces.
(string) --
namespaceTemplates (list) --
The namespaceTemplates to use for episodic reflection. Can be less nested than the episodic namespaces.
(string) --
memoryRecordSchema (dict) --
Schema for metadata fields on records generated by this reflection override.
metadataSchema (list) --
The metadata field definitions for this strategy.
(dict) --
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.
type (string) --
The MetadataValueType.
extractionType (string) --
Specifies whether the metadata value is extracted by the LLM or passed through deterministically from the event.
extractionConfig (dict) --
Configuration for extracting this metadata value from conversational content. Applicable only if extractionType is LLM inferred.
llmExtractionConfig (dict) --
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.
definition (string) -- [REQUIRED]
Description of what this metadata field represents.
validation (dict) --
Validation rules to constrain extracted values.
stringValidation (dict) --
Validation for STRING fields.
allowedValues (list) -- [REQUIRED]
Allowed values for this STRING field.
(string) --
stringListValidation (dict) --
Validation for STRINGLIST fields.
allowedValues (list) --
Allowed values for items in this STRINGLIST field.
(string) --
maxItems (integer) --
Maximum number of items in the string list.
numberValidation (dict) --
Validation for NUMBER fields.
minValue (float) --
Minimum allowed value.
maxValue (float) --
Maximum allowed value.
selfManagedConfiguration (dict) --
The self managed configuration for a custom memory strategy.
triggerConditions (list) --
A list of conditions that trigger memory processing.
(dict) --
Condition that triggers memory processing.
messageBasedTrigger (dict) --
Message based trigger configuration.
messageCount (integer) --
The number of messages that trigger memory processing.
tokenBasedTrigger (dict) --
Token based trigger configuration.
tokenCount (integer) --
Number of tokens that trigger memory processing.
timeBasedTrigger (dict) --
Time based trigger configuration.
idleSessionTimeout (integer) --
Idle session timeout (seconds) that triggers memory processing.
invocationConfiguration (dict) -- [REQUIRED]
Configuration to invoke a self-managed memory processing pipeline with.
topicArn (string) -- [REQUIRED]
The ARN of the SNS topic for job notifications.
payloadDeliveryBucketName (string) -- [REQUIRED]
The S3 bucket name for event payload delivery.
historicalContextWindowSize (integer) --
Number of historical messages to include in processing context.
memoryRecordSchema (dict) --
Schema for metadata fields on records generated by this strategy.
metadataSchema (list) --
The metadata field definitions for this strategy.
(dict) --
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.
type (string) --
The MetadataValueType.
extractionType (string) --
Specifies whether the metadata value is extracted by the LLM or passed through deterministically from the event.
extractionConfig (dict) --
Configuration for extracting this metadata value from conversational content. Applicable only if extractionType is LLM inferred.
llmExtractionConfig (dict) --
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.
definition (string) -- [REQUIRED]
Description of what this metadata field represents.
validation (dict) --
Validation rules to constrain extracted values.
stringValidation (dict) --
Validation for STRING fields.
allowedValues (list) -- [REQUIRED]
Allowed values for this STRING field.
(string) --
stringListValidation (dict) --
Validation for STRINGLIST fields.
allowedValues (list) --
Allowed values for items in this STRINGLIST field.
(string) --
maxItems (integer) --
Maximum number of items in the string list.
numberValidation (dict) --
Validation for NUMBER fields.
minValue (float) --
Minimum allowed value.
maxValue (float) --
Maximum allowed value.
episodicMemoryStrategy (dict) --
Input for creating an episodic memory strategy
name (string) -- [REQUIRED]
The name of the episodic memory strategy.
description (string) --
The description of the episodic memory strategy.
namespaces (list) --
This is a legacy parameter, use namespaceTemplates. The namespaces for which to create episodes.
(string) --
namespaceTemplates (list) --
The namespaceTemplates for which to create episodes.
(string) --
reflectionConfiguration (dict) --
The configuration for the reflections created with the episodic memory strategy.
namespaces (list) --
This is a legacy parameter, use namespaceTemplates. The namespaces over which to create reflections. Can be less nested than episode namespaces.
(string) --
namespaceTemplates (list) --
The namespaceTemplates over which to create reflections. Can be less nested than episode namespaces.
(string) --
memoryRecordSchema (dict) --
Schema for metadata fields on records generated by reflections.
metadataSchema (list) --
The metadata field definitions for this strategy.
(dict) --
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.
type (string) --
The MetadataValueType.
extractionType (string) --
Specifies whether the metadata value is extracted by the LLM or passed through deterministically from the event.
extractionConfig (dict) --
Configuration for extracting this metadata value from conversational content. Applicable only if extractionType is LLM inferred.
llmExtractionConfig (dict) --
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.
definition (string) -- [REQUIRED]
Description of what this metadata field represents.
validation (dict) --
Validation rules to constrain extracted values.
stringValidation (dict) --
Validation for STRING fields.
allowedValues (list) -- [REQUIRED]
Allowed values for this STRING field.
(string) --
stringListValidation (dict) --
Validation for STRINGLIST fields.
allowedValues (list) --
Allowed values for items in this STRINGLIST field.
(string) --
maxItems (integer) --
Maximum number of items in the string list.
numberValidation (dict) --
Validation for NUMBER fields.
minValue (float) --
Minimum allowed value.
maxValue (float) --
Maximum allowed value.
memoryRecordSchema (dict) --
Schema for metadata fields on records generated by this strategy.
metadataSchema (list) --
The metadata field definitions for this strategy.
(dict) --
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.
type (string) --
The MetadataValueType.
extractionType (string) --
Specifies whether the metadata value is extracted by the LLM or passed through deterministically from the event.
extractionConfig (dict) --
Configuration for extracting this metadata value from conversational content. Applicable only if extractionType is LLM inferred.
llmExtractionConfig (dict) --
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.
definition (string) -- [REQUIRED]
Description of what this metadata field represents.
validation (dict) --
Validation rules to constrain extracted values.
stringValidation (dict) --
Validation for STRING fields.
allowedValues (list) -- [REQUIRED]
Allowed values for this STRING field.
(string) --
stringListValidation (dict) --
Validation for STRINGLIST fields.
allowedValues (list) --
Allowed values for items in this STRINGLIST field.
(string) --
maxItems (integer) --
Maximum number of items in the string list.
numberValidation (dict) --
Validation for NUMBER fields.
minValue (float) --
Minimum allowed value.
maxValue (float) --
Maximum allowed value.
modifyMemoryStrategies (list) --
The list of memory strategies to modify.
(dict) --
Input for modifying a memory strategy.
memoryStrategyId (string) -- [REQUIRED]
The unique identifier of the memory strategy to modify.
description (string) --
The updated description of the memory strategy.
namespaces (list) --
This is a legacy parameter, use namespaceTemplates. The updated namespaces for the memory strategy.
(string) --
namespaceTemplates (list) --
The updated namespaceTemplates for the memory strategy.
(string) --
configuration (dict) --
The updated configuration for the memory strategy.
extraction (dict) --
The updated extraction configuration.
customExtractionConfiguration (dict) --
The updated custom extraction configuration.
semanticExtractionOverride (dict) --
The semantic extraction override configuration input.
appendToPrompt (string) -- [REQUIRED]
The text to append to the prompt for semantic extraction.
modelId (string) -- [REQUIRED]
The model ID to use for semantic extraction.
userPreferenceExtractionOverride (dict) --
The user preference extraction override configuration input.
appendToPrompt (string) -- [REQUIRED]
The text to append to the prompt for user preference extraction.
modelId (string) -- [REQUIRED]
The model ID to use for user preference extraction.
episodicExtractionOverride (dict) --
Configurations to override the extraction step of the episodic strategy.
appendToPrompt (string) -- [REQUIRED]
The text to append to the prompt for the extraction step of the episodic memory strategy.
modelId (string) -- [REQUIRED]
The model ID to use for the extraction step of the episodic memory strategy.
consolidation (dict) --
The updated consolidation configuration.
customConsolidationConfiguration (dict) --
The updated custom consolidation configuration.
semanticConsolidationOverride (dict) --
The semantic consolidation override configuration input.
appendToPrompt (string) -- [REQUIRED]
The text to append to the prompt for semantic consolidation.
modelId (string) -- [REQUIRED]
The model ID to use for semantic consolidation.
summaryConsolidationOverride (dict) --
The summary consolidation override configuration input.
appendToPrompt (string) -- [REQUIRED]
The text to append to the prompt for summary consolidation.
modelId (string) -- [REQUIRED]
The model ID to use for summary consolidation.
userPreferenceConsolidationOverride (dict) --
The user preference consolidation override configuration input.
appendToPrompt (string) -- [REQUIRED]
The text to append to the prompt for user preference consolidation.
modelId (string) -- [REQUIRED]
The model ID to use for user preference consolidation.
episodicConsolidationOverride (dict) --
Configurations to override the consolidation step of the episodic strategy.
appendToPrompt (string) -- [REQUIRED]
The text to append to the prompt for the consolidation step of the episodic memory strategy.
modelId (string) -- [REQUIRED]
The model ID to use for the consolidation step of the episodic memory strategy.
reflection (dict) --
The updated reflection configuration.
episodicReflectionConfiguration (dict) --
The updated episodic reflection configuration.
namespaces (list) --
This is a legacy parameter, use namespaceTemplates. The namespaces over which to create reflections. Can be less nested than episode namespaces.
(string) --
namespaceTemplates (list) --
The namespaceTemplates over which to create reflections. Can be less nested than episode namespaces.
(string) --
memoryRecordSchema (dict) --
Schema for metadata fields on records generated by reflections.
metadataSchema (list) --
The metadata field definitions for this strategy.
(dict) --
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.
type (string) --
The MetadataValueType.
extractionType (string) --
Specifies whether the metadata value is extracted by the LLM or passed through deterministically from the event.
extractionConfig (dict) --
Configuration for extracting this metadata value from conversational content. Applicable only if extractionType is LLM inferred.
llmExtractionConfig (dict) --
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.
definition (string) -- [REQUIRED]
Description of what this metadata field represents.
validation (dict) --
Validation rules to constrain extracted values.
stringValidation (dict) --
Validation for STRING fields.
allowedValues (list) -- [REQUIRED]
Allowed values for this STRING field.
(string) --
stringListValidation (dict) --
Validation for STRINGLIST fields.
allowedValues (list) --
Allowed values for items in this STRINGLIST field.
(string) --
maxItems (integer) --
Maximum number of items in the string list.
numberValidation (dict) --
Validation for NUMBER fields.
minValue (float) --
Minimum allowed value.
maxValue (float) --
Maximum allowed value.
customReflectionConfiguration (dict) --
The updated custom reflection configuration.
episodicReflectionOverride (dict) --
The reflection override configuration input.
appendToPrompt (string) -- [REQUIRED]
The text to append to the prompt for reflection step of the episodic memory strategy.
modelId (string) -- [REQUIRED]
The model ID to use for the reflection step of the episodic memory strategy.
namespaces (list) --
This is a legacy parameter, use namespaceTemplates. The namespaces to use for episodic reflection. Can be less nested than the episodic namespaces.
(string) --
namespaceTemplates (list) --
The namespaceTemplates to use for episodic reflection. Can be less nested than the episodic namespaces.
(string) --
memoryRecordSchema (dict) --
Schema for metadata fields on records generated by this reflection override.
metadataSchema (list) --
The metadata field definitions for this strategy.
(dict) --
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.
type (string) --
The MetadataValueType.
extractionType (string) --
Specifies whether the metadata value is extracted by the LLM or passed through deterministically from the event.
extractionConfig (dict) --
Configuration for extracting this metadata value from conversational content. Applicable only if extractionType is LLM inferred.
llmExtractionConfig (dict) --
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.
definition (string) -- [REQUIRED]
Description of what this metadata field represents.
validation (dict) --
Validation rules to constrain extracted values.
stringValidation (dict) --
Validation for STRING fields.
allowedValues (list) -- [REQUIRED]
Allowed values for this STRING field.
(string) --
stringListValidation (dict) --
Validation for STRINGLIST fields.
allowedValues (list) --
Allowed values for items in this STRINGLIST field.
(string) --
maxItems (integer) --
Maximum number of items in the string list.
numberValidation (dict) --
Validation for NUMBER fields.
minValue (float) --
Minimum allowed value.
maxValue (float) --
Maximum allowed value.
selfManagedConfiguration (dict) --
The updated self-managed configuration.
triggerConditions (list) --
The updated list of conditions that trigger memory processing.
(dict) --
Condition that triggers memory processing.
messageBasedTrigger (dict) --
Message based trigger configuration.
messageCount (integer) --
The number of messages that trigger memory processing.
tokenBasedTrigger (dict) --
Token based trigger configuration.
tokenCount (integer) --
Number of tokens that trigger memory processing.
timeBasedTrigger (dict) --
Time based trigger configuration.
idleSessionTimeout (integer) --
Idle session timeout (seconds) that triggers memory processing.
invocationConfiguration (dict) --
The updated configuration to invoke self-managed memory processing pipeline.
topicArn (string) --
The updated ARN of the SNS topic for job notifications.
payloadDeliveryBucketName (string) --
The updated S3 bucket name for event payload delivery.
historicalContextWindowSize (integer) --
The updated number of historical messages to include in processing context.
memoryRecordSchema (dict) --
Updated metadata schema for records generated by this strategy.
metadataSchema (list) --
The metadata field definitions for this strategy.
(dict) --
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.
type (string) --
The MetadataValueType.
extractionType (string) --
Specifies whether the metadata value is extracted by the LLM or passed through deterministically from the event.
extractionConfig (dict) --
Configuration for extracting this metadata value from conversational content. Applicable only if extractionType is LLM inferred.
llmExtractionConfig (dict) --
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.
definition (string) -- [REQUIRED]
Description of what this metadata field represents.
validation (dict) --
Validation rules to constrain extracted values.
stringValidation (dict) --
Validation for STRING fields.
allowedValues (list) -- [REQUIRED]
Allowed values for this STRING field.
(string) --
stringListValidation (dict) --
Validation for STRINGLIST fields.
allowedValues (list) --
Allowed values for items in this STRINGLIST field.
(string) --
maxItems (integer) --
Maximum number of items in the string list.
numberValidation (dict) --
Validation for NUMBER fields.
minValue (float) --
Minimum allowed value.
maxValue (float) --
Maximum allowed value.
deleteMemoryStrategies (list) --
The list of memory strategies to delete.
(dict) --
Input for deleting a memory strategy.
memoryStrategyId (string) -- [REQUIRED]
The unique identifier of the memory strategy to delete.
list
Additional metadata keys to index. Previously indexed keys cannot be removed.
(dict) --
A metadata key indexed for filtering.
key (string) -- [REQUIRED]
The metadata key name to index.
type (string) -- [REQUIRED]
The data type of the indexed key.
dict
Configuration for streaming memory record data to external resources.
resources (list) -- [REQUIRED]
List of stream delivery resource configurations.
(dict) --
Supported stream delivery resource types.
kinesis (dict) --
Kinesis Data Stream configuration.
dataStreamArn (string) -- [REQUIRED]
ARN of the Kinesis Data Stream.
contentConfigurations (list) -- [REQUIRED]
Content configurations for stream delivery.
(dict) --
Defines what content to stream and at what level of detail.
type (string) -- [REQUIRED]
Type of content to stream.
level (string) --
Level of detail for streamed content.
dict
Response Syntax
{
'memory': {
'arn': 'string',
'id': 'string',
'name': 'string',
'description': 'string',
'encryptionKeyArn': 'string',
'memoryExecutionRoleArn': 'string',
'eventExpiryDuration': 123,
'status': 'CREATING'|'ACTIVE'|'FAILED'|'DELETING'|'UPDATING',
'failureReason': 'string',
'createdAt': datetime(2015, 1, 1),
'updatedAt': datetime(2015, 1, 1),
'strategies': [
{
'strategyId': 'string',
'name': 'string',
'description': 'string',
'configuration': {
'type': 'SEMANTIC_OVERRIDE'|'SUMMARY_OVERRIDE'|'USER_PREFERENCE_OVERRIDE'|'SELF_MANAGED'|'EPISODIC_OVERRIDE',
'extraction': {
'customExtractionConfiguration': {
'semanticExtractionOverride': {
'appendToPrompt': 'string',
'modelId': 'string'
},
'userPreferenceExtractionOverride': {
'appendToPrompt': 'string',
'modelId': 'string'
},
'episodicExtractionOverride': {
'appendToPrompt': 'string',
'modelId': 'string'
}
}
},
'consolidation': {
'customConsolidationConfiguration': {
'semanticConsolidationOverride': {
'appendToPrompt': 'string',
'modelId': 'string'
},
'summaryConsolidationOverride': {
'appendToPrompt': 'string',
'modelId': 'string'
},
'userPreferenceConsolidationOverride': {
'appendToPrompt': 'string',
'modelId': 'string'
},
'episodicConsolidationOverride': {
'appendToPrompt': 'string',
'modelId': 'string'
}
}
},
'reflection': {
'customReflectionConfiguration': {
'episodicReflectionOverride': {
'appendToPrompt': 'string',
'modelId': 'string',
'namespaces': [
'string',
],
'namespaceTemplates': [
'string',
],
'memoryRecordSchema': {
'metadataSchema': [
{
'key': 'string',
'type': 'STRING'|'STRINGLIST'|'NUMBER',
'extractionType': 'LLM_INFERRED'|'STRICTLY_CONSISTENT',
'extractionConfig': {
'llmExtractionConfig': {
'llmExtractionInstruction': 'string',
'definition': 'string',
'validation': {
'stringValidation': {
'allowedValues': [
'string',
]
},
'stringListValidation': {
'allowedValues': [
'string',
],
'maxItems': 123
},
'numberValidation': {
'minValue': 123.0,
'maxValue': 123.0
}
}
}
}
},
]
}
}
},
'episodicReflectionConfiguration': {
'namespaces': [
'string',
],
'namespaceTemplates': [
'string',
],
'memoryRecordSchema': {
'metadataSchema': [
{
'key': 'string',
'type': 'STRING'|'STRINGLIST'|'NUMBER',
'extractionType': 'LLM_INFERRED'|'STRICTLY_CONSISTENT',
'extractionConfig': {
'llmExtractionConfig': {
'llmExtractionInstruction': 'string',
'definition': 'string',
'validation': {
'stringValidation': {
'allowedValues': [
'string',
]
},
'stringListValidation': {
'allowedValues': [
'string',
],
'maxItems': 123
},
'numberValidation': {
'minValue': 123.0,
'maxValue': 123.0
}
}
}
}
},
]
}
}
},
'selfManagedConfiguration': {
'triggerConditions': [
{
'messageBasedTrigger': {
'messageCount': 123
},
'tokenBasedTrigger': {
'tokenCount': 123
},
'timeBasedTrigger': {
'idleSessionTimeout': 123
}
},
],
'invocationConfiguration': {
'topicArn': 'string',
'payloadDeliveryBucketName': 'string'
},
'historicalContextWindowSize': 123
}
},
'type': 'SEMANTIC'|'SUMMARIZATION'|'USER_PREFERENCE'|'CUSTOM'|'EPISODIC',
'namespaces': [
'string',
],
'namespaceTemplates': [
'string',
],
'createdAt': datetime(2015, 1, 1),
'updatedAt': datetime(2015, 1, 1),
'status': 'CREATING'|'ACTIVE'|'DELETING'|'FAILED',
'memoryRecordSchema': {
'metadataSchema': [
{
'key': 'string',
'type': 'STRING'|'STRINGLIST'|'NUMBER',
'extractionType': 'LLM_INFERRED'|'STRICTLY_CONSISTENT',
'extractionConfig': {
'llmExtractionConfig': {
'llmExtractionInstruction': 'string',
'definition': 'string',
'validation': {
'stringValidation': {
'allowedValues': [
'string',
]
},
'stringListValidation': {
'allowedValues': [
'string',
],
'maxItems': 123
},
'numberValidation': {
'minValue': 123.0,
'maxValue': 123.0
}
}
}
}
},
]
}
},
],
'indexedKeys': [
{
'key': 'string',
'type': 'STRING'|'STRINGLIST'|'NUMBER'
},
],
'streamDeliveryResources': {
'resources': [
{
'kinesis': {
'dataStreamArn': 'string',
'contentConfigurations': [
{
'type': 'MEMORY_RECORDS',
'level': 'METADATA_ONLY'|'FULL_CONTENT'
},
]
}
},
]
}
}
}
Response Structure
(dict) --
memory (dict) --
The updated AgentCore Memory resource details.
arn (string) --
The Amazon Resource Name (ARN) of the memory.
id (string) --
The unique identifier of the memory.
name (string) --
The name of the memory.
description (string) --
The description of the memory.
encryptionKeyArn (string) --
The ARN of the KMS key used to encrypt the memory.
memoryExecutionRoleArn (string) --
The ARN of the IAM role that provides permissions for the memory.
eventExpiryDuration (integer) --
The number of days after which memory events will expire.
status (string) --
The current status of the memory.
failureReason (string) --
The reason for failure if the memory is in a failed state.
createdAt (datetime) --
The timestamp when the memory was created.
updatedAt (datetime) --
The timestamp when the memory was last updated.
strategies (list) --
The list of memory strategies associated with this memory.
(dict) --
Contains information about a memory strategy.
strategyId (string) --
The unique identifier of the memory strategy.
name (string) --
The name of the memory strategy.
description (string) --
The description of the memory strategy.
configuration (dict) --
The configuration of the memory strategy.
type (string) --
The type of override for the strategy configuration.
extraction (dict) --
The extraction configuration for the memory strategy.
customExtractionConfiguration (dict) --
The custom extraction configuration.
semanticExtractionOverride (dict) --
The semantic extraction override configuration.
appendToPrompt (string) --
The text to append to the prompt for semantic extraction.
modelId (string) --
The model ID to use for semantic extraction.
userPreferenceExtractionOverride (dict) --
The user preference extraction override configuration.
appendToPrompt (string) --
The text to append to the prompt for user preference extraction.
modelId (string) --
The model ID to use for user preference extraction.
episodicExtractionOverride (dict) --
The configurations to override the default extraction step for the episodic memory strategy.
appendToPrompt (string) --
The text appended to the prompt for the extraction step of the episodic memory strategy.
modelId (string) --
The model ID used for the extraction step of the episodic memory strategy.
consolidation (dict) --
The consolidation configuration for the memory strategy.
customConsolidationConfiguration (dict) --
The custom consolidation configuration.
semanticConsolidationOverride (dict) --
The semantic consolidation override configuration.
appendToPrompt (string) --
The text to append to the prompt for semantic consolidation.
modelId (string) --
The model ID to use for semantic consolidation.
summaryConsolidationOverride (dict) --
The summary consolidation override configuration.
appendToPrompt (string) --
The text to append to the prompt for summary consolidation.
modelId (string) --
The model ID to use for summary consolidation.
userPreferenceConsolidationOverride (dict) --
The user preference consolidation override configuration.
appendToPrompt (string) --
The text to append to the prompt for user preference consolidation.
modelId (string) --
The model ID to use for user preference consolidation.
episodicConsolidationOverride (dict) --
The configurations to override the default consolidation step for the episodic memory strategy.
appendToPrompt (string) --
The text appended to the prompt for the consolidation step of the episodic memory strategy.
modelId (string) --
The model ID used for the consolidation step of the episodic memory strategy.
reflection (dict) --
The reflection configuration for the memory strategy.
customReflectionConfiguration (dict) --
The configuration for a custom reflection strategy.
episodicReflectionOverride (dict) --
The configuration for a reflection strategy to override the default one.
appendToPrompt (string) --
The text appended to the prompt for the reflection step of the episodic memory strategy.
modelId (string) --
The model ID used for the reflection step of the episodic memory strategy.
namespaces (list) --
This is a legacy parameter. The namespaces over which reflections were created. Can be less nested than the episodic namespaces.
(string) --
namespaceTemplates (list) --
The namespaceTemplates over which reflections were created. Can be less nested than the episodic namespaces.
(string) --
memoryRecordSchema (dict) --
Schema for metadata fields on records generated by this reflection override.
metadataSchema (list) --
The metadata field definitions for this strategy.
(dict) --
A metadata field definition within a strategy's schema.
key (string) --
The metadata field name. Must match an indexed key to be queryable via metadata filters.
type (string) --
The MetadataValueType.
extractionType (string) --
Specifies whether the metadata value is extracted by the LLM or passed through deterministically from the event.
extractionConfig (dict) --
Configuration for extracting this metadata value from conversational content. Applicable only if extractionType is LLM inferred.
llmExtractionConfig (dict) --
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.
definition (string) --
Description of what this metadata field represents.
validation (dict) --
Validation rules to constrain extracted values.
stringValidation (dict) --
Validation for STRING fields.
allowedValues (list) --
Allowed values for this STRING field.
(string) --
stringListValidation (dict) --
Validation for STRINGLIST fields.
allowedValues (list) --
Allowed values for items in this STRINGLIST field.
(string) --
maxItems (integer) --
Maximum number of items in the string list.
numberValidation (dict) --
Validation for NUMBER fields.
minValue (float) --
Minimum allowed value.
maxValue (float) --
Maximum allowed value.
episodicReflectionConfiguration (dict) --
The configuration for the episodic reflection strategy.
namespaces (list) --
This is a legacy parameter, use namespaceTemplates. The namespaces for which to create reflections. Can be less nested than the episodic namespaces.
(string) --
namespaceTemplates (list) --
The namespaceTemplates for which to create reflections. Can be less nested than the episodic namespaces.
(string) --
memoryRecordSchema (dict) --
"Schema for metadata fields on records generated by reflections.
metadataSchema (list) --
The metadata field definitions for this strategy.
(dict) --
A metadata field definition within a strategy's schema.
key (string) --
The metadata field name. Must match an indexed key to be queryable via metadata filters.
type (string) --
The MetadataValueType.
extractionType (string) --
Specifies whether the metadata value is extracted by the LLM or passed through deterministically from the event.
extractionConfig (dict) --
Configuration for extracting this metadata value from conversational content. Applicable only if extractionType is LLM inferred.
llmExtractionConfig (dict) --
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.
definition (string) --
Description of what this metadata field represents.
validation (dict) --
Validation rules to constrain extracted values.
stringValidation (dict) --
Validation for STRING fields.
allowedValues (list) --
Allowed values for this STRING field.
(string) --
stringListValidation (dict) --
Validation for STRINGLIST fields.
allowedValues (list) --
Allowed values for items in this STRINGLIST field.
(string) --
maxItems (integer) --
Maximum number of items in the string list.
numberValidation (dict) --
Validation for NUMBER fields.
minValue (float) --
Minimum allowed value.
maxValue (float) --
Maximum allowed value.
selfManagedConfiguration (dict) --
Self-managed configuration settings.
triggerConditions (list) --
A list of conditions that trigger memory processing.
(dict) --
Condition that triggers memory processing.
messageBasedTrigger (dict) --
Message based trigger configuration.
messageCount (integer) --
The number of messages that trigger memory processing.
tokenBasedTrigger (dict) --
Token based trigger configuration.
tokenCount (integer) --
Number of tokens that trigger memory processing.
timeBasedTrigger (dict) --
Time based trigger configuration.
idleSessionTimeout (integer) --
Idle session timeout (seconds) that triggers memory processing.
invocationConfiguration (dict) --
The configuration to use when invoking memory processing.
topicArn (string) --
The ARN of the SNS topic for job notifications.
payloadDeliveryBucketName (string) --
The S3 bucket name for event payload delivery.
historicalContextWindowSize (integer) --
The number of historical messages to include in processing context.
type (string) --
The type of the memory strategy.
namespaces (list) --
This is a legacy parameter. The namespaces associated with the memory strategy.
(string) --
namespaceTemplates (list) --
The namespaceTemplates associated with the memory strategy.
(string) --
createdAt (datetime) --
The timestamp when the memory strategy was created.
updatedAt (datetime) --
The timestamp when the memory strategy was last updated.
status (string) --
The current status of the memory strategy.
memoryRecordSchema (dict) --
Schema for metadata fields on records generated by this strategy.
metadataSchema (list) --
The metadata field definitions for this strategy.
(dict) --
A metadata field definition within a strategy's schema.
key (string) --
The metadata field name. Must match an indexed key to be queryable via metadata filters.
type (string) --
The MetadataValueType.
extractionType (string) --
Specifies whether the metadata value is extracted by the LLM or passed through deterministically from the event.
extractionConfig (dict) --
Configuration for extracting this metadata value from conversational content. Applicable only if extractionType is LLM inferred.
llmExtractionConfig (dict) --
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.
definition (string) --
Description of what this metadata field represents.
validation (dict) --
Validation rules to constrain extracted values.
stringValidation (dict) --
Validation for STRING fields.
allowedValues (list) --
Allowed values for this STRING field.
(string) --
stringListValidation (dict) --
Validation for STRINGLIST fields.
allowedValues (list) --
Allowed values for items in this STRINGLIST field.
(string) --
maxItems (integer) --
Maximum number of items in the string list.
numberValidation (dict) --
Validation for NUMBER fields.
minValue (float) --
Minimum allowed value.
maxValue (float) --
Maximum allowed value.
indexedKeys (list) --
The indexed metadata keys for this memory. Only indexed keys can be used in metadata filters.
(dict) --
A metadata key indexed for filtering.
key (string) --
The metadata key name to index.
type (string) --
The data type of the indexed key.
streamDeliveryResources (dict) --
Configuration for streaming memory record data to external resources.
resources (list) --
List of stream delivery resource configurations.
(dict) --
Supported stream delivery resource types.
kinesis (dict) --
Kinesis Data Stream configuration.
dataStreamArn (string) --
ARN of the Kinesis Data Stream.
contentConfigurations (list) --
Content configurations for stream delivery.
(dict) --
Defines what content to stream and at what level of detail.
type (string) --
Type of content to stream.
level (string) --
Level of detail for streamed content.