aws-sdk-customerprofiles 1.90.0 → 1.91.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a67b7e2e43fc83ef061003c56469e1f608877c932f3ae3a179b752c5d921f082
-  data.tar.gz: 4c56559de81978a7d67552651f08dc222963e4695b2c23410f2edbe3717706c6
+  metadata.gz: 459db88096eb2f445ecc1a9d89d2221afeb5ab5f80e9e7965f45f0537047b845
+  data.tar.gz: '093c47d3f2150e5a553e8c034b1b8bf50840a6de166ce6f8da062e2458ebae0e'
 SHA512:
-  metadata.gz: 67090735b315615dc7b1f92b7cc84ffe5bb57f90561a6f6a83a60134249cc30e9ba263acc8d3295db541f473c3ab077beef1be6698225fa5efcc1c48558f9202
-  data.tar.gz: a198894d67b462b0f3f86fff543f9bb811bcadd1afa65574515173e27ffdc9ce2ba66f30596c026d83442bc1a4a89aeb728f33321b2b0633d43e7d26fe9025de
+  metadata.gz: 33849f306634497fbf5c163365d930da208d045dea7c437a8ca090d9fd2ff18c22602f95917cb0d5640421bd226a71fb73b4b66adecff7553c5fb14dbbd2df19
+  data.tar.gz: f90f283bbd213e973bb606f4d6fd17cac2955f67f400d35f5bee652ab8c1ef19f556514ea4951ce3c010771194cfcac4201b2aab968c284371cbdfde22be4d1f

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.91.0 (2026-07-02)
+------------------
+
+* Feature - Amazon Connect Customer Profiles adds support for diversityConfig to recommenderConfig which can be used for diversifying the recommendations. This release also includes model versioning support which helps customer to rollback trained models.
+
 1.90.0 (2026-05-28)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.90.0
+1.91.0

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

@@ -1782,6 +1782,15 @@ module Aws::CustomerProfiles
     #       excluded_columns: {
     #         "String" => ["text"],
     #       },
+    #       diversity_config: {
+    #         diversity_columns: [
+    #           {
+    #             name: "text", # required
+    #             cap_type: "PERCENTAGE", # required, accepts PERCENTAGE, VALUE
+    #             target: "DiversityTargetExpression", # required
+    #           },
+    #         ],
+    #       },
     #     },
     #     description: "sensitiveText",
     #     recommender_schema_name: "name",
@@ -4115,6 +4124,11 @@ module Aws::CustomerProfiles
     #   response. Use this to specify which metadata columns to return
     #   alongside recommended items.
     #
+    # @option params [Types::RecommendationDiversityConfig] :diversity_config
+    #   Runtime diversity configuration for this request. Enables
+    #   diversity-aware recommendations and optionally supplies values for
+    #   placeholder-based diversity caps configured on the recommender.
+    #
     # @return [Types::GetProfileRecommendationsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::GetProfileRecommendationsResponse#recommendations #recommendations} => Array<Types::Recommendation>
@@ -4151,6 +4165,12 @@ module Aws::CustomerProfiles
     #     metadata_config: {
     #       metadata_columns: ["MetadataColumnName"],
     #     },
+    #     diversity_config: {
+    #       enabled: false, # required
+    #       values: {
+    #         "DiversityPlaceholderName" => 1,
+    #       },
+    #     },
     #   })
     #
     # @example Response structure
@@ -4204,6 +4224,7 @@ module Aws::CustomerProfiles
     #   * {Types::GetRecommenderResponse#created_at #created_at} => Time
     #   * {Types::GetRecommenderResponse#failure_reason #failure_reason} => String
     #   * {Types::GetRecommenderResponse#latest_recommender_update #latest_recommender_update} => Types::RecommenderUpdate
+    #   * {Types::GetRecommenderResponse#active_recommender_version_name #active_recommender_version_name} => String
     #   * {Types::GetRecommenderResponse#training_metrics #training_metrics} => Array<Types::TrainingMetrics>
     #   * {Types::GetRecommenderResponse#tags #tags} => Hash<String,String>
     #
@@ -4232,6 +4253,10 @@ module Aws::CustomerProfiles
     #   resp.recommender_config.excluded_columns #=> Hash
     #   resp.recommender_config.excluded_columns["String"] #=> Array
     #   resp.recommender_config.excluded_columns["String"][0] #=> String
