aws-sdk-bedrockruntime 1.15.0 → 1.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 44ad8c5daa358580d3658e10ec3891b2757e92fd44ef6e6c696fa7fb2a421759
-  data.tar.gz: 4ade4c1767036c0894a618e3e04bb0a6b2330d7fefd565580b3437d577b69567
+  metadata.gz: 7d9aaed2520eafc32d768c6641145a47f146fbc96cc1282c1025131cc9f50c48
+  data.tar.gz: e255962e70aeb7051db7f7f57d0e0a74d6397e58b977622bf3061cd18e411485
 SHA512:
-  metadata.gz: 22a3b581362ed695d11d5097ab22e3fd190062abad919a844801e93fb4935a532dd380b8665c9add0e6787417647bf31d3fc8dac2dda244ad6bcf92a36256674
-  data.tar.gz: 37084725d280adceb4a181e146c17827fea7abd2bdee052be59f94965daf49a0af5095e8e3f57419b58419a1d9f1dccd28f90579d216a92b460dbd9406a892da
+  metadata.gz: c69fb53793f6ef1ba152dbac64d19289f835dc156231161deb3d13d761bba8a01666810bf294169a54050bd99a2243f2a2715da515259ed91f66fc88dd96f099
+  data.tar.gz: 48508ec3fa2435c70613511927e3681105bcbe2aa1b04d6b2d7284c890ddc6a191349f673bc8a721fd7634985596230415427174d561d137b105c164b79a6d32

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.16.0 (2024-07-10)
+------------------
+
+* Feature - Add support for contextual grounding check and ApplyGuardrail API for Guardrails for Amazon Bedrock.
+
 1.15.0 (2024-07-02)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.15.0
+1.16.0

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

@@ -436,6 +436,94 @@ module Aws::BedrockRuntime
 
     # @!group API Operations
 
