aws-sdk-bedrockagentruntime 1.79.0 → 1.80.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4eb4959009f8c6687e35f5cbd2afe31cfa973fd33d82d858aad099fef3363f34
-  data.tar.gz: e64a01355716635a665d82034a31e1580f3827905d1dbd4e4e970695b02d541e
+  metadata.gz: e0ef58ad0562ed2fe5cd46dd81e34603a964b80307d443b0a2e15f0943110879
+  data.tar.gz: 18bf2741643afbc47ab81a29325a3c559ec209b5b891cdb250565fd6c8750446
 SHA512:
-  metadata.gz: 993b27eb8ff62be0b637ebb43faba605a7912cf4b7ae7f74d8ac9a304d18cd15a52b954dc87644b0d06ca3e63bac98568f95f3b496198bba8196be5ea4ce00dc
-  data.tar.gz: 785e6a6416805fcbe9ba0fa389e9f7f9ec2effc286c1ed64caca5320226524d873e0b5904374331fa889229b9ee7574e11cc85766609a21a99c7151487bbadba
+  metadata.gz: d0cdd24b354fb95aab94b7142b78a31023317b212088d7781fcc40e3264afa200edeafe4b4f510e0740ad10ee69493a33e41861124733c7c2295c5b296f404f8
+  data.tar.gz: 201283cf416a858b94dd887deed683a842cb239c0ceb691b09a85f7692ddb5f115240235ca21f8b94cc5a00e70b42f7ee34f5035cff762eff404de59242320cf

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.80.0 (2026-08-17)
+------------------
+
+* Feature - AgenticRetrieveStream API now supports Amazon Bedrock AgentCore Memory. Use the new memoryConfiguration parameter to continue a session from short-term memory and retrieve from long-term memory.
+
 1.79.0 (2026-08-14)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.79.0
+1.80.0

data/lib/aws-sdk-bedrockagentruntime/client.rb

@@ -503,6 +503,10 @@ module Aws::BedrockAgentRuntime
     # @option params [Boolean] :generate_response
     #   Whether to generate a response based on the retrieved results.
     #
+    # @option params [Types::AgenticRetrieveMemoryConfiguration] :memory_configuration
+    #   The configuration for using an Amazon Bedrock AgentCore Memory
+    #   resource with this retrieval.
+    #
     # @option params [required, Array<Types::AgenticRetrieveMessage>] :messages
     #   The list of messages for the agentic retrieval conversation.
     #
@@ -737,6 +741,37 @@ module Aws::BedrockAgentRuntime
     #       reranking_model_type: "CUSTOM", # accepts CUSTOM, MANAGED, NONE
     #     },
     #     generate_response: false,
+    #     memory_configuration: {
+    #       memory_id: "AgentCoreMemoryId", # required
+    #       persistence_mode: "DEFAULT", # accepts DEFAULT, NONE
+    #       retrieval_configs: [
+    #         {
+    #           metadata_filters: [
+    #             {
+    #               left: { # required
+    #                 metadata_key: "AgenticRetrieveMemoryMetadataKey",
+    #               },
+    #               operator: "EQUALS_TO", # required, accepts EQUALS_TO, EXISTS, NOT_EXISTS, BEFORE, AFTER, CONTAINS, GREATER_THAN, GREATER_THAN_OR_EQUALS, LESS_THAN, LESS_THAN_OR_EQUALS
+    #               right: {
+    #                 metadata_value: {
+    #                   date_time_value: Time.now,
+    #                   number_value: 1.0,
+    #                   string_list_value: ["AgenticRetrieveMemoryMetadataStringListItem"],
+    #                   string_value: "AgenticRetrieveMemoryMetadataStringValue",
+    #                 },
+    #               },
+    #             },
+    #           ],
+    #           namespace: "MemoryNamespace",
+    #           namespace_path: "MemoryNamespace",
+    #           strategy_id: "MemoryStrategyId",
+    #         },
+    #       ],
+    #       session_binding: {
+    #         actor_id: "AgentCoreMemoryActorId", # required
+    #         session_id: "AgentCoreMemorySessionId", # required
+    #       },
+    #     },
     #     messages: [ # required
     #       {
     #         content: { # required
@@ -892,6 +927,11 @@ module Aws::BedrockAgentRuntime
     #   event.attributes.actions #=> Array
     #   event.attributes.actions[0].full_document_expansion.document_id #=> String
     #   event.attributes.actions[0].full_document_expansion.source_retriever.identifier #=> String
+    #   event.attributes.actions[0].memory_retrieve.input_query.text #=> String
+    #   event.attributes.actions[0].memory_retrieve.memory_id #=> String
+    #   event.attributes.actions[0].memory_retrieve.namespace #=> String
+    #   event.attributes.actions[0].memory_retrieve.namespace_path #=> String
+    #   event.attributes.actions[0].memory_retrieve.strategy_id #=> String
     #   event.attributes.actions[0].retrieve.input_query.text #=> String
     #   event.attributes.actions[0].retrieve.source_retrievers #=> Array
     #   event.attributes.actions[0].retrieve.source_retrievers[0].identifier #=> String
@@ -900,7 +940,7 @@ module Aws::BedrockAgentRuntime
     #   event.attributes.message #=> String
     #   event.attributes.retrieval_metadata #=> Array
     #   event.attributes.retrieval_metadata[0].identifier #=> String