+    #   resp.recommender_config.diversity_config.diversity_columns #=> Array
+    #   resp.recommender_config.diversity_config.diversity_columns[0].name #=> String
+    #   resp.recommender_config.diversity_config.diversity_columns[0].cap_type #=> String, one of "PERCENTAGE", "VALUE"
+    #   resp.recommender_config.diversity_config.diversity_columns[0].target #=> String
     #   resp.description #=> String
     #   resp.status #=> String, one of "PENDING", "IN_PROGRESS", "ACTIVE", "FAILED", "STOPPING", "INACTIVE", "STARTING", "DELETING"
     #   resp.last_updated_at #=> Time
@@ -4249,14 +4274,21 @@ module Aws::CustomerProfiles
     #   resp.latest_recommender_update.recommender_config.excluded_columns #=> Hash
     #   resp.latest_recommender_update.recommender_config.excluded_columns["String"] #=> Array
     #   resp.latest_recommender_update.recommender_config.excluded_columns["String"][0] #=> String
+    #   resp.latest_recommender_update.recommender_config.diversity_config.diversity_columns #=> Array
+    #   resp.latest_recommender_update.recommender_config.diversity_config.diversity_columns[0].name #=> String
+    #   resp.latest_recommender_update.recommender_config.diversity_config.diversity_columns[0].cap_type #=> String, one of "PERCENTAGE", "VALUE"
+    #   resp.latest_recommender_update.recommender_config.diversity_config.diversity_columns[0].target #=> String
     #   resp.latest_recommender_update.status #=> String, one of "PENDING", "IN_PROGRESS", "ACTIVE", "FAILED", "STOPPING", "INACTIVE", "STARTING", "DELETING"
     #   resp.latest_recommender_update.created_at #=> Time
     #   resp.latest_recommender_update.last_updated_at #=> Time
     #   resp.latest_recommender_update.failure_reason #=> String
+    #   resp.latest_recommender_update.recommender_version_name #=> String
+    #   resp.active_recommender_version_name #=> String
     #   resp.training_metrics #=> Array
     #   resp.training_metrics[0].time #=> Time
     #   resp.training_metrics[0].metrics #=> Hash
     #   resp.training_metrics[0].metrics["TrainingMetricName"] #=> Float
+    #   resp.training_metrics[0].recommender_version_name #=> String
     #   resp.tags #=> Hash
     #   resp.tags["TagKey"] #=> String
     #
@@ -6073,6 +6105,10 @@ module Aws::CustomerProfiles
     #   resp.recommenders[0].recommender_config.excluded_columns #=> Hash
     #   resp.recommenders[0].recommender_config.excluded_columns["String"] #=> Array
     #   resp.recommenders[0].recommender_config.excluded_columns["String"][0] #=> String
+    #   resp.recommenders[0].recommender_config.diversity_config.diversity_columns #=> Array
+    #   resp.recommenders[0].recommender_config.diversity_config.diversity_columns[0].name #=> String
+    #   resp.recommenders[0].recommender_config.diversity_config.diversity_columns[0].cap_type #=> String, one of "PERCENTAGE", "VALUE"
+    #   resp.recommenders[0].recommender_config.diversity_config.diversity_columns[0].target #=> String
     #   resp.recommenders[0].created_at #=> Time
     #   resp.recommenders[0].description #=> String
     #   resp.recommenders[0].status #=> String, one of "PENDING", "IN_PROGRESS", "ACTIVE", "FAILED", "STOPPING", "INACTIVE", "STARTING", "DELETING"
@@ -6092,10 +6128,15 @@ module Aws::CustomerProfiles
     #   resp.recommenders[0].latest_recommender_update.recommender_config.excluded_columns #=> Hash
     #   resp.recommenders[0].latest_recommender_update.recommender_config.excluded_columns["String"] #=> Array
     #   resp.recommenders[0].latest_recommender_update.recommender_config.excluded_columns["String"][0] #=> String