+    # The action to apply a guardrail.
+    #
+    # @option params [required, String] :guardrail_identifier
+    #   The guardrail identifier used in the request to apply the guardrail.
+    #
+    # @option params [required, String] :guardrail_version
+    #   The guardrail version used in the request to apply the guardrail.
+    #
+    # @option params [required, String] :source
+    #   The source of data used in the request to apply the guardrail.
+    #
+    # @option params [required, Array<Types::GuardrailContentBlock>] :content
+    #   The content details used in the request to apply the guardrail.
+    #
+    # @return [Types::ApplyGuardrailResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ApplyGuardrailResponse#usage #usage} => Types::GuardrailUsage
+    #   * {Types::ApplyGuardrailResponse#action #action} => String
+    #   * {Types::ApplyGuardrailResponse#outputs #outputs} => Array&lt;Types::GuardrailOutputContent&gt;
+    #   * {Types::ApplyGuardrailResponse#assessments #assessments} => Array&lt;Types::GuardrailAssessment&gt;
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.apply_guardrail({
+    #     guardrail_identifier: "GuardrailIdentifier", # required
+    #     guardrail_version: "GuardrailVersion", # required
+    #     source: "INPUT", # required, accepts INPUT, OUTPUT
+    #     content: [ # required
+    #       {
+    #         text: {
+    #           text: "String", # required
+    #           qualifiers: ["grounding_source"], # accepts grounding_source, query, guard_content
+    #         },
+    #       },
+    #     ],
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.usage.topic_policy_units #=> Integer
+    #   resp.usage.content_policy_units #=> Integer
+    #   resp.usage.word_policy_units #=> Integer
+    #   resp.usage.sensitive_information_policy_units #=> Integer
+    #   resp.usage.sensitive_information_policy_free_units #=> Integer
+    #   resp.usage.contextual_grounding_policy_units #=> Integer
+    #   resp.action #=> String, one of "NONE", "GUARDRAIL_INTERVENED"
+    #   resp.outputs #=> Array
+    #   resp.outputs[0].text #=> String
+    #   resp.assessments #=> Array
+    #   resp.assessments[0].topic_policy.topics #=> Array
+    #   resp.assessments[0].topic_policy.topics[0].name #=> String
+    #   resp.assessments[0].topic_policy.topics[0].type #=> String, one of "DENY"
+    #   resp.assessments[0].topic_policy.topics[0].action #=> String, one of "BLOCKED"
+    #   resp.assessments[0].content_policy.filters #=> Array
+    #   resp.assessments[0].content_policy.filters[0].type #=> String, one of "INSULTS", "HATE", "SEXUAL", "VIOLENCE", "MISCONDUCT", "PROMPT_ATTACK"
+    #   resp.assessments[0].content_policy.filters[0].confidence #=> String, one of "NONE", "LOW", "MEDIUM", "HIGH"
+    #   resp.assessments[0].content_policy.filters[0].action #=> String, one of "BLOCKED"
+    #   resp.assessments[0].word_policy.custom_words #=> Array
+    #   resp.assessments[0].word_policy.custom_words[0].match #=> String
+    #   resp.assessments[0].word_policy.custom_words[0].action #=> String, one of "BLOCKED"
+    #   resp.assessments[0].word_policy.managed_word_lists #=> Array
+    #   resp.assessments[0].word_policy.managed_word_lists[0].match #=> String
+    #   resp.assessments[0].word_policy.managed_word_lists[0].type #=> String, one of "PROFANITY"
+    #   resp.assessments[0].word_policy.managed_word_lists[0].action #=> String, one of "BLOCKED"
+    #   resp.assessments[0].sensitive_information_policy.pii_entities #=> Array
+    #   resp.assessments[0].sensitive_information_policy.pii_entities[0].match #=> String
+    #   resp.assessments[0].sensitive_information_policy.pii_entities[0].type #=> String, one of "ADDRESS", "AGE", "AWS_ACCESS_KEY", "AWS_SECRET_KEY", "CA_HEALTH_NUMBER", "CA_SOCIAL_INSURANCE_NUMBER", "CREDIT_DEBIT_CARD_CVV", "CREDIT_DEBIT_CARD_EXPIRY", "CREDIT_DEBIT_CARD_NUMBER", "DRIVER_ID", "EMAIL", "INTERNATIONAL_BANK_ACCOUNT_NUMBER", "IP_ADDRESS", "LICENSE_PLATE", "MAC_ADDRESS", "NAME", "PASSWORD", "PHONE", "PIN", "SWIFT_CODE", "UK_NATIONAL_HEALTH_SERVICE_NUMBER", "UK_NATIONAL_INSURANCE_NUMBER", "UK_UNIQUE_TAXPAYER_REFERENCE_NUMBER", "URL", "USERNAME", "US_BANK_ACCOUNT_NUMBER", "US_BANK_ROUTING_NUMBER", "US_INDIVIDUAL_TAX_IDENTIFICATION_NUMBER", "US_PASSPORT_NUMBER", "US_SOCIAL_SECURITY_NUMBER", "VEHICLE_IDENTIFICATION_NUMBER"
+    #   resp.assessments[0].sensitive_information_policy.pii_entities[0].action #=> String, one of "ANONYMIZED", "BLOCKED"
+    #   resp.assessments[0].sensitive_information_policy.regexes #=> Array
+    #   resp.assessments[0].sensitive_information_policy.regexes[0].name #=> String
+    #   resp.assessments[0].sensitive_information_policy.regexes[0].match #=> String
+    #   resp.assessments[0].sensitive_information_policy.regexes[0].regex #=> String
+    #   resp.assessments[0].sensitive_information_policy.regexes[0].action #=> String, one of "ANONYMIZED", "BLOCKED"
+    #   resp.assessments[0].contextual_grounding_policy.filters #=> Array
+    #   resp.assessments[0].contextual_grounding_policy.filters[0].type #=> String, one of "GROUNDING", "RELEVANCE"
+    #   resp.assessments[0].contextual_grounding_policy.filters[0].threshold #=> Float
+    #   resp.assessments[0].contextual_grounding_policy.filters[0].score #=> Float
+    #   resp.assessments[0].contextual_grounding_policy.filters[0].action #=> String, one of "BLOCKED", "NONE"
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/ApplyGuardrail AWS API Documentation
+    #
+    # @overload apply_guardrail(params = {})
+    # @param [Hash] params ({})
+    def apply_guardrail(params = {}, options = {})
+      req = build_request(:apply_guardrail, params)
+      req.send_request(options)
+    end
+
     # Sends messages to the specified Amazon Bedrock model. `Converse`
     # provides a consistent interface that works with all models that
     # support messages. This allows you to write code once and use it with
@@ -603,6 +691,7 @@ module Aws::BedrockRuntime
     #             guard_content: {
     #               text: {
     #                 text: "String", # required
+    #                 qualifiers: ["grounding_source"], # accepts grounding_source, query, guard_content
     #               },
     #             },
     #           },
@@ -615,6 +704,7 @@ module Aws::BedrockRuntime
     #         guard_content: {
     #           text: {
     #             text: "String", # required
+    #             qualifiers: ["grounding_source"], # accepts grounding_source, query, guard_content
     #           },
     #         },
     #       },
@@ -680,6 +770,8 @@ module Aws::BedrockRuntime
     #   resp.output.message.content[0].tool_result.content[0].document.source.bytes #=> String
     #   resp.output.message.content[0].tool_result.status #=> String, one of "success", "error"
     #   resp.output.message.content[0].guard_content.text.text #=> String
+    #   resp.output.message.content[0].guard_content.text.qualifiers #=> Array
+    #   resp.output.message.content[0].guard_content.text.qualifiers[0] #=> String, one of "grounding_source", "query", "guard_content"
     #   resp.stop_reason #=> String, one of "end_turn", "tool_use", "max_tokens", "stop_sequence", "guardrail_intervened", "content_filtered"
     #   resp.usage.input_tokens #=> Integer
     #   resp.usage.output_tokens #=> Integer
@@ -712,6 +804,11 @@ module Aws::BedrockRuntime
     #   resp.trace.guardrail.input_assessment["String"].sensitive_information_policy.regexes[0].match #=> String
     #   resp.trace.guardrail.input_assessment["String"].sensitive_information_policy.regexes[0].regex #=> String
     #   resp.trace.guardrail.input_assessment["String"].sensitive_information_policy.regexes[0].action #=> String, one of "ANONYMIZED", "BLOCKED"
+    #   resp.trace.guardrail.input_assessment["String"].contextual_grounding_policy.filters #=> Array
+    #   resp.trace.guardrail.input_assessment["String"].contextual_grounding_policy.filters[0].type #=> String, one of "GROUNDING", "RELEVANCE"
+    #   resp.trace.guardrail.input_assessment["String"].contextual_grounding_policy.filters[0].threshold #=> Float
+    #   resp.trace.guardrail.input_assessment["String"].contextual_grounding_policy.filters[0].score #=> Float
+    #   resp.trace.guardrail.input_assessment["String"].contextual_grounding_policy.filters[0].action #=> String, one of "BLOCKED", "NONE"
     #   resp.trace.guardrail.output_assessments #=> Hash
     #   resp.trace.guardrail.output_assessments["String"] #=> Array
     #   resp.trace.guardrail.output_assessments["String"][0].topic_policy.topics #=> Array
@@ -738,6 +835,11 @@ module Aws::BedrockRuntime
     #   resp.trace.guardrail.output_assessments["String"][0].sensitive_information_policy.regexes[0].match #=> String
     #   resp.trace.guardrail.output_assessments["String"][0].sensitive_information_policy.regexes[0].regex #=> String
     #   resp.trace.guardrail.output_assessments["String"][0].sensitive_information_policy.regexes[0].action #=> String, one of "ANONYMIZED", "BLOCKED"
+    #   resp.trace.guardrail.output_assessments["String"][0].contextual_grounding_policy.filters #=> Array
+    #   resp.trace.guardrail.output_assessments["String"][0].contextual_grounding_policy.filters[0].type #=> String, one of "GROUNDING", "RELEVANCE"
+    #   resp.trace.guardrail.output_assessments["String"][0].contextual_grounding_policy.filters[0].threshold #=> Float
+    #   resp.trace.guardrail.output_assessments["String"][0].contextual_grounding_policy.filters[0].score #=> Float
+    #   resp.trace.guardrail.output_assessments["String"][0].contextual_grounding_policy.filters[0].action #=> String, one of "BLOCKED", "NONE"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/Converse AWS API Documentation
     #
@@ -1077,6 +1179,7 @@ module Aws::BedrockRuntime
     #             guard_content: {
     #               text: {
     #                 text: "String", # required
+    #                 qualifiers: ["grounding_source"], # accepts grounding_source, query, guard_content
     #               },
     #             },
     #           },
@@ -1089,6 +1192,7 @@ module Aws::BedrockRuntime
     #         guard_content: {
     #           text: {
     #             text: "String", # required
+    #             qualifiers: ["grounding_source"], # accepts grounding_source, query, guard_content
     #           },
     #         },
     #       },
@@ -1190,6 +1294,11 @@ module Aws::BedrockRuntime
     #   event.trace.guardrail.input_assessment["String"].sensitive_information_policy.regexes[0].match #=> String
     #   event.trace.guardrail.input_assessment["String"].sensitive_information_policy.regexes[0].regex #=> String
     #   event.trace.guardrail.input_assessment["String"].sensitive_information_policy.regexes[0].action #=> String, one of "ANONYMIZED", "BLOCKED"
+    #   event.trace.guardrail.input_assessment["String"].contextual_grounding_policy.filters #=> Array
+    #   event.trace.guardrail.input_assessment["String"].contextual_grounding_policy.filters[0].type #=> String, one of "GROUNDING", "RELEVANCE"
+    #   event.trace.guardrail.input_assessment["String"].contextual_grounding_policy.filters[0].threshold #=> Float
+    #   event.trace.guardrail.input_assessment["String"].contextual_grounding_policy.filters[0].score #=> Float
+    #   event.trace.guardrail.input_assessment["String"].contextual_grounding_policy.filters[0].action #=> String, one of "BLOCKED", "NONE"
     #   event.trace.guardrail.output_assessments #=> Hash
     #   event.trace.guardrail.output_assessments["String"] #=> Array
     #   event.trace.guardrail.output_assessments["String"][0].topic_policy.topics #=> Array
@@ -1216,6 +1325,11 @@ module Aws::BedrockRuntime
     #   event.trace.guardrail.output_assessments["String"][0].sensitive_information_policy.regexes[0].match #=> String
     #   event.trace.guardrail.output_assessments["String"][0].sensitive_information_policy.regexes[0].regex #=> String
     #   event.trace.guardrail.output_assessments["String"][0].sensitive_information_policy.regexes[0].action #=> String, one of "ANONYMIZED", "BLOCKED"
+    #   event.trace.guardrail.output_assessments["String"][0].contextual_grounding_policy.filters #=> Array
+    #   event.trace.guardrail.output_assessments["String"][0].contextual_grounding_policy.filters[0].type #=> String, one of "GROUNDING", "RELEVANCE"
+    #   event.trace.guardrail.output_assessments["String"][0].contextual_grounding_policy.filters[0].threshold #=> Float
+    #   event.trace.guardrail.output_assessments["String"][0].contextual_grounding_policy.filters[0].score #=> Float
+    #   event.trace.guardrail.output_assessments["String"][0].contextual_grounding_policy.filters[0].action #=> String, one of "BLOCKED", "NONE"
     #
     #   For :internal_server_exception event available at #on_internal_server_exception_event callback and response eventstream enumerator:
     #   event.message #=> String
@@ -1665,7 +1779,7 @@ module Aws::BedrockRuntime
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-bedrockruntime'
-      context[:gem_version] = '1.15.0'
+      context[:gem_version] = '1.16.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -15,6 +15,8 @@ module Aws::BedrockRuntime
 
     AccessDeniedException = Shapes::StructureShape.new(name: 'AccessDeniedException')
     AnyToolChoice = Shapes::StructureShape.new(name: 'AnyToolChoice')
+    ApplyGuardrailRequest = Shapes::StructureShape.new(name: 'ApplyGuardrailRequest')
+    ApplyGuardrailResponse = Shapes::StructureShape.new(name: 'ApplyGuardrailResponse')
     AutoToolChoice = Shapes::StructureShape.new(name: 'AutoToolChoice')
     Body = Shapes::BlobShape.new(name: 'Body')
     ContentBlock = Shapes::UnionShape.new(name: 'ContentBlock')
@@ -47,18 +49,35 @@ module Aws::BedrockRuntime
     DocumentFormat = Shapes::StringShape.new(name: 'DocumentFormat')
     DocumentSource = Shapes::UnionShape.new(name: 'DocumentSource')
     DocumentSourceBytesBlob = Shapes::BlobShape.new(name: 'DocumentSourceBytesBlob')
+    GuardrailAction = Shapes::StringShape.new(name: 'GuardrailAction')
     GuardrailAssessment = Shapes::StructureShape.new(name: 'GuardrailAssessment')
     GuardrailAssessmentList = Shapes::ListShape.new(name: 'GuardrailAssessmentList')
     GuardrailAssessmentListMap = Shapes::MapShape.new(name: 'GuardrailAssessmentListMap')
     GuardrailAssessmentMap = Shapes::MapShape.new(name: 'GuardrailAssessmentMap')
     GuardrailConfiguration = Shapes::StructureShape.new(name: 'GuardrailConfiguration')
+    GuardrailContentBlock = Shapes::UnionShape.new(name: 'GuardrailContentBlock')
+    GuardrailContentBlockList = Shapes::ListShape.new(name: 'GuardrailContentBlockList')
     GuardrailContentFilter = Shapes::StructureShape.new(name: 'GuardrailContentFilter')
     GuardrailContentFilterConfidence = Shapes::StringShape.new(name: 'GuardrailContentFilterConfidence')
     GuardrailContentFilterList = Shapes::ListShape.new(name: 'GuardrailContentFilterList')
     GuardrailContentFilterType = Shapes::StringShape.new(name: 'GuardrailContentFilterType')
     GuardrailContentPolicyAction = Shapes::StringShape.new(name: 'GuardrailContentPolicyAction')
     GuardrailContentPolicyAssessment = Shapes::StructureShape.new(name: 'GuardrailContentPolicyAssessment')
+    GuardrailContentPolicyUnitsProcessed = Shapes::IntegerShape.new(name: 'GuardrailContentPolicyUnitsProcessed')
+    GuardrailContentQualifier = Shapes::StringShape.new(name: 'GuardrailContentQualifier')
+    GuardrailContentQualifierList = Shapes::ListShape.new(name: 'GuardrailContentQualifierList')
+    GuardrailContentSource = Shapes::StringShape.new(name: 'GuardrailContentSource')
+    GuardrailContextualGroundingFilter = Shapes::StructureShape.new(name: 'GuardrailContextualGroundingFilter')
+    GuardrailContextualGroundingFilterScoreDouble = Shapes::FloatShape.new(name: 'GuardrailContextualGroundingFilterScoreDouble')
+    GuardrailContextualGroundingFilterThresholdDouble = Shapes::FloatShape.new(name: 'GuardrailContextualGroundingFilterThresholdDouble')
+    GuardrailContextualGroundingFilterType = Shapes::StringShape.new(name: 'GuardrailContextualGroundingFilterType')
+    GuardrailContextualGroundingFilters = Shapes::ListShape.new(name: 'GuardrailContextualGroundingFilters')
+    GuardrailContextualGroundingPolicyAction = Shapes::StringShape.new(name: 'GuardrailContextualGroundingPolicyAction')
+    GuardrailContextualGroundingPolicyAssessment = Shapes::StructureShape.new(name: 'GuardrailContextualGroundingPolicyAssessment')
+    GuardrailContextualGroundingPolicyUnitsProcessed = Shapes::IntegerShape.new(name: 'GuardrailContextualGroundingPolicyUnitsProcessed')
     GuardrailConverseContentBlock = Shapes::UnionShape.new(name: 'GuardrailConverseContentBlock')
+    GuardrailConverseContentQualifier = Shapes::StringShape.new(name: 'GuardrailConverseContentQualifier')
+    GuardrailConverseContentQualifierList = Shapes::ListShape.new(name: 'GuardrailConverseContentQualifierList')
     GuardrailConverseTextBlock = Shapes::StructureShape.new(name: 'GuardrailConverseTextBlock')
     GuardrailCustomWord = Shapes::StructureShape.new(name: 'GuardrailCustomWord')
     GuardrailCustomWordList = Shapes::ListShape.new(name: 'GuardrailCustomWordList')
@@ -66,6 +85,8 @@ module Aws::BedrockRuntime
     GuardrailManagedWord = Shapes::StructureShape.new(name: 'GuardrailManagedWord')
     GuardrailManagedWordList = Shapes::ListShape.new(name: 'GuardrailManagedWordList')
     GuardrailManagedWordType = Shapes::StringShape.new(name: 'GuardrailManagedWordType')
+    GuardrailOutputContent = Shapes::StructureShape.new(name: 'GuardrailOutputContent')
+    GuardrailOutputContentList = Shapes::ListShape.new(name: 'GuardrailOutputContentList')
     GuardrailOutputText = Shapes::StringShape.new(name: 'GuardrailOutputText')
     GuardrailPiiEntityFilter = Shapes::StructureShape.new(name: 'GuardrailPiiEntityFilter')
     GuardrailPiiEntityFilterList = Shapes::ListShape.new(name: 'GuardrailPiiEntityFilterList')
@@ -74,18 +95,24 @@ module Aws::BedrockRuntime
     GuardrailRegexFilterList = Shapes::ListShape.new(name: 'GuardrailRegexFilterList')
     GuardrailSensitiveInformationPolicyAction = Shapes::StringShape.new(name: 'GuardrailSensitiveInformationPolicyAction')
     GuardrailSensitiveInformationPolicyAssessment = Shapes::StructureShape.new(name: 'GuardrailSensitiveInformationPolicyAssessment')
+    GuardrailSensitiveInformationPolicyFreeUnitsProcessed = Shapes::IntegerShape.new(name: 'GuardrailSensitiveInformationPolicyFreeUnitsProcessed')
+    GuardrailSensitiveInformationPolicyUnitsProcessed = Shapes::IntegerShape.new(name: 'GuardrailSensitiveInformationPolicyUnitsProcessed')
     GuardrailStreamConfiguration = Shapes::StructureShape.new(name: 'GuardrailStreamConfiguration')
     GuardrailStreamProcessingMode = Shapes::StringShape.new(name: 'GuardrailStreamProcessingMode')
+    GuardrailTextBlock = Shapes::StructureShape.new(name: 'GuardrailTextBlock')
     GuardrailTopic = Shapes::StructureShape.new(name: 'GuardrailTopic')
     GuardrailTopicList = Shapes::ListShape.new(name: 'GuardrailTopicList')
     GuardrailTopicPolicyAction = Shapes::StringShape.new(name: 'GuardrailTopicPolicyAction')
     GuardrailTopicPolicyAssessment = Shapes::StructureShape.new(name: 'GuardrailTopicPolicyAssessment')
+    GuardrailTopicPolicyUnitsProcessed = Shapes::IntegerShape.new(name: 'GuardrailTopicPolicyUnitsProcessed')
     GuardrailTopicType = Shapes::StringShape.new(name: 'GuardrailTopicType')
     GuardrailTrace = Shapes::StringShape.new(name: 'GuardrailTrace')
     GuardrailTraceAssessment = Shapes::StructureShape.new(name: 'GuardrailTraceAssessment')
+    GuardrailUsage = Shapes::StructureShape.new(name: 'GuardrailUsage')
     GuardrailVersion = Shapes::StringShape.new(name: 'GuardrailVersion')
     GuardrailWordPolicyAction = Shapes::StringShape.new(name: 'GuardrailWordPolicyAction')
     GuardrailWordPolicyAssessment = Shapes::StructureShape.new(name: 'GuardrailWordPolicyAssessment')
+    GuardrailWordPolicyUnitsProcessed = Shapes::IntegerShape.new(name: 'GuardrailWordPolicyUnitsProcessed')
     ImageBlock = Shapes::StructureShape.new(name: 'ImageBlock')
     ImageFormat = Shapes::StringShape.new(name: 'ImageFormat')
     ImageSource = Shapes::UnionShape.new(name: 'ImageSource')
@@ -154,6 +181,18 @@ module Aws::BedrockRuntime
 
     AnyToolChoice.struct_class = Types::AnyToolChoice
 
+    ApplyGuardrailRequest.add_member(:guardrail_identifier, Shapes::ShapeRef.new(shape: GuardrailIdentifier, required: true, location: "uri", location_name: "guardrailIdentifier"))
+    ApplyGuardrailRequest.add_member(:guardrail_version, Shapes::ShapeRef.new(shape: GuardrailVersion, required: true, location: "uri", location_name: "guardrailVersion"))
+    ApplyGuardrailRequest.add_member(:source, Shapes::ShapeRef.new(shape: GuardrailContentSource, required: true, location_name: "source"))
+    ApplyGuardrailRequest.add_member(:content, Shapes::ShapeRef.new(shape: GuardrailContentBlockList, required: true, location_name: "content"))
+    ApplyGuardrailRequest.struct_class = Types::ApplyGuardrailRequest
+
+    ApplyGuardrailResponse.add_member(:usage, Shapes::ShapeRef.new(shape: GuardrailUsage, required: true, location_name: "usage"))
+    ApplyGuardrailResponse.add_member(:action, Shapes::ShapeRef.new(shape: GuardrailAction, required: true, location_name: "action"))
+    ApplyGuardrailResponse.add_member(:outputs, Shapes::ShapeRef.new(shape: GuardrailOutputContentList, required: true, location_name: "outputs"))
+    ApplyGuardrailResponse.add_member(:assessments, Shapes::ShapeRef.new(shape: GuardrailAssessmentList, required: true, location_name: "assessments"))
+    ApplyGuardrailResponse.struct_class = Types::ApplyGuardrailResponse
+
     AutoToolChoice.struct_class = Types::AutoToolChoice
 
     ContentBlock.add_member(:text, Shapes::ShapeRef.new(shape: String, location_name: "text"))
@@ -286,6 +325,7 @@ module Aws::BedrockRuntime
     GuardrailAssessment.add_member(:content_policy, Shapes::ShapeRef.new(shape: GuardrailContentPolicyAssessment, location_name: "contentPolicy"))
     GuardrailAssessment.add_member(:word_policy, Shapes::ShapeRef.new(shape: GuardrailWordPolicyAssessment, location_name: "wordPolicy"))
     GuardrailAssessment.add_member(:sensitive_information_policy, Shapes::ShapeRef.new(shape: GuardrailSensitiveInformationPolicyAssessment, location_name: "sensitiveInformationPolicy"))
+    GuardrailAssessment.add_member(:contextual_grounding_policy, Shapes::ShapeRef.new(shape: GuardrailContextualGroundingPolicyAssessment, location_name: "contextualGroundingPolicy"))
     GuardrailAssessment.struct_class = Types::GuardrailAssessment
 
     GuardrailAssessmentList.member = Shapes::ShapeRef.new(shape: GuardrailAssessment)
@@ -301,6 +341,14 @@ module Aws::BedrockRuntime
     GuardrailConfiguration.add_member(:trace, Shapes::ShapeRef.new(shape: GuardrailTrace, location_name: "trace"))
     GuardrailConfiguration.struct_class = Types::GuardrailConfiguration
 
+    GuardrailContentBlock.add_member(:text, Shapes::ShapeRef.new(shape: GuardrailTextBlock, location_name: "text"))
+    GuardrailContentBlock.add_member(:unknown, Shapes::ShapeRef.new(shape: nil, location_name: 'unknown'))
+    GuardrailContentBlock.add_member_subclass(:text, Types::GuardrailContentBlock::Text)
+    GuardrailContentBlock.add_member_subclass(:unknown, Types::GuardrailContentBlock::Unknown)
+    GuardrailContentBlock.struct_class = Types::GuardrailContentBlock
+
+    GuardrailContentBlockList.member = Shapes::ShapeRef.new(shape: GuardrailContentBlock)
+
     GuardrailContentFilter.add_member(:type, Shapes::ShapeRef.new(shape: GuardrailContentFilterType, required: true, location_name: "type"))
     GuardrailContentFilter.add_member(:confidence, Shapes::ShapeRef.new(shape: GuardrailContentFilterConfidence, required: true, location_name: "confidence"))
     GuardrailContentFilter.add_member(:action, Shapes::ShapeRef.new(shape: GuardrailContentPolicyAction, required: true, location_name: "action"))
@@ -311,13 +359,29 @@ module Aws::BedrockRuntime
     GuardrailContentPolicyAssessment.add_member(:filters, Shapes::ShapeRef.new(shape: GuardrailContentFilterList, required: true, location_name: "filters"))
     GuardrailContentPolicyAssessment.struct_class = Types::GuardrailContentPolicyAssessment
 
+    GuardrailContentQualifierList.member = Shapes::ShapeRef.new(shape: GuardrailContentQualifier)
+
+    GuardrailContextualGroundingFilter.add_member(:type, Shapes::ShapeRef.new(shape: GuardrailContextualGroundingFilterType, required: true, location_name: "type"))
+    GuardrailContextualGroundingFilter.add_member(:threshold, Shapes::ShapeRef.new(shape: GuardrailContextualGroundingFilterThresholdDouble, required: true, location_name: "threshold"))
+    GuardrailContextualGroundingFilter.add_member(:score, Shapes::ShapeRef.new(shape: GuardrailContextualGroundingFilterScoreDouble, required: true, location_name: "score"))
+    GuardrailContextualGroundingFilter.add_member(:action, Shapes::ShapeRef.new(shape: GuardrailContextualGroundingPolicyAction, required: true, location_name: "action"))
+    GuardrailContextualGroundingFilter.struct_class = Types::GuardrailContextualGroundingFilter
+
+    GuardrailContextualGroundingFilters.member = Shapes::ShapeRef.new(shape: GuardrailContextualGroundingFilter)
+
+    GuardrailContextualGroundingPolicyAssessment.add_member(:filters, Shapes::ShapeRef.new(shape: GuardrailContextualGroundingFilters, location_name: "filters"))
+    GuardrailContextualGroundingPolicyAssessment.struct_class = Types::GuardrailContextualGroundingPolicyAssessment
+
     GuardrailConverseContentBlock.add_member(:text, Shapes::ShapeRef.new(shape: GuardrailConverseTextBlock, location_name: "text"))
     GuardrailConverseContentBlock.add_member(:unknown, Shapes::ShapeRef.new(shape: nil, location_name: 'unknown'))
     GuardrailConverseContentBlock.add_member_subclass(:text, Types::GuardrailConverseContentBlock::Text)
     GuardrailConverseContentBlock.add_member_subclass(:unknown, Types::GuardrailConverseContentBlock::Unknown)
     GuardrailConverseContentBlock.struct_class = Types::GuardrailConverseContentBlock
 
+    GuardrailConverseContentQualifierList.member = Shapes::ShapeRef.new(shape: GuardrailConverseContentQualifier)
+
     GuardrailConverseTextBlock.add_member(:text, Shapes::ShapeRef.new(shape: String, required: true, location_name: "text"))
+    GuardrailConverseTextBlock.add_member(:qualifiers, Shapes::ShapeRef.new(shape: GuardrailConverseContentQualifierList, location_name: "qualifiers"))
     GuardrailConverseTextBlock.struct_class = Types::GuardrailConverseTextBlock
 
     GuardrailCustomWord.add_member(:match, Shapes::ShapeRef.new(shape: String, required: true, location_name: "match"))
@@ -333,6 +397,11 @@ module Aws::BedrockRuntime
 
     GuardrailManagedWordList.member = Shapes::ShapeRef.new(shape: GuardrailManagedWord)
 
+    GuardrailOutputContent.add_member(:text, Shapes::ShapeRef.new(shape: GuardrailOutputText, location_name: "text"))
+    GuardrailOutputContent.struct_class = Types::GuardrailOutputContent
+
+    GuardrailOutputContentList.member = Shapes::ShapeRef.new(shape: GuardrailOutputContent)
+
     GuardrailPiiEntityFilter.add_member(:match, Shapes::ShapeRef.new(shape: String, required: true, location_name: "match"))
     GuardrailPiiEntityFilter.add_member(:type, Shapes::ShapeRef.new(shape: GuardrailPiiEntityType, required: true, location_name: "type"))
     GuardrailPiiEntityFilter.add_member(:action, Shapes::ShapeRef.new(shape: GuardrailSensitiveInformationPolicyAction, required: true, location_name: "action"))
@@ -358,6 +427,10 @@ module Aws::BedrockRuntime
     GuardrailStreamConfiguration.add_member(:stream_processing_mode, Shapes::ShapeRef.new(shape: GuardrailStreamProcessingMode, location_name: "streamProcessingMode"))
     GuardrailStreamConfiguration.struct_class = Types::GuardrailStreamConfiguration
 
+    GuardrailTextBlock.add_member(:text, Shapes::ShapeRef.new(shape: String, required: true, location_name: "text"))
+    GuardrailTextBlock.add_member(:qualifiers, Shapes::ShapeRef.new(shape: GuardrailContentQualifierList, location_name: "qualifiers"))
+    GuardrailTextBlock.struct_class = Types::GuardrailTextBlock
+
     GuardrailTopic.add_member(:name, Shapes::ShapeRef.new(shape: String, required: true, location_name: "name"))
     GuardrailTopic.add_member(:type, Shapes::ShapeRef.new(shape: GuardrailTopicType, required: true, location_name: "type"))
     GuardrailTopic.add_member(:action, Shapes::ShapeRef.new(shape: GuardrailTopicPolicyAction, required: true, location_name: "action"))
@@ -373,6 +446,14 @@ module Aws::BedrockRuntime
     GuardrailTraceAssessment.add_member(:output_assessments, Shapes::ShapeRef.new(shape: GuardrailAssessmentListMap, location_name: "outputAssessments"))
     GuardrailTraceAssessment.struct_class = Types::GuardrailTraceAssessment
 
+    GuardrailUsage.add_member(:topic_policy_units, Shapes::ShapeRef.new(shape: GuardrailTopicPolicyUnitsProcessed, required: true, location_name: "topicPolicyUnits"))
+    GuardrailUsage.add_member(:content_policy_units, Shapes::ShapeRef.new(shape: GuardrailContentPolicyUnitsProcessed, required: true, location_name: "contentPolicyUnits"))
+    GuardrailUsage.add_member(:word_policy_units, Shapes::ShapeRef.new(shape: GuardrailWordPolicyUnitsProcessed, required: true, location_name: "wordPolicyUnits"))
+    GuardrailUsage.add_member(:sensitive_information_policy_units, Shapes::ShapeRef.new(shape: GuardrailSensitiveInformationPolicyUnitsProcessed, required: true, location_name: "sensitiveInformationPolicyUnits"))
+    GuardrailUsage.add_member(:sensitive_information_policy_free_units, Shapes::ShapeRef.new(shape: GuardrailSensitiveInformationPolicyFreeUnitsProcessed, required: true, location_name: "sensitiveInformationPolicyFreeUnits"))
+    GuardrailUsage.add_member(:contextual_grounding_policy_units, Shapes::ShapeRef.new(shape: GuardrailContextualGroundingPolicyUnitsProcessed, required: true, location_name: "contextualGroundingPolicyUnits"))
+    GuardrailUsage.struct_class = Types::GuardrailUsage
+
     GuardrailWordPolicyAssessment.add_member(:custom_words, Shapes::ShapeRef.new(shape: GuardrailCustomWordList, required: true, location_name: "customWords"))
     GuardrailWordPolicyAssessment.add_member(:managed_word_lists, Shapes::ShapeRef.new(shape: GuardrailManagedWordList, required: true, location_name: "managedWordLists"))
     GuardrailWordPolicyAssessment.struct_class = Types::GuardrailWordPolicyAssessment
@@ -586,6 +667,20 @@ module Aws::BedrockRuntime
         "uid" => "bedrock-runtime-2023-09-30",
       }
 
+      api.add_operation(:apply_guardrail, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "ApplyGuardrail"
+        o.http_method = "POST"
+        o.http_request_uri = "/guardrail/{guardrailIdentifier}/version/{guardrailVersion}/apply"
+        o.input = Shapes::ShapeRef.new(shape: ApplyGuardrailRequest)
+        o.output = Shapes::ShapeRef.new(shape: ApplyGuardrailResponse)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+        o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+        o.errors << Shapes::ShapeRef.new(shape: ServiceQuotaExceededException)
+      end)
+
       api.add_operation(:converse, Seahorse::Model::Operation.new.tap do |o|
         o.name = "Converse"
         o.http_method = "POST"

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

@@ -12,6 +12,20 @@ module Aws::BedrockRuntime
   # @api private
   module Endpoints
 
+    class ApplyGuardrail
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::BedrockRuntime::EndpointParameters.new(
+          region: context.config.region,
+          use_dual_stack: context.config.use_dualstack_endpoint,
+          use_fips: context.config.use_fips_endpoint,
+          endpoint: endpoint,
+        )
+      end
+    end
+
     class Converse
       def self.build(context)
         unless context.config.regional_endpoint

data/lib/aws-sdk-bedrockruntime/plugins/endpoints.rb

@@ -58,6 +58,8 @@ module Aws::BedrockRuntime
 
         def parameters_for_operation(context)
           case context.operation_name
+          when :apply_guardrail
+            Aws::BedrockRuntime::Endpoints::ApplyGuardrail.build(context)
           when :converse
             Aws::BedrockRuntime::Endpoints::Converse.build(context)
           when :converse_stream

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

@@ -32,6 +32,60 @@ module Aws::BedrockRuntime
     #
     class AnyToolChoice < Aws::EmptyStructure; end
 
+    # @!attribute [rw] guardrail_identifier
+    #   The guardrail identifier used in the request to apply the guardrail.
+    #   @return [String]
+    #
+    # @!attribute [rw] guardrail_version
+    #   The guardrail version used in the request to apply the guardrail.
+    #   @return [String]
+    #
+    # @!attribute [rw] source
+    #   The source of data used in the request to apply the guardrail.
+    #   @return [String]
+    #
+    # @!attribute [rw] content
+    #   The content details used in the request to apply the guardrail.
+    #   @return [Array<Types::GuardrailContentBlock>]
+    #
+    # @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)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] usage
+    #   The usage details in the response from the guardrail.
+    #   @return [Types::GuardrailUsage]
+    #
+    # @!attribute [rw] action
+    #   The action taken in the response from the guardrail.
+    #   @return [String]
+    #
+    # @!attribute [rw] outputs
+    #   The output details in the response from the guardrail.
+    #   @return [Array<Types::GuardrailOutputContent>]
+    #
+    # @!attribute [rw] assessments
+    #   The assessment details in the response from the guardrail.
+    #   @return [Array<Types::GuardrailAssessment>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/ApplyGuardrailResponse AWS API Documentation
+    #
+    class ApplyGuardrailResponse < Struct.new(
+      :usage,
+      :action,
+      :outputs,
+      :assessments)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # The Model automatically decides if a tool should be called or whether
     # to generate text instead. For example, `\{"auto" : \{\}\}`.
     #
@@ -42,7 +96,12 @@ module Aws::BedrockRuntime
     class AutoToolChoice < Aws::EmptyStructure; end
 
     # A block of content for a message that you pass to, or receive from, a
-    # model with the Converse API (Converse and ConverseStream).
+    # model with the [Converse][1] or [ConverseStream][2] API operations.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html
+    # [2]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_ConverseStream.html
     #
     # @note ContentBlock is a union - when making an API calls you must set exactly one of the members.
     #
@@ -403,8 +462,12 @@ module Aws::BedrockRuntime
     #   @return [Types::ConverseStreamMetrics]
     #
     # @!attribute [rw] trace
-    #   The trace object in the response from ConverseStream that contains
-    #   information about the guardrail behavior.
+    #   The trace object in the response from [ConverseStream][1] that
+    #   contains information about the guardrail behavior.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_ConverseStream.html
     #   @return [Types::ConverseStreamTrace]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/ConverseStreamMetadataEvent AWS API Documentation
@@ -540,8 +603,12 @@ module Aws::BedrockRuntime
       include Aws::Structure
     end
 
-    # The trace object in a response from ConverseStream. Currently, you can
-    # only trace guardrails.
+    # The trace object in a response from [ConverseStream][1]. Currently,
+    # you can only trace guardrails.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_ConverseStream.html
     #
     # @!attribute [rw] guardrail
     #   The guardrail trace object.
@@ -555,8 +622,12 @@ module Aws::BedrockRuntime
       include Aws::Structure
     end
 
-    # The trace object in a response from Converse. Currently, you can only
-    # trace guardrails.
+    # The trace object in a response from [Converse][1]. Currently, you can
+    # only trace guardrails.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html
     #
     # @!attribute [rw] guardrail
     #   The guardrail trace object.
@@ -570,21 +641,31 @@ module Aws::BedrockRuntime
       include Aws::Structure
     end
 
-    # A document to include in a message when sending a [Converse][1] or
-    # [ConverseStream][2] request. You can include up to 5 documents in a
-    # request. The maximum document size is 50 MB.
-    #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html
-    # [2]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_ConverseStream.html
+    # A document to include in a message.
     #
     # @!attribute [rw] format
     #   The format of a document, or its extension.
     #   @return [String]
     #
     # @!attribute [rw] name
-    #   A name for the document.
+    #   A name for the document. The name can only contain the following
+    #   characters:
+    #
+    #   * Alphanumeric characters
+    #
+    #   * Whitespace characters (no more than one in a row)
+    #
+    #   * Hyphens
+    #
+    #   * Parentheses
+    #
+    #   * Square brackets
+    #
+    #   <note markdown="1"> This field is vulnerable to prompt injections, because the model
+    #   might inadvertently interpret it as instructions. Therefore, we
+    #   recommend that you specify a neutral name.
+    #
+    #    </note>
     #   @return [String]
     #
     # @!attribute [rw] source
@@ -601,22 +682,15 @@ module Aws::BedrockRuntime
       include Aws::Structure
     end
 
-    # Contains the content of the document included in a message when
-    # sending a [Converse][1] or [ConverseStream][2] request or in the
-    # response.
-    #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html
-    # [2]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_ConverseStream.html
+    # Contains the content of a document.
     #
     # @note DocumentSource is a union - when making an API calls you must set exactly one of the members.
     #
     # @note DocumentSource is a union - when returned from an API call exactly one value will be set and the returned type will be a subclass of DocumentSource corresponding to the set member.
     #
     # @!attribute [rw] bytes
-    #   A base64-encoded string of a UTF-8 encoded file, that is the
-    #   document to include in the message.
+    #   The raw bytes for the document. If you use an Amazon Web Services
+    #   SDK, you don't need to encode the bytes in base64.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/DocumentSource AWS API Documentation
@@ -651,19 +725,28 @@ module Aws::BedrockRuntime
     #   The sensitive information policy.
     #   @return [Types::GuardrailSensitiveInformationPolicyAssessment]
     #
+    # @!attribute [rw] contextual_grounding_policy
+    #   The contextual grounding policy used for the guardrail assessment.
+    #   @return [Types::GuardrailContextualGroundingPolicyAssessment]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/GuardrailAssessment AWS API Documentation
     #
     class GuardrailAssessment < Struct.new(
       :topic_policy,
       :content_policy,
       :word_policy,
-      :sensitive_information_policy)
+      :sensitive_information_policy,
+      :contextual_grounding_policy)
       SENSITIVE = []
       include Aws::Structure
     end
 
     # Configuration information for a guardrail that you use with the
-    # Converse action.
+    # [Converse][1] operation.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html
     #
     # @!attribute [rw] guardrail_identifier
     #   The identifier for the guardrail.
@@ -687,6 +770,27 @@ module Aws::BedrockRuntime
       include Aws::Structure
     end
 
+    # The content block to be evaluated by the guardrail.
+    #
+    # @note GuardrailContentBlock is a union - when making an API calls you must set exactly one of the members.
+    #
+    # @!attribute [rw] text
+    #   Text within content block to be evaluated by the guardrail.
+    #   @return [Types::GuardrailTextBlock]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/GuardrailContentBlock AWS API Documentation
+    #
+    class GuardrailContentBlock < Struct.new(
+      :text,
+      :unknown)
+      SENSITIVE = []
+      include Aws::Structure
+      include Aws::Structure::Union
+
+      class Text < GuardrailContentBlock; end
+      class Unknown < GuardrailContentBlock; end
+    end
+
     # The content filter for a guardrail.
     #
     # @!attribute [rw] type
@@ -725,8 +829,58 @@ module Aws::BedrockRuntime
       include Aws::Structure
     end
 
-    # A content block for selective guarding with the Converse API (Converse
-    # and ConverseStream).
+    # The details for the guardrails contextual grounding filter.
+    #
+    # @!attribute [rw] type
+    #   The contextual grounding filter type.
+    #   @return [String]
+    #
+    # @!attribute [rw] threshold
+    #   The threshold used by contextual grounding filter to determine
+    #   whether the content is grounded or not.
+    #   @return [Float]
+    #
+    # @!attribute [rw] score
+    #   The score generated by contextual grounding filter.
+    #   @return [Float]
+    #
+    # @!attribute [rw] action
+    #   The action performed by the guardrails contextual grounding filter.
+    #   @return [String]
+    #
+    # @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)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # The policy assessment details for the guardrails contextual grounding
+    # filter.
+    #
+    # @!attribute [rw] filters
+    #   The filter details for the guardrails contextual grounding filter.
+    #   @return [Array<Types::GuardrailContextualGroundingFilter>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/GuardrailContextualGroundingPolicyAssessment AWS API Documentation
+    #
+    class GuardrailContextualGroundingPolicyAssessment < Struct.new(
+      :filters)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # A content block for selective guarding with the [Converse][1] or
+    # [ConverseStream][2] API operations.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html
+    # [2]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_ConverseStream.html
     #
     # @note GuardrailConverseContentBlock is a union - when making an API calls you must set exactly one of the members.
     #
@@ -756,10 +910,16 @@ module Aws::BedrockRuntime
     #   The text that you want to guard.
     #   @return [String]
     #
+    # @!attribute [rw] qualifiers
+    #   The qualifier details for the guardrails contextual grounding
+    #   filter.
+    #   @return [Array<String>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/GuardrailConverseTextBlock AWS API Documentation
     #
     class GuardrailConverseTextBlock < Struct.new(
-      :text)
+      :text,
+      :qualifiers)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -807,6 +967,20 @@ module Aws::BedrockRuntime
       include Aws::Structure
     end
 
