aws-sdk-bedrockagentruntime 1.33.0 → 1.34.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f5088381cb0239347ff879a20b83d2ce09db6d5c22de232e70cfbf5009f0f50e
-  data.tar.gz: 4f962e9fa26b3ca1258dfe7235f8c93d452a371972924c8de1fc582f06bba222
+  metadata.gz: 4323d0c750789e655b49066e936b555266047e9b5f49edd619a6e32ff610bd8e
+  data.tar.gz: 142fd66af3d8a2475d20fd2b30fe045f892bcd8adda0b69f2352fd60f31246c6
 SHA512:
-  metadata.gz: 20bd46631d420b75fd08fc2fb64d78044a69cd30cbd565e25d28b2243fc682d7101be12a89e80413ef17d76cede722c511527c82b758b7bf33e4915836efb28e
-  data.tar.gz: 62b7c5402eefb06f871ff6aa1459ad3698ddb39d5bff3667f5c8cd6c15204802da4821f8cc969d365a63a81284cabef793f96ee3c9f7d0298f1cc603dfbdcdb4
+  metadata.gz: 9873898be9fdec71740cf215519847dd61b9bd31c5d51cce787cba2400e63b7f272df0e7a7b74a53d83230a56c1f0dfedce4d874bddc2f09e4ada4c0ffda2abf
+  data.tar.gz: f32be859ee44a6ff27508845624ea2bc39f265ae94aee41164df42fdd4b313313acbc911ed046bb373a4cf250995aab7a1b0844291e5c53f5a2193d8ad1afdbf

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.34.0 (2024-11-26)
+------------------
+
+* Feature - Custom Orchestration and Streaming configurations API release for AWSBedrockAgents.
+
 1.33.0 (2024-11-22)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.33.0
+1.34.0

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

@@ -637,6 +637,9 @@ module Aws::BedrockAgentRuntime
     #
     #   [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/agents-session-state.html
     #
+    # @option params [Types::StreamingConfigurations] :streaming_configurations
+    #   Specifies the configurations for streaming.
+    #
     # @return [Types::InvokeAgentResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::InvokeAgentResponse#completion #completion} => Types::ResponseStream
@@ -976,6 +979,10 @@ module Aws::BedrockAgentRuntime
     #         "String" => "String",
     #       },
     #     },
+    #     streaming_configurations: {
+    #       apply_guardrail_interval: 1,
+    #       stream_final_response: false,
+    #     },
     #   })
     #
     # @example Response structure
@@ -1061,6 +1068,8 @@ module Aws::BedrockAgentRuntime
     #   event.agent_id #=> String
     #   event.agent_version #=> String
     #   event.session_id #=> String
+    #   event.trace.custom_orchestration_trace.event.text #=> String
+    #   event.trace.custom_orchestration_trace.trace_id #=> String
     #   event.trace.failure_trace.failure_reason #=> String
     #   event.trace.failure_trace.trace_id #=> String
     #   event.trace.guardrail_trace.action #=> String, one of "INTERVENED", "NONE"
@@ -2157,6 +2166,8 @@ module Aws::BedrockAgentRuntime
     #
     #   For :trace event available at #on_trace_event callback and response eventstream enumerator:
     #   event.session_id #=> String
+    #   event.trace.custom_orchestration_trace.event.text #=> String
+    #   event.trace.custom_orchestration_trace.trace_id #=> String
     #   event.trace.failure_trace.failure_reason #=> String
     #   event.trace.failure_trace.trace_id #=> String
     #   event.trace.guardrail_trace.action #=> String, one of "INTERVENED", "NONE"
@@ -2964,7 +2975,7 @@ module Aws::BedrockAgentRuntime
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-bedrockagentruntime'
-      context[:gem_version] = '1.33.0'
+      context[:gem_version] = '1.34.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -58,6 +58,8 @@ module Aws::BedrockAgentRuntime
     ContentType = Shapes::StringShape.new(name: 'ContentType')
     CreationMode = Shapes::StringShape.new(name: 'CreationMode')
     CustomControlMethod = Shapes::StringShape.new(name: 'CustomControlMethod')
+    CustomOrchestrationTrace = Shapes::StructureShape.new(name: 'CustomOrchestrationTrace')
+    CustomOrchestrationTraceEvent = Shapes::StructureShape.new(name: 'CustomOrchestrationTraceEvent')
     DateTimestamp = Shapes::TimestampShape.new(name: 'DateTimestamp', timestampFormat: "iso8601")
     DeleteAgentMemoryRequest = Shapes::StructureShape.new(name: 'DeleteAgentMemoryRequest')
     DeleteAgentMemoryResponse = Shapes::StructureShape.new(name: 'DeleteAgentMemoryResponse')