+    #   resp.recommenders[0].latest_recommender_update.recommender_config.diversity_config.diversity_columns #=> Array
+    #   resp.recommenders[0].latest_recommender_update.recommender_config.diversity_config.diversity_columns[0].name #=> String
+    #   resp.recommenders[0].latest_recommender_update.recommender_config.diversity_config.diversity_columns[0].cap_type #=> String, one of "PERCENTAGE", "VALUE"
+    #   resp.recommenders[0].latest_recommender_update.recommender_config.diversity_config.diversity_columns[0].target #=> String
     #   resp.recommenders[0].latest_recommender_update.status #=> String, one of "PENDING", "IN_PROGRESS", "ACTIVE", "FAILED", "STOPPING", "INACTIVE", "STARTING", "DELETING"
     #   resp.recommenders[0].latest_recommender_update.created_at #=> Time
     #   resp.recommenders[0].latest_recommender_update.last_updated_at #=> Time
     #   resp.recommenders[0].latest_recommender_update.failure_reason #=> String
+    #   resp.recommenders[0].latest_recommender_update.recommender_version_name #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/customer-profiles-2020-08-15/ListRecommenders AWS API Documentation
     #
@@ -7957,6 +7998,10 @@ module Aws::CustomerProfiles
     #   The new configuration settings to apply to the recommender, including
     #   updated parameters and settings that define its behavior.
     #
+    # @option params [String] :recommender_version_name
+    #   The name of a specific recommender version to activate as part of this
+    #   update (for example, to roll back to a previously trained version).
+    #
     # @return [Types::UpdateRecommenderResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::UpdateRecommenderResponse#recommender_name #recommender_name} => String
@@ -7987,7 +8032,17 @@ module Aws::CustomerProfiles
     #       excluded_columns: {
     #         "String" => ["text"],
     #       },
+    #       diversity_config: {
+    #         diversity_columns: [
+    #           {
+    #             name: "text", # required
+    #             cap_type: "PERCENTAGE", # required, accepts PERCENTAGE, VALUE
+    #             target: "DiversityTargetExpression", # required
+    #           },
+    #         ],
+    #       },
     #     },
+    #     recommender_version_name: "RecommenderVersionName",
     #   })
     #
     # @example Response structure
@@ -8021,7 +8076,7 @@ module Aws::CustomerProfiles
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-customerprofiles'
-      context[:gem_version] = '1.90.0'
+      context[:gem_version] = '1.91.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -162,6 +162,14 @@ module Aws::CustomerProfiles
     DetectedProfileObjectTypes = Shapes::ListShape.new(name: 'DetectedProfileObjectTypes')
     Dimension = Shapes::UnionShape.new(name: 'Dimension')
     DimensionList = Shapes::ListShape.new(name: 'DimensionList')
+    DiversityCapType = Shapes::StringShape.new(name: 'DiversityCapType')
+    DiversityCapValue = Shapes::IntegerShape.new(name: 'DiversityCapValue')
+    DiversityColumn = Shapes::StructureShape.new(name: 'DiversityColumn')
+    DiversityColumnsList = Shapes::ListShape.new(name: 'DiversityColumnsList')
+    DiversityConfig = Shapes::StructureShape.new(name: 'DiversityConfig')
+    DiversityPlaceholderName = Shapes::StringShape.new(name: 'DiversityPlaceholderName')
+    DiversityTargetExpression = Shapes::StringShape.new(name: 'DiversityTargetExpression')
+    DiversityValuesMap = Shapes::MapShape.new(name: 'DiversityValuesMap')
     DomainList = Shapes::ListShape.new(name: 'DomainList')
     DomainObjectTypeField = Shapes::StructureShape.new(name: 'DomainObjectTypeField')
     DomainObjectTypeFieldName = Shapes::StringShape.new(name: 'DomainObjectTypeFieldName')
@@ -444,6 +452,7 @@ module Aws::CustomerProfiles
     Readiness = Shapes::StructureShape.new(name: 'Readiness')
     ReadinessStatus = Shapes::StringShape.new(name: 'ReadinessStatus')
     Recommendation = Shapes::StructureShape.new(name: 'Recommendation')
+    RecommendationDiversityConfig = Shapes::StructureShape.new(name: 'RecommendationDiversityConfig')
     Recommendations = Shapes::ListShape.new(name: 'Recommendations')
     RecommenderConfig = Shapes::StructureShape.new(name: 'RecommenderConfig')
     RecommenderConfigTrainingFrequencyInteger = Shapes::IntegerShape.new(name: 'RecommenderConfigTrainingFrequencyInteger')
