aws-sdk-bedrock 1.10.0 → 1.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '09e3b0e80fa2bfa28880abd4d1edfd07adaab36e0256c9bebf322969d1c3ca96'
-  data.tar.gz: 29fa80bc29d5ae97753794fa69708212eea61daff861dbff2a5888b467592445
+  metadata.gz: 0c419dba0e93f29b828cf5a2ccaf91cb0ffc8834e7784d929b3d37174243a6da
+  data.tar.gz: 97f129f441a7ed2fc97054e43dcc59cd5a49fb30422ded176da9c29e2505f745
 SHA512:
-  metadata.gz: a75a0286dc24e70ce02740008e23a36a34361143aefa9b9ecb615274d4b1ff626cffd188fb516851ff0d6fdbe6232129250ae3661d78780fc78b4ff053211181
-  data.tar.gz: 9c99b239bc4ec4c6a7ac3a3e0af13416d63c32d5e7f28496c218781cbcb5c8c62adaa3364c45b87a199e65241f79df4767a86bf46165e4276d9628c2dd1d9ceb
+  metadata.gz: 0dec358aaac92ca0912d7fece0e17d1d25f3e2c3a034235985e4c9295d9a5857f8dd8f2818665468a8b4ab862e81a8e25695944da29ad4204b796104a5c2f778
+  data.tar.gz: 838ba873012a002568f72982c9314f52e781e6eee9d52a2a3204ef5281d32202647794977906934392e51c6f993b5783bbef0b9a01d8939bf8336f975d8673ad

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.12.0 (2024-07-10)
+------------------
+
+* Feature - Add support for contextual grounding check for Guardrails for Amazon Bedrock.
+
+1.11.0 (2024-07-02)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
 1.10.0 (2024-06-25)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.10.0
+1.12.0

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

@@ -312,6 +312,15 @@ module Aws::Bedrock
     #
     #   @option options [String] :session_token
     #
+    #   @option options [Array] :sigv4a_signing_region_set
+    #     A list of regions that should be signed with SigV4a signing. When
+    #     not passed, a default `:sigv4a_signing_region_set` is searched for
+    #     in the following locations:
+    #
+    #     * `Aws.config[:sigv4a_signing_region_set]`
+    #     * `ENV['AWS_SIGV4A_SIGNING_REGION_SET']`
+    #     * `~/.aws/config`
+    #
     #   @option options [Boolean] :stub_responses (false)
     #     Causes the client to return stubbed responses. By default
     #     fake responses are generated and returned. You can specify
@@ -565,51 +574,38 @@ module Aws::Bedrock
       req.send_request(options)
     end
 
-    # Creates a guardrail to block topics and to filter out harmful content.
+    # Creates a guardrail to block topics and to implement safeguards for
+    # your generative AI applications.
     #
-    # * Specify a `name` and optional `description`.
-    #
-    # * Specify messages for when the guardrail successfully blocks a prompt
-    #   or a model response in the `blockedInputMessaging` and
-    #   `blockedOutputsMessaging` fields.
+    # You can configure the following policies in a guardrail to avoid
+    # undesirable and harmful content, filter out denied topics and words,
+    # and remove sensitive information for privacy protection.
     #
-    # * Specify topics for the guardrail to deny in the `topicPolicyConfig`
-    #   object. Each [GuardrailTopicConfig][1] object in the `topicsConfig`
-    #   list pertains to one topic.
+    # * **Content filters** - Adjust filter strengths to block input prompts
+    #   or model responses containing harmful content.
     #
-    #   * Give a `name` and `description` so that the guardrail can properly
-    #     identify the topic.
-    #
-    #   * Specify `DENY` in the `type` field.
-    #
-    #   * (Optional) Provide up to five prompts that you would categorize as
-    #     belonging to the topic in the `examples` list.
-    #
-    # * Specify filter strengths for the harmful categories defined in
-    #   Amazon Bedrock in the `contentPolicyConfig` object. Each
-    #   [GuardrailContentFilterConfig][2] object in the `filtersConfig` list
-    #   pertains to a harmful category. For more information, see [Content
-    #   filters][3]. For more information about the fields in a content
-    #   filter, see [GuardrailContentFilterConfig][2].
+    # * **Denied topics** - Define a set of topics that are undesirable in
+    #   the context of your application. These topics will be blocked if
+    #   detected in user queries or model responses.
     #
-    #   * Specify the category in the `type` field.
+    # * **Word filters** - Configure filters to block undesirable words,
+    #   phrases, and profanity. Such words can include offensive terms,
+    #   competitor names etc.
     #
-    #   * Specify the strength of the filter for prompts in the
-    #     `inputStrength` field and for model responses in the `strength`
-    #     field of the [GuardrailContentFilterConfig][2].
+    # * **Sensitive information filters** - Block or mask sensitive
+    #   information such as personally identifiable information (PII) or
+    #   custom regex in user inputs and model responses.
     #
-    # * (Optional) For security, include the ARN of a KMS key in the
-    #   `kmsKeyId` field.
+    # In addition to the above policies, you can also configure the messages
+    # to be returned to the user if a user input or model response is in
+    # violation of the policies defined in the guardrail.
     #
-    # * (Optional) Attach any tags to the guardrail in the `tags` object.
-    #   For more information, see [Tag resources][4].
+    # For more information, see [Guardrails for Amazon Bedrock][1] in the
+    # *Amazon Bedrock User Guide*.
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_GuardrailTopicConfig.html
-    # [2]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_GuardrailContentFilterConfig.html
-    # [3]: https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails-filters
-    # [4]: https://docs.aws.amazon.com/bedrock/latest/userguide/tagging
+    # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails.html
     #
     # @option params [required, String] :name
     #   The name to give the guardrail.
