aws-sdk-bedrockagentcore 1.50.0 → 1.51.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ebc0d69ef43dea4136df5dc0c68fbdb3ea00d4ae11063067d0ae2bc9bf14d47e
-  data.tar.gz: '048dfedc985753bda1a1fe3fcf57cd2d5c26b2d0b582fdc18d6fe2d2f296f0d3'
+  metadata.gz: 4bfc719cd838f47b9e9783b70ab63762123d1554a50d773b790f78427147cb7b
+  data.tar.gz: 9fe1f6fc31bd3a6e5a10dad3ed33b7e0e2c623a8a1061b6319ea4df2cd3e0272
 SHA512:
-  metadata.gz: '060149c37868825ea37afec0a168275ce6815d0ae955e53efcb49e0034d47ff94260e565098c6a8fa023613b69ae3141247078735e1bb49f7204ea112d3e12ad'
-  data.tar.gz: 75f1f497dbaf2b2954b74df4ef4ad1263c2614bde911eff552c8061c25abfc8c0ca2573f483302a58a0de6cea98b5f5c2a15745600a11fca24fc5ff4118902d3
+  metadata.gz: 85f92c50dc55fe9a14327e06f49407b1c4095698087bdf843dc36452a3d38cb19ed7db6d0ba68ef9cb8f53ead8be6c69a92a5e59a3390473afe757e0c7511899
+  data.tar.gz: a7f22f1f26d8d6906ebc7cf9c9437322b771d6095c79fb54f5af99786ed2c8343b2aeb05327321b68499942a61ac6d017ef72b85527476aaeed85392f87ff6d6

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.51.0 (2026-08-28)
+------------------
+
+* Feature - AgentCore Memory now supports direct ingestion into long-term memory via IngestData API
+
 1.50.0 (2026-08-21)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.50.0
+1.51.0

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

@@ -2691,6 +2691,103 @@ module Aws::BedrockAgentCore
       req.send_request(options)
     end
 
+    # Submits content directly for ingestion to generate long-term memory
+    # records in a AgentCore Memory resource.
+    #
+    # To use this operation, you must have the
+    # `bedrock-agentcore:IngestData` permission.
+    #
+    # @option params [required, String] :memory_id
+    #   The identifier of the AgentCore Memory resource to ingest content
+    #   into.
+    #
+    # @option params [required, Types::ContentSource] :source
+    #   The content to ingest. Only inline content is supported.
+    #
+    # @option params [required, Time,DateTime,Date,Integer,String] :content_timestamp
+    #   The timestamp of when the content occurred.
+    #
+    # @option params [required, String] :actor_id
+    #   The identifier of the actor associated with this content. An actor
+    #   represents an entity that participates in sessions and generates
+    #   content.
+    #
+    # @option params [String] :session_id
+    #   The identifier of the session that the content belongs to. If not
+    #   provided, a session identifier is generated and returned in the
+    #   response.
+    #
+    # @option params [Types::ExtractionConfig] :extraction_config
+    #   The extraction configuration for long-term memory records. Use this
+    #   parameter to specify namespace variable keys and their values for
+    #   namespace substitution during extraction.
+    #
+    # @option params [Hash<String,Types::MetadataValue>] :metadata
+    #   The key-value metadata to attach to the content.
+    #
+    # @option params [String] :client_token
+    #   A unique, case-sensitive identifier to ensure that the operation
+    #   completes no more than one time. If this token matches a previous
+    #   request, AgentCore ignores the request, but does not return an error.
+    #
+    #   **A suitable default value is auto-generated.** You should normally
+    #   not need to pass this option.**
+    #
+    # @return [Types::IngestDataOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::IngestDataOutput#session_id #session_id} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.ingest_data({
+    #     memory_id: "MemoryId", # required
+    #     source: { # required
+    #       inline: {
+    #         payload: [ # required
+    #           {
+    #             conversational: {
+    #               content: { # required
+    #                 text: "ContentTextString",
+    #               },
+    #               role: "ASSISTANT", # required, accepts ASSISTANT, USER, TOOL, OTHER
+    #             },
+    #             json: {
+    #               content: { # required
+    #               },
+    #             },
+    #           },
+    #         ],
+    #       },
+    #     },
+    #     content_timestamp: Time.now, # required
+    #     actor_id: "ActorId", # required
+    #     session_id: "SessionId",
+    #     extraction_config: {
+    #       namespace_variables: {
+    #         "NamespaceVariableName" => "NamespaceVariableValue",
+    #       },
+    #     },
+    #     metadata: {
+    #       "MetadataKey" => {
+    #         string_value: "MetadataValueStringValueString",
+    #       },
+    #     },
+    #     client_token: "String",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.session_id #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/IngestData AWS API Documentation
+    #
+    # @overload ingest_data(params = {})
+    # @param [Hash] params ({})
+    def ingest_data(params = {}, options = {})
+      req = build_request(:ingest_data, params)
+      req.send_request(options)
+    end
+
     # Sends a request to an agent or tool hosted in an Amazon Bedrock
     # AgentCore Runtime and receives responses in real-time.
     #