-    #   event.attributes.retrieval_metadata[0].retrieval_type #=> String, one of "BedrockKnowledgeBase"
+    #   event.attributes.retrieval_metadata[0].retrieval_type #=> String, one of "BedrockKnowledgeBase", "BedrockAgentCoreMemory"
     #   event.attributes.retrieval_response #=> Array
     #   event.attributes.retrieval_response[0].content.byte_content #=> String
     #   event.attributes.retrieval_response[0].content.mime_type #=> String
@@ -908,7 +948,7 @@ module Aws::BedrockAgentRuntime
     #   event.attributes.retrieval_response[0].metadata #=> Hash
     #   event.attributes.retrieval_response[0].source_retriever.identifier #=> String
     #   event.attributes.status #=> String, one of "IN_PROGRESS", "SUCCEEDED", "FAILED"
-    #   event.attributes.step #=> String, one of "Planning", "Retrieval", "SpeculativeRetrieval", "FullDocumentExpansion"
+    #   event.attributes.step #=> String, one of "Planning", "Retrieval", "SpeculativeRetrieval", "FullDocumentExpansion", "SessionHistoryLoad"
     #   event.attributes.warnings #=> Array
     #   event.attributes.warnings[0].guardrail.action #=> String, one of "INTERVENED", "NONE"
     #   event.attributes.warnings[0].guardrail.id #=> String
@@ -8427,7 +8467,7 @@ module Aws::BedrockAgentRuntime
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-bedrockagentruntime'
-      context[:gem_version] = '1.79.0'
+      context[:gem_version] = '1.80.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-bedrockagentruntime/client_api.rb

@@ -40,6 +40,9 @@ module Aws::BedrockAgentRuntime
     AgentCollaboratorInvocationOutput = Shapes::StructureShape.new(name: 'AgentCollaboratorInvocationOutput')
     AgentCollaboratorOutputPayload = Shapes::StructureShape.new(name: 'AgentCollaboratorOutputPayload')
     AgentCollaboratorPayloadString = Shapes::StringShape.new(name: 'AgentCollaboratorPayloadString')
+    AgentCoreMemoryActorId = Shapes::StringShape.new(name: 'AgentCoreMemoryActorId')
+    AgentCoreMemoryId = Shapes::StringShape.new(name: 'AgentCoreMemoryId')
+    AgentCoreMemorySessionId = Shapes::StringShape.new(name: 'AgentCoreMemorySessionId')
     AgentId = Shapes::StringShape.new(name: 'AgentId')
     AgentTraces = Shapes::ListShape.new(name: 'AgentTraces')
     AgentVersion = Shapes::StringShape.new(name: 'AgentVersion')
@@ -62,6 +65,22 @@ module Aws::BedrockAgentRuntime
     AgenticRetrieveFullDocExpansionDetails = Shapes::StructureShape.new(name: 'AgenticRetrieveFullDocExpansionDetails')
     AgenticRetrieveGeneratedResponse = Shapes::StructureShape.new(name: 'AgenticRetrieveGeneratedResponse')
     AgenticRetrieveGuardrailWarning = Shapes::StructureShape.new(name: 'AgenticRetrieveGuardrailWarning')
+    AgenticRetrieveMemoryConfiguration = Shapes::StructureShape.new(name: 'AgenticRetrieveMemoryConfiguration')
+    AgenticRetrieveMemoryMetadataFilter = Shapes::StructureShape.new(name: 'AgenticRetrieveMemoryMetadataFilter')
+    AgenticRetrieveMemoryMetadataFilterLeft = Shapes::UnionShape.new(name: 'AgenticRetrieveMemoryMetadataFilterLeft')
+    AgenticRetrieveMemoryMetadataFilterList = Shapes::ListShape.new(name: 'AgenticRetrieveMemoryMetadataFilterList')
+    AgenticRetrieveMemoryMetadataFilterOperator = Shapes::StringShape.new(name: 'AgenticRetrieveMemoryMetadataFilterOperator')
+    AgenticRetrieveMemoryMetadataFilterRight = Shapes::UnionShape.new(name: 'AgenticRetrieveMemoryMetadataFilterRight')
+    AgenticRetrieveMemoryMetadataKey = Shapes::StringShape.new(name: 'AgenticRetrieveMemoryMetadataKey')
+    AgenticRetrieveMemoryMetadataStringList = Shapes::ListShape.new(name: 'AgenticRetrieveMemoryMetadataStringList')
+    AgenticRetrieveMemoryMetadataStringListItem = Shapes::StringShape.new(name: 'AgenticRetrieveMemoryMetadataStringListItem')
+    AgenticRetrieveMemoryMetadataStringValue = Shapes::StringShape.new(name: 'AgenticRetrieveMemoryMetadataStringValue')
+    AgenticRetrieveMemoryMetadataValue = Shapes::UnionShape.new(name: 'AgenticRetrieveMemoryMetadataValue')
+    AgenticRetrieveMemoryPersistenceMode = Shapes::StringShape.new(name: 'AgenticRetrieveMemoryPersistenceMode')
+    AgenticRetrieveMemoryRetrievalConfig = Shapes::StructureShape.new(name: 'AgenticRetrieveMemoryRetrievalConfig')
+    AgenticRetrieveMemoryRetrievalConfigList = Shapes::ListShape.new(name: 'AgenticRetrieveMemoryRetrievalConfigList')
+    AgenticRetrieveMemoryRetrieveDetails = Shapes::StructureShape.new(name: 'AgenticRetrieveMemoryRetrieveDetails')
+    AgenticRetrieveMemorySessionBinding = Shapes::StructureShape.new(name: 'AgenticRetrieveMemorySessionBinding')
     AgenticRetrieveMessage = Shapes::StructureShape.new(name: 'AgenticRetrieveMessage')
     AgenticRetrieveMessageContent = Shapes::StructureShape.new(name: 'AgenticRetrieveMessageContent')
     AgenticRetrieveMetadata = Shapes::MapShape.new(name: 'AgenticRetrieveMetadata')