+    # The output content produced by the guardrail.
+    #
+    # @!attribute [rw] text
+    #   The specific text for the output content produced by the guardrail.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/GuardrailOutputContent AWS API Documentation
+    #
+    class GuardrailOutputContent < Struct.new(
+      :text)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # A Personally Identifiable Information (PII) entity configured in a
     # guardrail.
     #
@@ -913,6 +1087,25 @@ module Aws::BedrockRuntime
       include Aws::Structure
     end
 
+    # The text block to be evaluated by the guardrail.
+    #
+    # @!attribute [rw] text
+    #   The input text details to be evaluated by the guardrail.
+    #   @return [String]
+    #
+    # @!attribute [rw] qualifiers
+    #   The qualifiers describing the text block.
+    #   @return [Array<String>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/GuardrailTextBlock AWS API Documentation
+    #
+    class GuardrailTextBlock < Struct.new(
+      :text,
+      :qualifiers)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Information about a topic guardrail.
     #
     # @!attribute [rw] name
@@ -977,6 +1170,46 @@ module Aws::BedrockRuntime
       include Aws::Structure
     end
 
+    # The details on the use of the guardrail.
+    #
+    # @!attribute [rw] topic_policy_units
+    #   The topic policy units processed by the guardrail.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] content_policy_units
+    #   The content policy units processed by the guardrail.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] word_policy_units
+    #   The word policy units processed by the guardrail.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] sensitive_information_policy_units
+    #   The sensitive information policy units processed by the guardrail.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] sensitive_information_policy_free_units
+    #   The sensitive information policy free units processed by the
+    #   guardrail.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] contextual_grounding_policy_units
+    #   The contextual grounding policy units processed by the guardrail.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/GuardrailUsage AWS API Documentation
+    #
+    class GuardrailUsage < Struct.new(
+      :topic_policy_units,
+      :content_policy_units,
+      :word_policy_units,
+      :sensitive_information_policy_units,
+      :sensitive_information_policy_free_units,
+      :contextual_grounding_policy_units)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # The word policy assessment.
     #
     # @!attribute [rw] custom_words