@@ -318,6 +320,8 @@ module Aws::BedrockAgentRuntime
     SpanEndInteger = Shapes::IntegerShape.new(name: 'SpanEndInteger')
     SpanStartInteger = Shapes::IntegerShape.new(name: 'SpanStartInteger')
     StopSequences = Shapes::ListShape.new(name: 'StopSequences')
+    StreamingConfigurations = Shapes::StructureShape.new(name: 'StreamingConfigurations')
+    StreamingConfigurationsApplyGuardrailIntervalInteger = Shapes::IntegerShape.new(name: 'StreamingConfigurationsApplyGuardrailIntervalInteger')
     String = Shapes::StringShape.new(name: 'String')
     SummaryText = Shapes::StringShape.new(name: 'SummaryText')
     Temperature = Shapes::FloatShape.new(name: 'Temperature')
@@ -457,6 +461,13 @@ module Aws::BedrockAgentRuntime
     ContentMap.key = Shapes::ShapeRef.new(shape: String)
     ContentMap.value = Shapes::ShapeRef.new(shape: Parameters)
 
+    CustomOrchestrationTrace.add_member(:event, Shapes::ShapeRef.new(shape: CustomOrchestrationTraceEvent, location_name: "event"))
+    CustomOrchestrationTrace.add_member(:trace_id, Shapes::ShapeRef.new(shape: TraceId, location_name: "traceId"))
+    CustomOrchestrationTrace.struct_class = Types::CustomOrchestrationTrace
+
+    CustomOrchestrationTraceEvent.add_member(:text, Shapes::ShapeRef.new(shape: String, location_name: "text"))
+    CustomOrchestrationTraceEvent.struct_class = Types::CustomOrchestrationTraceEvent
+
     DeleteAgentMemoryRequest.add_member(:agent_alias_id, Shapes::ShapeRef.new(shape: AgentAliasId, required: true, location: "uri", location_name: "agentAliasId"))
     DeleteAgentMemoryRequest.add_member(:agent_id, Shapes::ShapeRef.new(shape: AgentId, required: true, location: "uri", location_name: "agentId"))
     DeleteAgentMemoryRequest.add_member(:memory_id, Shapes::ShapeRef.new(shape: MemoryId, location: "querystring", location_name: "memoryId"))
@@ -834,6 +845,7 @@ module Aws::BedrockAgentRuntime
     InvokeAgentRequest.add_member(:memory_id, Shapes::ShapeRef.new(shape: MemoryId, location_name: "memoryId"))
     InvokeAgentRequest.add_member(:session_id, Shapes::ShapeRef.new(shape: SessionId, required: true, location: "uri", location_name: "sessionId"))
     InvokeAgentRequest.add_member(:session_state, Shapes::ShapeRef.new(shape: SessionState, location_name: "sessionState"))
+    InvokeAgentRequest.add_member(:streaming_configurations, Shapes::ShapeRef.new(shape: StreamingConfigurations, location_name: "streamingConfigurations"))
     InvokeAgentRequest.struct_class = Types::InvokeAgentRequest
 
     InvokeAgentResponse.add_member(:completion, Shapes::ShapeRef.new(shape: ResponseStream, required: true, eventstream: true, location_name: "completion"))
@@ -1278,6 +1290,10 @@ module Aws::BedrockAgentRuntime
 
     StopSequences.member = Shapes::ShapeRef.new(shape: String)
 
+    StreamingConfigurations.add_member(:apply_guardrail_interval, Shapes::ShapeRef.new(shape: StreamingConfigurationsApplyGuardrailIntervalInteger, location_name: "applyGuardrailInterval"))
+    StreamingConfigurations.add_member(:stream_final_response, Shapes::ShapeRef.new(shape: Boolean, location_name: "streamFinalResponse"))
+    StreamingConfigurations.struct_class = Types::StreamingConfigurations
+
     TextInferenceConfig.add_member(:max_tokens, Shapes::ShapeRef.new(shape: MaxTokens, location_name: "maxTokens"))
     TextInferenceConfig.add_member(:stop_sequences, Shapes::ShapeRef.new(shape: RAGStopSequences, location_name: "stopSequences"))
     TextInferenceConfig.add_member(:temperature, Shapes::ShapeRef.new(shape: Temperature, location_name: "temperature"))
@@ -1294,12 +1310,14 @@ module Aws::BedrockAgentRuntime
     ThrottlingException.add_member(:message, Shapes::ShapeRef.new(shape: NonBlankString, location_name: "message"))
     ThrottlingException.struct_class = Types::ThrottlingException
 