@@ -629,6 +625,10 @@ module Aws::Bedrock
     # @option params [Types::GuardrailSensitiveInformationPolicyConfig] :sensitive_information_policy_config
     #   The sensitive information policy to configure for the guardrail.
     #
+    # @option params [Types::GuardrailContextualGroundingPolicyConfig] :contextual_grounding_policy_config
+    #   The contextual grounding policy configuration used to create a
+    #   guardrail.
+    #
     # @option params [required, String] :blocked_input_messaging
     #   The message to return when the guardrail blocks a prompt.
     #
@@ -714,6 +714,14 @@ module Aws::Bedrock
     #         },
     #       ],
     #     },
+    #     contextual_grounding_policy_config: {
+    #       filters_config: [ # required
+    #         {
+    #           type: "GROUNDING", # required, accepts GROUNDING, RELEVANCE
+    #           threshold: 1.0, # required
+    #         },
+    #       ],
+    #     },
     #     blocked_input_messaging: "GuardrailBlockedMessaging", # required
     #     blocked_outputs_messaging: "GuardrailBlockedMessaging", # required
     #     kms_key_id: "KmsKeyId",
@@ -747,7 +755,7 @@ module Aws::Bedrock
     # compare the configuration with another version.
     #
     # @option params [required, String] :guardrail_identifier
-    #   The unique identifier of the guardrail.
+    #   The unique identifier of the guardrail. This can be an ID or the ARN.
     #
     # @option params [String] :description
     #   A description of the guardrail version.
@@ -1087,7 +1095,7 @@ module Aws::Bedrock
     #   `guardrailVersion` field.
     #
     # @option params [required, String] :guardrail_identifier
-    #   The unique identifier of the guardrail.
+    #   The unique identifier of the guardrail. This can be an ID or the ARN.
     #
     # @option params [String] :guardrail_version
     #   The version of the guardrail.
@@ -1337,7 +1345,8 @@ module Aws::Bedrock
     # response returns details for the `DRAFT` version.
     #
     # @option params [required, String] :guardrail_identifier
-    #   The unique identifier of the guardrail for which to get details.
+    #   The unique identifier of the guardrail for which to get details. This
+    #   can be an ID or the ARN.
     #
     # @option params [String] :guardrail_version
     #   The version of the guardrail for which to get details. If you don't
@@ -1356,6 +1365,7 @@ module Aws::Bedrock
     #   * {Types::GetGuardrailResponse#content_policy #content_policy} => Types::GuardrailContentPolicy
     #   * {Types::GetGuardrailResponse#word_policy #word_policy} => Types::GuardrailWordPolicy
     #   * {Types::GetGuardrailResponse#sensitive_information_policy #sensitive_information_policy} => Types::GuardrailSensitiveInformationPolicy
+    #   * {Types::GetGuardrailResponse#contextual_grounding_policy #contextual_grounding_policy} => Types::GuardrailContextualGroundingPolicy
     #   * {Types::GetGuardrailResponse#created_at #created_at} => Time
     #   * {Types::GetGuardrailResponse#updated_at #updated_at} => Time
     #   * {Types::GetGuardrailResponse#status_reasons #status_reasons} => Array<String>
@@ -1401,6 +1411,9 @@ module Aws::Bedrock
     #   resp.sensitive_information_policy.regexes[0].description #=> String
     #   resp.sensitive_information_policy.regexes[0].pattern #=> String
     #   resp.sensitive_information_policy.regexes[0].action #=> String, one of "BLOCK", "ANONYMIZE"
+    #   resp.contextual_grounding_policy.filters #=> Array
+    #   resp.contextual_grounding_policy.filters[0].type #=> String, one of "GROUNDING", "RELEVANCE"
+    #   resp.contextual_grounding_policy.filters[0].threshold #=> Float
     #   resp.created_at #=> Time
     #   resp.updated_at #=> Time
     #   resp.status_reasons #=> Array
@@ -1820,7 +1833,7 @@ module Aws::Bedrock
     # `ListGuardrails` request to see the next batch of results.
     #
     # @option params [String] :guardrail_identifier
-    #   The unique identifier of the guardrail.
+    #   The unique identifier of the guardrail. This can be an ID or the ARN.
     #
     # @option params [Integer] :max_results
     #   The maximum number of results to return in the response.
@@ -2268,18 +2281,14 @@ module Aws::Bedrock
     # * (Optional) For security, include the ARN of a KMS key in the
     #   `kmsKeyId` field.
     #
-    # * (Optional) Attach any tags to the guardrail in the `tags` object.
-    #   For more information, see [Tag resources][4].
-    #
     #
     #
     # [1]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_GuardrailTopicConfig.html
     # [2]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_GuardrailContentFilterConfig.html
-    # [3]: https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails-filters
-    # [4]: https://docs.aws.amazon.com/bedrock/latest/userguide/tagging
+    # [3]: https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails-content-filters
     #
     # @option params [required, String] :guardrail_identifier
-    #   The unique identifier of the guardrail
+    #   The unique identifier of the guardrail. This can be an ID or the ARN.
     #
     # @option params [required, String] :name
     #   A name for the guardrail.
@@ -2299,6 +2308,10 @@ module Aws::Bedrock
     # @option params [Types::GuardrailSensitiveInformationPolicyConfig] :sensitive_information_policy_config
     #   The sensitive information policy to configure for the guardrail.
     #
+    # @option params [Types::GuardrailContextualGroundingPolicyConfig] :contextual_grounding_policy_config
+    #   The contextual grounding policy configuration used to update a
+    #   guardrail.
+    #
     # @option params [required, String] :blocked_input_messaging
     #   The message to return when the guardrail blocks a prompt.
     #
