aws-sdk-bedrockruntime 1.42.0 → 1.44.0

data/lib/aws-sdk-bedrockruntime/event_streams.rb

@@ -9,6 +9,29 @@
 
 module Aws::BedrockRuntime
   module EventStreams
+    class InvokeModelWithBidirectionalStreamInput
+
+      def initialize
+        @event_emitter = Aws::EventEmitter.new
+      end
+
+      # @option params [String, StringIO, File] :bytes
+      #   The audio content for the bidirectional input.
+      #
+      def signal_chunk_event(params = {})
+        @event_emitter.emit(:chunk, params)
+      end
+
+      def signal_end_stream
+        @event_emitter.emit(:end_stream, {})
+      end
+
+      # @api private
+      # @return Aws::EventEmitter
+      attr_reader :event_emitter
+
+    end
+
     class ConverseStreamOutput
 
       def initialize
@@ -92,6 +115,70 @@ module Aws::BedrockRuntime
       # @return Aws::EventEmitter
       attr_reader :event_emitter
 
+    end
+    class InvokeModelWithBidirectionalStreamOutput
+
+      def initialize
+        @event_emitter = Aws::EventEmitter.new
+      end
+
+      def on_chunk_event(&block)
+        @event_emitter.on(:chunk, block) if block_given?
+      end
+
+      def on_internal_server_exception_event(&block)
+        @event_emitter.on(:internal_server_exception, block) if block_given?
+      end
+
+      def on_model_stream_error_exception_event(&block)
+        @event_emitter.on(:model_stream_error_exception, block) if block_given?
+      end
+
+      def on_validation_exception_event(&block)
+        @event_emitter.on(:validation_exception, block) if block_given?
+      end
+
+      def on_throttling_exception_event(&block)
+        @event_emitter.on(:throttling_exception, block) if block_given?
+      end
+
+      def on_model_timeout_exception_event(&block)
+        @event_emitter.on(:model_timeout_exception, block) if block_given?
+      end
+
+      def on_service_unavailable_exception_event(&block)
+        @event_emitter.on(:service_unavailable_exception, block) if block_given?
+      end
+
+      def on_error_event(&block)
+        @event_emitter.on(:error, block) if block_given?
+      end
+
+      def on_initial_response_event(&block)
+        @event_emitter.on(:initial_response, block) if block_given?
+      end
+
+      def on_unknown_event(&block)
+        @event_emitter.on(:unknown_event, block) if block_given?
+      end
+
+      def on_event(&block)
+        on_chunk_event(&block)
+        on_internal_server_exception_event(&block)
+        on_model_stream_error_exception_event(&block)
+        on_validation_exception_event(&block)
+        on_throttling_exception_event(&block)
+        on_model_timeout_exception_event(&block)
+        on_service_unavailable_exception_event(&block)
+        on_error_event(&block)
+        on_initial_response_event(&block)
+        on_unknown_event(&block)
+      end
+
+      # @api private
+      # @return Aws::EventEmitter
+      attr_reader :event_emitter
+
     end
     class ResponseStream
 

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

@@ -54,13 +54,25 @@ module Aws::BedrockRuntime
     #   The content details used in the request to apply the guardrail.
     #   @return [Array<Types::GuardrailContentBlock>]
     #
+    # @!attribute [rw] output_scope
+    #   Specifies the scope of the output that you get in the response. Set
+    #   to `FULL` to return the entire output, including any detected and
+    #   non-detected entries in the response for enhanced debugging.
+    #
+    #   Note that the full output scope doesn't apply to word filters or
+    #   regex in sensitive information filters. It does apply to all other
+    #   filtering policies, including sensitive information with filters
+    #   that can detect personally identifiable information (PII).
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/ApplyGuardrailRequest AWS API Documentation
     #
     class ApplyGuardrailRequest < Struct.new(
       :guardrail_identifier,
       :guardrail_version,
       :source,
-      :content)
+      :content,
+      :output_scope)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -73,6 +85,10 @@ module Aws::BedrockRuntime
     #   The action taken in the response from the guardrail.
     #   @return [String]
     #
