Skip to content

Bedrock Agentcore Control  >  Operations  >  create_memory

create_memory

Operation

create_memory async

create_memory(input: CreateMemoryInput, plugins: list[Plugin] | None = None) -> CreateMemoryOutput

Creates a new Amazon Bedrock AgentCore Memory resource.

Parameters:

Name Type Description Default
input CreateMemoryInput

An instance of CreateMemoryInput.

required
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

None

Returns:

Type Description
CreateMemoryOutput

An instance of CreateMemoryOutput.

Input

CreateMemoryInput dataclass

Dataclass for CreateMemoryInput structure.

Attributes

client_token class-attribute instance-attribute
client_token: str | None = None

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.

description class-attribute instance-attribute
description: str | None = field(repr=False, default=None)

The description of the memory.

encryption_key_arn class-attribute instance-attribute
encryption_key_arn: str | None = None

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

event_expiry_duration class-attribute instance-attribute
event_expiry_duration: int | None = None

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

indexed_keys class-attribute instance-attribute
indexed_keys: list[IndexedKey] | None = None

Metadata keys to index for filtering. Once declared, indexed keys cannot be removed.

memory_execution_role_arn class-attribute instance-attribute
memory_execution_role_arn: str | None = None

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

memory_strategies class-attribute instance-attribute
memory_strategies: list[MemoryStrategyInput] | None = None

The memory strategies to use for this memory. Strategies define how information is extracted, processed, and consolidated.

name class-attribute instance-attribute
name: str | None = None

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

stream_delivery_resources class-attribute instance-attribute
stream_delivery_resources: StreamDeliveryResources | None = None

Configuration for streaming memory record data to external resources.

tags class-attribute instance-attribute
tags: dict[str, str] | None = None

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.

Output

CreateMemoryOutput dataclass

Dataclass for CreateMemoryOutput structure.

Attributes

memory class-attribute instance-attribute
memory: Memory | None = None

The details of the created memory, including its ID, ARN, name, description, and configuration settings.