@@ -2368,6 +2381,14 @@ module Aws::Bedrock
     #         },
     #       ],
     #     },
+    #     contextual_grounding_policy_config: {
+    #       filters_config: [ # required
+    #         {
+    #           type: "GROUNDING", # required, accepts GROUNDING, RELEVANCE
+    #           threshold: 1.0, # required
+    #         },
+    #       ],
+    #     },
     #     blocked_input_messaging: "GuardrailBlockedMessaging", # required
     #     blocked_outputs_messaging: "GuardrailBlockedMessaging", # required
     #     kms_key_id: "KmsKeyId",
@@ -2449,7 +2470,7 @@ module Aws::Bedrock
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-bedrock'
-      context[:gem_version] = '1.10.0'
+      context[:gem_version] = '1.12.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -106,6 +106,15 @@ module Aws::Bedrock
     GuardrailContentFiltersConfig = Shapes::ListShape.new(name: 'GuardrailContentFiltersConfig')
     GuardrailContentPolicy = Shapes::StructureShape.new(name: 'GuardrailContentPolicy')
     GuardrailContentPolicyConfig = Shapes::StructureShape.new(name: 'GuardrailContentPolicyConfig')
+    GuardrailContextualGroundingFilter = Shapes::StructureShape.new(name: 'GuardrailContextualGroundingFilter')
+    GuardrailContextualGroundingFilterConfig = Shapes::StructureShape.new(name: 'GuardrailContextualGroundingFilterConfig')
+    GuardrailContextualGroundingFilterConfigThresholdDouble = Shapes::FloatShape.new(name: 'GuardrailContextualGroundingFilterConfigThresholdDouble')
+    GuardrailContextualGroundingFilterThresholdDouble = Shapes::FloatShape.new(name: 'GuardrailContextualGroundingFilterThresholdDouble')
+    GuardrailContextualGroundingFilterType = Shapes::StringShape.new(name: 'GuardrailContextualGroundingFilterType')
+    GuardrailContextualGroundingFilters = Shapes::ListShape.new(name: 'GuardrailContextualGroundingFilters')
+    GuardrailContextualGroundingFiltersConfig = Shapes::ListShape.new(name: 'GuardrailContextualGroundingFiltersConfig')
+    GuardrailContextualGroundingPolicy = Shapes::StructureShape.new(name: 'GuardrailContextualGroundingPolicy')
+    GuardrailContextualGroundingPolicyConfig = Shapes::StructureShape.new(name: 'GuardrailContextualGroundingPolicyConfig')
     GuardrailDescription = Shapes::StringShape.new(name: 'GuardrailDescription')
     GuardrailDraftVersion = Shapes::StringShape.new(name: 'GuardrailDraftVersion')
     GuardrailFailureRecommendation = Shapes::StringShape.new(name: 'GuardrailFailureRecommendation')
@@ -300,6 +309,7 @@ module Aws::Bedrock
     CreateGuardrailRequest.add_member(:content_policy_config, Shapes::ShapeRef.new(shape: GuardrailContentPolicyConfig, location_name: "contentPolicyConfig"))
     CreateGuardrailRequest.add_member(:word_policy_config, Shapes::ShapeRef.new(shape: GuardrailWordPolicyConfig, location_name: "wordPolicyConfig"))
     CreateGuardrailRequest.add_member(:sensitive_information_policy_config, Shapes::ShapeRef.new(shape: GuardrailSensitiveInformationPolicyConfig, location_name: "sensitiveInformationPolicyConfig"))
+    CreateGuardrailRequest.add_member(:contextual_grounding_policy_config, Shapes::ShapeRef.new(shape: GuardrailContextualGroundingPolicyConfig, location_name: "contextualGroundingPolicyConfig"))
     CreateGuardrailRequest.add_member(:blocked_input_messaging, Shapes::ShapeRef.new(shape: GuardrailBlockedMessaging, required: true, location_name: "blockedInputMessaging"))
     CreateGuardrailRequest.add_member(:blocked_outputs_messaging, Shapes::ShapeRef.new(shape: GuardrailBlockedMessaging, required: true, location_name: "blockedOutputsMessaging"))
     CreateGuardrailRequest.add_member(:kms_key_id, Shapes::ShapeRef.new(shape: KmsKeyId, location_name: "kmsKeyId"))
@@ -533,6 +543,7 @@ module Aws::Bedrock
     GetGuardrailResponse.add_member(:content_policy, Shapes::ShapeRef.new(shape: GuardrailContentPolicy, location_name: "contentPolicy"))
     GetGuardrailResponse.add_member(:word_policy, Shapes::ShapeRef.new(shape: GuardrailWordPolicy, location_name: "wordPolicy"))
     GetGuardrailResponse.add_member(:sensitive_information_policy, Shapes::ShapeRef.new(shape: GuardrailSensitiveInformationPolicy, location_name: "sensitiveInformationPolicy"))
+    GetGuardrailResponse.add_member(:contextual_grounding_policy, Shapes::ShapeRef.new(shape: GuardrailContextualGroundingPolicy, location_name: "contextualGroundingPolicy"))
     GetGuardrailResponse.add_member(:created_at, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "createdAt"))
     GetGuardrailResponse.add_member(:updated_at, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "updatedAt"))
     GetGuardrailResponse.add_member(:status_reasons, Shapes::ShapeRef.new(shape: GuardrailStatusReasons, location_name: "statusReasons"))
@@ -611,6 +622,24 @@ module Aws::Bedrock
     GuardrailContentPolicyConfig.add_member(:filters_config, Shapes::ShapeRef.new(shape: GuardrailContentFiltersConfig, required: true, location_name: "filtersConfig"))
     GuardrailContentPolicyConfig.struct_class = Types::GuardrailContentPolicyConfig
 