+    # @!attribute [rw] action_reason
+    #   The reason for the action taken when harmful content is detected.
+    #   @return [String]
+    #
     # @!attribute [rw] outputs
     #   The output details in the response from the guardrail.
     #   @return [Array<Types::GuardrailOutputContent>]
@@ -90,6 +106,7 @@ module Aws::BedrockRuntime
     class ApplyGuardrailResponse < Struct.new(
       :usage,
       :action,
+      :action_reason,
       :outputs,
       :assessments,
       :guardrail_coverage)
@@ -208,6 +225,38 @@ module Aws::BedrockRuntime
     #
     class AutoToolChoice < Aws::EmptyStructure; end
 
+    # Payload content for the bidirectional input. The input is an audio
+    # stream.
+    #
+    # @!attribute [rw] bytes
+    #   The audio content for the bidirectional input.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/BidirectionalInputPayloadPart AWS API Documentation
+    #
+    class BidirectionalInputPayloadPart < Struct.new(
+      :bytes,
+      :event_type)
+      SENSITIVE = [:bytes]
+      include Aws::Structure
+    end
+
+    # Output from the bidirectional stream. The output is speech and a text
+    # transcription.
+    #
+    # @!attribute [rw] bytes
+    #   The speech output of the bidirectional stream.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/BidirectionalOutputPayloadPart AWS API Documentation
+    #
+    class BidirectionalOutputPayloadPart < Struct.new(
+      :bytes,
+      :event_type)
+      SENSITIVE = [:bytes]
+      include Aws::Structure
+    end
+
     # Defines a section of content to be cached for reuse in subsequent API
     # calls.
     #
@@ -1161,13 +1210,19 @@ module Aws::BedrockRuntime
     #   The guardrail action.
     #   @return [String]
     #
+    # @!attribute [rw] detected
+    #   Indicates whether content that breaches the guardrail configuration
+    #   is detected.
+    #   @return [Boolean]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/GuardrailContentFilter AWS API Documentation
     #
     class GuardrailContentFilter < Struct.new(
       :type,
       :confidence,
       :filter_strength,
-      :action)
+      :action,
+      :detected)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1205,13 +1260,20 @@ module Aws::BedrockRuntime
     #   The action performed by the guardrails contextual grounding filter.
     #   @return [String]
     #
+    # @!attribute [rw] detected
+    #   Indicates whether content that fails the contextual grounding
+    #   evaluation (grounding or relevance score less than the corresponding
+    #   threshold) was detected.
+    #   @return [Boolean]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/GuardrailContextualGroundingFilter AWS API Documentation
     #
     class GuardrailContextualGroundingFilter < Struct.new(
       :type,
       :threshold,
       :score,
-      :action)
+      :action,
+      :detected)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1363,11 +1425,17 @@ module Aws::BedrockRuntime
     #   The action for the custom word.
     #   @return [String]
     #
+    # @!attribute [rw] detected
+    #   Indicates whether custom word content that breaches the guardrail
+    #   configuration is detected.
+    #   @return [Boolean]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/GuardrailCustomWord AWS API Documentation
     #
     class GuardrailCustomWord < Struct.new(
       :match,
-      :action)
+      :action,
+      :detected)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1475,12 +1543,18 @@ module Aws::BedrockRuntime
     #   The action for the managed word.
     #   @return [String]
     #
+    # @!attribute [rw] detected
+    #   Indicates whether managed word content that breaches the guardrail
+    #   configuration is detected.
+    #   @return [Boolean]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/GuardrailManagedWord AWS API Documentation
     #
     class GuardrailManagedWord < Struct.new(
       :match,
       :type,
-      :action)
+      :action,
+      :detected)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1514,12 +1588,18 @@ module Aws::BedrockRuntime
     #   The PII entity filter action.
     #   @return [String]
     #
+    # @!attribute [rw] detected
+    #   Indicates whether personally identifiable information (PII) that
+    #   breaches the guardrail configuration is detected.
+    #   @return [Boolean]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/GuardrailPiiEntityFilter AWS API Documentation
     #
     class GuardrailPiiEntityFilter < Struct.new(
       :match,
       :type,
-      :action)
+      :action,
+      :detected)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1542,13 +1622,19 @@ module Aws::BedrockRuntime
     #   The region filter action.
     #   @return [String]
     #
