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

# 使用自定义资源获取批量物品推荐
<a name="getting-batch-recommendations"></a>

 借助自定义资源，您可以通过异步批量流获得物品建议。例如，您可以获取电子邮件列表中所有用户的产品建议，或者获得库存中的[物品间相似度](native-recipe-similar-items.md)。

 要获取物品的批量建议，您可以使用批量推理作业。*批量推理作业* 是一种工具，可从 Amazon S3 存储桶导入您的批量输入数据，使用您的自定义解决方案版本生成*物品建议*，然后将物品建议导出到 Amazon S3 存储桶。根据食谱，您的输入数据是用户或物品列表，或者是用户列表，每个用户列表都含有一组物品。

 如果您的解决方案使用 Similar Items 配方，并且您的物品数据集包含文本数据和物品标题数据，则可以为每组物品生成带有主题的批量建议。有关更多信息，请参阅 [内容生成器中带有主题的批量建议](themed-batch-recommendations.md)。

 创建自定义解决方案版本后，新数据如何影响批量物品推荐取决于其类型、导入方法和所用的自定义配方。有关新数据如何影响批量推荐的信息，请参阅[新数据如何影响批量推荐（自定义资源）](how-new-data-influences-batch-recommendations.md)。

**Topics**
+ [批量工作流程](#batch-worfklow-steps)
+ [指南和要求](#batch-permissions-req)
+ [批量工作流程评分](#batch-scoring)
+ [内容生成器中带有主题的批量建议](themed-batch-recommendations.md)
+ [为批量建议准备输入数据](batch-data-upload.md)
+ [创建批量推理作业](creating-batch-inference-job.md)
+ [批量推理作业输出示例](batch-inference-job-output-examples.md)

## 批量工作流程
<a name="batch-worfklow-steps"></a>

批量工作流程如下所示：

1.  准备好您的输入数据并以 JSON 格式将其上传到 Amazon S3 存储桶。输入数据的格式取决于您使用的食谱。请参阅[为批量建议准备输入数据](batch-data-upload.md)。

1.  为输出数据创建一个单独的位置，可以是文件夹，也可以是其他 Amazon S3 存储桶。

1.  创建批量推理作业。请参阅[创建批量推理作业](creating-batch-inference-job.md)。

1.  批量推理完成后，从 Amazon S3 中的输出位置检索物品建议。

## 指南和要求
<a name="batch-permissions-req"></a>

以下是获取批量建议的指南和要求：
+ 您的 Amazon Personalize IAM 服务角色必须有权读取文件并将其添加到您的 Amazon S3 存储桶。有关授予权限的信息，请参阅[批量工作流程的服务角色策略](granting-personalize-s3-access.md#role-policy-for-batch-workflows)。有关存储桶权限的更多信息，请参阅《Amazon Simple Storage Service 开发人员指南》**中的[用户策略示例](https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-policies-s3.html)。如果您使用 AWS Key Management Service (AWS KMS) 进行加密，则必须向 Amazon Personalize 和 Amazon Personalize IAM 服务角色授予使用您密钥的权限。有关更多信息，请参阅 [授予 Amazon Personalize 使用您的 AWS KMS 密钥的权限](granting-personalize-key-access.md)。
+  在创建批量推理作业之前，必须创建自定义解决方案和解决方案版本。不过，您无需创建 Amazon Personalize 市场活动。如果您创建了域数据集组，则仍然可以创建自定义资源。
+  要生成带有建议的主题，您必须使用 Similar-Items 配方。而且您必须有一个包含文本数据和物品标题数据的物品数据集。有关带有主题的建议的更多信息，请参阅[内容生成器中带有主题的批量建议](themed-batch-recommendations.md)。
+  输入数据的格式必须按[为用户细分准备输入数据](prepare-input-data-user-segment.md)所述来设置。
+ 您无法通过 Trending-Now 或 Next-Best-Action 配方获得批量建议。
+ 如果您使用带有占位符参数的筛选器，则必须在 `filterValues` 对象的输入数据中包含参数的值。有关更多信息，请参阅 [在您的输入 JSON 中提供筛选器值](filter-batch.md#providing-filter-values)。
+ 我们建议您使用与输入数据不同的位置来存储输出数据（文件夹或其他 Amazon S3 存储桶）。
+  批量推荐可能与实时推荐不完全相同。这是因为批量推理作业需要更长的时间才能完成，并且仅考虑作业开始前 15 分钟可用的数据。

## 批量工作流程评分
<a name="batch-scoring"></a>

批量建议包括以下分数：
+ 对于 User-Personalization 和 Personalized-Ranking 食谱，Amazon Personalize 计算批量推理作业建议分数，如 [推荐评分的工作原理（自定义资源）](recommendations.md#how-recommendation-scoring-works)和 [个性化排名评分的工作原理](rankings.md#how-ranking-scoring-works)所述。您可以在批量推理作业的输出 JSON 文件中查看分数。
+  使用 Similar-Items 配方，如果您获得带有主题的批量建议，Amazon Personalize 会根据主题与每个物品的相关程度对每组相关物品进行排名。每个物品都包含从 0 到 1 的分数。分数越高，该物品与主题的关系就越密切。有关带有主题的建议的更多信息，请参阅[内容生成器中带有主题的批量建议](themed-batch-recommendations.md)。