+    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.struct_class = Types::GuardrailContextualGroundingFilter
+
+    GuardrailContextualGroundingFilterConfig.add_member(:type, Shapes::ShapeRef.new(shape: GuardrailContextualGroundingFilterType, required: true, location_name: "type"))
+    GuardrailContextualGroundingFilterConfig.add_member(:threshold, Shapes::ShapeRef.new(shape: GuardrailContextualGroundingFilterConfigThresholdDouble, required: true, location_name: "threshold"))
+    GuardrailContextualGroundingFilterConfig.struct_class = Types::GuardrailContextualGroundingFilterConfig
+
+    GuardrailContextualGroundingFilters.member = Shapes::ShapeRef.new(shape: GuardrailContextualGroundingFilter)
+
+    GuardrailContextualGroundingFiltersConfig.member = Shapes::ShapeRef.new(shape: GuardrailContextualGroundingFilterConfig)
+
+    GuardrailContextualGroundingPolicy.add_member(:filters, Shapes::ShapeRef.new(shape: GuardrailContextualGroundingFilters, required: true, location_name: "filters"))
+    GuardrailContextualGroundingPolicy.struct_class = Types::GuardrailContextualGroundingPolicy
+
+    GuardrailContextualGroundingPolicyConfig.add_member(:filters_config, Shapes::ShapeRef.new(shape: GuardrailContextualGroundingFiltersConfig, required: true, location_name: "filtersConfig"))
+    GuardrailContextualGroundingPolicyConfig.struct_class = Types::GuardrailContextualGroundingPolicyConfig
+
     GuardrailFailureRecommendations.member = Shapes::ShapeRef.new(shape: GuardrailFailureRecommendation)
 
     GuardrailManagedWordLists.member = Shapes::ShapeRef.new(shape: GuardrailManagedWords)
@@ -934,6 +963,7 @@ module Aws::Bedrock
     UpdateGuardrailRequest.add_member(:content_policy_config, Shapes::ShapeRef.new(shape: GuardrailContentPolicyConfig, location_name: "contentPolicyConfig"))
     UpdateGuardrailRequest.add_member(:word_policy_config, Shapes::ShapeRef.new(shape: GuardrailWordPolicyConfig, location_name: "wordPolicyConfig"))
     UpdateGuardrailRequest.add_member(:sensitive_information_policy_config, Shapes::ShapeRef.new(shape: GuardrailSensitiveInformationPolicyConfig, location_name: "sensitiveInformationPolicyConfig"))
+    UpdateGuardrailRequest.add_member(:contextual_grounding_policy_config, Shapes::ShapeRef.new(shape: GuardrailContextualGroundingPolicyConfig, location_name: "contextualGroundingPolicyConfig"))
     UpdateGuardrailRequest.add_member(:blocked_input_messaging, Shapes::ShapeRef.new(shape: GuardrailBlockedMessaging, required: true, location_name: "blockedInputMessaging"))
     UpdateGuardrailRequest.add_member(:blocked_outputs_messaging, Shapes::ShapeRef.new(shape: GuardrailBlockedMessaging, required: true, location_name: "blockedOutputsMessaging"))
     UpdateGuardrailRequest.add_member(:kms_key_id, Shapes::ShapeRef.new(shape: KmsKeyId, location_name: "kmsKeyId"))

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

@@ -191,6 +191,11 @@ module Aws::Bedrock
     #   The sensitive information policy to configure for the guardrail.
     #   @return [Types::GuardrailSensitiveInformationPolicyConfig]
     #
+    # @!attribute [rw] contextual_grounding_policy_config
+    #   The contextual grounding policy configuration used to create a
+    #   guardrail.
+    #   @return [Types::GuardrailContextualGroundingPolicyConfig]
+    #
     # @!attribute [rw] blocked_input_messaging
     #   The message to return when the guardrail blocks a prompt.
     #   @return [String]
@@ -231,6 +236,7 @@ module Aws::Bedrock
       :content_policy_config,
       :word_policy_config,
       :sensitive_information_policy_config,
+      :contextual_grounding_policy_config,
       :blocked_input_messaging,
       :blocked_outputs_messaging,
       :kms_key_id,
@@ -245,12 +251,12 @@ module Aws::Bedrock
     #   @return [String]
     #
     # @!attribute [rw] guardrail_arn
-    #   The ARN of the guardrail that was created.
+    #   The ARN of the guardrail.
     #   @return [String]
     #
     # @!attribute [rw] version
-    #   The version of the guardrail that was created. This value should be
-    #   1.
+    #   The version of the guardrail that was created. This value will
+    #   always be `DRAFT`.
     #   @return [String]
     #
     # @!attribute [rw] created_at
@@ -269,7 +275,8 @@ module Aws::Bedrock
     end
 
     # @!attribute [rw] guardrail_identifier
-    #   The unique identifier of the guardrail.
+    #   The unique identifier of the guardrail. This can be an ID or the
+    #   ARN.
     #   @return [String]
     #
     # @!attribute [rw] description
@@ -586,7 +593,8 @@ module Aws::Bedrock
     class DeleteCustomModelResponse < Aws::EmptyStructure; end
 
     # @!attribute [rw] guardrail_identifier
-    #   The unique identifier of the guardrail.
+    #   The unique identifier of the guardrail. This can be an ID or the
+    #   ARN.
     #   @return [String]
     #
     # @!attribute [rw] guardrail_version
@@ -1231,6 +1239,7 @@ module Aws::Bedrock
 
     # @!attribute [rw] guardrail_identifier
     #   The unique identifier of the guardrail for which to get details.