@@ -433,7 +452,9 @@ module Aws::BedrockAgentRuntime
     Memories = Shapes::ListShape.new(name: 'Memories')
     Memory = Shapes::UnionShape.new(name: 'Memory')
     MemoryId = Shapes::StringShape.new(name: 'MemoryId')
+    MemoryNamespace = Shapes::StringShape.new(name: 'MemoryNamespace')
     MemorySessionSummary = Shapes::StructureShape.new(name: 'MemorySessionSummary')
+    MemoryStrategyId = Shapes::StringShape.new(name: 'MemoryStrategyId')
     MemoryType = Shapes::StringShape.new(name: 'MemoryType')
     Message = Shapes::StructureShape.new(name: 'Message')
     Messages = Shapes::ListShape.new(name: 'Messages')
@@ -664,6 +685,7 @@ module Aws::BedrockAgentRuntime
     TextToSqlConfigurationType = Shapes::StringShape.new(name: 'TextToSqlConfigurationType')
     TextToSqlKnowledgeBaseConfiguration = Shapes::StructureShape.new(name: 'TextToSqlKnowledgeBaseConfiguration')
     ThrottlingException = Shapes::StructureShape.new(name: 'ThrottlingException')
+    Timestamp = Shapes::TimestampShape.new(name: 'Timestamp')
     TopK = Shapes::IntegerShape.new(name: 'TopK')
     TopP = Shapes::FloatShape.new(name: 'TopP')
     Trace = Shapes::UnionShape.new(name: 'Trace')
@@ -765,6 +787,7 @@ module Aws::BedrockAgentRuntime
     AgentTraces.member = Shapes::ShapeRef.new(shape: TracePart, event: true)
 
     AgenticRetrieveAction.add_member(:full_document_expansion, Shapes::ShapeRef.new(shape: AgenticRetrieveFullDocExpansionDetails, location_name: "fullDocumentExpansion"))
+    AgenticRetrieveAction.add_member(:memory_retrieve, Shapes::ShapeRef.new(shape: AgenticRetrieveMemoryRetrieveDetails, location_name: "memoryRetrieve"))
     AgenticRetrieveAction.add_member(:retrieve, Shapes::ShapeRef.new(shape: AgenticRetrieveActionDetails, location_name: "retrieve"))
     AgenticRetrieveAction.struct_class = Types::AgenticRetrieveAction
 
@@ -822,6 +845,64 @@ module Aws::BedrockAgentRuntime
     AgenticRetrieveGuardrailWarning.add_member(:version, Shapes::ShapeRef.new(shape: String, required: true, location_name: "version"))
     AgenticRetrieveGuardrailWarning.struct_class = Types::AgenticRetrieveGuardrailWarning
 