@@ -6441,7 +6538,7 @@ module Aws::BedrockAgentCore
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-bedrockagentcore'
-      context[:gem_version] = '1.50.0'
+      context[:gem_version] = '1.51.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -132,6 +132,7 @@ module Aws::BedrockAgentCore
     ContentBlockList = Shapes::ListShape.new(name: 'ContentBlockList')
     ContentBlockType = Shapes::StringShape.new(name: 'ContentBlockType')
     ContentDeltaEvent = Shapes::StructureShape.new(name: 'ContentDeltaEvent')
+    ContentSource = Shapes::UnionShape.new(name: 'ContentSource')
     ContentStartEvent = Shapes::StructureShape.new(name: 'ContentStartEvent')
     ContentStopEvent = Shapes::StructureShape.new(name: 'ContentStopEvent')
     ContentTextString = Shapes::StringShape.new(name: 'ContentTextString')
@@ -374,9 +375,14 @@ module Aws::BedrockAgentCore
     HttpResponseCode = Shapes::IntegerShape.new(name: 'HttpResponseCode')
     IgnoredReferenceInputField = Shapes::StringShape.new(name: 'IgnoredReferenceInputField')
     IgnoredReferenceInputFields = Shapes::ListShape.new(name: 'IgnoredReferenceInputFields')
+    IngestDataInput = Shapes::StructureShape.new(name: 'IngestDataInput')
+    IngestDataOutput = Shapes::StructureShape.new(name: 'IngestDataOutput')
+    IngestPayloadList = Shapes::ListShape.new(name: 'IngestPayloadList')
+    IngestPayloadType = Shapes::UnionShape.new(name: 'IngestPayloadType')
     InlineContent = Shapes::StringShape.new(name: 'InlineContent')
     InlineGroundTruth = Shapes::StructureShape.new(name: 'InlineGroundTruth')
     InlineGroundTruthTurnsList = Shapes::ListShape.new(name: 'InlineGroundTruthTurnsList')
+    InlineMemoryContent = Shapes::StructureShape.new(name: 'InlineMemoryContent')
     InputContentBlock = Shapes::StructureShape.new(name: 'InputContentBlock')
     InputContentBlockList = Shapes::ListShape.new(name: 'InputContentBlockList')
     Insight = Shapes::StructureShape.new(name: 'Insight')
@@ -1154,6 +1160,12 @@ module Aws::BedrockAgentCore
     ContentDeltaEvent.add_member(:stderr, Shapes::ShapeRef.new(shape: String, location_name: "stderr"))
     ContentDeltaEvent.struct_class = Types::ContentDeltaEvent
 
+    ContentSource.add_member(:inline, Shapes::ShapeRef.new(shape: InlineMemoryContent, location_name: "inline"))
+    ContentSource.add_member(:unknown, Shapes::ShapeRef.new(shape: nil, location_name: 'unknown'))
+    ContentSource.add_member_subclass(:inline, Types::ContentSource::Inline)
+    ContentSource.add_member_subclass(:unknown, Types::ContentSource::Unknown)
+    ContentSource.struct_class = Types::ContentSource
+
     ContentStartEvent.struct_class = Types::ContentStartEvent
 
     ContentStopEvent.add_member(:exit_code, Shapes::ShapeRef.new(shape: Integer, required: true, location_name: "exitCode"))
@@ -2075,6 +2087,29 @@ module Aws::BedrockAgentCore
 
     IgnoredReferenceInputFields.member = Shapes::ShapeRef.new(shape: IgnoredReferenceInputField)
 