+    #   This can be an ID or the ARN.
     #   @return [String]
     #
     # @!attribute [rw] guardrail_version
@@ -1261,7 +1270,7 @@ module Aws::Bedrock
     #   @return [String]
     #
     # @!attribute [rw] guardrail_arn
-    #   The ARN of the guardrail that was created.
+    #   The ARN of the guardrail.
     #   @return [String]
     #
     # @!attribute [rw] version
@@ -1289,6 +1298,10 @@ module Aws::Bedrock
     #   guardrail.
     #   @return [Types::GuardrailSensitiveInformationPolicy]
     #
+    # @!attribute [rw] contextual_grounding_policy
+    #   The contextual grounding policy used in the guardrail.
+    #   @return [Types::GuardrailContextualGroundingPolicy]
+    #
     # @!attribute [rw] created_at
     #   The date and time at which the guardrail was created.
     #   @return [Time]
@@ -1333,6 +1346,7 @@ module Aws::Bedrock
       :content_policy,
       :word_policy,
       :sensitive_information_policy,
+      :contextual_grounding_policy,
       :created_at,
       :updated_at,
       :status_reasons,
@@ -1700,17 +1714,9 @@ module Aws::Bedrock
     #
     # For more information, see [Guardrails content filters][1].
     #
-    # This data type is used in the following API operations:
-    #
-    # * [CreateGuardrail request body][2]
-    #
-    # * [UpdateGuardrail request body][3]
-    #
     #
     #
     # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails-filters.html
-    # [2]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_CreateGuardrail.html#API_CreateGuardrail_RequestSyntax
-    # [3]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_UpdateGuardrail.html#API_UpdateGuardrail_RequestSyntax
     #
     # @!attribute [rw] type
     #   The harmful category that the content filter is applied to.
@@ -1767,32 +1773,93 @@ module Aws::Bedrock
 
     # Contains details about how to handle harmful content.
     #
-    # This data type is used in the following API operations:
+    # @!attribute [rw] filters_config
+    #   Contains the type of the content filter and how strongly it should
+    #   apply to prompts and model responses.
+    #   @return [Array<Types::GuardrailContentFilterConfig>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-2023-04-20/GuardrailContentPolicyConfig AWS API Documentation
+    #
+    class GuardrailContentPolicyConfig < Struct.new(
+      :filters_config)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # The details for the guardrails contextual grounding filter.
+    #
+    # @!attribute [rw] type
+    #   The filter type details for the guardrails contextual grounding
+    #   filter.
+    #   @return [String]
+    #
+    # @!attribute [rw] threshold
+    #   The threshold details for the guardrails contextual grounding
+    #   filter.
+    #   @return [Float]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-2023-04-20/GuardrailContextualGroundingFilter AWS API Documentation
+    #
+    class GuardrailContextualGroundingFilter < Struct.new(
+      :type,
+      :threshold)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # The filter configuration details for the guardrails contextual
+    # grounding filter.
+    #
+    # @!attribute [rw] type
+    #   The filter details for the guardrails contextual grounding filter.
+    #   @return [String]
+    #
+    # @!attribute [rw] threshold
+    #   The threshold details for the guardrails contextual grounding
+    #   filter.
+    #   @return [Float]
     #
-    # * [CreateGuardrail request body][1]
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-2023-04-20/GuardrailContextualGroundingFilterConfig AWS API Documentation
     #
-    # * [UpdateGuardrail request body][2]
+    class GuardrailContextualGroundingFilterConfig < Struct.new(
+      :type,
+      :threshold)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # The details for the guardrails contextual grounding policy.
     #
+    # @!attribute [rw] filters
+    #   The filter details for the guardrails contextual grounding policy.
+    #   @return [Array<Types::GuardrailContextualGroundingFilter>]
     #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-2023-04-20/GuardrailContextualGroundingPolicy AWS API Documentation
     #
-    # [1]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_CreateGuardrail.html#API_CreateGuardrail_RequestSyntax
-    # [2]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_UpdateGuardrail.html#API_UpdateGuardrail_RequestSyntax
+    class GuardrailContextualGroundingPolicy < Struct.new(
+      :filters)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # The policy configuration details for the guardrails contextual
+    # grounding policy.
     #
     # @!attribute [rw] filters_config
-    #   Contains the type of the content filter and how strongly it should
-    #   apply to prompts and model responses.
-    #   @return [Array<Types::GuardrailContentFilterConfig>]
+    #   The filter configuration details for the guardrails contextual
+    #   grounding policy.
+    #   @return [Array<Types::GuardrailContextualGroundingFilterConfig>]
     #
-    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-2023-04-20/GuardrailContentPolicyConfig AWS API Documentation
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-2023-04-20/GuardrailContextualGroundingPolicyConfig AWS API Documentation
     #