@@ -473,6 +482,7 @@ module Aws::CustomerProfiles
     RecommenderSummary = Shapes::StructureShape.new(name: 'RecommenderSummary')
     RecommenderSummaryList = Shapes::ListShape.new(name: 'RecommenderSummaryList')
     RecommenderUpdate = Shapes::StructureShape.new(name: 'RecommenderUpdate')
+    RecommenderVersionName = Shapes::StringShape.new(name: 'RecommenderVersionName')
     ResourceNotFoundException = Shapes::StructureShape.new(name: 'ResourceNotFoundException')
     ResultsSummary = Shapes::StructureShape.new(name: 'ResultsSummary')
     RoleArn = Shapes::StringShape.new(name: 'RoleArn')
@@ -1266,6 +1276,19 @@ module Aws::CustomerProfiles
 
     DimensionList.member = Shapes::ShapeRef.new(shape: Dimension)
 
+    DiversityColumn.add_member(:name, Shapes::ShapeRef.new(shape: text, required: true, location_name: "Name"))
+    DiversityColumn.add_member(:cap_type, Shapes::ShapeRef.new(shape: DiversityCapType, required: true, location_name: "CapType"))
+    DiversityColumn.add_member(:target, Shapes::ShapeRef.new(shape: DiversityTargetExpression, required: true, location_name: "Target"))
+    DiversityColumn.struct_class = Types::DiversityColumn
+
+    DiversityColumnsList.member = Shapes::ShapeRef.new(shape: DiversityColumn)
+
+    DiversityConfig.add_member(:diversity_columns, Shapes::ShapeRef.new(shape: DiversityColumnsList, location_name: "DiversityColumns"))
+    DiversityConfig.struct_class = Types::DiversityConfig
+
+    DiversityValuesMap.key = Shapes::ShapeRef.new(shape: DiversityPlaceholderName)
+    DiversityValuesMap.value = Shapes::ShapeRef.new(shape: DiversityCapValue)
+
     DomainList.member = Shapes::ShapeRef.new(shape: ListDomainItem)
 
     DomainObjectTypeField.add_member(:source, Shapes::ShapeRef.new(shape: text, required: true, location_name: "Source"))
@@ -1671,6 +1694,7 @@ module Aws::CustomerProfiles
     GetProfileRecommendationsRequest.add_member(:candidate_ids, Shapes::ShapeRef.new(shape: CandidateIdList, location_name: "CandidateIds"))
     GetProfileRecommendationsRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: maxSize500, location_name: "MaxResults"))
     GetProfileRecommendationsRequest.add_member(:metadata_config, Shapes::ShapeRef.new(shape: MetadataConfig, location_name: "MetadataConfig"))
+    GetProfileRecommendationsRequest.add_member(:diversity_config, Shapes::ShapeRef.new(shape: RecommendationDiversityConfig, location_name: "DiversityConfig"))
     GetProfileRecommendationsRequest.struct_class = Types::GetProfileRecommendationsRequest
 
     GetProfileRecommendationsResponse.add_member(:recommendations, Shapes::ShapeRef.new(shape: Recommendations, location_name: "Recommendations"))
@@ -1705,6 +1729,7 @@ module Aws::CustomerProfiles
     GetRecommenderResponse.add_member(:created_at, Shapes::ShapeRef.new(shape: timestamp, location_name: "CreatedAt"))
     GetRecommenderResponse.add_member(:failure_reason, Shapes::ShapeRef.new(shape: String, location_name: "FailureReason"))
     GetRecommenderResponse.add_member(:latest_recommender_update, Shapes::ShapeRef.new(shape: RecommenderUpdate, location_name: "LatestRecommenderUpdate"))
+    GetRecommenderResponse.add_member(:active_recommender_version_name, Shapes::ShapeRef.new(shape: RecommenderVersionName, location_name: "ActiveRecommenderVersionName"))
     GetRecommenderResponse.add_member(:training_metrics, Shapes::ShapeRef.new(shape: TrainingMetricsList, location_name: "TrainingMetrics"))
     GetRecommenderResponse.add_member(:tags, Shapes::ShapeRef.new(shape: TagMap, location_name: "Tags"))
     GetRecommenderResponse.struct_class = Types::GetRecommenderResponse
