Creates a new Amazon Bedrock AgentCore Memory resource¶
Description¶
Creates a new Amazon Bedrock AgentCore Memory resource.
Usage¶
bedrockagentcorecontrol_create_memory(clientToken, name, description,
encryptionKeyArn, memoryExecutionRoleArn, eventExpiryDuration,
memoryStrategies, indexedKeys, namespaceKeys, streamDeliveryResources,
tags)
Arguments¶
-
clientTokenA 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.
-
name[required] The name of the memory. The name must be unique within your account.
-
descriptionThe description of the memory.
-
encryptionKeyArnThe Amazon Resource Name (ARN) of the KMS key used to encrypt the memory data.
-
memoryExecutionRoleArnThe Amazon Resource Name (ARN) of the IAM role that provides permissions for the memory to access Amazon Web Services services.
-
eventExpiryDuration[required] The duration after which memory events expire. Specified as an ISO 8601 duration.
-
memoryStrategiesThe memory strategies to use for this memory. Strategies define how information is extracted, processed, and consolidated.
-
indexedKeysMetadata keys to index for filtering. Once declared, indexed keys cannot be removed.
-
namespaceKeysThe namespace variable key definitions with optional validation rules. Use these
namespaceKeysinnamespaceTemplatesto control namespace hierarchy. -
streamDeliveryResourcesConfiguration for streaming memory record data to external resources.
-
tagsA 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.
Value¶
A list with the following syntax:
list(
memory = list(
arn = "string",
id = "string",
name = "string",
description = "string",
encryptionKeyArn = "string",
memoryExecutionRoleArn = "string",
eventExpiryDuration = 123,
status = "CREATING"|"ACTIVE"|"FAILED"|"DELETING"|"UPDATING",
failureReason = "string",
createdAt = as.POSIXct(
"2015-01-01"
),
updatedAt = as.POSIXct(
"2015-01-01"
),
strategies = list(
list(
strategyId = "string",
name = "string",
description = "string",
configuration = list(
type = "SEMANTIC_OVERRIDE"|"SUMMARY_OVERRIDE"|"USER_PREFERENCE_OVERRIDE"|"SELF_MANAGED"|"EPISODIC_OVERRIDE",
extraction = list(
customExtractionConfiguration = list(
semanticExtractionOverride = list(
appendToPrompt = "string",
modelId = "string"
),
userPreferenceExtractionOverride = list(
appendToPrompt = "string",
modelId = "string"
),
episodicExtractionOverride = list(
appendToPrompt = "string",
modelId = "string"
)
)
),
consolidation = list(
customConsolidationConfiguration = list(
semanticConsolidationOverride = list(
appendToPrompt = "string",
modelId = "string"
),
summaryConsolidationOverride = list(
appendToPrompt = "string",
modelId = "string"
),
userPreferenceConsolidationOverride = list(
appendToPrompt = "string",
modelId = "string"
),
episodicConsolidationOverride = list(
appendToPrompt = "string",
modelId = "string"
)
)
),
reflection = list(
customReflectionConfiguration = list(
episodicReflectionOverride = list(
appendToPrompt = "string",
modelId = "string",
namespaces = list(
"string"
),
namespaceTemplates = list(
"string"
),
memoryRecordSchema = list(
metadataSchema = list(
list(
key = "string",
type = "STRING"|"STRINGLIST"|"NUMBER",
extractionType = "LLM_INFERRED"|"STRICTLY_CONSISTENT",
extractionConfig = list(
llmExtractionConfig = list(
llmExtractionInstruction = "string",
definition = "string",
validation = list(
stringValidation = list(
allowedValues = list(
"string"
)
),
stringListValidation = list(
allowedValues = list(
"string"
),
maxItems = 123
),
numberValidation = list(
minValue = 123.0,
maxValue = 123.0
)
)
)
)
)
)
)
)
),
episodicReflectionConfiguration = list(
namespaces = list(
"string"
),
namespaceTemplates = list(
"string"
),
memoryRecordSchema = list(
metadataSchema = list(
list(
key = "string",
type = "STRING"|"STRINGLIST"|"NUMBER",
extractionType = "LLM_INFERRED"|"STRICTLY_CONSISTENT",
extractionConfig = list(
llmExtractionConfig = list(
llmExtractionInstruction = "string",
definition = "string",
validation = list(
stringValidation = list(
allowedValues = list(
"string"
)
),
stringListValidation = list(
allowedValues = list(
"string"
),
maxItems = 123
),
numberValidation = list(
minValue = 123.0,
maxValue = 123.0
)
)
)
)
)
)
)
)
),
selfManagedConfiguration = list(
triggerConditions = list(
list(
messageBasedTrigger = list(
messageCount = 123
),
tokenBasedTrigger = list(
tokenCount = 123
),
timeBasedTrigger = list(
idleSessionTimeout = 123
)
)
),
invocationConfiguration = list(
topicArn = "string",
payloadDeliveryBucketName = "string"
),
historicalContextWindowSize = 123
)
),
type = "SEMANTIC"|"SUMMARIZATION"|"USER_PREFERENCE"|"CUSTOM"|"EPISODIC",
namespaces = list(
"string"
),
namespaceTemplates = list(
"string"
),
createdAt = as.POSIXct(
"2015-01-01"
),
updatedAt = as.POSIXct(
"2015-01-01"
),
status = "CREATING"|"ACTIVE"|"DELETING"|"FAILED",
memoryRecordSchema = list(
metadataSchema = list(
list(
key = "string",
type = "STRING"|"STRINGLIST"|"NUMBER",
extractionType = "LLM_INFERRED"|"STRICTLY_CONSISTENT",
extractionConfig = list(
llmExtractionConfig = list(
llmExtractionInstruction = "string",
definition = "string",
validation = list(
stringValidation = list(
allowedValues = list(
"string"
)
),
stringListValidation = list(
allowedValues = list(
"string"
),
maxItems = 123
),
numberValidation = list(
minValue = 123.0,
maxValue = 123.0
)
)
)
)
)
)
)
)
),
indexedKeys = list(
list(
key = "string",
type = "STRING"|"STRINGLIST"|"NUMBER"
)
),
namespaceKeys = list(
list(
key = "string",
validation = list(
allowedValues = list(
"string"
),
regexPattern = "string"
)
)
),
streamDeliveryResources = list(
resources = list(
list(
kinesis = list(
dataStreamArn = "string",
contentConfigurations = list(
list(
type = "MEMORY_RECORDS",
level = "METADATA_ONLY"|"FULL_CONTENT"
)
)
)
)
)
),
managedByResourceArn = "string"
)
)
Request syntax¶
svc$create_memory(
clientToken = "string",
name = "string",
description = "string",
encryptionKeyArn = "string",
memoryExecutionRoleArn = "string",
eventExpiryDuration = 123,
memoryStrategies = list(
list(
semanticMemoryStrategy = list(
name = "string",
description = "string",
namespaces = list(
"string"
),
namespaceTemplates = list(
"string"
),
memoryRecordSchema = list(
metadataSchema = list(
list(
key = "string",
type = "STRING"|"STRINGLIST"|"NUMBER",
extractionType = "LLM_INFERRED"|"STRICTLY_CONSISTENT",
extractionConfig = list(
llmExtractionConfig = list(
llmExtractionInstruction = "string",
definition = "string",
validation = list(
stringValidation = list(
allowedValues = list(
"string"
)
),
stringListValidation = list(
allowedValues = list(
"string"
),
maxItems = 123
),
numberValidation = list(
minValue = 123.0,
maxValue = 123.0
)
)
)
)
)
)
)
),
summaryMemoryStrategy = list(
name = "string",
description = "string",
namespaces = list(
"string"
),
namespaceTemplates = list(
"string"
),
memoryRecordSchema = list(
metadataSchema = list(
list(
key = "string",
type = "STRING"|"STRINGLIST"|"NUMBER",
extractionType = "LLM_INFERRED"|"STRICTLY_CONSISTENT",
extractionConfig = list(
llmExtractionConfig = list(
llmExtractionInstruction = "string",
definition = "string",
validation = list(
stringValidation = list(
allowedValues = list(
"string"
)
),
stringListValidation = list(
allowedValues = list(
"string"
),
maxItems = 123
),
numberValidation = list(
minValue = 123.0,
maxValue = 123.0
)
)
)
)
)
)
)
),
userPreferenceMemoryStrategy = list(
name = "string",
description = "string",
namespaces = list(
"string"
),
namespaceTemplates = list(
"string"
),
memoryRecordSchema = list(
metadataSchema = list(
list(
key = "string",
type = "STRING"|"STRINGLIST"|"NUMBER",
extractionType = "LLM_INFERRED"|"STRICTLY_CONSISTENT",
extractionConfig = list(
llmExtractionConfig = list(
llmExtractionInstruction = "string",
definition = "string",
validation = list(
stringValidation = list(
allowedValues = list(
"string"
)
),
stringListValidation = list(
allowedValues = list(
"string"
),
maxItems = 123
),
numberValidation = list(
minValue = 123.0,
maxValue = 123.0
)
)
)
)
)
)
)
),
customMemoryStrategy = list(
name = "string",
description = "string",
namespaces = list(
"string"
),
namespaceTemplates = list(
"string"
),
configuration = list(
semanticOverride = list(
extraction = list(
appendToPrompt = "string",
modelId = "string"
),
consolidation = list(
appendToPrompt = "string",
modelId = "string"
)
),
summaryOverride = list(
consolidation = list(
appendToPrompt = "string",
modelId = "string"
)
),
userPreferenceOverride = list(
extraction = list(
appendToPrompt = "string",
modelId = "string"
),
consolidation = list(
appendToPrompt = "string",
modelId = "string"
)
),
episodicOverride = list(
extraction = list(
appendToPrompt = "string",
modelId = "string"
),
consolidation = list(
appendToPrompt = "string",
modelId = "string"
),
reflection = list(
appendToPrompt = "string",
modelId = "string",
namespaces = list(
"string"
),
namespaceTemplates = list(
"string"
),
memoryRecordSchema = list(
metadataSchema = list(
list(
key = "string",
type = "STRING"|"STRINGLIST"|"NUMBER",
extractionType = "LLM_INFERRED"|"STRICTLY_CONSISTENT",
extractionConfig = list(
llmExtractionConfig = list(
llmExtractionInstruction = "string",
definition = "string",
validation = list(
stringValidation = list(
allowedValues = list(
"string"
)
),
stringListValidation = list(
allowedValues = list(
"string"
),
maxItems = 123
),
numberValidation = list(
minValue = 123.0,
maxValue = 123.0
)
)
)
)
)
)
)
)
),
selfManagedConfiguration = list(
triggerConditions = list(
list(
messageBasedTrigger = list(
messageCount = 123
),
tokenBasedTrigger = list(
tokenCount = 123
),
timeBasedTrigger = list(
idleSessionTimeout = 123
)
)
),
invocationConfiguration = list(
topicArn = "string",
payloadDeliveryBucketName = "string"
),
historicalContextWindowSize = 123
)
),
memoryRecordSchema = list(
metadataSchema = list(
list(
key = "string",
type = "STRING"|"STRINGLIST"|"NUMBER",
extractionType = "LLM_INFERRED"|"STRICTLY_CONSISTENT",
extractionConfig = list(
llmExtractionConfig = list(
llmExtractionInstruction = "string",
definition = "string",
validation = list(
stringValidation = list(
allowedValues = list(
"string"
)
),
stringListValidation = list(
allowedValues = list(
"string"
),
maxItems = 123
),
numberValidation = list(
minValue = 123.0,
maxValue = 123.0
)
)
)
)
)
)
)
),
episodicMemoryStrategy = list(
name = "string",
description = "string",
namespaces = list(
"string"
),
namespaceTemplates = list(
"string"
),
reflectionConfiguration = list(
namespaces = list(
"string"
),
namespaceTemplates = list(
"string"
),
memoryRecordSchema = list(
metadataSchema = list(
list(
key = "string",
type = "STRING"|"STRINGLIST"|"NUMBER",
extractionType = "LLM_INFERRED"|"STRICTLY_CONSISTENT",
extractionConfig = list(
llmExtractionConfig = list(
llmExtractionInstruction = "string",
definition = "string",
validation = list(
stringValidation = list(
allowedValues = list(
"string"
)
),
stringListValidation = list(
allowedValues = list(
"string"
),
maxItems = 123
),
numberValidation = list(
minValue = 123.0,
maxValue = 123.0
)
)
)
)
)
)
)
),
memoryRecordSchema = list(
metadataSchema = list(
list(
key = "string",
type = "STRING"|"STRINGLIST"|"NUMBER",
extractionType = "LLM_INFERRED"|"STRICTLY_CONSISTENT",
extractionConfig = list(
llmExtractionConfig = list(
llmExtractionInstruction = "string",
definition = "string",
validation = list(
stringValidation = list(
allowedValues = list(
"string"
)
),
stringListValidation = list(
allowedValues = list(
"string"
),
maxItems = 123
),
numberValidation = list(
minValue = 123.0,
maxValue = 123.0
)
)
)
)
)
)
)
)
)
),
indexedKeys = list(
list(
key = "string",
type = "STRING"|"STRINGLIST"|"NUMBER"
)
),
namespaceKeys = list(
list(
key = "string",
validation = list(
allowedValues = list(
"string"
),
regexPattern = "string"
)
)
),
streamDeliveryResources = list(
resources = list(
list(
kinesis = list(
dataStreamArn = "string",
contentConfigurations = list(
list(
type = "MEMORY_RECORDS",
level = "METADATA_ONLY"|"FULL_CONTENT"
)
)
)
)
)
),
tags = list(
"string"
)
)