-    class GuardrailContentPolicyConfig < Struct.new(
+    class GuardrailContextualGroundingPolicyConfig < Struct.new(
       :filters_config)
       SENSITIVE = []
       include Aws::Structure
     end
 
     # The managed word list that was configured for the guardrail. (This is
-    # a list of words that are pre-defined and managed by Guardrails only.)
+    # a list of words that are pre-defined and managed by guardrails only.)
     #
     # @!attribute [rw] type
     #   ManagedWords$type The managed word type that was configured for the
@@ -1844,6 +1911,231 @@ module Aws::Bedrock
     #
     # @!attribute [rw] type
     #   Configure guardrail type when the PII entity is detected.
+    #
+    #   The following PIIs are used to block or mask sensitive information:
+    #
+    #   * **General**
+    #
+    #     * **ADDRESS**
+    #
+    #       A physical address, such as "100 Main Street, Anytown, USA" or
+    #       "Suite #12, Building 123". An address can include information
+    #       such as the street, building, location, city, state, country,
+    #       county, zip code, precinct, and neighborhood.
+    #
+    #     * **AGE**
+    #
+    #       An individual's age, including the quantity and unit of time.
+    #       For example, in the phrase "I am 40 years old," Guarrails
+    #       recognizes "40 years" as an age.
+    #
+    #     * **NAME**
+    #
+    #       An individual's name. This entity type does not include titles,
+    #       such as Dr., Mr., Mrs., or Miss. guardrails doesn't apply this
+    #       entity type to names that are part of organizations or
+    #       addresses. For example, guardrails recognizes the "John Doe
+    #       Organization" as an organization, and it recognizes "Jane Doe
+    #       Street" as an address.
+    #
+    #     * **EMAIL**
+    #
+    #       An email address, such as *marymajor@email.com*.
+    #
+    #     * **PHONE**
+    #
+    #       A phone number. This entity type also includes fax and pager
+    #       numbers.
+    #
+    #     * **USERNAME**
+    #
+    #       A user name that identifies an account, such as a login name,
+    #       screen name, nick name, or handle.
+    #
+    #     * **PASSWORD**
+    #
+    #       An alphanumeric string that is used as a password, such as
+    #       "**very20special#pass**".
+    #
+    #     * **DRIVER\_ID**
+    #
+    #       The number assigned to a driver's license, which is an official
+    #       document permitting an individual to operate one or more
+    #       motorized vehicles on a public road. A driver's license number
+    #       consists of alphanumeric characters.
+    #
+    #     * **LICENSE\_PLATE**
+    #
+    #       A license plate for a vehicle is issued by the state or country
+    #       where the vehicle is registered. The format for passenger
+    #       vehicles is typically five to eight digits, consisting of
+    #       upper-case letters and numbers. The format varies depending on
+    #       the location of the issuing state or country.
+    #
+    #     * **VEHICLE\_IDENTIFICATION\_NUMBER**
+    #
+    #       A Vehicle Identification Number (VIN) uniquely identifies a
+    #       vehicle. VIN content and format are defined in the *ISO 3779*
+    #       specification. Each country has specific codes and formats for
+    #       VINs.
+    #
+    #   * **Finance**
+    #
+    #     * **REDIT\_DEBIT\_CARD\_CVV**
+    #
+    #       A three-digit card verification code (CVV) that is present on
+    #       VISA, MasterCard, and Discover credit and debit cards. For
+    #       American Express credit or debit cards, the CVV is a four-digit
+    #       numeric code.
+    #
+    #     * **CREDIT\_DEBIT\_CARD\_EXPIRY**
+    #
+    #       The expiration date for a credit or debit card. This number is
+    #       usually four digits long and is often formatted as *month/year*
+    #       or *MM/YY*. Guardrails recognizes expiration dates such as
+    #       *01/21*, *01/2021*, and *Jan 2021*.
+    #
+    #     * **CREDIT\_DEBIT\_CARD\_NUMBER**
+    #
+    #       The number for a credit or debit card. These numbers can vary
+    #       from 13 to 16 digits in length. However, Amazon Comprehend also
+    #       recognizes credit or debit card numbers when only the last four
+    #       digits are present.
+    #
+    #     * **PIN**
+    #
+    #       A four-digit personal identification number (PIN) with which you
+    #       can access your bank account.
+    #
+    #     * **INTERNATIONAL\_BANK\_ACCOUNT\_NUMBER**
+    #
+    #       An International Bank Account Number has specific formats in
+    #       each country. For more information, see
+    #       [www.iban.com/structure][1].
+    #
+    #     * **SWIFT\_CODE**
+    #
+    #       A SWIFT code is a standard format of Bank Identifier Code (BIC)
+    #       used to specify a particular bank or branch. Banks use these
+    #       codes for money transfers such as international wire transfers.
+    #
+    #       SWIFT codes consist of eight or 11 characters. The 11-digit
+    #       codes refer to specific branches, while eight-digit codes (or
+    #       11-digit codes ending in 'XXX') refer to the head or primary
+    #       office.
+    #
+    #   * **IT**
+    #
+    #     * **IP\_ADDRESS**
+    #
+    #       An IPv4 address, such as *198.51.100.0*.
+    #
+    #     * **MAC\_ADDRESS**
+    #
+    #       A *media access control* (MAC) address is a unique identifier
+    #       assigned to a network interface controller (NIC).
+    #
+    #     * **URL**
+    #
+    #       A web address, such as *www.example.com*.
+    #
+    #     * **AWS\_ACCESS\_KEY**
+    #
+    #       A unique identifier that's associated with a secret access key;
+    #       you use the access key ID and secret access key to sign
+    #       programmatic Amazon Web Services requests cryptographically.
+    #
+    #     * **AWS\_SECRET\_KEY**
+    #
+    #       A unique identifier that's associated with an access key. You
+    #       use the access key ID and secret access key to sign programmatic
+    #       Amazon Web Services requests cryptographically.
+    #
+    #   * **USA specific**
+    #
+    #     * **US\_BANK\_ACCOUNT\_NUMBER**
+    #
+    #       A US bank account number, which is typically 10 to 12 digits
+    #       long.
+    #
+    #     * **US\_BANK\_ROUTING\_NUMBER**
+    #
+    #       A US bank account routing number. These are typically nine
+    #       digits long,
+    #
+    #     * **US\_INDIVIDUAL\_TAX\_IDENTIFICATION\_NUMBER**
+    #
+    #       A US Individual Taxpayer Identification Number (ITIN) is a
+    #       nine-digit number that starts with a "9" and contain a "7"
+    #       or "8" as the fourth digit. An ITIN can be formatted with a
+    #       space or a dash after the third and forth digits.
+    #
+    #     * **US\_PASSPORT\_NUMBER**
+    #
+    #       A US passport number. Passport numbers range from six to nine
+    #       alphanumeric characters.
+    #
+    #     * **US\_SOCIAL\_SECURITY\_NUMBER**
+    #
+    #       A US Social Security Number (SSN) is a nine-digit number that is
+    #       issued to US citizens, permanent residents, and temporary
+    #       working residents.
+    #
+    #   * **Canada specific**
+    #
+    #     * **CA\_HEALTH\_NUMBER**
+    #
+    #       A Canadian Health Service Number is a 10-digit unique
+    #       identifier, required for individuals to access healthcare
+    #       benefits.
+    #
+    #     * **CA\_SOCIAL\_INSURANCE\_NUMBER**
+    #
+    #       A Canadian Social Insurance Number (SIN) is a nine-digit unique
+    #       identifier, required for individuals to access government
+    #       programs and benefits.
+    #
+    #       The SIN is formatted as three groups of three digits, such as
+    #       *123-456-789*. A SIN can be validated through a simple
+    #       check-digit process called the [Luhn algorithm][2].
+    #
+    #   * **UK Specific**
+    #
+    #     * **UK\_NATIONAL\_HEALTH\_SERVICE\_NUMBER**
+    #
+    #       A UK National Health Service Number is a 10-17 digit number,
+    #       such as *485 777 3456*. The current system formats the 10-digit
+    #       number with spaces after the third and sixth digits. The final
+    #       digit is an error-detecting checksum.
+    #
+    #     * **UK\_NATIONAL\_INSURANCE\_NUMBER**
+    #
+    #       A UK National Insurance Number (NINO) provides individuals with
+    #       access to National Insurance (social security) benefits. It is
+    #       also used for some purposes in the UK tax system.
+    #
+    #       The number is nine digits long and starts with two letters,
+    #       followed by six numbers and one letter. A NINO can be formatted
+    #       with a space or a dash after the two letters and after the
+    #       second, forth, and sixth digits.
+    #
+    #     * **UK\_UNIQUE\_TAXPAYER\_REFERENCE\_NUMBER**
+    #
+    #       A UK Unique Taxpayer Reference (UTR) is a 10-digit number that
+    #       identifies a taxpayer or a business.
+    #
+    #   * **Custom**
+    #
+    #     * **Regex filter** - You can use a regular expressions to define
+    #       patterns for a guardrail to recognize and act upon such as
+    #       serial number, booking ID etc..
+    #
+    #     ^
+    #
+    #
+    #
+    #   [1]: https://www.iban.com/structure
+    #   [2]: https://www.wikipedia.org/wiki/Luhn_algorithm
     #   @return [String]
     #
     # @!attribute [rw] action
@@ -2060,17 +2352,6 @@ module Aws::Bedrock
 
     # Details about topics for the guardrail to identify and deny.
     #
-    # This data type is used in the following API operations:
-    #
-    # * [CreateGuardrail request body][1]
-    #
-    # * [UpdateGuardrail request body][2]
-    #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_CreateGuardrail.html#API_CreateGuardrail_RequestSyntax
-    # [2]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_UpdateGuardrail.html#API_UpdateGuardrail_RequestSyntax
-    #
     # @!attribute [rw] name
     #   The name of the topic to deny.
     #   @return [String]
@@ -2127,17 +2408,6 @@ module Aws::Bedrock
     # Contains details about topics that the guardrail should identify and
     # deny.
     #
-    # This data type is used in the following API operations:
-    #
-    # * [CreateGuardrail request body][1]
-    #
-    # * [UpdateGuardrail request body][2]
-    #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_CreateGuardrail.html#API_CreateGuardrail_RequestSyntax
-    # [2]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_UpdateGuardrail.html#API_UpdateGuardrail_RequestSyntax
-    #
     # @!attribute [rw] topics_config
     #   A list of policies related to topics that the guardrail should deny.
     #   @return [Array<Types::GuardrailTopicConfig>]
@@ -2519,7 +2789,8 @@ module Aws::Bedrock
     end
 
     # @!attribute [rw] guardrail_identifier
-    #   The unique identifier of the guardrail.
+    #   The unique identifier of the guardrail. This can be an ID or the
+    #   ARN.
     #   @return [String]
     #
     # @!attribute [rw] max_results
@@ -3154,7 +3425,8 @@ module Aws::Bedrock
     class UntagResourceResponse < Aws::EmptyStructure; end
 
     # @!attribute [rw] guardrail_identifier
-    #   The unique identifier of the guardrail
+    #   The unique identifier of the guardrail. This can be an ID or the
+    #   ARN.
     #   @return [String]
     #
     # @!attribute [rw] name
@@ -3181,6 +3453,11 @@ module Aws::Bedrock
     #   The sensitive information policy to configure for the guardrail.
     #   @return [Types::GuardrailSensitiveInformationPolicyConfig]
     #
+    # @!attribute [rw] contextual_grounding_policy_config
+    #   The contextual grounding policy configuration used to update a
+    #   guardrail.
+    #   @return [Types::GuardrailContextualGroundingPolicyConfig]
+    #
     # @!attribute [rw] blocked_input_messaging
     #   The message to return when the guardrail blocks a prompt.
     #   @return [String]
@@ -3203,6 +3480,7 @@ module Aws::Bedrock
       :content_policy_config,
       :word_policy_config,
       :sensitive_information_policy_config,
+      :contextual_grounding_policy_config,
       :blocked_input_messaging,
       :blocked_outputs_messaging,
       :kms_key_id)
