Create Memory
| bedrockagentcorecontrol_create_memory | R Documentation |
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, streamDeliveryResources, tags)
Arguments¶
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. |
name |
[required] The name of the memory. The name must be unique within your account. |
description |
The description of the memory. |
encryptionKeyArn |
The Amazon Resource Name (ARN) of the KMS key used to encrypt the memory data. |
memoryExecutionRoleArn |
The 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. |
memoryStrategies |
The memory strategies to use for this memory. Strategies define how information is extracted, processed, and consolidated. |
indexedKeys |
Metadata keys to index for filtering. Once declared, indexed keys cannot be removed. |
streamDeliveryResources |
Configuration for streaming memory record data to external resources. |
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. |
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",
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",
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",
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",
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"
)
),
streamDeliveryResources = list(
resources = list(
list(
kinesis = list(
dataStreamArn = "string",
contentConfigurations = list(
list(
type = "MEMORY_RECORDS",
level = "METADATA_ONLY"|"FULL_CONTENT"
)
)
)
)
)
)
)
)
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",
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",
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",
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",
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",
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",
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",
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"
)
),
streamDeliveryResources = list(
resources = list(
list(
kinesis = list(
dataStreamArn = "string",
contentConfigurations = list(
list(
type = "MEMORY_RECORDS",
level = "METADATA_ONLY"|"FULL_CONTENT"
)
)
)
)
)
),
tags = list(
"string"
)
)