Amazon Bedrock AgentCore Control

2026/03/06 - Amazon Bedrock AgentCore Control - 3 updated api methods

Changes  Adds support for streaming memory records in AgentCore Memory

CreateMemory (updated) Link ¶
Changes (request, response)
Request
{'streamDeliveryResources': {'resources': [{'kinesis': {'contentConfigurations': [{'level': 'METADATA_ONLY '
                                                                                            '| '
                                                                                            'FULL_CONTENT',
                                                                                   'type': 'MEMORY_RECORDS'}],
                                                        'dataStreamArn': 'string'}}]}}
Response
{'memory': {'streamDeliveryResources': {'resources': [{'kinesis': {'contentConfigurations': [{'level': 'METADATA_ONLY '
                                                                                                       '| '
                                                                                                       'FULL_CONTENT',
                                                                                              'type': 'MEMORY_RECORDS'}],
                                                                   'dataStreamArn': 'string'}}]}}}

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',
                ]
            },
            'summaryMemoryStrategy': {
                'name': 'string',
                'description': 'string',
                'namespaces': [
                    'string',
                ]
            },
            'userPreferenceMemoryStrategy': {
                'name': 'string',
                'description': 'string',
                'namespaces': [
                    'string',
                ]
            },
            'customMemoryStrategy': {
                'name': 'string',
                'description': 'string',
                'namespaces': [
                    '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',
                            ]
                        }
                    },
                    'selfManagedConfiguration': {
                        'triggerConditions': [
                            {
                                'messageBasedTrigger': {
                                    'messageCount': 123
                                },
                                'tokenBasedTrigger': {
                                    'tokenCount': 123
                                },
                                'timeBasedTrigger': {
                                    'idleSessionTimeout': 123
                                }
                            },
                        ],
                        'invocationConfiguration': {
                            'topicArn': 'string',
                            'payloadDeliveryBucketName': 'string'
                        },
                        'historicalContextWindowSize': 123
                    }
                }
            },
            'episodicMemoryStrategy': {
                'name': 'string',
                'description': 'string',
                'namespaces': [
                    'string',
                ],
                'reflectionConfiguration': {
                    'namespaces': [
                        'string',
                    ]
                }
            }
        },
    ],
    streamDeliveryResources={
        'resources': [
            {
                'kinesis': {
                    'dataStreamArn': 'string',
                    'contentConfigurations': [
                        {
                            'type': 'MEMORY_RECORDS',
                            'level': 'METADATA_ONLY'|'FULL_CONTENT'
                        },
                    ]
                }
            },
        ]
    },
    tags={
        'string': 'string'
    }
)
type clientToken:

string

param clientToken:

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.

type name:

string

param name:

[REQUIRED]

The name of the memory. The name must be unique within your account.

type description:

string

param description:

The description of the memory.

type encryptionKeyArn:

string

param encryptionKeyArn:

The Amazon Resource Name (ARN) of the KMS key used to encrypt the memory data.

type memoryExecutionRoleArn:

string

param memoryExecutionRoleArn:

The Amazon Resource Name (ARN) of the IAM role that provides permissions for the memory to access Amazon Web Services services.

type eventExpiryDuration:

integer

param eventExpiryDuration:

[REQUIRED]

The duration after which memory events expire. Specified as an ISO 8601 duration.

type memoryStrategies:

list

param memoryStrategies:

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) --

        The namespaces associated with the semantic memory strategy.

        • (string) --

    • 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) --

        The namespaces associated with the summary memory strategy.

        • (string) --

    • 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) --

        The namespaces associated with the user preference memory strategy.

        • (string) --

    • 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) --

        The namespaces 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) --

              The namespaces to use for episodic reflection. Can be less nested than the episodic namespaces.

              • (string) --

        • 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.

    • 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) --

        The namespaces for which to create episodes.

        • (string) --

      • reflectionConfiguration (dict) --

        The configuration for the reflections created with the episodic memory strategy.

        • namespaces (list) -- [REQUIRED]

          The namespaces over which to create reflections. Can be less nested than episode namespaces.

          • (string) --

type streamDeliveryResources:

dict

param streamDeliveryResources:

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.

type tags:

dict

param tags:

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) --

rtype:

dict

returns:

Response Syntax