@@ -1023,7 +1256,7 @@ module Aws::BedrockRuntime
     #
     # @!attribute [rw] bytes
     #   The raw image bytes for the image. If you use an AWS SDK, you don't
-    #   need to base64 encode the image bytes.
+    #   need to encode the image bytes in base64.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/ImageSource AWS API Documentation
@@ -1359,7 +1592,19 @@ module Aws::BedrockRuntime
     #   @return [String]
     #
     # @!attribute [rw] content
-    #   The message content.
+    #   The message content. Note the following restrictions:
+    #
+    #   * You can include up to 20 images. Each image's size, height, and
+    #     width must be no more than 3.75 MB, 8000 px, and 8000 px,
+    #     respectively.
+    #
+    #   * You can include up to five documents. Each document's size must
+    #     be no more than 4.5 MB.
+    #
+    #   * If you include a `ContentBlock` with a `document` field in the
+    #     array, you must also include a `ContentBlock` with a `text` field.
+    #
+    #   * You can only include images and documents if the `role` is `user`.
     #   @return [Array<Types::ContentBlock>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/Message AWS API Documentation
@@ -1553,11 +1798,16 @@ module Aws::BedrockRuntime
     #   @return [String]
     #
     # @!attribute [rw] guard_content
-    #   A content block to assess with the guardrail. Use with the Converse
-    #   API (Converse and ConverseStream).
+    #   A content block to assess with the guardrail. Use with the
+    #   [Converse][1] or [ConverseStream][2] API operations.
     #
     #   For more information, see *Use a guardrail with the Converse API* in
     #   the *Amazon Bedrock User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html
