@aws-sdk/client-kendra 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.
|
@@ -10,15 +10,18 @@ import { AdditionalResultAttribute, AttributeSuggestionsUpdateConfig, CapacityUn
|
|
|
10
10
|
*/
|
|
11
11
|
export interface QueryResultItem {
|
|
12
12
|
/**
|
|
13
|
+
* @public
|
|
13
14
|
* <p>The identifier for the query result.</p>
|
|
14
15
|
*/
|
|
15
16
|
Id?: string;
|
|
16
17
|
/**
|
|
18
|
+
* @public
|
|
17
19
|
* <p>The type of document within the response. For example, a response could include a
|
|
18
20
|
* question-answer that's relevant to the query.</p>
|
|
19
21
|
*/
|
|
20
22
|
Type?: QueryResultType | string;
|
|
21
23
|
/**
|
|
24
|
+
* @public
|
|
22
25
|
* <p>If the <code>Type</code> of document within the response is <code>ANSWER</code>, then it
|
|
23
26
|
* is either a <code>TABLE</code> answer or <code>TEXT</code> answer. If it's a table answer,
|
|
24
27
|
* a table excerpt is returned in <code>TableExcerpt</code>. If it's a text answer, a text
|
|
@@ -26,34 +29,41 @@ export interface QueryResultItem {
|
|
|
26
29
|
*/
|
|
27
30
|
Format?: QueryResultFormat | string;
|
|
28
31
|
/**
|
|
32
|
+
* @public
|
|
29
33
|
* <p>One or more additional fields/attributes associated with the query result.</p>
|
|
30
34
|
*/
|
|
31
35
|
AdditionalAttributes?: AdditionalResultAttribute[];
|
|
32
36
|
/**
|
|
37
|
+
* @public
|
|
33
38
|
* <p>The identifier for the document.</p>
|
|
34
39
|
*/
|
|
35
40
|
DocumentId?: string;
|
|
36
41
|
/**
|
|
42
|
+
* @public
|
|
37
43
|
* <p>The title of the document. Contains the text of the title and information for
|
|
38
44
|
* highlighting the relevant terms in the title.</p>
|
|
39
45
|
*/
|
|
40
46
|
DocumentTitle?: TextWithHighlights;
|
|
41
47
|
/**
|
|
48
|
+
* @public
|
|
42
49
|
* <p>An extract of the text in the document. Contains information about highlighting the
|
|
43
50
|
* relevant terms in the excerpt.</p>
|
|
44
51
|
*/
|
|
45
52
|
DocumentExcerpt?: TextWithHighlights;
|
|
46
53
|
/**
|
|
54
|
+
* @public
|
|
47
55
|
* <p>The URI of the original location of the document.</p>
|
|
48
56
|
*/
|
|
49
57
|
DocumentURI?: string;
|
|
50
58
|
/**
|
|
59
|
+
* @public
|
|
51
60
|
* <p>An array of document fields/attributes assigned to a document in the search results.
|
|
52
61
|
* For example, the document author (<code>_author</code>) or the source URI
|
|
53
62
|
* (<code>_source_uri</code>) of the document.</p>
|
|
54
63
|
*/
|
|
55
64
|
DocumentAttributes?: DocumentAttribute[];
|
|
56
65
|
/**
|
|
66
|
+
* @public
|
|
57
67
|
* <p>Indicates the confidence level of Amazon Kendra providing a relevant result for
|
|
58
68
|
* the query. Each result is placed into a bin that indicates the confidence,
|
|
59
69
|
* <code>VERY_HIGH</code>, <code>HIGH</code>, <code>MEDIUM</code> and <code>LOW</code>.
|
|
@@ -65,11 +75,13 @@ export interface QueryResultItem {
|
|
|
65
75
|
*/
|
|
66
76
|
ScoreAttributes?: ScoreAttributes;
|
|
67
77
|
/**
|
|
78
|
+
* @public
|
|
68
79
|
* <p>A token that identifies a particular result from a particular query. Use this token to
|
|
69
80
|
* provide click-through feedback for the result. For more information, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/submitting-feedback.html">Submitting feedback</a>.</p>
|
|
70
81
|
*/
|
|
71
82
|
FeedbackToken?: string;
|
|
72
83
|
/**
|
|
84
|
+
* @public
|
|
73
85
|
* <p>An excerpt from a table within a document.</p>
|
|
74
86
|
*/
|
|
75
87
|
TableExcerpt?: TableExcerpt;
|
|
@@ -80,20 +92,24 @@ export interface QueryResultItem {
|
|
|
80
92
|
*/
|
|
81
93
|
export interface Correction {
|
|
82
94
|
/**
|
|
95
|
+
* @public
|
|
83
96
|
* <p>The zero-based location in the response string or text where
|
|
84
97
|
* the corrected word starts.</p>
|
|
85
98
|
*/
|
|
86
99
|
BeginOffset?: number;
|
|
87
100
|
/**
|
|
101
|
+
* @public
|
|
88
102
|
* <p>The zero-based location in the response string or text where
|
|
89
103
|
* the corrected word ends.</p>
|
|
90
104
|
*/
|
|
91
105
|
EndOffset?: number;
|
|
92
106
|
/**
|
|
107
|
+
* @public
|
|
93
108
|
* <p>The string or text of a misspelled word in a query.</p>
|
|
94
109
|
*/
|
|
95
110
|
Term?: string;
|
|
96
111
|
/**
|
|
112
|
+
* @public
|
|
97
113
|
* <p>The string or text of a corrected misspelled word in a query.</p>
|
|
98
114
|
*/
|
|
99
115
|
CorrectedTerm?: string;
|
|
@@ -104,10 +120,12 @@ export interface Correction {
|
|
|
104
120
|
*/
|
|
105
121
|
export interface SpellCorrectedQuery {
|
|
106
122
|
/**
|
|
123
|
+
* @public
|
|
107
124
|
* <p>The query with the suggested spell corrections.</p>
|
|
108
125
|
*/
|
|
109
126
|
SuggestedQueryText?: string;
|
|
110
127
|
/**
|
|
128
|
+
* @public
|
|
111
129
|
* <p>The corrected misspelled word or words in a query.</p>
|
|
112
130
|
*/
|
|
113
131
|
Corrections?: Correction[];
|
|
@@ -129,10 +147,12 @@ export type WarningCode = (typeof WarningCode)[keyof typeof WarningCode];
|
|
|
129
147
|
*/
|
|
130
148
|
export interface Warning {
|
|
131
149
|
/**
|
|
150
|
+
* @public
|
|
132
151
|
* <p>The message that explains the problem with the query.</p>
|
|
133
152
|
*/
|
|
134
153
|
Message?: string;
|
|
135
154
|
/**
|
|
155
|
+
* @public
|
|
136
156
|
* <p>The code used to show the type of warning for the query.</p>
|
|
137
157
|
*/
|
|
138
158
|
Code?: WarningCode | string;
|
|
@@ -143,26 +163,32 @@ export interface Warning {
|
|
|
143
163
|
*/
|
|
144
164
|
export interface RetrieveResultItem {
|
|
145
165
|
/**
|
|
166
|
+
* @public
|
|
146
167
|
* <p>The identifier of the relevant passage result.</p>
|
|
147
168
|
*/
|
|
148
169
|
Id?: string;
|
|
149
170
|
/**
|
|
171
|
+
* @public
|
|
150
172
|
* <p>The identifier of the document.</p>
|
|
151
173
|
*/
|
|
152
174
|
DocumentId?: string;
|
|
153
175
|
/**
|
|
176
|
+
* @public
|
|
154
177
|
* <p>The title of the document.</p>
|
|
155
178
|
*/
|
|
156
179
|
DocumentTitle?: string;
|
|
157
180
|
/**
|
|
181
|
+
* @public
|
|
158
182
|
* <p>The contents of the relevant passage.</p>
|
|
159
183
|
*/
|
|
160
184
|
Content?: string;
|
|
161
185
|
/**
|
|
186
|
+
* @public
|
|
162
187
|
* <p>The URI of the original location of the document.</p>
|
|
163
188
|
*/
|
|
164
189
|
DocumentURI?: string;
|
|
165
190
|
/**
|
|
191
|
+
* @public
|
|
166
192
|
* <p>An array of document fields/attributes assigned to a document in the
|
|
167
193
|
* search results. For example, the document author (<code>_author</code>)
|
|
168
194
|
* or the source URI (<code>_source_uri</code>) of the document.</p>
|
|
@@ -174,11 +200,13 @@ export interface RetrieveResultItem {
|
|
|
174
200
|
*/
|
|
175
201
|
export interface RetrieveResult {
|
|
176
202
|
/**
|
|
203
|
+
* @public
|
|
177
204
|
* <p>The identifier of query used for the search. You also use <code>QueryId</code> to
|
|
178
205
|
* identify the search when using the <a href="https://docs.aws.amazon.com/kendra/latest/APIReference/API_SubmitFeedback.html">Submitfeedback</a> API.</p>
|
|
179
206
|
*/
|
|
180
207
|
QueryId?: string;
|
|
181
208
|
/**
|
|
209
|
+
* @public
|
|
182
210
|
* <p>The results of the retrieved relevant passages for the search.</p>
|
|
183
211
|
*/
|
|
184
212
|
ResultItems?: RetrieveResultItem[];
|
|
@@ -202,10 +230,12 @@ export declare class ResourceInUseException extends __BaseException {
|
|
|
202
230
|
*/
|
|
203
231
|
export interface StartDataSourceSyncJobRequest {
|
|
204
232
|
/**
|
|
233
|
+
* @public
|
|
205
234
|
* <p>The identifier of the data source connector to synchronize.</p>
|
|
206
235
|
*/
|
|
207
236
|
Id: string | undefined;
|
|
208
237
|
/**
|
|
238
|
+
* @public
|
|
209
239
|
* <p>The identifier of the index used with the data source connector.</p>
|
|
210
240
|
*/
|
|
211
241
|
IndexId: string | undefined;
|
|
@@ -215,6 +245,7 @@ export interface StartDataSourceSyncJobRequest {
|
|
|
215
245
|
*/
|
|
216
246
|
export interface StartDataSourceSyncJobResponse {
|
|
217
247
|
/**
|
|
248
|
+
* @public
|
|
218
249
|
* <p>Identifies a particular synchronization job.</p>
|
|
219
250
|
*/
|
|
220
251
|
ExecutionId?: string;
|
|
@@ -224,11 +255,13 @@ export interface StartDataSourceSyncJobResponse {
|
|
|
224
255
|
*/
|
|
225
256
|
export interface StopDataSourceSyncJobRequest {
|
|
226
257
|
/**
|
|
258
|
+
* @public
|
|
227
259
|
* <p>The identifier of the data source connector for which to stop the synchronization
|
|
228
260
|
* jobs.</p>
|
|
229
261
|
*/
|
|
230
262
|
Id: string | undefined;
|
|
231
263
|
/**
|
|
264
|
+
* @public
|
|
232
265
|
* <p>The identifier of the index used with the data source connector.</p>
|
|
233
266
|
*/
|
|
234
267
|
IndexId: string | undefined;
|
|
@@ -241,10 +274,12 @@ export interface StopDataSourceSyncJobRequest {
|
|
|
241
274
|
*/
|
|
242
275
|
export interface ClickFeedback {
|
|
243
276
|
/**
|
|
277
|
+
* @public
|
|
244
278
|
* <p>The identifier of the search result that was clicked.</p>
|
|
245
279
|
*/
|
|
246
280
|
ResultId: string | undefined;
|
|
247
281
|
/**
|
|
282
|
+
* @public
|
|
248
283
|
* <p>The Unix timestamp when the result was clicked.</p>
|
|
249
284
|
*/
|
|
250
285
|
ClickTime: Date | undefined;
|
|
@@ -268,11 +303,13 @@ export type RelevanceType = (typeof RelevanceType)[keyof typeof RelevanceType];
|
|
|
268
303
|
*/
|
|
269
304
|
export interface RelevanceFeedback {
|
|
270
305
|
/**
|
|
306
|
+
* @public
|
|
271
307
|
* <p>The identifier of the search result that the user provided relevance feedback
|
|
272
308
|
* for.</p>
|
|
273
309
|
*/
|
|
274
310
|
ResultId: string | undefined;
|
|
275
311
|
/**
|
|
312
|
+
* @public
|
|
276
313
|
* <p>Whether the document was relevant or not relevant to the search.</p>
|
|
277
314
|
*/
|
|
278
315
|
RelevanceValue: RelevanceType | string | undefined;
|
|
@@ -282,21 +319,25 @@ export interface RelevanceFeedback {
|
|
|
282
319
|
*/
|
|
283
320
|
export interface SubmitFeedbackRequest {
|
|
284
321
|
/**
|
|
322
|
+
* @public
|
|
285
323
|
* <p>The identifier of the index that was queried.</p>
|
|
286
324
|
*/
|
|
287
325
|
IndexId: string | undefined;
|
|
288
326
|
/**
|
|
327
|
+
* @public
|
|
289
328
|
* <p>The identifier of the specific query for which you are submitting
|
|
290
329
|
* feedback. The query ID is returned in the response to the
|
|
291
330
|
* <code>Query</code> API.</p>
|
|
292
331
|
*/
|
|
293
332
|
QueryId: string | undefined;
|
|
294
333
|
/**
|
|
334
|
+
* @public
|
|
295
335
|
* <p>Tells Amazon Kendra that a particular search result link was chosen
|
|
296
336
|
* by the user. </p>
|
|
297
337
|
*/
|
|
298
338
|
ClickFeedbackItems?: ClickFeedback[];
|
|
299
339
|
/**
|
|
340
|
+
* @public
|
|
300
341
|
* <p>Provides Amazon Kendra with relevant or not relevant feedback for
|
|
301
342
|
* whether a particular item was relevant to the search.</p>
|
|
302
343
|
*/
|
|
@@ -307,10 +348,12 @@ export interface SubmitFeedbackRequest {
|
|
|
307
348
|
*/
|
|
308
349
|
export interface TagResourceRequest {
|
|
309
350
|
/**
|
|
351
|
+
* @public
|
|
310
352
|
* <p>The Amazon Resource Name (ARN) of the index, FAQ, or data source to tag.</p>
|
|
311
353
|
*/
|
|
312
354
|
ResourceARN: string | undefined;
|
|
313
355
|
/**
|
|
356
|
+
* @public
|
|
314
357
|
* <p>A list of tag keys to add to the index, FAQ, or data source. If a tag already exists, the
|
|
315
358
|
* existing value is replaced with the new value.</p>
|
|
316
359
|
*/
|
|
@@ -326,11 +369,13 @@ export interface TagResourceResponse {
|
|
|
326
369
|
*/
|
|
327
370
|
export interface UntagResourceRequest {
|
|
328
371
|
/**
|
|
372
|
+
* @public
|
|
329
373
|
* <p>The Amazon Resource Name (ARN) of the index, FAQ, or data source to remove the tag
|
|
330
374
|
* from.</p>
|
|
331
375
|
*/
|
|
332
376
|
ResourceARN: string | undefined;
|
|
333
377
|
/**
|
|
378
|
+
* @public
|
|
334
379
|
* <p>A list of tag keys to remove from the index, FAQ, or data source. If a tag key does not
|
|
335
380
|
* exist on the resource, it is ignored.</p>
|
|
336
381
|
*/
|
|
@@ -346,28 +391,34 @@ export interface UntagResourceResponse {
|
|
|
346
391
|
*/
|
|
347
392
|
export interface UpdateAccessControlConfigurationRequest {
|
|
348
393
|
/**
|
|
394
|
+
* @public
|
|
349
395
|
* <p>The identifier of the index for an access control configuration.</p>
|
|
350
396
|
*/
|
|
351
397
|
IndexId: string | undefined;
|
|
352
398
|
/**
|
|
399
|
+
* @public
|
|
353
400
|
* <p>The identifier of the access control configuration you want to update.</p>
|
|
354
401
|
*/
|
|
355
402
|
Id: string | undefined;
|
|
356
403
|
/**
|
|
404
|
+
* @public
|
|
357
405
|
* <p>A new name for the access control configuration.</p>
|
|
358
406
|
*/
|
|
359
407
|
Name?: string;
|
|
360
408
|
/**
|
|
409
|
+
* @public
|
|
361
410
|
* <p>A new description for the access control configuration.</p>
|
|
362
411
|
*/
|
|
363
412
|
Description?: string;
|
|
364
413
|
/**
|
|
414
|
+
* @public
|
|
365
415
|
* <p>Information you want to update on principals (users and/or groups) and which documents
|
|
366
416
|
* they should have access to. This is useful for user context filtering, where search
|
|
367
417
|
* results are filtered based on the user or their group access to documents.</p>
|
|
368
418
|
*/
|
|
369
419
|
AccessControlList?: Principal[];
|
|
370
420
|
/**
|
|
421
|
+
* @public
|
|
371
422
|
* <p>The updated list of <a href="https://docs.aws.amazon.com/kendra/latest/dg/API_Principal.html">principal</a> lists that define the
|
|
372
423
|
* hierarchy for which documents users should have access to.</p>
|
|
373
424
|
*/
|
|
@@ -383,40 +434,49 @@ export interface UpdateAccessControlConfigurationResponse {
|
|
|
383
434
|
*/
|
|
384
435
|
export interface UpdateDataSourceRequest {
|
|
385
436
|
/**
|
|
437
|
+
* @public
|
|
386
438
|
* <p>The identifier of the data source connector you want to update.</p>
|
|
387
439
|
*/
|
|
388
440
|
Id: string | undefined;
|
|
389
441
|
/**
|
|
442
|
+
* @public
|
|
390
443
|
* <p>A new name for the data source connector.</p>
|
|
391
444
|
*/
|
|
392
445
|
Name?: string;
|
|
393
446
|
/**
|
|
447
|
+
* @public
|
|
394
448
|
* <p>The identifier of the index used with the data source connector.</p>
|
|
395
449
|
*/
|
|
396
450
|
IndexId: string | undefined;
|
|
397
451
|
/**
|
|
452
|
+
* @public
|
|
398
453
|
* <p>Configuration information you want to update for the data source connector.</p>
|
|
399
454
|
*/
|
|
400
455
|
Configuration?: DataSourceConfiguration;
|
|
401
456
|
/**
|
|
457
|
+
* @public
|
|
402
458
|
* <p>Configuration information for an Amazon Virtual Private Cloud to connect to your data source.
|
|
403
459
|
* For more information, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/vpc-configuration.html">Configuring a VPC</a>.</p>
|
|
404
460
|
*/
|
|
405
461
|
VpcConfiguration?: DataSourceVpcConfiguration;
|
|
406
462
|
/**
|
|
463
|
+
* @public
|
|
407
464
|
* <p>A new description for the data source connector.</p>
|
|
408
465
|
*/
|
|
409
466
|
Description?: string;
|
|
410
467
|
/**
|
|
468
|
+
* @public
|
|
411
469
|
* <p>The sync schedule you want to update for the data source connector.</p>
|
|
412
470
|
*/
|
|
413
471
|
Schedule?: string;
|
|
414
472
|
/**
|
|
473
|
+
* @public
|
|
415
474
|
* <p>The Amazon Resource Name (ARN) of a role with permission to access the data source and
|
|
416
475
|
* required resources. For more information, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html">IAM roles for Amazon Kendra</a>.</p>
|
|
417
476
|
*/
|
|
418
477
|
RoleArn?: string;
|
|
419
478
|
/**
|
|
479
|
+
* @public
|
|
420
480
|
* <p>The code for a language you want to update for the data source connector.
|
|
421
481
|
* This allows you to support a language for all
|
|
422
482
|
* documents when updating the data source. English is supported
|
|
@@ -426,6 +486,7 @@ export interface UpdateDataSourceRequest {
|
|
|
426
486
|
*/
|
|
427
487
|
LanguageCode?: string;
|
|
428
488
|
/**
|
|
489
|
+
* @public
|
|
429
490
|
* <p>Configuration information you want to update for altering document metadata and
|
|
430
491
|
* content during the document ingestion process.</p>
|
|
431
492
|
* <p>For more information on how to create, modify and delete document metadata, or make
|
|
@@ -438,18 +499,22 @@ export interface UpdateDataSourceRequest {
|
|
|
438
499
|
*/
|
|
439
500
|
export interface UpdateExperienceRequest {
|
|
440
501
|
/**
|
|
502
|
+
* @public
|
|
441
503
|
* <p>The identifier of your Amazon Kendra experience you want to update.</p>
|
|
442
504
|
*/
|
|
443
505
|
Id: string | undefined;
|
|
444
506
|
/**
|
|
507
|
+
* @public
|
|
445
508
|
* <p>A new name for your Amazon Kendra experience.</p>
|
|
446
509
|
*/
|
|
447
510
|
Name?: string;
|
|
448
511
|
/**
|
|
512
|
+
* @public
|
|
449
513
|
* <p>The identifier of the index for your Amazon Kendra experience.</p>
|
|
450
514
|
*/
|
|
451
515
|
IndexId: string | undefined;
|
|
452
516
|
/**
|
|
517
|
+
* @public
|
|
453
518
|
* <p>The Amazon Resource Name (ARN) of a role with permission to access <code>Query</code>
|
|
454
519
|
* API, <code>QuerySuggestions</code> API, <code>SubmitFeedback</code>
|
|
455
520
|
* API, and IAM Identity Center that stores your user and group information.
|
|
@@ -457,10 +522,12 @@ export interface UpdateExperienceRequest {
|
|
|
457
522
|
*/
|
|
458
523
|
RoleArn?: string;
|
|
459
524
|
/**
|
|
525
|
+
* @public
|
|
460
526
|
* <p>Configuration information you want to update for your Amazon Kendra experience.</p>
|
|
461
527
|
*/
|
|
462
528
|
Configuration?: ExperienceConfiguration;
|
|
463
529
|
/**
|
|
530
|
+
* @public
|
|
464
531
|
* <p>A new description for your Amazon Kendra experience.</p>
|
|
465
532
|
*/
|
|
466
533
|
Description?: string;
|
|
@@ -470,22 +537,27 @@ export interface UpdateExperienceRequest {
|
|
|
470
537
|
*/
|
|
471
538
|
export interface UpdateFeaturedResultsSetRequest {
|
|
472
539
|
/**
|
|
540
|
+
* @public
|
|
473
541
|
* <p>The identifier of the index used for featuring results.</p>
|
|
474
542
|
*/
|
|
475
543
|
IndexId: string | undefined;
|
|
476
544
|
/**
|
|
545
|
+
* @public
|
|
477
546
|
* <p>The identifier of the set of featured results that you want to update.</p>
|
|
478
547
|
*/
|
|
479
548
|
FeaturedResultsSetId: string | undefined;
|
|
480
549
|
/**
|
|
550
|
+
* @public
|
|
481
551
|
* <p>A new name for the set of featured results.</p>
|
|
482
552
|
*/
|
|
483
553
|
FeaturedResultsSetName?: string;
|
|
484
554
|
/**
|
|
555
|
+
* @public
|
|
485
556
|
* <p>A new description for the set of featured results.</p>
|
|
486
557
|
*/
|
|
487
558
|
Description?: string;
|
|
488
559
|
/**
|
|
560
|
+
* @public
|
|
489
561
|
* <p>You can set the status to <code>ACTIVE</code> or <code>INACTIVE</code>.
|
|
490
562
|
* When the value is <code>ACTIVE</code>, featured results are ready for
|
|
491
563
|
* use. You can still configure your settings before setting the status
|
|
@@ -495,11 +567,13 @@ export interface UpdateFeaturedResultsSetRequest {
|
|
|
495
567
|
*/
|
|
496
568
|
Status?: FeaturedResultsSetStatus | string;
|
|
497
569
|
/**
|
|
570
|
+
* @public
|
|
498
571
|
* <p>A list of queries for featuring results. For more information on the
|
|
499
572
|
* list of queries, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/API_FeaturedResultsSet.html">FeaturedResultsSet</a>.</p>
|
|
500
573
|
*/
|
|
501
574
|
QueryTexts?: string[];
|
|
502
575
|
/**
|
|
576
|
+
* @public
|
|
503
577
|
* <p>A list of document IDs for the documents you want to feature at the
|
|
504
578
|
* top of the search results page. For more information on the list of
|
|
505
579
|
* featured documents, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/API_FeaturedResultsSet.html">FeaturedResultsSet</a>.</p>
|
|
@@ -511,6 +585,7 @@ export interface UpdateFeaturedResultsSetRequest {
|
|
|
511
585
|
*/
|
|
512
586
|
export interface UpdateFeaturedResultsSetResponse {
|
|
513
587
|
/**
|
|
588
|
+
* @public
|
|
514
589
|
* <p>Information on the set of featured results. This includes the identifier
|
|
515
590
|
* of the featured results set, whether the featured results set is active
|
|
516
591
|
* or inactive, when the featured results set was last updated, and more.</p>
|
|
@@ -522,29 +597,35 @@ export interface UpdateFeaturedResultsSetResponse {
|
|
|
522
597
|
*/
|
|
523
598
|
export interface UpdateIndexRequest {
|
|
524
599
|
/**
|
|
600
|
+
* @public
|
|
525
601
|
* <p>The identifier of the index you want to update.</p>
|
|
526
602
|
*/
|
|
527
603
|
Id: string | undefined;
|
|
528
604
|
/**
|
|
605
|
+
* @public
|
|
529
606
|
* <p>The name of the index you want to update.</p>
|
|
530
607
|
*/
|
|
531
608
|
Name?: string;
|
|
532
609
|
/**
|
|
610
|
+
* @public
|
|
533
611
|
* <p>An Identity and Access Management (IAM) role that gives Amazon Kendra
|
|
534
612
|
* permission to access Amazon CloudWatch logs and metrics.</p>
|
|
535
613
|
*/
|
|
536
614
|
RoleArn?: string;
|
|
537
615
|
/**
|
|
616
|
+
* @public
|
|
538
617
|
* <p>A new description for the index.</p>
|
|
539
618
|
*/
|
|
540
619
|
Description?: string;
|
|
541
620
|
/**
|
|
621
|
+
* @public
|
|
542
622
|
* <p>The document metadata configuration you want to update for the index. Document metadata
|
|
543
623
|
* are fields or attributes associated with your documents. For example, the company department
|
|
544
624
|
* name associated with each document.</p>
|
|
545
625
|
*/
|
|
546
626
|
DocumentMetadataConfigurationUpdates?: DocumentMetadataConfiguration[];
|
|
547
627
|
/**
|
|
628
|
+
* @public
|
|
548
629
|
* <p>Sets the number of additional document storage and query capacity units that should be
|
|
549
630
|
* used by the index. You can change the capacity of the index up to 5 times per day, or make 5
|
|
550
631
|
* API calls.</p>
|
|
@@ -553,14 +634,17 @@ export interface UpdateIndexRequest {
|
|
|
553
634
|
*/
|
|
554
635
|
CapacityUnits?: CapacityUnitsConfiguration;
|
|
555
636
|
/**
|
|
637
|
+
* @public
|
|
556
638
|
* <p>The user token configuration.</p>
|
|
557
639
|
*/
|
|
558
640
|
UserTokenConfigurations?: UserTokenConfiguration[];
|
|
559
641
|
/**
|
|
642
|
+
* @public
|
|
560
643
|
* <p>The user context policy.</p>
|
|
561
644
|
*/
|
|
562
645
|
UserContextPolicy?: UserContextPolicy | string;
|
|
563
646
|
/**
|
|
647
|
+
* @public
|
|
564
648
|
* <p>Enables fetching access levels of groups and users from an IAM Identity Center (successor to Single Sign-On)
|
|
565
649
|
* identity source. To configure this, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/API_UserGroupResolutionConfiguration.html">UserGroupResolutionConfiguration</a>.</p>
|
|
566
650
|
*/
|
|
@@ -571,22 +655,27 @@ export interface UpdateIndexRequest {
|
|
|
571
655
|
*/
|
|
572
656
|
export interface UpdateQuerySuggestionsBlockListRequest {
|
|
573
657
|
/**
|
|
658
|
+
* @public
|
|
574
659
|
* <p>The identifier of the index for the block list.</p>
|
|
575
660
|
*/
|
|
576
661
|
IndexId: string | undefined;
|
|
577
662
|
/**
|
|
663
|
+
* @public
|
|
578
664
|
* <p>The identifier of the block list you want to update.</p>
|
|
579
665
|
*/
|
|
580
666
|
Id: string | undefined;
|
|
581
667
|
/**
|
|
668
|
+
* @public
|
|
582
669
|
* <p>A new name for the block list.</p>
|
|
583
670
|
*/
|
|
584
671
|
Name?: string;
|
|
585
672
|
/**
|
|
673
|
+
* @public
|
|
586
674
|
* <p>A new description for the block list.</p>
|
|
587
675
|
*/
|
|
588
676
|
Description?: string;
|
|
589
677
|
/**
|
|
678
|
+
* @public
|
|
590
679
|
* <p>The S3 path where your block list text file sits in S3.</p>
|
|
591
680
|
* <p>If you update your block list and provide the same path to the
|
|
592
681
|
* block list text file in S3, then Amazon Kendra reloads the file to refresh
|
|
@@ -599,6 +688,7 @@ export interface UpdateQuerySuggestionsBlockListRequest {
|
|
|
599
688
|
*/
|
|
600
689
|
SourceS3Path?: S3Path;
|
|
601
690
|
/**
|
|
691
|
+
* @public
|
|
602
692
|
* <p>The IAM (Identity and Access Management) role used to access the
|
|
603
693
|
* block list text file in S3.</p>
|
|
604
694
|
*/
|
|
@@ -609,10 +699,12 @@ export interface UpdateQuerySuggestionsBlockListRequest {
|
|
|
609
699
|
*/
|
|
610
700
|
export interface UpdateQuerySuggestionsConfigRequest {
|
|
611
701
|
/**
|
|
702
|
+
* @public
|
|
612
703
|
* <p> The identifier of the index with query suggestions you want to update.</p>
|
|
613
704
|
*/
|
|
614
705
|
IndexId: string | undefined;
|
|
615
706
|
/**
|
|
707
|
+
* @public
|
|
616
708
|
* <p>Set the mode to <code>ENABLED</code> or <code>LEARN_ONLY</code>.</p>
|
|
617
709
|
* <p>By default, Amazon Kendra enables query suggestions.
|
|
618
710
|
* <code>LEARN_ONLY</code> mode allows you to turn off query suggestions.
|
|
@@ -623,12 +715,14 @@ export interface UpdateQuerySuggestionsConfigRequest {
|
|
|
623
715
|
*/
|
|
624
716
|
Mode?: Mode | string;
|
|
625
717
|
/**
|
|
718
|
+
* @public
|
|
626
719
|
* <p>How recent your queries are in your query log time window.</p>
|
|
627
720
|
* <p>The time window is the number of days from current day to past days.</p>
|
|
628
721
|
* <p>By default, Amazon Kendra sets this to 180.</p>
|
|
629
722
|
*/
|
|
630
723
|
QueryLogLookBackWindowInDays?: number;
|
|
631
724
|
/**
|
|
725
|
+
* @public
|
|
632
726
|
* <p>
|
|
633
727
|
* <code>TRUE</code> to include queries without user information (i.e. all queries,
|
|
634
728
|
* irrespective of the user), otherwise <code>FALSE</code> to only include queries
|
|
@@ -644,6 +738,7 @@ export interface UpdateQuerySuggestionsConfigRequest {
|
|
|
644
738
|
*/
|
|
645
739
|
IncludeQueriesWithoutUserInformation?: boolean;
|
|
646
740
|
/**
|
|
741
|
+
* @public
|
|
647
742
|
* <p>The minimum number of unique users who must search a query in order for the query
|
|
648
743
|
* to be eligible to suggest to your users.</p>
|
|
649
744
|
* <p>Increasing this number might decrease the number of suggestions. However, this
|
|
@@ -652,6 +747,7 @@ export interface UpdateQuerySuggestionsConfigRequest {
|
|
|
652
747
|
*/
|
|
653
748
|
MinimumNumberOfQueryingUsers?: number;
|
|
654
749
|
/**
|
|
750
|
+
* @public
|
|
655
751
|
* <p>The the minimum number of times a query must be searched in order to be
|
|
656
752
|
* eligible to suggest to your users.</p>
|
|
657
753
|
* <p>Decreasing this number increases the number of suggestions. However, this
|
|
@@ -661,6 +757,7 @@ export interface UpdateQuerySuggestionsConfigRequest {
|
|
|
661
757
|
*/
|
|
662
758
|
MinimumQueryCount?: number;
|
|
663
759
|
/**
|
|
760
|
+
* @public
|
|
664
761
|
* <p>Configuration information for the document fields/attributes that you want to base
|
|
665
762
|
* query suggestions on.</p>
|
|
666
763
|
*/
|
|
@@ -671,27 +768,33 @@ export interface UpdateQuerySuggestionsConfigRequest {
|
|
|
671
768
|
*/
|
|
672
769
|
export interface UpdateThesaurusRequest {
|
|
673
770
|
/**
|
|
771
|
+
* @public
|
|
674
772
|
* <p>The identifier of the thesaurus you want to update.</p>
|
|
675
773
|
*/
|
|
676
774
|
Id: string | undefined;
|
|
677
775
|
/**
|
|
776
|
+
* @public
|
|
678
777
|
* <p>A new name for the thesaurus.</p>
|
|
679
778
|
*/
|
|
680
779
|
Name?: string;
|
|
681
780
|
/**
|
|
781
|
+
* @public
|
|
682
782
|
* <p>The identifier of the index for the thesaurus.</p>
|
|
683
783
|
*/
|
|
684
784
|
IndexId: string | undefined;
|
|
685
785
|
/**
|
|
786
|
+
* @public
|
|
686
787
|
* <p>A new description for the thesaurus.</p>
|
|
687
788
|
*/
|
|
688
789
|
Description?: string;
|
|
689
790
|
/**
|
|
791
|
+
* @public
|
|
690
792
|
* <p>An IAM role that gives Amazon Kendra permissions to
|
|
691
793
|
* access thesaurus file specified in <code>SourceS3Path</code>.</p>
|
|
692
794
|
*/
|
|
693
795
|
RoleArn?: string;
|
|
694
796
|
/**
|
|
797
|
+
* @public
|
|
695
798
|
* <p>Information required to find a specific file in an Amazon S3 bucket.</p>
|
|
696
799
|
*/
|
|
697
800
|
SourceS3Path?: S3Path;
|
|
@@ -708,10 +811,12 @@ export interface UpdateThesaurusRequest {
|
|
|
708
811
|
*/
|
|
709
812
|
export interface Facet {
|
|
710
813
|
/**
|
|
814
|
+
* @public
|
|
711
815
|
* <p>The unique key for the document attribute.</p>
|
|
712
816
|
*/
|
|
713
817
|
DocumentAttributeKey?: string;
|
|
714
818
|
/**
|
|
819
|
+
* @public
|
|
715
820
|
* <p>An array of document attributes that are nested facets within a facet.</p>
|
|
716
821
|
* <p>For example, the document attribute or facet "Department" includes a value called
|
|
717
822
|
* "Engineering". In addition, the document attribute or facet "SubDepartment" includes the
|
|
@@ -724,6 +829,7 @@ export interface Facet {
|
|
|
724
829
|
*/
|
|
725
830
|
Facets?: Facet[];
|
|
726
831
|
/**
|
|
832
|
+
* @public
|
|
727
833
|
* <p>Maximum number of facet values per facet. The default is 10. You can use this to limit
|
|
728
834
|
* the number of facet values to less than 10. If you want to increase the default, contact
|
|
729
835
|
* <a href="http://aws.amazon.com/contact-us/">Support</a>.</p>
|
|
@@ -737,15 +843,18 @@ export interface Facet {
|
|
|
737
843
|
*/
|
|
738
844
|
export interface DocumentAttributeValueCountPair {
|
|
739
845
|
/**
|
|
846
|
+
* @public
|
|
740
847
|
* <p>The value of the attribute. For example, "HR".</p>
|
|
741
848
|
*/
|
|
742
849
|
DocumentAttributeValue?: DocumentAttributeValue;
|
|
743
850
|
/**
|
|
851
|
+
* @public
|
|
744
852
|
* <p>The number of documents in the response that have the attribute value for the
|
|
745
853
|
* key.</p>
|
|
746
854
|
*/
|
|
747
855
|
Count?: number;
|
|
748
856
|
/**
|
|
857
|
+
* @public
|
|
749
858
|
* <p>Contains the results of a document attribute that is a nested facet. A
|
|
750
859
|
* <code>FacetResult</code> contains the counts for each facet nested within a
|
|
751
860
|
* facet.</p>
|
|
@@ -766,16 +875,19 @@ export interface DocumentAttributeValueCountPair {
|
|
|
766
875
|
*/
|
|
767
876
|
export interface FacetResult {
|
|
768
877
|
/**
|
|
878
|
+
* @public
|
|
769
879
|
* <p>The key for the facet values. This is the same as the <code>DocumentAttributeKey</code>
|
|
770
880
|
* provided in the query.</p>
|
|
771
881
|
*/
|
|
772
882
|
DocumentAttributeKey?: string;
|
|
773
883
|
/**
|
|
884
|
+
* @public
|
|
774
885
|
* <p>The data type of the facet value. This is the same as the type defined for the index
|
|
775
886
|
* field when it was created.</p>
|
|
776
887
|
*/
|
|
777
888
|
DocumentAttributeValueType?: DocumentAttributeValueType | string;
|
|
778
889
|
/**
|
|
890
|
+
* @public
|
|
779
891
|
* <p>An array of key/value pairs, where the key is the value of the attribute and the count
|
|
780
892
|
* is the number of documents that share the key value.</p>
|
|
781
893
|
*/
|
|
@@ -810,50 +922,60 @@ export interface FacetResult {
|
|
|
810
922
|
*/
|
|
811
923
|
export interface AttributeFilter {
|
|
812
924
|
/**
|
|
925
|
+
* @public
|
|
813
926
|
* <p>Performs a logical <code>AND</code> operation on all supplied filters.</p>
|
|
814
927
|
*/
|
|
815
928
|
AndAllFilters?: AttributeFilter[];
|
|
816
929
|
/**
|
|
930
|
+
* @public
|
|
817
931
|
* <p>Performs a logical <code>OR</code> operation on all supplied filters.</p>
|
|
818
932
|
*/
|
|
819
933
|
OrAllFilters?: AttributeFilter[];
|
|
820
934
|
/**
|
|
935
|
+
* @public
|
|
821
936
|
* <p>Performs a logical <code>NOT</code> operation on all supplied filters.</p>
|
|
822
937
|
*/
|
|
823
938
|
NotFilter?: AttributeFilter;
|
|
824
939
|
/**
|
|
940
|
+
* @public
|
|
825
941
|
* <p>Performs an equals operation on two document attributes or metadata fields.</p>
|
|
826
942
|
*/
|
|
827
943
|
EqualsTo?: DocumentAttribute;
|
|
828
944
|
/**
|
|
945
|
+
* @public
|
|
829
946
|
* <p>Returns true when a document contains all of the specified document attributes or
|
|
830
947
|
* metadata fields. This filter is only applicable to <code>StringListValue</code>
|
|
831
948
|
* metadata.</p>
|
|
832
949
|
*/
|
|
833
950
|
ContainsAll?: DocumentAttribute;
|
|
834
951
|
/**
|
|
952
|
+
* @public
|
|
835
953
|
* <p>Returns true when a document contains any of the specified document attributes or
|
|
836
954
|
* metadata fields. This filter is only applicable to <code>StringListValue</code>
|
|
837
955
|
* metadata.</p>
|
|
838
956
|
*/
|
|
839
957
|
ContainsAny?: DocumentAttribute;
|
|
840
958
|
/**
|
|
959
|
+
* @public
|
|
841
960
|
* <p>Performs a greater than operation on two document attributes or metadata fields. Use
|
|
842
961
|
* with a document attribute of type <code>Date</code> or <code>Long</code>.</p>
|
|
843
962
|
*/
|
|
844
963
|
GreaterThan?: DocumentAttribute;
|
|
845
964
|
/**
|
|
965
|
+
* @public
|
|
846
966
|
* <p>Performs a greater or equals than operation on two document attributes or metadata
|
|
847
967
|
* fields. Use with a document attribute of type <code>Date</code> or
|
|
848
968
|
* <code>Long</code>.</p>
|
|
849
969
|
*/
|
|
850
970
|
GreaterThanOrEquals?: DocumentAttribute;
|
|
851
971
|
/**
|
|
972
|
+
* @public
|
|
852
973
|
* <p>Performs a less than operation on two document attributes or metadata fields. Use with a
|
|
853
974
|
* document attribute of type <code>Date</code> or <code>Long</code>.</p>
|
|
854
975
|
*/
|
|
855
976
|
LessThan?: DocumentAttribute;
|
|
856
977
|
/**
|
|
978
|
+
* @public
|
|
857
979
|
* <p>Performs a less than or equals operation on two document attributes or metadata fields.
|
|
858
980
|
* Use with a document attribute of type <code>Date</code> or <code>Long</code>.</p>
|
|
859
981
|
*/
|
|
@@ -864,26 +986,31 @@ export interface AttributeFilter {
|
|
|
864
986
|
*/
|
|
865
987
|
export interface QueryResult {
|
|
866
988
|
/**
|
|
989
|
+
* @public
|
|
867
990
|
* <p>The identifier for the search. You also use <code>QueryId</code> to identify the
|
|
868
991
|
* search when using the <a href="https://docs.aws.amazon.com/kendra/latest/APIReference/API_SubmitFeedback.html">SubmitFeedback</a> API.</p>
|
|
869
992
|
*/
|
|
870
993
|
QueryId?: string;
|
|
871
994
|
/**
|
|
995
|
+
* @public
|
|
872
996
|
* <p>The results of the search.</p>
|
|
873
997
|
*/
|
|
874
998
|
ResultItems?: QueryResultItem[];
|
|
875
999
|
/**
|
|
1000
|
+
* @public
|
|
876
1001
|
* <p>Contains the facet results. A <code>FacetResult</code> contains the counts for each
|
|
877
1002
|
* field/attribute key that was specified in the <code>Facets</code> input parameter.</p>
|
|
878
1003
|
*/
|
|
879
1004
|
FacetResults?: FacetResult[];
|
|
880
1005
|
/**
|
|
1006
|
+
* @public
|
|
881
1007
|
* <p>The total number of items found by the search. However, you can only retrieve up to
|
|
882
1008
|
* 100 items. For example, if the search found 192 items, you can only retrieve the first
|
|
883
1009
|
* 100 of the items.</p>
|
|
884
1010
|
*/
|
|
885
1011
|
TotalNumberOfResults?: number;
|
|
886
1012
|
/**
|
|
1013
|
+
* @public
|
|
887
1014
|
* <p>A list of warning codes and their messages on problems with your query.</p>
|
|
888
1015
|
* <p>Amazon Kendra currently only supports one type of warning, which is a warning on
|
|
889
1016
|
* invalid syntax used in the query. For examples of invalid query syntax, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/searching-example.html#searching-index-query-syntax">Searching
|
|
@@ -891,10 +1018,12 @@ export interface QueryResult {
|
|
|
891
1018
|
*/
|
|
892
1019
|
Warnings?: Warning[];
|
|
893
1020
|
/**
|
|
1021
|
+
* @public
|
|
894
1022
|
* <p>A list of information related to suggested spell corrections for a query.</p>
|
|
895
1023
|
*/
|
|
896
1024
|
SpellCorrectedQueries?: SpellCorrectedQuery[];
|
|
897
1025
|
/**
|
|
1026
|
+
* @public
|
|
898
1027
|
* <p>The list of featured result items. Featured results are displayed at
|
|
899
1028
|
* the top of the search results page, placed above all other results for
|
|
900
1029
|
* certain queries. If there's an exact match of a query, then certain
|
|
@@ -909,22 +1038,26 @@ export interface QueryResult {
|
|
|
909
1038
|
*/
|
|
910
1039
|
export interface AttributeSuggestionsGetConfig {
|
|
911
1040
|
/**
|
|
1041
|
+
* @public
|
|
912
1042
|
* <p>The list of document field/attribute keys or field names to use for query suggestions.
|
|
913
1043
|
* If the content within any of the fields match what your user starts typing as their query,
|
|
914
1044
|
* then the field content is returned as a query suggestion.</p>
|
|
915
1045
|
*/
|
|
916
1046
|
SuggestionAttributes?: string[];
|
|
917
1047
|
/**
|
|
1048
|
+
* @public
|
|
918
1049
|
* <p>The list of additional document field/attribute keys or field names to include in the
|
|
919
1050
|
* response. You can use additional fields to provide extra information in the response.
|
|
920
1051
|
* Additional fields are not used to based suggestions on.</p>
|
|
921
1052
|
*/
|
|
922
1053
|
AdditionalResponseAttributes?: string[];
|
|
923
1054
|
/**
|
|
1055
|
+
* @public
|
|
924
1056
|
* <p>Filters the search results based on document fields/attributes.</p>
|
|
925
1057
|
*/
|
|
926
1058
|
AttributeFilter?: AttributeFilter;
|
|
927
1059
|
/**
|
|
1060
|
+
* @public
|
|
928
1061
|
* <p>Applies user context filtering so that only users who are given access to certain
|
|
929
1062
|
* documents see these document in their search results.</p>
|
|
930
1063
|
*/
|
|
@@ -935,11 +1068,13 @@ export interface AttributeSuggestionsGetConfig {
|
|
|
935
1068
|
*/
|
|
936
1069
|
export interface RetrieveRequest {
|
|
937
1070
|
/**
|
|
1071
|
+
* @public
|
|
938
1072
|
* <p>The identifier of the index to retrieve relevant passages for the
|
|
939
1073
|
* search.</p>
|
|
940
1074
|
*/
|
|
941
1075
|
IndexId: string | undefined;
|
|
942
1076
|
/**
|
|
1077
|
+
* @public
|
|
943
1078
|
* <p>The input query text to retrieve relevant passages for the search.
|
|
944
1079
|
* Amazon Kendra truncates queries at 30 token words, which excludes
|
|
945
1080
|
* punctuation and stop words. Truncation still applies if you use Boolean
|
|
@@ -947,6 +1082,7 @@ export interface RetrieveRequest {
|
|
|
947
1082
|
*/
|
|
948
1083
|
QueryText: string | undefined;
|
|
949
1084
|
/**
|
|
1085
|
+
* @public
|
|
950
1086
|
* <p>Filters search results by document fields/attributes. You can only provide
|
|
951
1087
|
* one attribute filter; however, the <code>AndAllFilters</code>, <code>NotFilter</code>,
|
|
952
1088
|
* and <code>OrAllFilters</code> parameters contain a list of other filters.</p>
|
|
@@ -955,12 +1091,14 @@ export interface RetrieveRequest {
|
|
|
955
1091
|
*/
|
|
956
1092
|
AttributeFilter?: AttributeFilter;
|
|
957
1093
|
/**
|
|
1094
|
+
* @public
|
|
958
1095
|
* <p>A list of document fields/attributes to include in the response. You can limit
|
|
959
1096
|
* the response to include certain document fields. By default, all document
|
|
960
1097
|
* fields are included in the response.</p>
|
|
961
1098
|
*/
|
|
962
1099
|
RequestedDocumentAttributes?: string[];
|
|
963
1100
|
/**
|
|
1101
|
+
* @public
|
|
964
1102
|
* <p>Overrides relevance tuning configurations of fields/attributes set at the index
|
|
965
1103
|
* level.</p>
|
|
966
1104
|
* <p>If you use this API to override the relevance tuning configured at the index level,
|
|
@@ -972,18 +1110,21 @@ export interface RetrieveRequest {
|
|
|
972
1110
|
*/
|
|
973
1111
|
DocumentRelevanceOverrideConfigurations?: DocumentRelevanceConfiguration[];
|
|
974
1112
|
/**
|
|
1113
|
+
* @public
|
|
975
1114
|
* <p>Retrieved relevant passages are returned in pages the size of the
|
|
976
1115
|
* <code>PageSize</code> parameter. By default, Amazon Kendra returns the first page
|
|
977
1116
|
* of results. Use this parameter to get result pages after the first one.</p>
|
|
978
1117
|
*/
|
|
979
1118
|
PageNumber?: number;
|
|
980
1119
|
/**
|
|
1120
|
+
* @public
|
|
981
1121
|
* <p>Sets the number of retrieved relevant passages that are returned in each page of
|
|
982
1122
|
* results. The default page size is 10. The maximum number of results returned is 100.
|
|
983
1123
|
* If you ask for more than 100 results, only 100 are returned.</p>
|
|
984
1124
|
*/
|
|
985
1125
|
PageSize?: number;
|
|
986
1126
|
/**
|
|
1127
|
+
* @public
|
|
987
1128
|
* <p>The user context token or user and group information.</p>
|
|
988
1129
|
*/
|
|
989
1130
|
UserContext?: UserContext;
|
|
@@ -993,10 +1134,12 @@ export interface RetrieveRequest {
|
|
|
993
1134
|
*/
|
|
994
1135
|
export interface GetQuerySuggestionsRequest {
|
|
995
1136
|
/**
|
|
1137
|
+
* @public
|
|
996
1138
|
* <p>The identifier of the index you want to get query suggestions from.</p>
|
|
997
1139
|
*/
|
|
998
1140
|
IndexId: string | undefined;
|
|
999
1141
|
/**
|
|
1142
|
+
* @public
|
|
1000
1143
|
* <p>The text of a user's query to generate query suggestions.</p>
|
|
1001
1144
|
* <p>A query is suggested if the query prefix matches
|
|
1002
1145
|
* what a user starts to type as their query.</p>
|
|
@@ -1007,11 +1150,13 @@ export interface GetQuerySuggestionsRequest {
|
|
|
1007
1150
|
*/
|
|
1008
1151
|
QueryText: string | undefined;
|
|
1009
1152
|
/**
|
|
1153
|
+
* @public
|
|
1010
1154
|
* <p>The maximum number of query suggestions you want to show
|
|
1011
1155
|
* to your users.</p>
|
|
1012
1156
|
*/
|
|
1013
1157
|
MaxSuggestionsCount?: number;
|
|
1014
1158
|
/**
|
|
1159
|
+
* @public
|
|
1015
1160
|
* <p>The suggestions type to base query suggestions on. The suggestion
|
|
1016
1161
|
* types are query history or document fields/attributes. You can set
|
|
1017
1162
|
* one type or the other.</p>
|
|
@@ -1024,6 +1169,7 @@ export interface GetQuerySuggestionsRequest {
|
|
|
1024
1169
|
*/
|
|
1025
1170
|
SuggestionTypes?: (SuggestionType | string)[];
|
|
1026
1171
|
/**
|
|
1172
|
+
* @public
|
|
1027
1173
|
* <p>Configuration information for the document fields/attributes that you
|
|
1028
1174
|
* want to base query suggestions on.</p>
|
|
1029
1175
|
*/
|
|
@@ -1034,16 +1180,19 @@ export interface GetQuerySuggestionsRequest {
|
|
|
1034
1180
|
*/
|
|
1035
1181
|
export interface QueryRequest {
|
|
1036
1182
|
/**
|
|
1183
|
+
* @public
|
|
1037
1184
|
* <p>The identifier of the index for the search.</p>
|
|
1038
1185
|
*/
|
|
1039
1186
|
IndexId: string | undefined;
|
|
1040
1187
|
/**
|
|
1188
|
+
* @public
|
|
1041
1189
|
* <p>The input query text for the search. Amazon Kendra truncates queries at 30 token
|
|
1042
1190
|
* words, which excludes punctuation and stop words. Truncation still applies if you use
|
|
1043
1191
|
* Boolean or more advanced, complex queries. </p>
|
|
1044
1192
|
*/
|
|
1045
1193
|
QueryText?: string;
|
|
1046
1194
|
/**
|
|
1195
|
+
* @public
|
|
1047
1196
|
* <p>Filters search results by document fields/attributes. You can only provide
|
|
1048
1197
|
* one attribute filter; however, the <code>AndAllFilters</code>, <code>NotFilter</code>,
|
|
1049
1198
|
* and <code>OrAllFilters</code> parameters contain a list of other filters.</p>
|
|
@@ -1052,22 +1201,26 @@ export interface QueryRequest {
|
|
|
1052
1201
|
*/
|
|
1053
1202
|
AttributeFilter?: AttributeFilter;
|
|
1054
1203
|
/**
|
|
1204
|
+
* @public
|
|
1055
1205
|
* <p>An array of documents fields/attributes for faceted search. Amazon Kendra returns a
|
|
1056
1206
|
* count for each field key specified. This helps your users narrow their search.</p>
|
|
1057
1207
|
*/
|
|
1058
1208
|
Facets?: Facet[];
|
|
1059
1209
|
/**
|
|
1210
|
+
* @public
|
|
1060
1211
|
* <p>An array of document fields/attributes to include in the response. You can limit the
|
|
1061
1212
|
* response to include certain document fields. By default, all document attributes are
|
|
1062
1213
|
* included in the response.</p>
|
|
1063
1214
|
*/
|
|
1064
1215
|
RequestedDocumentAttributes?: string[];
|
|
1065
1216
|
/**
|
|
1217
|
+
* @public
|
|
1066
1218
|
* <p>Sets the type of query result or response. Only results for the specified type are
|
|
1067
1219
|
* returned.</p>
|
|
1068
1220
|
*/
|
|
1069
1221
|
QueryResultTypeFilter?: QueryResultType | string;
|
|
1070
1222
|
/**
|
|
1223
|
+
* @public
|
|
1071
1224
|
* <p>Overrides relevance tuning configurations of fields/attributes set at the index level.</p>
|
|
1072
1225
|
* <p>If you use this API to override the relevance tuning configured at the index level, but there
|
|
1073
1226
|
* is no relevance tuning configured at the index level, then Amazon Kendra does not apply any
|
|
@@ -1078,18 +1231,21 @@ export interface QueryRequest {
|
|
|
1078
1231
|
*/
|
|
1079
1232
|
DocumentRelevanceOverrideConfigurations?: DocumentRelevanceConfiguration[];
|
|
1080
1233
|
/**
|
|
1234
|
+
* @public
|
|
1081
1235
|
* <p>Query results are returned in pages the size of the <code>PageSize</code> parameter.
|
|
1082
1236
|
* By default, Amazon Kendra returns the first page of results. Use this parameter to
|
|
1083
1237
|
* get result pages after the first one.</p>
|
|
1084
1238
|
*/
|
|
1085
1239
|
PageNumber?: number;
|
|
1086
1240
|
/**
|
|
1241
|
+
* @public
|
|
1087
1242
|
* <p>Sets the number of results that are returned in each page of results. The default page
|
|
1088
1243
|
* size is 10. The maximum number of results returned is 100. If you ask for more than 100
|
|
1089
1244
|
* results, only 100 are returned.</p>
|
|
1090
1245
|
*/
|
|
1091
1246
|
PageSize?: number;
|
|
1092
1247
|
/**
|
|
1248
|
+
* @public
|
|
1093
1249
|
* <p>Provides information that determines how the results of the query are sorted. You can
|
|
1094
1250
|
* set the field that Amazon Kendra should sort the results on, and specify whether the
|
|
1095
1251
|
* results should be sorted in ascending or descending order. In the case of ties in sorting
|
|
@@ -1099,16 +1255,19 @@ export interface QueryRequest {
|
|
|
1099
1255
|
*/
|
|
1100
1256
|
SortingConfiguration?: SortingConfiguration;
|
|
1101
1257
|
/**
|
|
1258
|
+
* @public
|
|
1102
1259
|
* <p>The user context token or user and group information.</p>
|
|
1103
1260
|
*/
|
|
1104
1261
|
UserContext?: UserContext;
|
|
1105
1262
|
/**
|
|
1263
|
+
* @public
|
|
1106
1264
|
* <p>Provides an identifier for a specific user. The <code>VisitorId</code> should be a
|
|
1107
1265
|
* unique identifier, such as a GUID. Don't use personally identifiable information, such as
|
|
1108
1266
|
* the user's email address, as the <code>VisitorId</code>.</p>
|
|
1109
1267
|
*/
|
|
1110
1268
|
VisitorId?: string;
|
|
1111
1269
|
/**
|
|
1270
|
+
* @public
|
|
1112
1271
|
* <p>Enables suggested spell corrections for queries.</p>
|
|
1113
1272
|
*/
|
|
1114
1273
|
SpellCorrectionConfiguration?: SpellCorrectionConfiguration;
|