{
    'memory': {
        'arn': 'string',
        'id': 'string',
        'name': 'string',
        'description': 'string',
        'encryptionKeyArn': 'string',
        'memoryExecutionRoleArn': 'string',
        'eventExpiryDuration': 123,
        'status': 'CREATING'|'ACTIVE'|'FAILED'|'DELETING',
        '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',
                                ]
                            }
                        },
                        'episodicReflectionConfiguration': {
                            'namespaces': [
                                'string',
                            ]
                        }
                    },
                    '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',
                ],
                'createdAt': datetime(2015, 1, 1),
                'updatedAt': datetime(2015, 1, 1),
                'status': 'CREATING'|'ACTIVE'|'DELETING'|'FAILED'
            },
        ],
        '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) --

                    The namespaces over which reflections were created. Can be less nested than the episodic namespaces.

                    • (string) --

              • episodicReflectionConfiguration (dict) --

                The configuration for the episodic reflection strategy.

                • namespaces (list) --

                  The namespaces for which to create reflections. Can be less nested than the episodic namespaces.

                  • (string) --

            • 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) --

            The namespaces 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.

      • 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.

GetMemory (updated) Link ¶
Changes (response)
{'memory': {'streamDeliveryResources': {'resources': [{'kinesis': {'contentConfigurations': [{'level': 'METADATA_ONLY '
                                                                                                       '| '
                                                                                                       'FULL_CONTENT',
                                                                                              'type': 'MEMORY_RECORDS'}],
                                                                   'dataStreamArn': 'string'}}]}}}

Retrieve an existing Amazon Bedrock AgentCore Memory resource.

See also: AWS API Documentation

Request Syntax

client.get_memory(
    memoryId='string',
    view='full'|'without_decryption'
)
type memoryId:

string

param memoryId:

[REQUIRED]

The unique identifier of the memory to retrieve.

type view:

string

param view:

The level of detail to return for the memory.

rtype:

dict

returns:

Response Syntax

{
    'memory': {
        'arn': 'string',
        'id': 'string',
        'name': 'string',
        'description': 'string',
        'encryptionKeyArn': 'string',
        'memoryExecutionRoleArn': 'string',
        'eventExpiryDuration': 123,
        'status': 'CREATING'|'ACTIVE'|'FAILED'|'DELETING',
        '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',
                                ]
                            }
                        },
                        'episodicReflectionConfiguration': {
                            'namespaces': [
                                'string',
                            ]
                        }
                    },
                    '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',
                ],
                'createdAt': datetime(2015, 1, 1),
                'updatedAt': datetime(2015, 1, 1),
                'status': 'CREATING'|'ACTIVE'|'DELETING'|'FAILED'
            },
        ],
        '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) --

                    The namespaces over which reflections were created. Can be less nested than the episodic namespaces.

                    • (string) --

              • episodicReflectionConfiguration (dict) --

                The configuration for the episodic reflection strategy.

                • namespaces (list) --

                  The namespaces for which to create reflections. Can be less nested than the episodic namespaces.

                  • (string) --

            • 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) --

            The namespaces 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.

      • 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.

UpdateMemory (updated) Link ¶
Changes (request, response)
Request
{'streamDeliveryResources': {'resources': [{'kinesis': {'contentConfigurations': [{'level': 'METADATA_ONLY '
                                                                                            '| '
                                                                                            'FULL_CONTENT',
                                                                                   'type': 'MEMORY_RECORDS'}],
                                                        'dataStreamArn': 'string'}}]}}