+    #   [2]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_ConverseStream.html
     #   @return [Types::GuardrailConverseContentBlock]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/SystemContentBlock AWS API Documentation
@@ -1613,7 +1863,13 @@ module Aws::BedrockRuntime
       include Aws::Structure
     end
 
-    # Information about a tool that you can use with the Converse API.
+    # Information about a tool that you can use with the Converse API. For
+    # more information, see [Tool use (function calling)][1] in the Amazon
+    # Bedrock User Guide.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/tool-use.html
     #
     # @note Tool is a union - when making an API calls you must set exactly one of the members.
     #
@@ -1671,13 +1927,19 @@ module Aws::BedrockRuntime
       class Unknown < ToolChoice; end
     end
 
-    # Configuration information for the tools that you pass to a model.
+    # Configuration information for the tools that you pass to a model. For
+    # more information, see [Tool use (function calling)][1] in the Amazon
+    # Bedrock User Guide.
     #
     # <note markdown="1"> This field is only supported by Anthropic Claude 3, Cohere Command R,
     # Cohere Command R+, and Mistral Large models.
     #
     #  </note>
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/tool-use.html
+    #
     # @!attribute [rw] tools
     #   An array of tools that you want to pass to a model.
     #   @return [Array<Types::Tool>]

data/lib/aws-sdk-bedrockruntime.rb