+    # @!attribute [rw] detected
+    #   Indicates whether custom regex entities that breach the guardrail
+    #   configuration are detected.
+    #   @return [Boolean]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/GuardrailRegexFilter AWS API Documentation
     #
     class GuardrailRegexFilter < Struct.new(
       :name,
       :match,
       :regex,
-      :action)
+      :action,
+      :detected)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1658,12 +1744,18 @@ module Aws::BedrockRuntime
     #   The action the guardrail should take when it intervenes on a topic.
     #   @return [String]
     #
+    # @!attribute [rw] detected
+    #   Indicates whether topic content that breaches the guardrail
+    #   configuration is detected.
+    #   @return [Boolean]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/GuardrailTopic AWS API Documentation
     #
     class GuardrailTopic < Struct.new(
       :name,
       :type,
-      :action)
+      :action,
+      :detected)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1697,12 +1789,18 @@ module Aws::BedrockRuntime
     #   the output assessments.
     #   @return [Hash<String,Array<Types::GuardrailAssessment>>]
     #
+    # @!attribute [rw] action_reason
+    #   Provides the reason for the action taken when harmful content is
+    #   detected.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/GuardrailTraceAssessment AWS API Documentation
     #
     class GuardrailTraceAssessment < Struct.new(
       :model_output,
       :input_assessment,
-      :output_assessments)
+      :output_assessments,
+      :action_reason)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2040,6 +2138,47 @@ module Aws::BedrockRuntime
       include Aws::Structure
     end
 
+    # @!attribute [rw] model_id
+    #   The model ID or ARN of the model ID to use. Currently, only
+    #   `amazon.nova-sonic-v1:0` is supported.
+    #   @return [String]
+    #
+    # @!attribute [rw] body
+    #   The prompt and inference parameters in the format specified in the
+    #   `BidirectionalInputPayloadPart` in the header. You must provide the
+    #   body in JSON format. To see the format and content of the request
+    #   and response bodies for different models, refer to [Inference
+    #   parameters][1]. For more information, see [Run inference][2] in the
+    #   Bedrock User Guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters.html
+    #   [2]: https://docs.aws.amazon.com/bedrock/latest/userguide/api-methods-run.html
+    #   @return [Types::InvokeModelWithBidirectionalStreamInput]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/InvokeModelWithBidirectionalStreamRequest AWS API Documentation
+    #
+    class InvokeModelWithBidirectionalStreamRequest < Struct.new(
+      :model_id,
+      :body)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] body
+    #   Streaming response from the model in the format specified by the
+    #   `BidirectionalOutputPayloadPart` header.
+    #   @return [Types::InvokeModelWithBidirectionalStreamOutput]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/InvokeModelWithBidirectionalStreamResponse AWS API Documentation
+    #
+    class InvokeModelWithBidirectionalStreamResponse < Struct.new(
+      :body)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] body
     #   The prompt and inference parameters in the format specified in the
     #   `contentType` in the header. You must provide the body in JSON
@@ -3194,6 +3333,48 @@ module Aws::BedrockRuntime
 
     end
 
+    # Payload content, the speech chunk, for the bidirectional input of the
+    # invocation step.
+    #
+    # EventStream is an Enumerator of Events.
+    #  #event_types #=> Array, returns all modeled event types in the stream
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/InvokeModelWithBidirectionalStreamInput AWS API Documentation
+    #
+    class InvokeModelWithBidirectionalStreamInput < Enumerator
+
+      def event_types
+        [
+          :chunk
+        ]
+      end
+
+    end
+
+    # Output from the bidirectional stream that was used for model
+    # invocation.
+    #
+    # EventStream is an Enumerator of Events.
+    #  #event_types #=> Array, returns all modeled event types in the stream
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/InvokeModelWithBidirectionalStreamOutput AWS API Documentation
+    #
+    class InvokeModelWithBidirectionalStreamOutput < Enumerator
+
+      def event_types
+        [
+          :chunk,
+          :internal_server_exception,
+          :model_stream_error_exception,
+          :validation_exception,
+          :throttling_exception,
+          :model_timeout_exception,
+          :service_unavailable_exception
+        ]
+      end
+
+    end
+
     # Definition of content in the response stream.
     #
     # EventStream is an Enumerator of Events.

