本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 準備批次建議的輸入資料 批次推論任務會從 Amazon S3 儲存貯體匯入批次輸入 JSON 資料，使用您的自訂解決方案版本來產生建議，然後將項目建議匯出至 Amazon S3 儲存貯體。您必須先準備 JSON 檔案並將其上傳至 Amazon S3 儲存貯體，才能取得批次建議。建議您在 Amazon S3 儲存貯體中建立輸出資料夾，或使用個別的輸出 Amazon S3 儲存貯體。然後，您可以使用相同的輸入資料位置執行多個批次推論任務。 如果您使用具有預留位置參數的篩選條件，例如 `$GENRE`，則必須提供輸入 JSON 中`filterValues`物件中參數的值。如需詳細資訊，請參閱[在輸入 JSON 中提供篩選條件值](filter-batch.md#providing-filter-values)。 **準備和匯入資料** 1. 根據您的配方格式化批次輸入資料。您無法透過 Trending-Now 配方取得批次建議。 + 對於 USER\$1PERSONALIZATION 配方和熱門計數配方，您的輸入資料是具有 userIds清單的 JSON 檔案 + 對於 RELATED\$1ITEMS 配方，您的輸入資料是 itemIds的清單 + 對於個人化\$1RANKING 配方，您的輸入資料是 userIds 的清單，每個都與 itemIds 的集合配對 使用新行分隔每一列。如需輸入資料範例，請參閱 [批次推論任務輸入和輸出 JSON 範例](#batch-inference-job-json-examples)。 1. 將輸入 JSON 上傳至 Amazon S3 儲存貯體中的輸入資料夾。如需詳細資訊，請參閱《*Amazon Simple Storage Service 使用者指南*》中的[使用拖放功能上傳檔案和資料夾](https://docs.aws.amazon.com/AmazonS3/latest/user-guide/upload-objects.html) 1. 為您的輸出資料建立個別的位置，可以是資料夾或不同的 Amazon S3 儲存貯體。透過為輸出 JSON 建立個別位置，您可以使用相同的輸入資料位置執行多個批次推論任務。 1. 建立批次推論任務。Amazon Personalize 會將建議從解決方案版本輸出到輸出資料位置。 ## 批次推論任務輸入和輸出 JSON 範例 如何使用配方來格式化輸入資料。如果您使用具有預留位置參數的篩選條件，例如 `$GENRE`，則必須提供輸入 JSON 中`filterValues`物件中參數的值。如需詳細資訊，請參閱[在輸入 JSON 中提供篩選條件值](filter-batch.md#providing-filter-values)。 下列各節列出批次推論任務的正確格式 JSON 輸入和輸出範例。您無法透過 Trending-Now 配方取得批次建議。 **Topics** + [USER\$1PERSONALIZATION 配方](#batch-input-user-personalization) + [POPULAR\$1ITEMS 配方 （僅限opularity-Count)](#batch-input-popular-items) + [PERSONALIZED\$1RANKING 配方](#batch-input-ranking) + [RELATED\$1ITEMS 配方](#batch-input-related-items) ### USER\$1PERSONALIZATION 配方 以下顯示 USER\$1PERSONALIZATION 配方的正確格式 JSON 輸入和輸出範例。如果您使用 User-Personalization-v2，則每個建議項目都會包含項目包含在建議中的原因清單。此清單可以是空的。如需可能原因的資訊，請參閱 [User-Personalization-v2 的建議原因](recommendations.md#recommendation-reasons)。 ------ #### [ Input ] `userId` 以新行分隔每個行，如下所示。 ``` {"userId": "4638"} {"userId": "663"} {"userId": "3384"} ... ``` ------ #### [ Output ] ``` {"input":{"userId":"4638"},"output":{"recommendedItems":["63992","115149","110102","148626","148888","31685","102445","69526","92535","143355","62374","7451","56171","122882","66097","91542","142488","139385","40583","71530","39292","111360","34048","47099","135137"],"scores":[0.0152238,0.0069081,0.0068222,0.006394,0.0059746,0.0055851,0.0049357,0.0044644,0.0042968,0.004015,0.0038805,0.0037476,0.0036563,0.0036178,0.00341,0.0033467,0.0033258,0.0032454,0.0032076,0.0031996,0.0029558,0.0029021,0.0029007,0.0028837,0.0028316]},"error":null} {"input":{"userId":"663"},"output":{"recommendedItems":["368","377","25","780","1610","648","1270","6","165","1196","1097","300","1183","608","104","474","736","293","141","2987","1265","2716","223","733","2028"],"scores":[0.0406197,0.0372557,0.0254077,0.0151975,0.014991,0.0127175,0.0124547,0.0116712,0.0091098,0.0085492,0.0079035,0.0078995,0.0075598,0.0074876,0.0072006,0.0071775,0.0068923,0.0066552,0.0066232,0.0062504,0.0062386,0.0061121,0.0060942,0.0060781,0.0059263]},"error":null} {"input":{"userId":"3384"},"output":{"recommendedItems":["597","21","223","2144","208","2424","594","595","920","104","520","367","2081","39","1035","2054","160","1370","48","1092","158","2671","500","474","1907"],"scores":[0.0241061,0.0119394,0.0118012,0.010662,0.0086972,0.0079428,0.0073218,0.0071438,0.0069602,0.0056961,0.0055999,0.005577,0.0054387,0.0051787,0.0051412,0.0050493,0.0047126,0.0045393,0.0042159,0.0042098,0.004205,0.0042029,0.0040778,0.0038897,0.0038809]},"error":null} ... ``` ------ ### POPULAR\$1ITEMS 配方 （僅限opularity-Count) 以下顯示熱門計數配方的正確格式 JSON 輸入和輸出範例。您無法透過 Trending-Now 配方取得批次建議。 ------ #### [ Input ] `userId` 以新行分隔每個行，如下所示。 ``` {"userId": "12"} {"userId": "105"} {"userId": "41"} ... ``` ------ #### [ Output ] ``` {"input": {"userId": "12"}, "output": {"recommendedItems": ["105", "106", "441"]}} {"input": {"userId": "105"}, "output": {"recommendedItems": ["105", "106", "441"]}} {"input": {"userId": "41"}, "output": {"recommendedItems": ["105", "106", "441"]}} ... ``` ------ ### PERSONALIZED\$1RANKING 配方 以下顯示正確格式化的 PersonalIZED\$1RANKING 配方 JSON 輸入和輸出範例。 ------ #### [ Input ] 使用新行分隔`itemIds`要排名的每個 `userId`和 清單，如下所示。 ``` {"userId": "891", "itemList": ["27", "886", "101"]} {"userId": "445", "itemList": ["527", "55", "901"]} {"userId": "71", "itemList": ["27", "351", "101"]} ... ``` ------ #### [ Output ] ``` {"input":{"userId":"891","itemList":["27","886","101"]},"output":{"recommendedItems":["27","101","886"],"scores":[0.48421,0.28133,0.23446]}} {"input":{"userId":"445","itemList":["527","55","901"]},"output":{"recommendedItems":["901","527","55"],"scores":[0.46972,0.31011,0.22017]}} {"input":{"userId":"71","itemList":["29","351","199"]},"output":{"recommendedItems":["351","29","199"],"scores":[0.68937,0.24829,0.06232]}} ... ``` ------ ### RELATED\$1ITEMS 配方 以下顯示 RELATED\$1ITEMS 配方的正確格式 JSON 輸入和輸出範例。 ------ #### [ Input ] `itemId` 以新行分隔每個行，如下所示。 ``` {"itemId": "105"} {"itemId": "106"} {"itemId": "441"} ... ``` ------ #### [ Output ] ``` {"input": {"itemId": "105"}, "output": {"recommendedItems": ["106", "107", "49"]}} {"input": {"itemId": "106"}, "output": {"recommendedItems": ["105", "107", "49"]}} {"input": {"itemId": "441"}, "output": {"recommendedItems": ["2", "442", "435"]}} ... ``` ------ 以下顯示具有主題的相似項目配方的正確格式 JSON 輸入和輸出範例。 ------ #### [ Input ] `itemId` 以新行分隔每個行，如下所示。 ``` {"itemId": "40"} {"itemId": "43"} ... ``` ------ #### [ Output ] ``` {"input":{"itemId":"40"},"output":{"recommendedItems":["36","50","44","22","21","29","3","1","2","39"],"theme":"Movies with a strong female lead","itemsThemeRelevanceScores":[0.19994527,0.183059963,0.17478035,0.1618133,0.1574806,0.15468733,0.1499242,0.14353688,0.13531424,0.10291852]}} {"input":{"itemId":"43"},"output":{"recommendedItems":["50","21","36","3","17","2","39","1","10","5"],"theme":"The best movies of 1995","itemsThemeRelevanceScores":[0.184988,0.1795761,0.11143453,0.0989443,0.08258403,0.07952615,0.07115086,0.0621634,-0.138913,-0.188913]}} ... ``` ------