+    IngestDataInput.add_member(:memory_id, Shapes::ShapeRef.new(shape: MemoryId, required: true, location: "uri", location_name: "memoryId"))
+    IngestDataInput.add_member(:source, Shapes::ShapeRef.new(shape: ContentSource, required: true, location_name: "source"))
+    IngestDataInput.add_member(:content_timestamp, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "contentTimestamp"))
+    IngestDataInput.add_member(:actor_id, Shapes::ShapeRef.new(shape: ActorId, required: true, location_name: "actorId"))
+    IngestDataInput.add_member(:session_id, Shapes::ShapeRef.new(shape: SessionId, location_name: "sessionId"))
+    IngestDataInput.add_member(:extraction_config, Shapes::ShapeRef.new(shape: ExtractionConfig, location_name: "extractionConfig"))
+    IngestDataInput.add_member(:metadata, Shapes::ShapeRef.new(shape: MetadataMap, location_name: "metadata"))
+    IngestDataInput.add_member(:client_token, Shapes::ShapeRef.new(shape: String, location_name: "clientToken", metadata: {"idempotencyToken" => true}))
+    IngestDataInput.struct_class = Types::IngestDataInput
+
+    IngestDataOutput.add_member(:session_id, Shapes::ShapeRef.new(shape: SessionId, required: true, location_name: "sessionId"))
+    IngestDataOutput.struct_class = Types::IngestDataOutput
+
+    IngestPayloadList.member = Shapes::ShapeRef.new(shape: IngestPayloadType)
+
+    IngestPayloadType.add_member(:conversational, Shapes::ShapeRef.new(shape: Conversational, location_name: "conversational"))
+    IngestPayloadType.add_member(:json, Shapes::ShapeRef.new(shape: MemoryJsonData, location_name: "json"))
+    IngestPayloadType.add_member(:unknown, Shapes::ShapeRef.new(shape: nil, location_name: 'unknown'))
+    IngestPayloadType.add_member_subclass(:conversational, Types::IngestPayloadType::Conversational)
+    IngestPayloadType.add_member_subclass(:json, Types::IngestPayloadType::Json)
+    IngestPayloadType.add_member_subclass(:unknown, Types::IngestPayloadType::Unknown)
+    IngestPayloadType.struct_class = Types::IngestPayloadType
+
     InlineGroundTruth.add_member(:assertions, Shapes::ShapeRef.new(shape: EvaluationContentList, location_name: "assertions"))
     InlineGroundTruth.add_member(:expected_trajectory, Shapes::ShapeRef.new(shape: EvaluationExpectedTrajectory, location_name: "expectedTrajectory"))
     InlineGroundTruth.add_member(:turns, Shapes::ShapeRef.new(shape: InlineGroundTruthTurnsList, location_name: "turns"))
@@ -2082,6 +2117,9 @@ module Aws::BedrockAgentCore
 
     InlineGroundTruthTurnsList.member = Shapes::ShapeRef.new(shape: GroundTruthTurn)
 
+    InlineMemoryContent.add_member(:payload, Shapes::ShapeRef.new(shape: IngestPayloadList, required: true, location_name: "payload"))
+    InlineMemoryContent.struct_class = Types::InlineMemoryContent
+
     InputContentBlock.add_member(:path, Shapes::ShapeRef.new(shape: MaxLenString, required: true, location_name: "path"))
     InputContentBlock.add_member(:text, Shapes::ShapeRef.new(shape: MaxLenString, location_name: "text"))
     InputContentBlock.add_member(:blob, Shapes::ShapeRef.new(shape: Body, location_name: "blob"))
@@ -3903,6 +3941,20 @@ module Aws::BedrockAgentCore
         o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
       end)
 