+    AgenticRetrieveMemoryConfiguration.add_member(:memory_id, Shapes::ShapeRef.new(shape: AgentCoreMemoryId, required: true, location_name: "memoryId"))
+    AgenticRetrieveMemoryConfiguration.add_member(:persistence_mode, Shapes::ShapeRef.new(shape: AgenticRetrieveMemoryPersistenceMode, location_name: "persistenceMode"))
+    AgenticRetrieveMemoryConfiguration.add_member(:retrieval_configs, Shapes::ShapeRef.new(shape: AgenticRetrieveMemoryRetrievalConfigList, location_name: "retrievalConfigs"))
+    AgenticRetrieveMemoryConfiguration.add_member(:session_binding, Shapes::ShapeRef.new(shape: AgenticRetrieveMemorySessionBinding, location_name: "sessionBinding"))
+    AgenticRetrieveMemoryConfiguration.struct_class = Types::AgenticRetrieveMemoryConfiguration
+
+    AgenticRetrieveMemoryMetadataFilter.add_member(:left, Shapes::ShapeRef.new(shape: AgenticRetrieveMemoryMetadataFilterLeft, required: true, location_name: "left"))
+    AgenticRetrieveMemoryMetadataFilter.add_member(:operator, Shapes::ShapeRef.new(shape: AgenticRetrieveMemoryMetadataFilterOperator, required: true, location_name: "operator"))
+    AgenticRetrieveMemoryMetadataFilter.add_member(:right, Shapes::ShapeRef.new(shape: AgenticRetrieveMemoryMetadataFilterRight, location_name: "right"))
+    AgenticRetrieveMemoryMetadataFilter.struct_class = Types::AgenticRetrieveMemoryMetadataFilter
+
+    AgenticRetrieveMemoryMetadataFilterLeft.add_member(:metadata_key, Shapes::ShapeRef.new(shape: AgenticRetrieveMemoryMetadataKey, location_name: "metadataKey"))
+    AgenticRetrieveMemoryMetadataFilterLeft.add_member(:unknown, Shapes::ShapeRef.new(shape: nil, location_name: 'unknown'))
+    AgenticRetrieveMemoryMetadataFilterLeft.add_member_subclass(:metadata_key, Types::AgenticRetrieveMemoryMetadataFilterLeft::MetadataKey)
+    AgenticRetrieveMemoryMetadataFilterLeft.add_member_subclass(:unknown, Types::AgenticRetrieveMemoryMetadataFilterLeft::Unknown)
+    AgenticRetrieveMemoryMetadataFilterLeft.struct_class = Types::AgenticRetrieveMemoryMetadataFilterLeft
+
+    AgenticRetrieveMemoryMetadataFilterList.member = Shapes::ShapeRef.new(shape: AgenticRetrieveMemoryMetadataFilter)
+
+    AgenticRetrieveMemoryMetadataFilterRight.add_member(:metadata_value, Shapes::ShapeRef.new(shape: AgenticRetrieveMemoryMetadataValue, location_name: "metadataValue"))
+    AgenticRetrieveMemoryMetadataFilterRight.add_member(:unknown, Shapes::ShapeRef.new(shape: nil, location_name: 'unknown'))
+    AgenticRetrieveMemoryMetadataFilterRight.add_member_subclass(:metadata_value, Types::AgenticRetrieveMemoryMetadataFilterRight::MetadataValue)
+    AgenticRetrieveMemoryMetadataFilterRight.add_member_subclass(:unknown, Types::AgenticRetrieveMemoryMetadataFilterRight::Unknown)
+    AgenticRetrieveMemoryMetadataFilterRight.struct_class = Types::AgenticRetrieveMemoryMetadataFilterRight
+
+    AgenticRetrieveMemoryMetadataStringList.member = Shapes::ShapeRef.new(shape: AgenticRetrieveMemoryMetadataStringListItem)
+
+    AgenticRetrieveMemoryMetadataValue.add_member(:date_time_value, Shapes::ShapeRef.new(shape: Timestamp, location_name: "dateTimeValue"))
+    AgenticRetrieveMemoryMetadataValue.add_member(:number_value, Shapes::ShapeRef.new(shape: Double, location_name: "numberValue"))
+    AgenticRetrieveMemoryMetadataValue.add_member(:string_list_value, Shapes::ShapeRef.new(shape: AgenticRetrieveMemoryMetadataStringList, location_name: "stringListValue"))
+    AgenticRetrieveMemoryMetadataValue.add_member(:string_value, Shapes::ShapeRef.new(shape: AgenticRetrieveMemoryMetadataStringValue, location_name: "stringValue"))
+    AgenticRetrieveMemoryMetadataValue.add_member(:unknown, Shapes::ShapeRef.new(shape: nil, location_name: 'unknown'))
+    AgenticRetrieveMemoryMetadataValue.add_member_subclass(:date_time_value, Types::AgenticRetrieveMemoryMetadataValue::DateTimeValue)
+    AgenticRetrieveMemoryMetadataValue.add_member_subclass(:number_value, Types::AgenticRetrieveMemoryMetadataValue::NumberValue)
+    AgenticRetrieveMemoryMetadataValue.add_member_subclass(:string_list_value, Types::AgenticRetrieveMemoryMetadataValue::StringListValue)
+    AgenticRetrieveMemoryMetadataValue.add_member_subclass(:string_value, Types::AgenticRetrieveMemoryMetadataValue::StringValue)
+    AgenticRetrieveMemoryMetadataValue.add_member_subclass(:unknown, Types::AgenticRetrieveMemoryMetadataValue::Unknown)
+    AgenticRetrieveMemoryMetadataValue.struct_class = Types::AgenticRetrieveMemoryMetadataValue
+
+    AgenticRetrieveMemoryRetrievalConfig.add_member(:metadata_filters, Shapes::ShapeRef.new(shape: AgenticRetrieveMemoryMetadataFilterList, location_name: "metadataFilters"))
+    AgenticRetrieveMemoryRetrievalConfig.add_member(:namespace, Shapes::ShapeRef.new(shape: MemoryNamespace, location_name: "namespace"))
+    AgenticRetrieveMemoryRetrievalConfig.add_member(:namespace_path, Shapes::ShapeRef.new(shape: MemoryNamespace, location_name: "namespacePath"))
+    AgenticRetrieveMemoryRetrievalConfig.add_member(:strategy_id, Shapes::ShapeRef.new(shape: MemoryStrategyId, location_name: "strategyId"))
+    AgenticRetrieveMemoryRetrievalConfig.struct_class = Types::AgenticRetrieveMemoryRetrievalConfig
+
+    AgenticRetrieveMemoryRetrievalConfigList.member = Shapes::ShapeRef.new(shape: AgenticRetrieveMemoryRetrievalConfig)
+
+    AgenticRetrieveMemoryRetrieveDetails.add_member(:input_query, Shapes::ShapeRef.new(shape: AgenticRetrieveMessageContent, required: true, location_name: "inputQuery"))
+    AgenticRetrieveMemoryRetrieveDetails.add_member(:memory_id, Shapes::ShapeRef.new(shape: String, required: true, location_name: "memoryId"))
+    AgenticRetrieveMemoryRetrieveDetails.add_member(:namespace, Shapes::ShapeRef.new(shape: String, location_name: "namespace"))
+    AgenticRetrieveMemoryRetrieveDetails.add_member(:namespace_path, Shapes::ShapeRef.new(shape: String, location_name: "namespacePath"))
+    AgenticRetrieveMemoryRetrieveDetails.add_member(:strategy_id, Shapes::ShapeRef.new(shape: String, location_name: "strategyId"))
+    AgenticRetrieveMemoryRetrieveDetails.struct_class = Types::AgenticRetrieveMemoryRetrieveDetails
+
+    AgenticRetrieveMemorySessionBinding.add_member(:actor_id, Shapes::ShapeRef.new(shape: AgentCoreMemoryActorId, required: true, location_name: "actorId"))
+    AgenticRetrieveMemorySessionBinding.add_member(:session_id, Shapes::ShapeRef.new(shape: AgentCoreMemorySessionId, required: true, location_name: "sessionId"))
+    AgenticRetrieveMemorySessionBinding.struct_class = Types::AgenticRetrieveMemorySessionBinding
+
     AgenticRetrieveMessage.add_member(:content, Shapes::ShapeRef.new(shape: AgenticRetrieveMessageContent, required: true, location_name: "content"))
     AgenticRetrieveMessage.add_member(:role, Shapes::ShapeRef.new(shape: ConversationRole, required: true, location_name: "role"))
     AgenticRetrieveMessage.struct_class = Types::AgenticRetrieveMessage