@@ -34,7 +34,7 @@ require_relative 'aws-sdk-bedrockruntime/event_streams'
 # structure.
 #
 #     bedrock_runtime = Aws::BedrockRuntime::Client.new
-#     resp = bedrock_runtime.converse(params)
+#     resp = bedrock_runtime.apply_guardrail(params)
 #
 # See {Client} for more information.
 #
@@ -54,6 +54,6 @@ require_relative 'aws-sdk-bedrockruntime/event_streams'
 # @!group service
 module Aws::BedrockRuntime
 
-  GEM_VERSION = '1.15.0'
+  GEM_VERSION = '1.16.0'
 
 end

data/sig/client.rbs

@@ -76,6 +76,29 @@ module Aws
                   | (?Hash[Symbol, untyped]) -> instance
 
 
+      interface _ApplyGuardrailResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::ApplyGuardrailResponse]
+        def usage: () -> Types::GuardrailUsage
+        def action: () -> ("NONE" | "GUARDRAIL_INTERVENED")
+        def outputs: () -> ::Array[Types::GuardrailOutputContent]
+        def assessments: () -> ::Array[Types::GuardrailAssessment]
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/BedrockRuntime/Client.html#apply_guardrail-instance_method
+      def apply_guardrail: (
+                             guardrail_identifier: ::String,
+                             guardrail_version: ::String,
+                             source: ("INPUT" | "OUTPUT"),
+                             content: Array[
+                               {
+                                 text: {
+                                   text: ::String,
+                                   qualifiers: Array[("grounding_source" | "query" | "guard_content")]?
+                                 }?
+                               },
+                             ]
+                           ) -> _ApplyGuardrailResponseSuccess
+                         | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _ApplyGuardrailResponseSuccess
+
       interface _ConverseResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::ConverseResponse]
         def output: () -> Types::ConverseOutput
@@ -139,7 +162,8 @@ module Aws
                               }?,
                               guard_content: {
                                 text: {
-                                  text: ::String
+                                  text: ::String,
+                                  qualifiers: Array[("grounding_source" | "query" | "guard_content")]?
                                 }?
                               }?
                             },
@@ -151,7 +175,8 @@ module Aws
                           text: ::String?,
                           guard_content: {
                             text: {
-                              text: ::String
+                              text: ::String,
+                              qualifiers: Array[("grounding_source" | "query" | "guard_content")]?
                             }?
                           }?
                         },
@@ -254,7 +279,8 @@ module Aws
                                      }?,
                                      guard_content: {
                                        text: {
-                                         text: ::String
+                                         text: ::String,
+                                         qualifiers: Array[("grounding_source" | "query" | "guard_content")]?
                                        }?
                                      }?
                                    },
@@ -266,7 +292,8 @@ module Aws
                                  text: ::String?,
                                  guard_content: {
                                    text: {
-                                     text: ::String
+                                     text: ::String,
+                                     qualifiers: Array[("grounding_source" | "query" | "guard_content")]?
                                    }?
                                  }?
                                },

data/sig/types.rbs

@@ -16,6 +16,22 @@ module Aws::BedrockRuntime
     class AnyToolChoice < Aws::EmptyStructure
     end
 
+    class ApplyGuardrailRequest
+      attr_accessor guardrail_identifier: ::String
+      attr_accessor guardrail_version: ::String
+      attr_accessor source: ("INPUT" | "OUTPUT")
+      attr_accessor content: ::Array[Types::GuardrailContentBlock]
+      SENSITIVE: []
+    end
+
+    class ApplyGuardrailResponse
+      attr_accessor usage: Types::GuardrailUsage
+      attr_accessor action: ("NONE" | "GUARDRAIL_INTERVENED")
+      attr_accessor outputs: ::Array[Types::GuardrailOutputContent]
+      attr_accessor assessments: ::Array[Types::GuardrailAssessment]
+      SENSITIVE: []
+    end
+
     class AutoToolChoice < Aws::EmptyStructure
     end
 
@@ -191,6 +207,7 @@ module Aws::BedrockRuntime
       attr_accessor content_policy: Types::GuardrailContentPolicyAssessment
       attr_accessor word_policy: Types::GuardrailWordPolicyAssessment
       attr_accessor sensitive_information_policy: Types::GuardrailSensitiveInformationPolicyAssessment
+      attr_accessor contextual_grounding_policy: Types::GuardrailContextualGroundingPolicyAssessment
       SENSITIVE: []
     end
 
@@ -201,6 +218,17 @@ module Aws::BedrockRuntime
       SENSITIVE: []
     end
 
+    class GuardrailContentBlock
+      attr_accessor text: Types::GuardrailTextBlock
+      attr_accessor unknown: untyped
+      SENSITIVE: []
+
+      class Text < GuardrailContentBlock
+      end
+      class Unknown < GuardrailContentBlock
+      end
+    end
+
     class GuardrailContentFilter
       attr_accessor type: ("INSULTS" | "HATE" | "SEXUAL" | "VIOLENCE" | "MISCONDUCT" | "PROMPT_ATTACK")
       attr_accessor confidence: ("NONE" | "LOW" | "MEDIUM" | "HIGH")
@@ -213,6 +241,19 @@ module Aws::BedrockRuntime
       SENSITIVE: []
     end
 
+    class GuardrailContextualGroundingFilter
+      attr_accessor type: ("GROUNDING" | "RELEVANCE")
+      attr_accessor threshold: ::Float
+      attr_accessor score: ::Float
+      attr_accessor action: ("BLOCKED" | "NONE")
+      SENSITIVE: []
+    end
+
+    class GuardrailContextualGroundingPolicyAssessment
+      attr_accessor filters: ::Array[Types::GuardrailContextualGroundingFilter]
+      SENSITIVE: []
+    end
+
     class GuardrailConverseContentBlock
       attr_accessor text: Types::GuardrailConverseTextBlock
       attr_accessor unknown: untyped
@@ -226,6 +267,7 @@ module Aws::BedrockRuntime
 
     class GuardrailConverseTextBlock
       attr_accessor text: ::String
+      attr_accessor qualifiers: ::Array[("grounding_source" | "query" | "guard_content")]
       SENSITIVE: []
     end
 
@@ -242,6 +284,11 @@ module Aws::BedrockRuntime
       SENSITIVE: []
     end
 
+    class GuardrailOutputContent
+      attr_accessor text: ::String
+      SENSITIVE: []
+    end
+
     class GuardrailPiiEntityFilter
       attr_accessor match: ::String
       attr_accessor type: ("ADDRESS" | "AGE" | "AWS_ACCESS_KEY" | "AWS_SECRET_KEY" | "CA_HEALTH_NUMBER" | "CA_SOCIAL_INSURANCE_NUMBER" | "CREDIT_DEBIT_CARD_CVV" | "CREDIT_DEBIT_CARD_EXPIRY" | "CREDIT_DEBIT_CARD_NUMBER" | "DRIVER_ID" | "EMAIL" | "INTERNATIONAL_BANK_ACCOUNT_NUMBER" | "IP_ADDRESS" | "LICENSE_PLATE" | "MAC_ADDRESS" | "NAME" | "PASSWORD" | "PHONE" | "PIN" | "SWIFT_CODE" | "UK_NATIONAL_HEALTH_SERVICE_NUMBER" | "UK_NATIONAL_INSURANCE_NUMBER" | "UK_UNIQUE_TAXPAYER_REFERENCE_NUMBER" | "URL" | "USERNAME" | "US_BANK_ACCOUNT_NUMBER" | "US_BANK_ROUTING_NUMBER" | "US_INDIVIDUAL_TAX_IDENTIFICATION_NUMBER" | "US_PASSPORT_NUMBER" | "US_SOCIAL_SECURITY_NUMBER" | "VEHICLE_IDENTIFICATION_NUMBER")
@@ -271,6 +318,12 @@ module Aws::BedrockRuntime
       SENSITIVE: []
     end
 
+    class GuardrailTextBlock
+      attr_accessor text: ::String
+      attr_accessor qualifiers: ::Array[("grounding_source" | "query" | "guard_content")]
+      SENSITIVE: []
+    end
+
     class GuardrailTopic
       attr_accessor name: ::String
       attr_accessor type: ("DENY")
@@ -290,6 +343,16 @@ module Aws::BedrockRuntime
       SENSITIVE: []
     end
 
+    class GuardrailUsage
+      attr_accessor topic_policy_units: ::Integer
+      attr_accessor content_policy_units: ::Integer
+      attr_accessor word_policy_units: ::Integer
+      attr_accessor sensitive_information_policy_units: ::Integer
+      attr_accessor sensitive_information_policy_free_units: ::Integer
+      attr_accessor contextual_grounding_policy_units: ::Integer
+      SENSITIVE: []
+    end
+
     class GuardrailWordPolicyAssessment
       attr_accessor custom_words: ::Array[Types::GuardrailCustomWord]
       attr_accessor managed_word_lists: ::Array[Types::GuardrailManagedWord]

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-bedrockruntime
 version: !ruby/object:Gem::Version
-  version: 1.15.0
+  version: 1.16.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-07-02 00:00:00.000000000 Z
+date: 2024-07-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core