@@ -2517,6 +2542,10 @@ module Aws::CustomerProfiles
     Recommendation.add_member(:score, Shapes::ShapeRef.new(shape: Double0To1, location_name: "Score"))
     Recommendation.struct_class = Types::Recommendation
 
+    RecommendationDiversityConfig.add_member(:enabled, Shapes::ShapeRef.new(shape: optionalBoolean, required: true, location_name: "Enabled"))
+    RecommendationDiversityConfig.add_member(:values, Shapes::ShapeRef.new(shape: DiversityValuesMap, location_name: "Values"))
+    RecommendationDiversityConfig.struct_class = Types::RecommendationDiversityConfig
+
     Recommendations.member = Shapes::ShapeRef.new(shape: Recommendation)
 
     RecommenderConfig.add_member(:events_config, Shapes::ShapeRef.new(shape: EventsConfig, location_name: "EventsConfig"))
@@ -2524,6 +2553,7 @@ module Aws::CustomerProfiles
     RecommenderConfig.add_member(:inference_config, Shapes::ShapeRef.new(shape: InferenceConfig, location_name: "InferenceConfig"))
     RecommenderConfig.add_member(:included_columns, Shapes::ShapeRef.new(shape: IncludedColumns, location_name: "IncludedColumns"))
     RecommenderConfig.add_member(:excluded_columns, Shapes::ShapeRef.new(shape: IncludedColumns, location_name: "ExcludedColumns"))
+    RecommenderConfig.add_member(:diversity_config, Shapes::ShapeRef.new(shape: DiversityConfig, location_name: "DiversityConfig"))
     RecommenderConfig.struct_class = Types::RecommenderConfig
 
     RecommenderContext.key = Shapes::ShapeRef.new(shape: ContextKey)
@@ -2602,6 +2632,7 @@ module Aws::CustomerProfiles
     RecommenderUpdate.add_member(:created_at, Shapes::ShapeRef.new(shape: timestamp, location_name: "CreatedAt"))
     RecommenderUpdate.add_member(:last_updated_at, Shapes::ShapeRef.new(shape: timestamp, location_name: "LastUpdatedAt"))
     RecommenderUpdate.add_member(:failure_reason, Shapes::ShapeRef.new(shape: String, location_name: "FailureReason"))
+    RecommenderUpdate.add_member(:recommender_version_name, Shapes::ShapeRef.new(shape: RecommenderVersionName, location_name: "RecommenderVersionName"))
     RecommenderUpdate.struct_class = Types::RecommenderUpdate
 
     ResourceNotFoundException.add_member(:message, Shapes::ShapeRef.new(shape: message, location_name: "Message"))
@@ -2783,6 +2814,7 @@ module Aws::CustomerProfiles
 
     TrainingMetrics.add_member(:time, Shapes::ShapeRef.new(shape: timestamp, location_name: "Time"))
     TrainingMetrics.add_member(:metrics, Shapes::ShapeRef.new(shape: Metrics, location_name: "Metrics"))
+    TrainingMetrics.add_member(:recommender_version_name, Shapes::ShapeRef.new(shape: RecommenderVersionName, location_name: "RecommenderVersionName"))
     TrainingMetrics.struct_class = Types::TrainingMetrics
 
     TrainingMetricsList.member = Shapes::ShapeRef.new(shape: TrainingMetrics)
@@ -2935,6 +2967,7 @@ module Aws::CustomerProfiles
     UpdateRecommenderRequest.add_member(:recommender_name, Shapes::ShapeRef.new(shape: name, required: true, location: "uri", location_name: "RecommenderName"))
     UpdateRecommenderRequest.add_member(:description, Shapes::ShapeRef.new(shape: sensitiveText, location_name: "Description"))
     UpdateRecommenderRequest.add_member(:recommender_config, Shapes::ShapeRef.new(shape: RecommenderConfig, location_name: "RecommenderConfig"))
+    UpdateRecommenderRequest.add_member(:recommender_version_name, Shapes::ShapeRef.new(shape: RecommenderVersionName, location_name: "RecommenderVersionName"))
     UpdateRecommenderRequest.struct_class = Types::UpdateRecommenderRequest
 
     UpdateRecommenderResponse.add_member(:recommender_name, Shapes::ShapeRef.new(shape: name, required: true, location_name: "RecommenderName"))

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