+      api.add_operation(:ingest_data, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "IngestData"
+        o.http_method = "POST"
+        o.http_request_uri = "/memories/{memoryId}/ingest"
+        o.input = Shapes::ShapeRef.new(shape: IngestDataInput)
+        o.output = Shapes::ShapeRef.new(shape: IngestDataOutput)
+        o.errors << Shapes::ShapeRef.new(shape: ServiceQuotaExceededException)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottledException)
+        o.errors << Shapes::ShapeRef.new(shape: ServiceException)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+        o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+      end)
+
       api.add_operation(:invoke_agent_runtime, Seahorse::Model::Operation.new.tap do |o|
         o.name = "InvokeAgentRuntime"
         o.http_method = "POST"

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

@@ -1416,6 +1416,27 @@ module Aws::BedrockAgentCore
       include Aws::Structure
     end
 
+    # The source of the content to ingest. Only inline content is supported.
+    #
+    # @note ContentSource is a union - when making an API calls you must set exactly one of the members.
+    #
+    # @!attribute [rw] inline
+    #   The content included directly in the request.
+    #   @return [Types::InlineMemoryContent]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/ContentSource AWS API Documentation
+    #
+    class ContentSource < Struct.new(
+      :inline,
+      :unknown)
+      SENSITIVE = []
+      include Aws::Structure
+      include Aws::Structure::Union
+
+      class Inline < ContentSource; end
+      class Unknown < ContentSource; end
+    end
+
     # An event that signals the start of content streaming from a command
     # execution. This event is sent when the command begins producing
     # output.
@@ -5476,6 +5497,109 @@ module Aws::BedrockAgentCore
       include Aws::Structure
     end
 
+    # @!attribute [rw] memory_id
+    #   The identifier of the AgentCore Memory resource to ingest content
+    #   into.
+    #   @return [String]
+    #
+    # @!attribute [rw] source
+    #   The content to ingest. Only inline content is supported.
+    #   @return [Types::ContentSource]
+    #
+    # @!attribute [rw] content_timestamp
+    #   The timestamp of when the content occurred.
+    #   @return [Time]
+    #
+    # @!attribute [rw] actor_id
+    #   The identifier of the actor associated with this content. An actor
+    #   represents an entity that participates in sessions and generates
+    #   content.
+    #   @return [String]
+    #
+    # @!attribute [rw] session_id
+    #   The identifier of the session that the content belongs to. If not
+    #   provided, a session identifier is generated and returned in the
+    #   response.
+    #   @return [String]
+    #
+    # @!attribute [rw] extraction_config
+    #   The extraction configuration for long-term memory records. Use this
+    #   parameter to specify namespace variable keys and their values for
+    #   namespace substitution during extraction.
+    #   @return [Types::ExtractionConfig]
+    #
+    # @!attribute [rw] metadata
+    #   The key-value metadata to attach to the content.
+    #   @return [Hash<String,Types::MetadataValue>]
+    #
+    # @!attribute [rw] client_token
+    #   A unique, case-sensitive identifier to ensure that the operation
+    #   completes no more than one time. If this token matches a previous
+    #   request, AgentCore ignores the request, but does not return an
+    #   error.
+    #
+    #   **A suitable default value is auto-generated.** You should normally
+    #   not need to pass this option.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/IngestDataInput AWS API Documentation
+    #
+    class IngestDataInput < Struct.new(
+      :memory_id,
+      :source,
+      :content_timestamp,
+      :actor_id,
+      :session_id,
+      :extraction_config,
+      :metadata,
+      :client_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] session_id
+    #   The identifier of the session that the service ingested the content
+    #   into. This value echoes the session identifier from the request, or
+    #   the identifier that the service generated when you did not provide
+    #   one.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/IngestDataOutput AWS API Documentation
+    #
+    class IngestDataOutput < Struct.new(
+      :session_id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # A single content payload item to ingest. A payload item contains
+    # either conversational or JSON content.
+    #
+    # @note IngestPayloadType is a union - when making an API calls you must set exactly one of the members.
+    #
+    # @!attribute [rw] conversational
+    #   The conversational content for this payload item.
+    #   @return [Types::Conversational]
+    #
+    # @!attribute [rw] json
+    #   The JSON content for this payload item.
+    #   @return [Types::MemoryJsonData]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/IngestPayloadType AWS API Documentation
+    #
+    class IngestPayloadType < Struct.new(
+      :conversational,
+      :json,
+      :unknown)
+      SENSITIVE = [:json]
+      include Aws::Structure
+      include Aws::Structure::Union
+
+      class Conversational < IngestPayloadType; end
+      class Json < IngestPayloadType; end
+      class Unknown < IngestPayloadType; end
+    end
+
     # Inline ground truth data containing assertions, expected trajectories,
     # and per-turn expected responses.
     #
@@ -5503,6 +5627,21 @@ module Aws::BedrockAgentCore
       include Aws::Structure
     end
 
+    # The content included directly in the request as one or more payload
+    # items.
+    #
+    # @!attribute [rw] payload
+    #   The list of content payload items to ingest.
+    #   @return [Array<Types::IngestPayloadType>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/InlineMemoryContent AWS API Documentation
+    #
+    class InlineMemoryContent < Struct.new(
+      :payload)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # A block of input content.
     #
     # @!attribute [rw] path

data/lib/aws-sdk-bedrockagentcore.rb

@@ -56,7 +56,7 @@ module Aws::BedrockAgentCore
   autoload :Endpoints, 'aws-sdk-bedrockagentcore/endpoints'
   autoload :EventStreams, 'aws-sdk-bedrockagentcore/event_streams'
 
-  GEM_VERSION = '1.50.0'
+  GEM_VERSION = '1.51.0'
 
 end
 

data/sig/client.rbs

@@ -767,6 +767,44 @@ module Aws
                                                  ) -> _GetWorkloadAccessTokenForUserIdResponseSuccess
                                                | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _GetWorkloadAccessTokenForUserIdResponseSuccess
 
+      interface _IngestDataResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::IngestDataOutput]
+        def session_id: () -> ::String
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/BedrockAgentCore/Client.html#ingest_data-instance_method
+      def ingest_data: (
+                         memory_id: ::String,
+                         source: {
+                           inline: {
+                             payload: Array[
+                               {
+                                 conversational: {
+                                   content: {
+                                     text: ::String?
+                                   },
+                                   role: ("ASSISTANT" | "USER" | "TOOL" | "OTHER")
+                                 }?,
+                                 json: {
+                                   content: {
+                                   }
+                                 }?
+                               }
+                             ]
+                           }?
+                         },
+                         content_timestamp: ::Time,
+                         actor_id: ::String,
+                         ?session_id: ::String,
+                         ?extraction_config: {
+                           namespace_variables: Hash[::String, ::String]?
+                         },
+                         ?metadata: Hash[::String, {
+                             string_value: ::String?
+                           }],
+                         ?client_token: ::String
+                       ) -> _IngestDataResponseSuccess
+                     | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _IngestDataResponseSuccess
+
       interface _InvokeAgentRuntimeResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::InvokeAgentRuntimeResponse]
         def runtime_session_id: () -> ::String

