本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在 Amazon Personalize 中的網域建議程式建議中啟用中繼資料
<a name="create-recommender-return-metadata"></a>

**重要**  
當您在建議中啟用中繼資料時，會產生額外費用。如需詳細資訊，請參閱 [Amazon Personalize 定價](https://aws.amazon.com/personalize/pricing/)。

建立建議者時，您可以啟用 選項，將項目資料集中的項目中繼資料與建議結果一起包含。如果啟用，您可以在建議請求中指定項目資料集中的資料欄。Amazon Personalize 會針對建議回應中的每個項目傳回此資料。

您可以使用中繼資料來豐富使用者介面中的建議，例如將電影的類型新增至輪跳功能。或者，您可以使用它來視覺化評估建議品質。如果您在應用程式中使用生成式 AI，您可以將中繼資料插入 AI 提示，以產生更相關的內容。如需將 Amazon Personalize 與生成式 AI 搭配使用的詳細資訊，請參閱 [Amazon Personalize 和生成式 AI](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>

如果您有項目資料集，且希望 選項在取得建議時包含中繼資料，請在 `true`中`enableMetadataWithRecommendations`將 設定為 `recommender-config`。

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

## 啟用中繼資料 (AWS SDKS)
<a name="domain-config-enable-metadata-sdk"></a>

如果您有項目資料集，且希望 選項在取得建議時包含中繼資料，請在 `true`中`enableMetadataWithRecommendations`將 設定為 `recommender-config`。

```
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)
```