@@ -2900,6 +2900,54 @@ module Aws::CustomerProfiles
       class Unknown < Dimension; end
     end
 
+    # Defines a diversity constraint for a single item column, specifying a
+    # cap type and a target value or placeholder that controls how many
+    # recommended items may share the same column value.
+    #
+    # @!attribute [rw] name
+    #   The name of the item catalog column on which to apply the diversity
+    #   cap. The column must be defined in the recommender schema.
+    #   @return [String]
+    #
+    # @!attribute [rw] cap_type
+    #   The type of diversity cap to apply. Valid values are `PERCENTAGE`
+    #   (interpret `Target` as a percentage of returned items) and `VALUE`
+    #   (interpret `Target` as an absolute count).
+    #   @return [String]
+    #
+    # @!attribute [rw] target
+    #   The diversity cap target. Either an integer literal (for example,
+    #   `"25"`) or a placeholder expression of the form `$name` whose value
+    #   is supplied at inference time through `GetProfileRecommendations`.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/customer-profiles-2020-08-15/DiversityColumn AWS API Documentation
+    #
+    class DiversityColumn < Struct.new(
+      :name,
+      :cap_type,
+      :target)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Configuration that controls diversity of recommendation results by
+    # capping the representation of specified item columns.
+    #
+    # @!attribute [rw] diversity_columns
+    #   A list of up to two diversity columns. Each column defines a cap on
+    #   the number or percentage of recommended items that share the same
+    #   value for that column.
+    #   @return [Array<Types::DiversityColumn>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/customer-profiles-2020-08-15/DiversityConfig AWS API Documentation
+    #
+    class DiversityConfig < Struct.new(
+      :diversity_columns)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # The standard domain object type.
     #
     # @!attribute [rw] source
@@ -4811,6 +4859,12 @@ module Aws::CustomerProfiles
     #   alongside recommended items.
     #   @return [Types::MetadataConfig]
     #
+    # @!attribute [rw] diversity_config
+    #   Runtime diversity configuration for this request. Enables
+    #   diversity-aware recommendations and optionally supplies values for
+    #   placeholder-based diversity caps configured on the recommender.
+    #   @return [Types::RecommendationDiversityConfig]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/customer-profiles-2020-08-15/GetProfileRecommendationsRequest AWS API Documentation
     #
     class GetProfileRecommendationsRequest < Struct.new(
@@ -4822,7 +4876,8 @@ module Aws::CustomerProfiles
       :recommender_promotional_filters,
       :candidate_ids,
       :max_results,
-      :metadata_config)
+      :metadata_config,
+      :diversity_config)
       SENSITIVE = [:context]
       include Aws::Structure
     end
@@ -4974,6 +5029,11 @@ module Aws::CustomerProfiles
     #   recommender, including status and timestamp.
     #   @return [Types::RecommenderUpdate]
     #
+    # @!attribute [rw] active_recommender_version_name
+    #   The name of the recommender version currently serving
+    #   recommendations. Omitted when no active recommender version is set.
+    #   @return [String]
+    #
     # @!attribute [rw] training_metrics
     #   A set of metrics that provide information about the recommender's
     #   training performance and accuracy.
@@ -4997,6 +5057,7 @@ module Aws::CustomerProfiles
       :created_at,
       :failure_reason,
       :latest_recommender_update,
+      :active_recommender_version_name,
       :training_metrics,
       :tags)
       SENSITIVE = [:description]
@@ -8792,6 +8853,29 @@ module Aws::CustomerProfiles
       include Aws::Structure
     end
 
+    # Runtime diversity configuration for a `GetProfileRecommendations`
+    # request.
+    #
+    # @!attribute [rw] enabled
+    #   Whether diversity-aware recommendations are enabled for this
+    #   request.
+    #   @return [Boolean]
+    #
+    # @!attribute [rw] values
+    #   An optional map of placeholder name to integer cap value used to
+    #   resolve `$name` placeholders defined in the recommender's
+    #   `DiversityConfig` at inference time. Up to 2 entries are supported.
+    #   @return [Hash<String,Integer>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/customer-profiles-2020-08-15/RecommendationDiversityConfig AWS API Documentation
+    #
+    class RecommendationDiversityConfig < Struct.new(
+      :enabled,
+      :values)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Configuration settings that define the behavior and parameters of a
     # recommender.
     #
@@ -8833,6 +8917,12 @@ module Aws::CustomerProfiles
     #   IncludedColumns — both cannot be specified in the same request.
     #   @return [Hash<String,Array<String>>]
     #
+    # @!attribute [rw] diversity_config
+    #   Configuration for diversity-aware recommendations. When set, the
+    #   recommender applies diversity constraints defined per item column to
+    #   reduce over-concentration of similar items in the results.
+    #   @return [Types::DiversityConfig]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/customer-profiles-2020-08-15/RecommenderConfig AWS API Documentation
     #
     class RecommenderConfig < Struct.new(
@@ -8840,7 +8930,8 @@ module Aws::CustomerProfiles
       :training_frequency,
       :inference_config,
       :included_columns,
-      :excluded_columns)
+      :excluded_columns,
+      :diversity_config)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -9129,6 +9220,11 @@ module Aws::CustomerProfiles
     #   If the update operation failed, provides the reason for the failure.
     #   @return [String]
     #
+    # @!attribute [rw] recommender_version_name
+    #   The name of the recommender version associated with this update
+    #   operation.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/customer-profiles-2020-08-15/RecommenderUpdate AWS API Documentation
     #
     class RecommenderUpdate < Struct.new(
@@ -9136,7 +9232,8 @@ module Aws::CustomerProfiles
       :status,
       :created_at,
       :last_updated_at,
-      :failure_reason)
+      :failure_reason,
+      :recommender_version_name)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -9991,11 +10088,17 @@ module Aws::CustomerProfiles
     #   process.
     #   @return [Hash<String,Float>]
     #
+    # @!attribute [rw] recommender_version_name
+    #   The name of the recommender version that produced these training
+    #   metrics.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/customer-profiles-2020-08-15/TrainingMetrics AWS API Documentation
     #
     class TrainingMetrics < Struct.new(
       :time,
-      :metrics)
+      :metrics,
+      :recommender_version_name)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -10773,13 +10876,20 @@ module Aws::CustomerProfiles
     #   including updated parameters and settings that define its behavior.
     #   @return [Types::RecommenderConfig]
     #
+    # @!attribute [rw] recommender_version_name
+    #   The name of a specific recommender version to activate as part of
+    #   this update (for example, to roll back to a previously trained
+    #   version).
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/customer-profiles-2020-08-15/UpdateRecommenderRequest AWS API Documentation
     #
     class UpdateRecommenderRequest < Struct.new(
       :domain_name,
       :recommender_name,
       :description,
-      :recommender_config)
+      :recommender_config,
+      :recommender_version_name)
       SENSITIVE = [:description]
       include Aws::Structure
     end

data/lib/aws-sdk-customerprofiles.rb

@@ -54,7 +54,7 @@ module Aws::CustomerProfiles
   autoload :EndpointProvider, 'aws-sdk-customerprofiles/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-customerprofiles/endpoints'
 
-  GEM_VERSION = '1.90.0'
+  GEM_VERSION = '1.91.0'
 
 end
 

data/sig/client.rbs

@@ -995,6 +995,10 @@ module Aws
                                          ?max_results: ::Integer,
                                          ?metadata_config: {
                                            metadata_columns: Array[::String]?
+                                         },
+                                         ?diversity_config: {
+                                           enabled: bool,
+                                           values: Hash[::String, ::Integer]?
                                          }
                                        ) -> _GetProfileRecommendationsResponseSuccess
                                      | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _GetProfileRecommendationsResponseSuccess
@@ -1011,6 +1015,7 @@ module Aws
         def created_at: () -> ::Time
         def failure_reason: () -> ::String
         def latest_recommender_update: () -> Types::RecommenderUpdate
+        def active_recommender_version_name: () -> ::String
         def training_metrics: () -> ::Array[Types::TrainingMetrics]
         def tags: () -> ::Hash[::String, ::String]
       end
@@ -1943,7 +1948,8 @@ module Aws
                                 domain_name: ::String,
                                 recommender_name: ::String,
                                 ?description: ::String,
-                                ?recommender_config: Params::recommender_config
+                                ?recommender_config: Params::recommender_config,
+                                ?recommender_version_name: ::String
                               ) -> _UpdateRecommenderResponseSuccess
                             | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _UpdateRecommenderResponseSuccess
     end

data/sig/params.rbs

@@ -235,7 +235,16 @@ module Aws
         min_provisioned_tps: ::Integer?
       }?,
       included_columns: Hash[::String, Array[::String]]?,
-      excluded_columns: Hash[::String, Array[::String]]?
+      excluded_columns: Hash[::String, Array[::String]]?,
+      diversity_config: {
+        diversity_columns: Array[
+          {
+            name: ::String,
+            cap_type: ("PERCENTAGE" | "VALUE"),
+            target: ::String
+          }
+        ]?
+      }?
     }
 
       type group = {

data/sig/types.rbs

@@ -797,6 +797,18 @@ module Aws::CustomerProfiles
       end
     end
 
+    class DiversityColumn
+      attr_accessor name: ::String
+      attr_accessor cap_type: ("PERCENTAGE" | "VALUE")
+      attr_accessor target: ::String
+      SENSITIVE: []
+    end
+
+    class DiversityConfig
+      attr_accessor diversity_columns: ::Array[Types::DiversityColumn]
+      SENSITIVE: []
+    end
+
     class DomainObjectTypeField
       attr_accessor source: ::String
       attr_accessor target: ::String
@@ -1275,6 +1287,7 @@ module Aws::CustomerProfiles
       attr_accessor candidate_ids: ::Array[::String]
       attr_accessor max_results: ::Integer
       attr_accessor metadata_config: Types::MetadataConfig
+      attr_accessor diversity_config: Types::RecommendationDiversityConfig
       SENSITIVE: [:context]
     end
 
@@ -1319,6 +1332,7 @@ module Aws::CustomerProfiles
       attr_accessor created_at: ::Time
       attr_accessor failure_reason: ::String
       attr_accessor latest_recommender_update: Types::RecommenderUpdate
+      attr_accessor active_recommender_version_name: ::String
       attr_accessor training_metrics: ::Array[Types::TrainingMetrics]
       attr_accessor tags: ::Hash[::String, ::String]
       SENSITIVE: [:description]
@@ -2308,12 +2322,19 @@ module Aws::CustomerProfiles
       SENSITIVE: []
     end
 
+    class RecommendationDiversityConfig
+      attr_accessor enabled: bool
+      attr_accessor values: ::Hash[::String, ::Integer]
+      SENSITIVE: []
+    end
+
     class RecommenderConfig
       attr_accessor events_config: Types::EventsConfig
       attr_accessor training_frequency: ::Integer
       attr_accessor inference_config: Types::InferenceConfig
       attr_accessor included_columns: ::Hash[::String, ::Array[::String]]
       attr_accessor excluded_columns: ::Hash[::String, ::Array[::String]]
+      attr_accessor diversity_config: Types::DiversityConfig
       SENSITIVE: []
     end
 
@@ -2385,6 +2406,7 @@ module Aws::CustomerProfiles
       attr_accessor created_at: ::Time
       attr_accessor last_updated_at: ::Time
       attr_accessor failure_reason: ::String
+      attr_accessor recommender_version_name: ::String
       SENSITIVE: []
     end
 
@@ -2607,6 +2629,7 @@ module Aws::CustomerProfiles
     class TrainingMetrics
       attr_accessor time: ::Time
       attr_accessor metrics: ::Hash[("hit" | "coverage" | "recall" | "popularity" | "freshness" | "similarity" | "mean_reciprocal_rank_at_25" | "normalized_discounted_cumulative_gain_at_5" | "normalized_discounted_cumulative_gain_at_10" | "normalized_discounted_cumulative_gain_at_25" | "precision_at_5" | "precision_at_10" | "precision_at_25"), ::Float]
+      attr_accessor recommender_version_name: ::String
       SENSITIVE: []
     end
 
@@ -2785,6 +2808,7 @@ module Aws::CustomerProfiles
       attr_accessor recommender_name: ::String
       attr_accessor description: ::String
       attr_accessor recommender_config: Types::RecommenderConfig
+      attr_accessor recommender_version_name: ::String
       SENSITIVE: [:description]
     end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-customerprofiles
 version: !ruby/object:Gem::Version
-  version: 1.90.0
+  version: 1.91.0
 platform: ruby
 authors:
 - Amazon Web Services