@@ -867,6 +948,7 @@ module Aws::BedrockAgentRuntime
 
     AgenticRetrieveStreamRequest.add_member(:agentic_retrieve_configuration, Shapes::ShapeRef.new(shape: AgenticRetrieveConfiguration, required: true, location_name: "agenticRetrieveConfiguration"))
     AgenticRetrieveStreamRequest.add_member(:generate_response, Shapes::ShapeRef.new(shape: Boolean, location_name: "generateResponse"))
+    AgenticRetrieveStreamRequest.add_member(:memory_configuration, Shapes::ShapeRef.new(shape: AgenticRetrieveMemoryConfiguration, location_name: "memoryConfiguration"))
     AgenticRetrieveStreamRequest.add_member(:messages, Shapes::ShapeRef.new(shape: AgenticRetrieveStreamRequestMessagesList, required: true, location_name: "messages"))
     AgenticRetrieveStreamRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "nextToken"))
     AgenticRetrieveStreamRequest.add_member(:policy_configuration, Shapes::ShapeRef.new(shape: AgenticRetrievePolicyConfiguration, location_name: "policyConfiguration"))

data/lib/aws-sdk-bedrockagentruntime/types.rb

@@ -384,6 +384,11 @@ module Aws::BedrockAgentRuntime
     #   Details of a full document expansion action.
     #   @return [Types::AgenticRetrieveFullDocExpansionDetails]
     #
+    # @!attribute [rw] memory_retrieve
+    #   The details of a long-term memory retrieval that the agent chose to
+    #   perform.
+    #   @return [Types::AgenticRetrieveMemoryRetrieveDetails]
+    #
     # @!attribute [rw] retrieve
     #   Details of the retrieve action.
     #   @return [Types::AgenticRetrieveActionDetails]
@@ -392,6 +397,7 @@ module Aws::BedrockAgentRuntime
     #
     class AgenticRetrieveAction < Struct.new(
       :full_document_expansion,
+      :memory_retrieve,
       :retrieve)
       SENSITIVE = []
       include Aws::Structure
@@ -625,6 +631,270 @@ module Aws::BedrockAgentRuntime
       include Aws::Structure
     end
 