+    Trace.add_member(:custom_orchestration_trace, Shapes::ShapeRef.new(shape: CustomOrchestrationTrace, location_name: "customOrchestrationTrace"))
     Trace.add_member(:failure_trace, Shapes::ShapeRef.new(shape: FailureTrace, location_name: "failureTrace"))
     Trace.add_member(:guardrail_trace, Shapes::ShapeRef.new(shape: GuardrailTrace, location_name: "guardrailTrace"))
     Trace.add_member(:orchestration_trace, Shapes::ShapeRef.new(shape: OrchestrationTrace, location_name: "orchestrationTrace"))
     Trace.add_member(:post_processing_trace, Shapes::ShapeRef.new(shape: PostProcessingTrace, location_name: "postProcessingTrace"))
     Trace.add_member(:pre_processing_trace, Shapes::ShapeRef.new(shape: PreProcessingTrace, location_name: "preProcessingTrace"))
     Trace.add_member(:unknown, Shapes::ShapeRef.new(shape: nil, location_name: 'unknown'))
+    Trace.add_member_subclass(:custom_orchestration_trace, Types::Trace::CustomOrchestrationTrace)
     Trace.add_member_subclass(:failure_trace, Types::Trace::FailureTrace)
     Trace.add_member_subclass(:guardrail_trace, Types::Trace::GuardrailTrace)
     Trace.add_member_subclass(:orchestration_trace, Types::Trace::OrchestrationTrace)

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

@@ -636,6 +636,39 @@ module Aws::BedrockAgentRuntime
       include Aws::Structure
     end
 
+    # The trace behavior for the custom orchestration.
+    #
+    # @!attribute [rw] event
+    #   The trace event details used with the custom orchestration.
+    #   @return [Types::CustomOrchestrationTraceEvent]
+    #
+    # @!attribute [rw] trace_id
+    #   The unique identifier of the trace.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/CustomOrchestrationTrace AWS API Documentation
+    #
+    class CustomOrchestrationTrace < Struct.new(
+      :event,
+      :trace_id)
+      SENSITIVE = [:event]
+      include Aws::Structure
+    end
+
+    # The event in the custom orchestration sequence.
+    #
+    # @!attribute [rw] text
+    #   The text that prompted the event at this step.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/CustomOrchestrationTraceEvent AWS API Documentation
+    #
+    class CustomOrchestrationTraceEvent < Struct.new(
+      :text)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] agent_alias_id
     #   The unique identifier of an alias of an agent.
     #   @return [String]
@@ -2369,6 +2402,10 @@ module Aws::BedrockAgentRuntime
     #   [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/agents-session-state.html
     #   @return [Types::SessionState]
     #
+    # @!attribute [rw] streaming_configurations
+    #   Specifies the configurations for streaming.
+    #   @return [Types::StreamingConfigurations]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/InvokeAgentRequest AWS API Documentation
     #
     class InvokeAgentRequest < Struct.new(
@@ -2379,7 +2416,8 @@ module Aws::BedrockAgentRuntime
       :input_text,
       :memory_id,
       :session_id,
-      :session_state)
+      :session_state,
+      :streaming_configurations)
       SENSITIVE = [:input_text]
       include Aws::Structure
     end
@@ -4712,6 +4750,26 @@ module Aws::BedrockAgentRuntime
       include Aws::Structure
     end
 
+    # Configurations for streaming.
+    #
+    # @!attribute [rw] apply_guardrail_interval
+    #   The guardrail interval to apply as response is generated.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] stream_final_response
+    #   Specifies whether to enable streaming for the final response. This
+    #   is set to `false` by default.
+    #   @return [Boolean]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/StreamingConfigurations AWS API Documentation
+    #
+    class StreamingConfigurations < Struct.new(
+      :apply_guardrail_interval,
+      :stream_final_response)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Configuration settings for text generation using a language model via
     # the RetrieveAndGenerate operation. Includes parameters like
     # temperature, top-p, maximum token count, and stop sequences.
@@ -4839,6 +4897,11 @@ module Aws::BedrockAgentRuntime
     #
     # @note Trace is a union - when returned from an API call exactly one value will be set and the returned type will be a subclass of Trace corresponding to the set member.
     #
+    # @!attribute [rw] custom_orchestration_trace
+    #   Details about the custom orchestration step in which the agent
+    #   determines the order in which actions are executed.
+    #   @return [Types::CustomOrchestrationTrace]
+    #
     # @!attribute [rw] failure_trace
     #   Contains information about the failure of the interaction.
     #   @return [Types::FailureTrace]