data/sig/types.rbs

@@ -444,6 +444,17 @@ module Aws::BedrockAgentCore
       SENSITIVE: []
     end
 
+    class ContentSource
+      attr_accessor inline: Types::InlineMemoryContent
+      attr_accessor unknown: untyped
+      SENSITIVE: []
+
+      class Inline < ContentSource
+      end
+      class Unknown < ContentSource
+      end
+    end
+
     class ContentStartEvent < Aws::EmptyStructure
     end
 
@@ -1699,6 +1710,37 @@ module Aws::BedrockAgentCore
       SENSITIVE: []
     end
 
+    class IngestDataInput
+      attr_accessor memory_id: ::String
+      attr_accessor source: Types::ContentSource
+      attr_accessor content_timestamp: ::Time
+      attr_accessor actor_id: ::String
+      attr_accessor session_id: ::String
+      attr_accessor extraction_config: Types::ExtractionConfig
+      attr_accessor metadata: ::Hash[::String, Types::MetadataValue]
+      attr_accessor client_token: ::String
+      SENSITIVE: []
+    end
+
+    class IngestDataOutput
+      attr_accessor session_id: ::String
+      SENSITIVE: []
+    end
+
+    class IngestPayloadType
+      attr_accessor conversational: Types::Conversational
+      attr_accessor json: Types::MemoryJsonData
+      attr_accessor unknown: untyped
+      SENSITIVE: [:json]
+
+      class Conversational < IngestPayloadType
+      end
+      class Json < IngestPayloadType
+      end
+      class Unknown < IngestPayloadType
+      end
+    end
+
     class InlineGroundTruth
       attr_accessor assertions: ::Array[Types::EvaluationContent]
       attr_accessor expected_trajectory: Types::EvaluationExpectedTrajectory
@@ -1706,6 +1748,11 @@ module Aws::BedrockAgentCore
       SENSITIVE: []
     end
 
+    class InlineMemoryContent
+      attr_accessor payload: ::Array[Types::IngestPayloadType]
+      SENSITIVE: []
+    end
+
     class InputContentBlock
       attr_accessor path: ::String
       attr_accessor text: ::String

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-bedrockagentcore
 version: !ruby/object:Gem::Version
-  version: 1.50.0
+  version: 1.51.0
 platform: ruby
 authors:
 - Amazon Web Services