+    # Specifies an AgentCore Memory resource and how this retrieval uses it.
+    # Set sessionBinding to restore and continue a session. Set
+    # retrievalConfigs to let the agent retrieve from long-term memory. You
+    # must specify at least one of the two.
+    #
+    # @!attribute [rw] memory_id
+    #   The identifier of the AgentCore Memory resource to use. The resource
+    #   must exist in your account and be in the ACTIVE state.
+    #   @return [String]
+    #
+    # @!attribute [rw] persistence_mode
+    #   Specifies whether the agent-generated answer is written back to the
+    #   given short-term memory session, and applies only when
+    #   sessionBinding is set. Valid values:
+    #
+    #   * `DEFAULT` (default) – Specifies that the question and the
+    #     agent-generated answer are persisted to the session as a single
+    #     event. This value requires generateResponse to be true.
+    #
+    #   * `NONE` – Specifies that the session is left unchanged.
+    #   @return [String]
+    #
+    # @!attribute [rw] retrieval_configs
+    #   Specifies the long-term memory configuration the agent can retrieve
+    #   from. The agent decides whether to retrieve and composes its own
+    #   query. This field currently accepts at most one entry.
+    #   @return [Array<Types::AgenticRetrieveMemoryRetrievalConfig>]
+    #
+    # @!attribute [rw] session_binding
+    #   The short-term memory session whose history is restored for this
+    #   retrieval. To persist the agent-generated answer to the session,
+    #   omit persistenceMode or set it to DEFAULT. To leave the session
+    #   unchanged, set persistenceMode to NONE. Supply session history
+    #   through the existing messages parameter or through short-term
+    #   memory, but not both.
+    #   @return [Types::AgenticRetrieveMemorySessionBinding]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/AgenticRetrieveMemoryConfiguration AWS API Documentation
+    #
+    class AgenticRetrieveMemoryConfiguration < Struct.new(
+      :memory_id,
+      :persistence_mode,
+      :retrieval_configs,
+      :session_binding)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # A metadata filter expression, in the form accepted by the AgentCore
+    # Memory RetrieveMemoryRecords operation. The expression has a left
+    # operand that names the metadata key, an operator, and a right operand.
+    # For the EXISTS and NOT\_EXISTS operators, omit the right operand.
+    #
+    # @!attribute [rw] left
+    #   The metadata key that the expression evaluates.
+    #   @return [Types::AgenticRetrieveMemoryMetadataFilterLeft]
+    #
+    # @!attribute [rw] operator
+    #   The relationship that the metadata key and value must have for a
+    #   memory record to match.
+    #   @return [String]
+    #
+    # @!attribute [rw] right
+    #   The value that the expression compares the metadata key against.
+    #   Supply this value for every operator except EXISTS and NOT\_EXISTS.
+    #   @return [Types::AgenticRetrieveMemoryMetadataFilterRight]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/AgenticRetrieveMemoryMetadataFilter AWS API Documentation
+    #
+    class AgenticRetrieveMemoryMetadataFilter < Struct.new(
+      :left,
+      :operator,
+      :right)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # The left operand of a metadata filter expression. Set exactly one
+    # member.
+    #
+    # @note AgenticRetrieveMemoryMetadataFilterLeft is a union - when making an API calls you must set exactly one of the members.
+    #
+    # @!attribute [rw] metadata_key
+    #   The metadata key to filter on.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/AgenticRetrieveMemoryMetadataFilterLeft AWS API Documentation
+    #
+    class AgenticRetrieveMemoryMetadataFilterLeft < Struct.new(
+      :metadata_key,
+      :unknown)
+      SENSITIVE = []
+      include Aws::Structure
+      include Aws::Structure::Union
+
+      class MetadataKey < AgenticRetrieveMemoryMetadataFilterLeft; end
+      class Unknown < AgenticRetrieveMemoryMetadataFilterLeft; end
+    end
+
+    # The right operand of a metadata filter expression. Set exactly one
+    # member.
+    #
+    # @note AgenticRetrieveMemoryMetadataFilterRight is a union - when making an API calls you must set exactly one of the members.
+    #
+    # @!attribute [rw] metadata_value
+    #   The value to compare the metadata key against.
+    #   @return [Types::AgenticRetrieveMemoryMetadataValue]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/AgenticRetrieveMemoryMetadataFilterRight AWS API Documentation
+    #
+    class AgenticRetrieveMemoryMetadataFilterRight < Struct.new(
+      :metadata_value,
+      :unknown)
+      SENSITIVE = []
+      include Aws::Structure
+      include Aws::Structure::Union
+
+      class MetadataValue < AgenticRetrieveMemoryMetadataFilterRight; end
+      class Unknown < AgenticRetrieveMemoryMetadataFilterRight; end
+    end
+
+    # A metadata value that a filter expression compares against. Set
+    # exactly one member.
+    #
+    # @note AgenticRetrieveMemoryMetadataValue is a union - when making an API calls you must set exactly one of the members.
+    #
+    # @!attribute [rw] date_time_value
+    #   A timestamp value in ISO 8601 UTC format.
+    #   @return [Time]
+    #
+    # @!attribute [rw] number_value
+    #   A numeric value.
+    #   @return [Float]
+    #
+    # @!attribute [rw] string_list_value
+    #   A list of string values.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] string_value
+    #   A string value.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/AgenticRetrieveMemoryMetadataValue AWS API Documentation
+    #
+    class AgenticRetrieveMemoryMetadataValue < Struct.new(
+      :date_time_value,
+      :number_value,
+      :string_list_value,
+      :string_value,
+      :unknown)
+      SENSITIVE = []
+      include Aws::Structure
+      include Aws::Structure::Union
+
+      class DateTimeValue < AgenticRetrieveMemoryMetadataValue; end
+      class NumberValue < AgenticRetrieveMemoryMetadataValue; end
+      class StringListValue < AgenticRetrieveMemoryMetadataValue; end
+      class StringValue < AgenticRetrieveMemoryMetadataValue; end
+      class Unknown < AgenticRetrieveMemoryMetadataValue; end
+    end
+
+    # The long-term memory namespace that the agent might retrieve memory
+    # records from, and the filters applied to that retrieval. You must
+    # specify either namespace or namespacePath.
+    #
+    # @!attribute [rw] metadata_filters
+    #   The metadata filter expressions that restrict retrieval to matching
+    #   memory records. You can specify a maximum of 5 expressions.
+    #   @return [Array<Types::AgenticRetrieveMemoryMetadataFilter>]
+    #
+    # @!attribute [rw] namespace
+    #   The namespace prefix to filter memory records by. The agent
+    #   retrieves memory records in namespaces that start with the provided
+    #   prefix. You must specify either namespace or namespacePath.
+    #   @return [String]
+    #
+    # @!attribute [rw] namespace_path
+    #   The parent namespace to use for hierarchical retrievals. The agent
+    #   retrieves all memory records whose namespace falls under the same
+    #   parent hierarchy. You must specify either namespace or
+    #   namespacePath.
+    #   @return [String]
+    #
+    # @!attribute [rw] strategy_id
+    #   The extraction strategy ID that restricts retrieval to memory
+    #   records produced by a single strategy. Omit this parameter to
+    #   retrieve records from every strategy on the memory resource.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/AgenticRetrieveMemoryRetrievalConfig AWS API Documentation
+    #
+    class AgenticRetrieveMemoryRetrievalConfig < Struct.new(
+      :metadata_filters,
+      :namespace,
+      :namespace_path,
+      :strategy_id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # A long-term memory retrieval that the agent chose to perform. The
+    # record reports the query and the namespace. The corresponding
+    # Retrieval step reports the results.
+    #
+    # @!attribute [rw] input_query
+    #   The query that the agent composed.
+    #   @return [Types::AgenticRetrieveMessageContent]
+    #
+    # @!attribute [rw] memory_id
+    #   The identifier of the AgentCore Memory resource retrieved from.
+    #   @return [String]
+    #
+    # @!attribute [rw] namespace
+    #   The namespace prefix retrieved from, as supplied in the request.
+    #   This field is present when the request specified namespace.
+    #   @return [String]
+    #
+    # @!attribute [rw] namespace_path
+    #   The parent namespace retrieved from hierarchically, as supplied in
+    #   the request. This field is present when the request specified
+    #   namespacePath.
+    #   @return [String]
+    #
+    # @!attribute [rw] strategy_id
+    #   The extraction strategy that restricted retrieval, if the request
+    #   specified one.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/AgenticRetrieveMemoryRetrieveDetails AWS API Documentation
+    #
+    class AgenticRetrieveMemoryRetrieveDetails < Struct.new(
+      :input_query,
+      :memory_id,
+      :namespace,
+      :namespace_path,
+      :strategy_id)
+      SENSITIVE = [:input_query]
+      include Aws::Structure
+    end
+
+    # The short-term memory session that this retrieval reads from and
+    # writes to.
+    #
+    # @!attribute [rw] actor_id
+    #   The identifier of the end user or agent that the session belongs to.
+    #   This identifier scopes session history so that one actor's history
+    #   is never returned for another. You are responsible for sending the
+    #   correct actor value.
+    #   @return [String]
+    #
+    # @!attribute [rw] session_id
+    #   The identifier of the session to restore and continue. You are
+    #   responsible for sending the correct session value.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/AgenticRetrieveMemorySessionBinding AWS API Documentation
+    #
+    class AgenticRetrieveMemorySessionBinding < Struct.new(
+      :actor_id,
+      :session_id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # A message in the agentic retrieval conversation.
     #
     # @!attribute [rw] content
@@ -798,6 +1068,11 @@ module Aws::BedrockAgentRuntime
     #   Whether to generate a response based on the retrieved results.
     #   @return [Boolean]
     #
+    # @!attribute [rw] memory_configuration
+    #   The configuration for using an Amazon Bedrock AgentCore Memory
+    #   resource with this retrieval.
+    #   @return [Types::AgenticRetrieveMemoryConfiguration]
+    #
     # @!attribute [rw] messages
     #   The list of messages for the agentic retrieval conversation.
     #   @return [Array<Types::AgenticRetrieveMessage>]
@@ -825,6 +1100,7 @@ module Aws::BedrockAgentRuntime
     class AgenticRetrieveStreamRequest < Struct.new(
       :agentic_retrieve_configuration,
       :generate_response,
+      :memory_configuration,
       :messages,
       :next_token,
       :policy_configuration,

data/lib/aws-sdk-bedrockagentruntime.rb

@@ -56,7 +56,7 @@ module Aws::BedrockAgentRuntime
   autoload :Endpoints, 'aws-sdk-bedrockagentruntime/endpoints'
   autoload :EventStreams, 'aws-sdk-bedrockagentruntime/event_streams'
 
-  GEM_VERSION = '1.79.0'
+  GEM_VERSION = '1.80.0'
 
 end
 

data/sig/client.rbs

@@ -109,6 +109,37 @@ module Aws
                                        reranking_model_type: ("CUSTOM" | "MANAGED" | "NONE")?
                                      },
                                      ?generate_response: bool,
+                                     ?memory_configuration: {
+                                       memory_id: ::String,
+                                       persistence_mode: ("DEFAULT" | "NONE")?,
+                                       retrieval_configs: Array[
+                                         {
+                                           metadata_filters: Array[
+                                             {
+                                               left: {
+                                                 metadata_key: ::String?
+                                               },
+                                               operator: ("EQUALS_TO" | "EXISTS" | "NOT_EXISTS" | "BEFORE" | "AFTER" | "CONTAINS" | "GREATER_THAN" | "GREATER_THAN_OR_EQUALS" | "LESS_THAN" | "LESS_THAN_OR_EQUALS"),
+                                               right: {
+                                                 metadata_value: {
+                                                   date_time_value: ::Time?,
+                                                   number_value: ::Float?,
+                                                   string_list_value: Array[::String]?,
+                                                   string_value: ::String?
+                                                 }?
+                                               }?
+                                             }
+                                           ]?,
+                                           namespace: ::String?,
+                                           namespace_path: ::String?,
+                                           strategy_id: ::String?
+                                         }
+                                       ]?,
+                                       session_binding: {
+                                         actor_id: ::String,
+                                         session_id: ::String
+                                       }?
+                                     },
                                      messages: Array[
                                        {
                                          content: {

data/sig/types.rbs

@@ -102,6 +102,7 @@ module Aws::BedrockAgentRuntime
 
     class AgenticRetrieveAction
       attr_accessor full_document_expansion: Types::AgenticRetrieveFullDocExpansionDetails
+      attr_accessor memory_retrieve: Types::AgenticRetrieveMemoryRetrieveDetails
       attr_accessor retrieve: Types::AgenticRetrieveActionDetails
       SENSITIVE: []
     end
@@ -174,6 +175,86 @@ module Aws::BedrockAgentRuntime
       SENSITIVE: []
     end
 
+    class AgenticRetrieveMemoryConfiguration
+      attr_accessor memory_id: ::String
+      attr_accessor persistence_mode: ("DEFAULT" | "NONE")
+      attr_accessor retrieval_configs: ::Array[Types::AgenticRetrieveMemoryRetrievalConfig]
+      attr_accessor session_binding: Types::AgenticRetrieveMemorySessionBinding
+      SENSITIVE: []
+    end
+
+    class AgenticRetrieveMemoryMetadataFilter
+      attr_accessor left: Types::AgenticRetrieveMemoryMetadataFilterLeft
+      attr_accessor operator: ("EQUALS_TO" | "EXISTS" | "NOT_EXISTS" | "BEFORE" | "AFTER" | "CONTAINS" | "GREATER_THAN" | "GREATER_THAN_OR_EQUALS" | "LESS_THAN" | "LESS_THAN_OR_EQUALS")
+      attr_accessor right: Types::AgenticRetrieveMemoryMetadataFilterRight
+      SENSITIVE: []
+    end
+
+    class AgenticRetrieveMemoryMetadataFilterLeft
+      attr_accessor metadata_key: ::String
+      attr_accessor unknown: untyped
+      SENSITIVE: []
+
+      class MetadataKey < AgenticRetrieveMemoryMetadataFilterLeft
+      end
+      class Unknown < AgenticRetrieveMemoryMetadataFilterLeft
+      end
+    end
+
+    class AgenticRetrieveMemoryMetadataFilterRight
+      attr_accessor metadata_value: Types::AgenticRetrieveMemoryMetadataValue
+      attr_accessor unknown: untyped
+      SENSITIVE: []
+
+      class MetadataValue < AgenticRetrieveMemoryMetadataFilterRight
+      end
+      class Unknown < AgenticRetrieveMemoryMetadataFilterRight
+      end
+    end
+
+    class AgenticRetrieveMemoryMetadataValue
+      attr_accessor date_time_value: ::Time
+      attr_accessor number_value: ::Float
+      attr_accessor string_list_value: ::Array[::String]
+      attr_accessor string_value: ::String
+      attr_accessor unknown: untyped
+      SENSITIVE: []
+
+      class DateTimeValue < AgenticRetrieveMemoryMetadataValue
+      end
+      class NumberValue < AgenticRetrieveMemoryMetadataValue
+      end
+      class StringListValue < AgenticRetrieveMemoryMetadataValue
+      end
+      class StringValue < AgenticRetrieveMemoryMetadataValue
+      end
+      class Unknown < AgenticRetrieveMemoryMetadataValue
+      end
+    end
+
+    class AgenticRetrieveMemoryRetrievalConfig
+      attr_accessor metadata_filters: ::Array[Types::AgenticRetrieveMemoryMetadataFilter]
+      attr_accessor namespace: ::String
+      attr_accessor namespace_path: ::String
+      attr_accessor strategy_id: ::String
+      SENSITIVE: []
+    end
+
+    class AgenticRetrieveMemoryRetrieveDetails
+      attr_accessor input_query: Types::AgenticRetrieveMessageContent
+      attr_accessor memory_id: ::String
+      attr_accessor namespace: ::String
+      attr_accessor namespace_path: ::String
+      attr_accessor strategy_id: ::String
+      SENSITIVE: [:input_query]
+    end
+
+    class AgenticRetrieveMemorySessionBinding
+      attr_accessor actor_id: ::String
+      attr_accessor session_id: ::String
+      SENSITIVE: []
+    end
+
     class AgenticRetrieveMessage
       attr_accessor content: Types::AgenticRetrieveMessageContent
       attr_accessor role: ("user" | "assistant")
@@ -219,7 +300,7 @@ module Aws::BedrockAgentRuntime
 
     class AgenticRetrieveSourceMetadata
       attr_accessor identifier: ::String
-      attr_accessor retrieval_type: ("BedrockKnowledgeBase")
+      attr_accessor retrieval_type: ("BedrockKnowledgeBase" | "BedrockAgentCoreMemory")
       SENSITIVE: []
     end
 
@@ -231,6 +312,7 @@ module Aws::BedrockAgentRuntime
     class AgenticRetrieveStreamRequest
       attr_accessor agentic_retrieve_configuration: Types::AgenticRetrieveConfiguration
       attr_accessor generate_response: bool
+      attr_accessor memory_configuration: Types::AgenticRetrieveMemoryConfiguration
       attr_accessor messages: ::Array[Types::AgenticRetrieveMessage]
       attr_accessor next_token: ::String
       attr_accessor policy_configuration: Types::AgenticRetrievePolicyConfiguration
@@ -259,7 +341,7 @@ module Aws::BedrockAgentRuntime
       attr_accessor retrieval_metadata: ::Array[Types::AgenticRetrieveSourceMetadata]
       attr_accessor retrieval_response: ::Array[Types::AgenticRetrieveTraceResultItem]
       attr_accessor status: ("IN_PROGRESS" | "SUCCEEDED" | "FAILED")
-      attr_accessor step: ("Planning" | "Retrieval" | "SpeculativeRetrieval" | "FullDocumentExpansion")
+      attr_accessor step: ("Planning" | "Retrieval" | "SpeculativeRetrieval" | "FullDocumentExpansion" | "SessionHistoryLoad")
       attr_accessor warnings: ::Array[Types::AgenticRetrieveWarning]
       SENSITIVE: []
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-bedrockagentruntime
 version: !ruby/object:Gem::Version
-  version: 1.79.0
+  version: 1.80.0
 platform: ruby
 authors:
 - Amazon Web Services