@@ -4866,16 +4929,18 @@ module Aws::BedrockAgentRuntime
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/Trace AWS API Documentation
     #
     class Trace < Struct.new(
+      :custom_orchestration_trace,
       :failure_trace,
       :guardrail_trace,
       :orchestration_trace,
       :post_processing_trace,
       :pre_processing_trace,
       :unknown)
-      SENSITIVE = [:failure_trace, :guardrail_trace, :orchestration_trace, :post_processing_trace, :pre_processing_trace]
+      SENSITIVE = [:custom_orchestration_trace, :failure_trace, :guardrail_trace, :orchestration_trace, :post_processing_trace, :pre_processing_trace]
       include Aws::Structure
       include Aws::Structure::Union
 
+      class CustomOrchestrationTrace < Trace; end
       class FailureTrace < Trace; end
       class GuardrailTrace < Trace; end
       class OrchestrationTrace < Trace; end

data/lib/aws-sdk-bedrockagentruntime.rb

@@ -55,7 +55,7 @@ module Aws::BedrockAgentRuntime
   autoload :Endpoints, 'aws-sdk-bedrockagentruntime/endpoints'
   autoload :EventStreams, 'aws-sdk-bedrockagentruntime/event_streams'
 
-  GEM_VERSION = '1.33.0'
+  GEM_VERSION = '1.34.0'
 
 end
 

data/sig/client.rbs

@@ -239,6 +239,10 @@ module Aws
                               },
                             ]?,
                             session_attributes: Hash[::String, ::String]?
+                          },
+                          ?streaming_configurations: {
+                            apply_guardrail_interval: ::Integer?,
+                            stream_final_response: bool?
                           }
                         ) ?{ (*untyped) -> void } -> _InvokeAgentResponseSuccess
                       | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) ?{ (*untyped) -> void } -> _InvokeAgentResponseSuccess

data/sig/types.rbs

@@ -164,6 +164,17 @@ module Aws::BedrockAgentRuntime
       SENSITIVE: []
     end
 
+    class CustomOrchestrationTrace
+      attr_accessor event: Types::CustomOrchestrationTraceEvent
+      attr_accessor trace_id: ::String
+      SENSITIVE: [:event]
+    end
+
+    class CustomOrchestrationTraceEvent
+      attr_accessor text: ::String
+      SENSITIVE: []
+    end
+
     class DeleteAgentMemoryRequest
       attr_accessor agent_alias_id: ::String
       attr_accessor agent_id: ::String
@@ -643,6 +654,7 @@ module Aws::BedrockAgentRuntime
       attr_accessor memory_id: ::String
       attr_accessor session_id: ::String
       attr_accessor session_state: Types::SessionState
+      attr_accessor streaming_configurations: Types::StreamingConfigurations
       SENSITIVE: [:input_text]
     end
 
@@ -1195,6 +1207,12 @@ module Aws::BedrockAgentRuntime
       SENSITIVE: []
     end
 
+    class StreamingConfigurations
+      attr_accessor apply_guardrail_interval: ::Integer
+      attr_accessor stream_final_response: bool
+      SENSITIVE: []
+    end
+
     class TextInferenceConfig
       attr_accessor max_tokens: ::Integer
       attr_accessor stop_sequences: ::Array[::String]
@@ -1221,14 +1239,17 @@ module Aws::BedrockAgentRuntime
     end
 
     class Trace
+      attr_accessor custom_orchestration_trace: Types::CustomOrchestrationTrace
       attr_accessor failure_trace: Types::FailureTrace
       attr_accessor guardrail_trace: Types::GuardrailTrace
       attr_accessor orchestration_trace: Types::OrchestrationTrace
       attr_accessor post_processing_trace: Types::PostProcessingTrace
       attr_accessor pre_processing_trace: Types::PreProcessingTrace
       attr_accessor unknown: untyped
-      SENSITIVE: [:failure_trace, :guardrail_trace, :orchestration_trace, :post_processing_trace, :pre_processing_trace]
+      SENSITIVE: [:custom_orchestration_trace, :failure_trace, :guardrail_trace, :orchestration_trace, :post_processing_trace, :pre_processing_trace]
 
+      class CustomOrchestrationTrace < Trace
+      end
       class FailureTrace < Trace
       end
       class GuardrailTrace < Trace

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-bedrockagentruntime
 version: !ruby/object:Gem::Version
-  version: 1.33.0
+  version: 1.34.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-11-22 00:00:00.000000000 Z
+date: 2024-11-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core