本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 在推荐中为 Amazon Personalize 中的域推荐器启用元数据
<a name="create-recommender-return-metadata"></a>

**重要**  
在建议中启用元数据时，会产生额外成本。有关更多信息，请参阅 [Amazon Personalize 定价](https://aws.amazon.com/personalize/pricing/)。

创建推荐器时，您可以启用该选项，以将物品数据集中的物品元数据与建议结果一起包括在内。如果启用，则可以在建议请求中指定物品数据集中的列。Amazon Personalize 会在建议响应中返回每个物品的这些数据。

您可以使用元数据来丰富用户界面中的建议，例如将电影的类型添加到轮播中。或者，您可以用它来直观地评测建议质量。如果您在应用程序中使用生成式人工智能，则可以将元数据插入人工智能提示中，以生成相关性更高的内容。有关 Amazon Personalize 与生成式人工智能结合使用的更多信息，请参阅[Amazon Personalize 和生成式人工智能](personalize-with-gen-ai.md)。

要向建议添加元数据，您必须拥有包含一列元数据的物品数据集。您不一定要在训练中使用元数据。有关创建数据集的信息，请参阅[创建架构和数据集](data-prep-creating-datasets.md)。有关在数据集中更新数据的信息，请参阅[训练后更新数据集中的数据](updating-datasets.md)。

以下代码示例演示如何启用选项以在 AWS CLI 或中包含项目元数据 AWS SDKs。要使用 Amazon Personalize 控制台执行此操作，请在创建推荐器时在**高级配置**页面上启用元数据。有关更多信息，请参阅 [创建推荐器（控制台）](creating-domain-recommenders.md#creating-recommenders-console)。

## 启用元数据（AWS CLI）
<a name="domain-config-enable-metadata-cli"></a>

如果您有物品数据集，并且希望该选项在您获得建议时包含元数据，请在 `recommender-config` 中将 `enableMetadataWithRecommendations` 设置为 `true`。

```
aws personalize create-recommender \
--name recommender name \
--dataset-group-arn dataset group \
--recipe-arn recipe ARN \
--recommender-config "{\"enableMetadataWithRecommendations\": "true"}"
```

## 启用元数据 (AWS SDK)
<a name="domain-config-enable-metadata-sdk"></a>

如果您有物品数据集，并且希望该选项在您获得建议时包含元数据，请在 `recommender-config` 中将 `enableMetadataWithRecommendations` 设置为 `true`。

```
import boto3

personalize = boto3.client('personalize')

create_recommender_response = personalize.create_recommender(
  name = 'recommender name',
  recipeArn = 'recipe name',
  datasetGroupArn = 'dataset group ARN',
  recommenderConfig = {"enableMetadataWithRecommendations": True}
)

recommender_arn = create_recommender_response['recommenderArn']

print('Recommender ARN:' + recommender_arn)
```