@aws-sdk/client-personalize-runtime 3.379.1 → 3.385.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
|
@@ -5,32 +5,38 @@ import { PersonalizeRuntimeServiceException as __BaseException } from "./Persona
|
|
|
5
5
|
*/
|
|
6
6
|
export interface GetPersonalizedRankingRequest {
|
|
7
7
|
/**
|
|
8
|
+
* @public
|
|
8
9
|
* <p>The Amazon Resource Name (ARN) of the campaign to use for generating the personalized
|
|
9
10
|
* ranking.</p>
|
|
10
11
|
*/
|
|
11
12
|
campaignArn: string | undefined;
|
|
12
13
|
/**
|
|
14
|
+
* @public
|
|
13
15
|
* <p>A list of items (by <code>itemId</code>) to rank. If an item was not included in the training dataset,
|
|
14
16
|
* the item is appended to the end of the reranked list. The maximum is 500.</p>
|
|
15
17
|
*/
|
|
16
18
|
inputList: string[] | undefined;
|
|
17
19
|
/**
|
|
20
|
+
* @public
|
|
18
21
|
* <p>The user for which you want the campaign to provide a personalized ranking.</p>
|
|
19
22
|
*/
|
|
20
23
|
userId: string | undefined;
|
|
21
24
|
/**
|
|
25
|
+
* @public
|
|
22
26
|
* <p>The contextual metadata to use when getting recommendations. Contextual metadata includes
|
|
23
27
|
* any interaction information that might be relevant when getting a user's recommendations, such
|
|
24
28
|
* as the user's current location or device type.</p>
|
|
25
29
|
*/
|
|
26
30
|
context?: Record<string, string>;
|
|
27
31
|
/**
|
|
32
|
+
* @public
|
|
28
33
|
* <p>The Amazon Resource Name (ARN) of a filter you created to include items or exclude items from recommendations for a given user.
|
|
29
34
|
* For more information, see
|
|
30
35
|
* <a href="https://docs.aws.amazon.com/personalize/latest/dg/filter.html">Filtering Recommendations</a>.</p>
|
|
31
36
|
*/
|
|
32
37
|
filterArn?: string;
|
|
33
38
|
/**
|
|
39
|
+
* @public
|
|
34
40
|
* <p>The values to use when filtering recommendations. For each placeholder parameter in your filter expression, provide the parameter name (in matching case)
|
|
35
41
|
* as a key and the filter value(s) as the corresponding value. Separate multiple values for one parameter with a comma.
|
|
36
42
|
* </p>
|
|
@@ -52,15 +58,18 @@ export interface GetPersonalizedRankingRequest {
|
|
|
52
58
|
*/
|
|
53
59
|
export interface PredictedItem {
|
|
54
60
|
/**
|
|
61
|
+
* @public
|
|
55
62
|
* <p>The recommended item ID.</p>
|
|
56
63
|
*/
|
|
57
64
|
itemId?: string;
|
|
58
65
|
/**
|
|
66
|
+
* @public
|
|
59
67
|
* <p>A numeric representation of the model's certainty that the item will be the next user
|
|
60
68
|
* selection. For more information on scoring logic, see <a>how-scores-work</a>.</p>
|
|
61
69
|
*/
|
|
62
70
|
score?: number;
|
|
63
71
|
/**
|
|
72
|
+
* @public
|
|
64
73
|
* <p>The name of the promotion that included the predicted item.</p>
|
|
65
74
|
*/
|
|
66
75
|
promotionName?: string;
|
|
@@ -70,10 +79,12 @@ export interface PredictedItem {
|
|
|
70
79
|
*/
|
|
71
80
|
export interface GetPersonalizedRankingResponse {
|
|
72
81
|
/**
|
|
82
|
+
* @public
|
|
73
83
|
* <p>A list of items in order of most likely interest to the user. The maximum is 500.</p>
|
|
74
84
|
*/
|
|
75
85
|
personalizedRanking?: PredictedItem[];
|
|
76
86
|
/**
|
|
87
|
+
* @public
|
|
77
88
|
* <p>The ID of the recommendation.</p>
|
|
78
89
|
*/
|
|
79
90
|
recommendationId?: string;
|
|
@@ -108,19 +119,23 @@ export declare class ResourceNotFoundException extends __BaseException {
|
|
|
108
119
|
*/
|
|
109
120
|
export interface Promotion {
|
|
110
121
|
/**
|
|
122
|
+
* @public
|
|
111
123
|
* <p>The name of the promotion.</p>
|
|
112
124
|
*/
|
|
113
125
|
name?: string;
|
|
114
126
|
/**
|
|
127
|
+
* @public
|
|
115
128
|
* <p>The percentage of recommended items to apply the promotion to.</p>
|
|
116
129
|
*/
|
|
117
130
|
percentPromotedItems?: number;
|
|
118
131
|
/**
|
|
132
|
+
* @public
|
|
119
133
|
* <p>The Amazon Resource Name (ARN) of the filter used by the promotion. This filter defines the criteria for promoted items. For more information, see
|
|
120
134
|
* <a href="https://docs.aws.amazon.com/personalize/latest/dg/promoting-items.html#promotion-filters">Promotion filters</a>.</p>
|
|
121
135
|
*/
|
|
122
136
|
filterArn?: string;
|
|
123
137
|
/**
|
|
138
|
+
* @public
|
|
124
139
|
* <p>The values to use when promoting items.
|
|
125
140
|
* For each placeholder parameter in your promotion's filter expression, provide the parameter name (in matching case) as a key and the filter value(s) as the corresponding value. Separate multiple values for one parameter with a comma.
|
|
126
141
|
* </p>
|
|
@@ -139,36 +154,43 @@ export interface Promotion {
|
|
|
139
154
|
*/
|
|
140
155
|
export interface GetRecommendationsRequest {
|
|
141
156
|
/**
|
|
157
|
+
* @public
|
|
142
158
|
* <p>The Amazon Resource Name (ARN) of the campaign to use for getting recommendations.</p>
|
|
143
159
|
*/
|
|
144
160
|
campaignArn?: string;
|
|
145
161
|
/**
|
|
162
|
+
* @public
|
|
146
163
|
* <p>The item ID to provide recommendations for.</p>
|
|
147
164
|
* <p>Required for <code>RELATED_ITEMS</code> recipe type.</p>
|
|
148
165
|
*/
|
|
149
166
|
itemId?: string;
|
|
150
167
|
/**
|
|
168
|
+
* @public
|
|
151
169
|
* <p>The user ID to provide recommendations for.</p>
|
|
152
170
|
* <p>Required for <code>USER_PERSONALIZATION</code> recipe type.</p>
|
|
153
171
|
*/
|
|
154
172
|
userId?: string;
|
|
155
173
|
/**
|
|
174
|
+
* @public
|
|
156
175
|
* <p>The number of results to return. The default is 25. The maximum is 500.</p>
|
|
157
176
|
*/
|
|
158
177
|
numResults?: number;
|
|
159
178
|
/**
|
|
179
|
+
* @public
|
|
160
180
|
* <p>The contextual metadata to use when getting recommendations. Contextual metadata includes
|
|
161
181
|
* any interaction information that might be relevant when getting a user's recommendations, such
|
|
162
182
|
* as the user's current location or device type.</p>
|
|
163
183
|
*/
|
|
164
184
|
context?: Record<string, string>;
|
|
165
185
|
/**
|
|
186
|
+
* @public
|
|
166
187
|
* <p>The ARN of the filter to apply to the returned recommendations. For more information, see
|
|
167
188
|
* <a href="https://docs.aws.amazon.com/personalize/latest/dg/filter.html">Filtering Recommendations</a>.</p>
|
|
168
189
|
* <p>When using this parameter, be sure the filter resource is <code>ACTIVE</code>.</p>
|
|
169
190
|
*/
|
|
170
191
|
filterArn?: string;
|
|
171
192
|
/**
|
|
193
|
+
* @public
|
|
172
194
|
* <p>The values to use when filtering recommendations. For each placeholder parameter in your filter expression, provide the parameter name (in matching case)
|
|
173
195
|
* as a key and the filter value(s) as the corresponding value. Separate multiple values for one parameter with a comma.
|
|
174
196
|
* </p>
|
|
@@ -182,11 +204,13 @@ export interface GetRecommendationsRequest {
|
|
|
182
204
|
*/
|
|
183
205
|
filterValues?: Record<string, string>;
|
|
184
206
|
/**
|
|
207
|
+
* @public
|
|
185
208
|
* <p>The Amazon Resource Name (ARN) of the recommender to use to get recommendations. Provide a recommender ARN if you
|
|
186
209
|
* created a Domain dataset group with a recommender for a domain use case.</p>
|
|
187
210
|
*/
|
|
188
211
|
recommenderArn?: string;
|
|
189
212
|
/**
|
|
213
|
+
* @public
|
|
190
214
|
* <p>The promotions to apply to the recommendation request.
|
|
191
215
|
* A promotion defines additional business rules that apply to a configurable subset of recommended items.</p>
|
|
192
216
|
*/
|
|
@@ -197,11 +221,13 @@ export interface GetRecommendationsRequest {
|
|
|
197
221
|
*/
|
|
198
222
|
export interface GetRecommendationsResponse {
|
|
199
223
|
/**
|
|
224
|
+
* @public
|
|
200
225
|
* <p>A list of recommendations sorted in descending order by prediction score. There can be a
|
|
201
226
|
* maximum of 500 items in the list.</p>
|
|
202
227
|
*/
|
|
203
228
|
itemList?: PredictedItem[];
|
|
204
229
|
/**
|
|
230
|
+
* @public
|
|
205
231
|
* <p>The ID of the recommendation.</p>
|
|
206
232
|
*/
|
|
207
233
|
recommendationId?: string;
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@aws-sdk/client-personalize-runtime",
|
|
3
3
|
"description": "AWS SDK for JavaScript Personalize Runtime Client for Node.js, Browser and React Native",
|
|
4
|
-
"version": "3.
|
|
4
|
+
"version": "3.385.0",
|
|
5
5
|
"scripts": {
|
|
6
6
|
"build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
|
|
7
7
|
"build:cjs": "tsc -p tsconfig.cjs.json",
|
|
@@ -21,15 +21,15 @@
|
|
|
21
21
|
"dependencies": {
|
|
22
22
|
"@aws-crypto/sha256-browser": "3.0.0",
|
|
23
23
|
"@aws-crypto/sha256-js": "3.0.0",
|
|
24
|
-
"@aws-sdk/client-sts": "3.
|
|
25
|
-
"@aws-sdk/credential-provider-node": "3.
|
|
24
|
+
"@aws-sdk/client-sts": "3.385.0",
|
|
25
|
+
"@aws-sdk/credential-provider-node": "3.385.0",
|
|
26
26
|
"@aws-sdk/middleware-host-header": "3.379.1",
|
|
27
27
|
"@aws-sdk/middleware-logger": "3.378.0",
|
|
28
28
|
"@aws-sdk/middleware-recursion-detection": "3.378.0",
|
|
29
29
|
"@aws-sdk/middleware-signing": "3.379.1",
|
|
30
|
-
"@aws-sdk/middleware-user-agent": "3.
|
|
30
|
+
"@aws-sdk/middleware-user-agent": "3.382.0",
|
|
31
31
|
"@aws-sdk/types": "3.378.0",
|
|
32
|
-
"@aws-sdk/util-endpoints": "3.
|
|
32
|
+
"@aws-sdk/util-endpoints": "3.382.0",
|
|
33
33
|
"@aws-sdk/util-user-agent-browser": "3.378.0",
|
|
34
34
|
"@aws-sdk/util-user-agent-node": "3.378.0",
|
|
35
35
|
"@smithy/config-resolver": "^2.0.1",
|