@@ -3215,7 +3493,7 @@ module Aws::Bedrock
     #   @return [String]
     #
     # @!attribute [rw] guardrail_arn
-    #   The ARN of the guardrail that was created.
+    #   The ARN of the guardrail.
     #   @return [String]
     #
     # @!attribute [rw] version

data/lib/aws-sdk-bedrock.rb

@@ -53,6 +53,6 @@ require_relative 'aws-sdk-bedrock/customizations'
 # @!group service
 module Aws::Bedrock
 
-  GEM_VERSION = '1.10.0'
+  GEM_VERSION = '1.12.0'
 
 end

data/sig/client.rbs

@@ -48,6 +48,7 @@ module Aws
                       ?sdk_ua_app_id: String,
                       ?secret_access_key: String,
                       ?session_token: String,
+                      ?sigv4a_signing_region_set: Array[String],
                       ?stub_responses: untyped,
                       ?token_provider: untyped,
                       ?use_dualstack_endpoint: bool,
@@ -204,6 +205,14 @@ module Aws
                                   },
                                 ]?
                               },
+                              ?contextual_grounding_policy_config: {
+                                filters_config: Array[
+                                  {
+                                    type: ("GROUNDING" | "RELEVANCE"),
+                                    threshold: ::Float
+                                  },
+                                ]
+                              },
                               blocked_input_messaging: ::String,
                               blocked_outputs_messaging: ::String,
                               ?kms_key_id: ::String,