data/lib/aws-sdk-bedrockruntime.rb

@@ -54,9 +54,10 @@ module Aws::BedrockRuntime
   autoload :EndpointParameters, 'aws-sdk-bedrockruntime/endpoint_parameters'
   autoload :EndpointProvider, 'aws-sdk-bedrockruntime/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-bedrockruntime/endpoints'
+  autoload :AsyncClient, 'aws-sdk-bedrockruntime/async_client'
   autoload :EventStreams, 'aws-sdk-bedrockruntime/event_streams'
 
-  GEM_VERSION = '1.42.0'
+  GEM_VERSION = '1.44.0'
 
 end
 

data/sig/client.rbs

@@ -84,6 +84,7 @@ module Aws
         include ::Seahorse::Client::_ResponseSuccess[Types::ApplyGuardrailResponse]
         def usage: () -> Types::GuardrailUsage
         def action: () -> ("NONE" | "GUARDRAIL_INTERVENED")
+        def action_reason: () -> ::String
         def outputs: () -> ::Array[Types::GuardrailOutputContent]
         def assessments: () -> ::Array[Types::GuardrailAssessment]
         def guardrail_coverage: () -> Types::GuardrailCoverage
@@ -106,7 +107,8 @@ module Aws
                                    }
                                  }?
                                },
-                             ]
+                             ],
+                             ?output_scope: ("INTERVENTIONS" | "FULL")
                            ) -> _ApplyGuardrailResponseSuccess
                          | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _ApplyGuardrailResponseSuccess
 
@@ -273,7 +275,7 @@ module Aws
                       ?guardrail_config: {
                         guardrail_identifier: ::String,
                         guardrail_version: ::String,
-                        trace: ("enabled" | "disabled")?
+                        trace: ("enabled" | "disabled" | "enabled_full")?
                       },
                       ?additional_model_request_fields: {
                       },
@@ -445,7 +447,7 @@ module Aws
                              ?guardrail_config: {
                                guardrail_identifier: ::String,
                                guardrail_version: ::String,
-                               trace: ("enabled" | "disabled")?,
+                               trace: ("enabled" | "disabled" | "enabled_full")?,
                                stream_processing_mode: ("sync" | "async")?
                              },
                              ?additional_model_request_fields: {
@@ -491,13 +493,24 @@ module Aws
                           ?content_type: ::String,
                           ?accept: ::String,
                           model_id: ::String,
-                          ?trace: ("ENABLED" | "DISABLED"),
+                          ?trace: ("ENABLED" | "DISABLED" | "ENABLED_FULL"),
                           ?guardrail_identifier: ::String,
                           ?guardrail_version: ::String,
                           ?performance_config_latency: ("standard" | "optimized")
                         ) -> _InvokeModelResponseSuccess
                       | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _InvokeModelResponseSuccess
 
+      interface _InvokeModelWithBidirectionalStreamResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::InvokeModelWithBidirectionalStreamResponse]
+        def body: () -> Types::InvokeModelWithBidirectionalStreamOutput
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/BedrockRuntime/Client.html#invoke_model_with_bidirectional_stream-instance_method
+      def invoke_model_with_bidirectional_stream: (
+                                                    model_id: ::String,
+                                                    input_event_stream_hander: untyped
+                                                  ) ?{ (*untyped) -> void } -> _InvokeModelWithBidirectionalStreamResponseSuccess
+                                                | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) ?{ (*untyped) -> void } -> _InvokeModelWithBidirectionalStreamResponseSuccess
+
       interface _InvokeModelWithResponseStreamResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::InvokeModelWithResponseStreamResponse]
         def body: () -> Types::ResponseStream
@@ -510,7 +523,7 @@ module Aws
                                                ?content_type: ::String,
                                                ?accept: ::String,
                                                model_id: ::String,
-                                               ?trace: ("ENABLED" | "DISABLED"),
+                                               ?trace: ("ENABLED" | "DISABLED" | "ENABLED_FULL"),
                                                ?guardrail_identifier: ::String,
                                                ?guardrail_version: ::String,
                                                ?performance_config_latency: ("standard" | "optimized")