Response
{'memory': {'streamDeliveryResources': {'resources': [{'kinesis': {'contentConfigurations': [{'level': 'METADATA_ONLY '
                                                                                                       '| '
                                                                                                       'FULL_CONTENT',
                                                                                              'type': 'MEMORY_RECORDS'}],
                                                                   'dataStreamArn': 'string'}}]}}}

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',
                    ]
                },
                'summaryMemoryStrategy': {
                    'name': 'string',
                    'description': 'string',
                    'namespaces': [
                        'string',
                    ]
                },
                'userPreferenceMemoryStrategy': {
                    'name': 'string',
                    'description': 'string',
                    'namespaces': [
                        'string',
                    ]
                },
                'customMemoryStrategy': {
                    'name': 'string',
                    'description': 'string',
                    'namespaces': [
                        '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',
                                ]
                            }
                        },
                        'selfManagedConfiguration': {
                            'triggerConditions': [
                                {
                                    'messageBasedTrigger': {
                                        'messageCount': 123
                                    },
                                    'tokenBasedTrigger': {
                                        'tokenCount': 123
                                    },
                                    'timeBasedTrigger': {
                                        'idleSessionTimeout': 123
                                    }
                                },
                            ],
                            'invocationConfiguration': {
                                'topicArn': 'string',
                                'payloadDeliveryBucketName': 'string'
                            },
                            'historicalContextWindowSize': 123
                        }
                    }
                },
                'episodicMemoryStrategy': {
                    'name': 'string',
                    'description': 'string',
                    'namespaces': [
                        'string',
                    ],
                    'reflectionConfiguration': {
                        'namespaces': [
                            'string',
                        ]
                    }
                }
            },
        ],
        'modifyMemoryStrategies': [
            {
                'memoryStrategyId': 'string',
                'description': 'string',
                'namespaces': [
                    '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',
                            ]
                        },
                        'customReflectionConfiguration': {
                            'episodicReflectionOverride': {
                                'appendToPrompt': 'string',
                                'modelId': 'string',
                                'namespaces': [
                                    'string',
                                ]
                            }
                        }
                    },
                    'selfManagedConfiguration': {
                        'triggerConditions': [
                            {
                                'messageBasedTrigger': {
                                    'messageCount': 123
                                },
                                'tokenBasedTrigger': {
                                    'tokenCount': 123
                                },
                                'timeBasedTrigger': {
                                    'idleSessionTimeout': 123
                                }
                            },
                        ],
                        'invocationConfiguration': {
                            'topicArn': 'string',
                            'payloadDeliveryBucketName': 'string'
                        },
                        'historicalContextWindowSize': 123
                    }
                }
            },
        ],
        'deleteMemoryStrategies': [
            {
                'memoryStrategyId': 'string'
            },
        ]
    },
    streamDeliveryResources={
        'resources': [
            {
                'kinesis': {
                    'dataStreamArn': 'string',
                    'contentConfigurations': [
                        {
                            'type': 'MEMORY_RECORDS',
                            'level': 'METADATA_ONLY'|'FULL_CONTENT'
                        },
                    ]
                }
            },
        ]
    }
)
type clientToken:

string

param clientToken:

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.

type memoryId:

string

param memoryId:

[REQUIRED]

The unique identifier of the memory to update.

type description:

string

param description:

The updated description of the AgentCore Memory resource.

type eventExpiryDuration:

integer

param eventExpiryDuration:

The number of days after which memory events will expire, between 7 and 365 days.

type memoryExecutionRoleArn:

string

param memoryExecutionRoleArn:

The ARN of the IAM role that provides permissions for the AgentCore Memory resource.

type memoryStrategies:

dict

param memoryStrategies:

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) --

          The namespaces associated with the semantic memory strategy.

          • (string) --

      • 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) --

          The namespaces associated with the summary memory strategy.

          • (string) --

      • 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) --

          The namespaces associated with the user preference memory strategy.

          • (string) --

      • 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) --

          The namespaces 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) --

                The namespaces to use for episodic reflection. Can be less nested than the episodic namespaces.

                • (string) --

          • 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.

      • 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) --

          The namespaces for which to create episodes.

          • (string) --

        • reflectionConfiguration (dict) --

          The configuration for the reflections created with the episodic memory strategy.

          • namespaces (list) -- [REQUIRED]

            The namespaces over which to create reflections. Can be less nested than episode namespaces.

            • (string) --

  • 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) --

        The updated namespaces 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) -- [REQUIRED]

              The namespaces over which to create reflections. Can be less nested than episode namespaces.

              • (string) --

          • 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) --

                The namespaces to use for episodic reflection. Can be less nested than the episodic namespaces.

                • (string) --

        • 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.

  • 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.

type streamDeliveryResources:

dict

param streamDeliveryResources:

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.

rtype:

dict

returns:

Response Syntax

{
    'memory': {
        'arn': 'string',
        'id': 'string',
        'name': 'string',
        'description': 'string',
        'encryptionKeyArn': 'string',
        'memoryExecutionRoleArn': 'string',
        'eventExpiryDuration': 123,
        'status': 'CREATING'|'ACTIVE'|'FAILED'|'DELETING',
        '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',
                                ]
                            }
                        },
                        'episodicReflectionConfiguration': {
                            'namespaces': [
                                'string',
                            ]
                        }
                    },
                    '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',
                ],
                'createdAt': datetime(2015, 1, 1),
                'updatedAt': datetime(2015, 1, 1),
                'status': 'CREATING'|'ACTIVE'|'DELETING'|'FAILED'
            },
        ],
        '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) --

                    The namespaces over which reflections were created. Can be less nested than the episodic namespaces.

                    • (string) --

              • episodicReflectionConfiguration (dict) --

                The configuration for the episodic reflection strategy.

                • namespaces (list) --

                  The namespaces for which to create reflections. Can be less nested than the episodic namespaces.

                  • (string) --

            • 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) --

            The namespaces 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.

      • 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.