@@ -399,6 +408,7 @@ module Aws
         def content_policy: () -> Types::GuardrailContentPolicy
         def word_policy: () -> Types::GuardrailWordPolicy
         def sensitive_information_policy: () -> Types::GuardrailSensitiveInformationPolicy
+        def contextual_grounding_policy: () -> Types::GuardrailContextualGroundingPolicy
         def created_at: () -> ::Time
         def updated_at: () -> ::Time
         def status_reasons: () -> ::Array[::String]
@@ -712,6 +722,14 @@ module Aws
                                   },
                                 ]?
                               },
+                              ?contextual_grounding_policy_config: {
+                                filters_config: Array[
+                                  {
+                                    type: ("GROUNDING" | "RELEVANCE"),
+                                    threshold: ::Float
+                                  },
+                                ]
+                              },
                               blocked_input_messaging: ::String,
                               blocked_outputs_messaging: ::String,
                               ?kms_key_id: ::String

data/sig/resource.rbs

@@ -48,6 +48,7 @@ module Aws
                         ?sdk_ua_app_id: String,
                         ?secret_access_key: String,
                         ?session_token: String,
+                        ?sigv4a_signing_region_set: Array[String],
                         ?stub_responses: untyped,
                         ?token_provider: untyped,
                         ?use_dualstack_endpoint: bool,

data/sig/types.rbs

@@ -55,6 +55,7 @@ module Aws::Bedrock
       attr_accessor content_policy_config: Types::GuardrailContentPolicyConfig
       attr_accessor word_policy_config: Types::GuardrailWordPolicyConfig
       attr_accessor sensitive_information_policy_config: Types::GuardrailSensitiveInformationPolicyConfig
+      attr_accessor contextual_grounding_policy_config: Types::GuardrailContextualGroundingPolicyConfig
       attr_accessor blocked_input_messaging: ::String
       attr_accessor blocked_outputs_messaging: ::String
       attr_accessor kms_key_id: ::String
@@ -350,6 +351,7 @@ module Aws::Bedrock
       attr_accessor content_policy: Types::GuardrailContentPolicy
       attr_accessor word_policy: Types::GuardrailWordPolicy
       attr_accessor sensitive_information_policy: Types::GuardrailSensitiveInformationPolicy
+      attr_accessor contextual_grounding_policy: Types::GuardrailContextualGroundingPolicy
       attr_accessor created_at: ::Time
       attr_accessor updated_at: ::Time
       attr_accessor status_reasons: ::Array[::String]
@@ -444,6 +446,28 @@ module Aws::Bedrock
       SENSITIVE: []
     end
 
+    class GuardrailContextualGroundingFilter
+      attr_accessor type: ("GROUNDING" | "RELEVANCE")
+      attr_accessor threshold: ::Float
+      SENSITIVE: []
+    end
+
+    class GuardrailContextualGroundingFilterConfig
+      attr_accessor type: ("GROUNDING" | "RELEVANCE")
+      attr_accessor threshold: ::Float
+      SENSITIVE: []
+    end
+
+    class GuardrailContextualGroundingPolicy
+      attr_accessor filters: ::Array[Types::GuardrailContextualGroundingFilter]
+      SENSITIVE: []
+    end
+
+    class GuardrailContextualGroundingPolicyConfig
+      attr_accessor filters_config: ::Array[Types::GuardrailContextualGroundingFilterConfig]
+      SENSITIVE: []
+    end
+
     class GuardrailManagedWords
       attr_accessor type: ("PROFANITY")
       SENSITIVE: []
@@ -826,6 +850,7 @@ module Aws::Bedrock
       attr_accessor content_policy_config: Types::GuardrailContentPolicyConfig
       attr_accessor word_policy_config: Types::GuardrailWordPolicyConfig
       attr_accessor sensitive_information_policy_config: Types::GuardrailSensitiveInformationPolicyConfig
+      attr_accessor contextual_grounding_policy_config: Types::GuardrailContextualGroundingPolicyConfig
       attr_accessor blocked_input_messaging: ::String
       attr_accessor blocked_outputs_messaging: ::String
       attr_accessor kms_key_id: ::String

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-bedrock
 version: !ruby/object:Gem::Version
-  version: 1.10.0
+  version: 1.12.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-06-25 00:00:00.000000000 Z
+date: 2024-07-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.199.0
+        version: 3.201.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.199.0
+        version: 3.201.0
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement