@aws-sdk/client-kendra 3.934.0 → 3.935.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.
Files changed (53) hide show
  1. package/dist-cjs/index.js +396 -396
  2. package/dist-es/index.js +2 -1
  3. package/dist-es/models/enums.js +382 -0
  4. package/dist-es/models/errors.js +171 -0
  5. package/dist-es/models/models_0.js +1 -525
  6. package/dist-es/schemas/schemas_0.js +1 -1
  7. package/dist-types/commands/GetQuerySuggestionsCommand.d.ts +1 -2
  8. package/dist-types/commands/QueryCommand.d.ts +1 -1
  9. package/dist-types/commands/RetrieveCommand.d.ts +1 -1
  10. package/dist-types/commands/StartDataSourceSyncJobCommand.d.ts +1 -1
  11. package/dist-types/commands/StopDataSourceSyncJobCommand.d.ts +1 -1
  12. package/dist-types/commands/SubmitFeedbackCommand.d.ts +1 -1
  13. package/dist-types/commands/TagResourceCommand.d.ts +1 -1
  14. package/dist-types/commands/UntagResourceCommand.d.ts +1 -1
  15. package/dist-types/commands/UpdateAccessControlConfigurationCommand.d.ts +1 -1
  16. package/dist-types/commands/UpdateDataSourceCommand.d.ts +1 -1
  17. package/dist-types/commands/UpdateExperienceCommand.d.ts +1 -1
  18. package/dist-types/commands/UpdateFeaturedResultsSetCommand.d.ts +1 -1
  19. package/dist-types/commands/UpdateIndexCommand.d.ts +1 -1
  20. package/dist-types/commands/UpdateQuerySuggestionsBlockListCommand.d.ts +1 -1
  21. package/dist-types/commands/UpdateQuerySuggestionsConfigCommand.d.ts +1 -1
  22. package/dist-types/commands/UpdateThesaurusCommand.d.ts +1 -1
  23. package/dist-types/index.d.ts +3 -1
  24. package/dist-types/models/enums.d.ts +878 -0
  25. package/dist-types/models/errors.d.ts +185 -0
  26. package/dist-types/models/models_0.d.ts +1402 -1004
  27. package/dist-types/ts3.4/commands/GetQuerySuggestionsCommand.d.ts +4 -2
  28. package/dist-types/ts3.4/commands/QueryCommand.d.ts +1 -1
  29. package/dist-types/ts3.4/commands/RetrieveCommand.d.ts +1 -1
  30. package/dist-types/ts3.4/commands/StartDataSourceSyncJobCommand.d.ts +1 -1
  31. package/dist-types/ts3.4/commands/StopDataSourceSyncJobCommand.d.ts +1 -1
  32. package/dist-types/ts3.4/commands/SubmitFeedbackCommand.d.ts +1 -1
  33. package/dist-types/ts3.4/commands/TagResourceCommand.d.ts +1 -1
  34. package/dist-types/ts3.4/commands/UntagResourceCommand.d.ts +1 -1
  35. package/dist-types/ts3.4/commands/UpdateAccessControlConfigurationCommand.d.ts +1 -1
  36. package/dist-types/ts3.4/commands/UpdateDataSourceCommand.d.ts +1 -1
  37. package/dist-types/ts3.4/commands/UpdateExperienceCommand.d.ts +1 -1
  38. package/dist-types/ts3.4/commands/UpdateFeaturedResultsSetCommand.d.ts +1 -1
  39. package/dist-types/ts3.4/commands/UpdateIndexCommand.d.ts +1 -1
  40. package/dist-types/ts3.4/commands/UpdateQuerySuggestionsBlockListCommand.d.ts +1 -1
  41. package/dist-types/ts3.4/commands/UpdateQuerySuggestionsConfigCommand.d.ts +1 -1
  42. package/dist-types/ts3.4/commands/UpdateThesaurusCommand.d.ts +1 -1
  43. package/dist-types/ts3.4/index.d.ts +3 -1
  44. package/dist-types/ts3.4/models/enums.d.ts +485 -0
  45. package/dist-types/ts3.4/models/errors.d.ts +101 -0
  46. package/dist-types/ts3.4/models/models_0.d.ts +322 -559
  47. package/package.json +12 -12
  48. package/dist-es/models/index.js +0 -2
  49. package/dist-es/models/models_1.js +0 -29
  50. package/dist-types/models/index.d.ts +0 -2
  51. package/dist-types/models/models_1.d.ts +0 -1462
  52. package/dist-types/ts3.4/models/index.d.ts +0 -2
  53. package/dist-types/ts3.4/models/models_1.d.ts +0 -321
@@ -1,1462 +0,0 @@
1
- import { ExceptionOptionType as __ExceptionOptionType } from "@smithy/smithy-client";
2
- import { KendraServiceException as __BaseException } from "./KendraServiceException";
3
- import { AdditionalResultAttribute, AttributeSuggestionsUpdateConfig, CapacityUnitsConfiguration, CollapseConfiguration, CollapsedResultDetail, CustomDocumentEnrichmentConfiguration, DataSourceConfiguration, DataSourceVpcConfiguration, DocumentAttribute, DocumentAttributeValue, DocumentAttributeValueType, DocumentMetadataConfiguration, DocumentRelevanceConfiguration, ExperienceConfiguration, FeaturedDocument, FeaturedResultsItem, FeaturedResultsSet, FeaturedResultsSetStatus, HierarchicalPrincipal, Mode, Principal, QueryResultFormat, QueryResultType, S3Path, SortingConfiguration, SpellCorrectionConfiguration, SuggestionType, Tag, TextWithHighlights, UserContext, UserContextPolicy, UserGroupResolutionConfiguration, UserTokenConfiguration } from "./models_0";
4
- /**
5
- * @public
6
- * @enum
7
- */
8
- export declare const ScoreConfidence: {
9
- readonly HIGH: "HIGH";
10
- readonly LOW: "LOW";
11
- readonly MEDIUM: "MEDIUM";
12
- readonly NOT_AVAILABLE: "NOT_AVAILABLE";
13
- readonly VERY_HIGH: "VERY_HIGH";
14
- };
15
- /**
16
- * @public
17
- */
18
- export type ScoreConfidence = (typeof ScoreConfidence)[keyof typeof ScoreConfidence];
19
- /**
20
- * <p>Provides a relative ranking that indicates how confident Amazon Kendra is that the
21
- * response is relevant to the query.</p>
22
- * @public
23
- */
24
- export interface ScoreAttributes {
25
- /**
26
- * <p>A relative ranking for how relevant the response is to the query.</p>
27
- * @public
28
- */
29
- ScoreConfidence?: ScoreConfidence | undefined;
30
- }
31
- /**
32
- * <p>Provides information about a table cell in a table excerpt.</p>
33
- * @public
34
- */
35
- export interface TableCell {
36
- /**
37
- * <p>The actual value or content within a table cell. A table cell could contain a date
38
- * value of a year, or a string value of text, for example.</p>
39
- * @public
40
- */
41
- Value?: string | undefined;
42
- /**
43
- * <p>
44
- * <code>TRUE</code> if the response of the table cell is the top answer. This is the
45
- * cell value or content with the highest confidence score or is the most relevant to the
46
- * query.</p>
47
- * @public
48
- */
49
- TopAnswer?: boolean | undefined;
50
- /**
51
- * <p>
52
- * <code>TRUE</code> means that the table cell has a high enough confidence and is
53
- * relevant to the query, so the value or content should be highlighted.</p>
54
- * @public
55
- */
56
- Highlighted?: boolean | undefined;
57
- /**
58
- * <p>
59
- * <code>TRUE</code> means that the table cell should be treated as a header.</p>
60
- * @public
61
- */
62
- Header?: boolean | undefined;
63
- }
64
- /**
65
- * <p>Information about a row in a table excerpt.</p>
66
- * @public
67
- */
68
- export interface TableRow {
69
- /**
70
- * <p>A list of table cells in a row.</p>
71
- * @public
72
- */
73
- Cells?: TableCell[] | undefined;
74
- }
75
- /**
76
- * <p>An excerpt from a table within a document. The table excerpt displays up to five
77
- * columns and three rows, depending on how many table cells are relevant to the query and
78
- * how many columns are available in the original table. The top most relevant cell is
79
- * displayed in the table excerpt, along with the next most relevant cells.</p>
80
- * @public
81
- */
82
- export interface TableExcerpt {
83
- /**
84
- * <p>A list of rows in the table excerpt.</p>
85
- * @public
86
- */
87
- Rows?: TableRow[] | undefined;
88
- /**
89
- * <p>A count of the number of rows in the original table within the document.</p>
90
- * @public
91
- */
92
- TotalNumberOfRows?: number | undefined;
93
- }
94
- /**
95
- * <p>A single query result.</p>
96
- * <p>A query result contains information about a document returned by the query. This
97
- * includes the original location of the document, a list of attributes assigned to the
98
- * document, and relevant text from the document that satisfies the query.</p>
99
- * @public
100
- */
101
- export interface QueryResultItem {
102
- /**
103
- * <p>The unique identifier for the query result item id (<code>Id</code>) and the query
104
- * result item document id (<code>DocumentId</code>) combined. The value of this field changes
105
- * with every request, even when you have the same documents.</p>
106
- * @public
107
- */
108
- Id?: string | undefined;
109
- /**
110
- * <p>The type of document within the response. For example, a response could include a
111
- * question-answer that's relevant to the query.</p>
112
- * @public
113
- */
114
- Type?: QueryResultType | undefined;
115
- /**
116
- * <p>If the <code>Type</code> of document within the response is <code>ANSWER</code>, then it
117
- * is either a <code>TABLE</code> answer or <code>TEXT</code> answer. If it's a table answer,
118
- * a table excerpt is returned in <code>TableExcerpt</code>. If it's a text answer, a text
119
- * excerpt is returned in <code>DocumentExcerpt</code>.</p>
120
- * @public
121
- */
122
- Format?: QueryResultFormat | undefined;
123
- /**
124
- * <p>One or more additional fields/attributes associated with the query result.</p>
125
- * @public
126
- */
127
- AdditionalAttributes?: AdditionalResultAttribute[] | undefined;
128
- /**
129
- * <p>The identifier for the document.</p>
130
- * @public
131
- */
132
- DocumentId?: string | undefined;
133
- /**
134
- * <p>The title of the document. Contains the text of the title and information for
135
- * highlighting the relevant terms in the title.</p>
136
- * @public
137
- */
138
- DocumentTitle?: TextWithHighlights | undefined;
139
- /**
140
- * <p>An extract of the text in the document. Contains information about highlighting the
141
- * relevant terms in the excerpt.</p>
142
- * @public
143
- */
144
- DocumentExcerpt?: TextWithHighlights | undefined;
145
- /**
146
- * <p>The URI of the original location of the document.</p>
147
- * @public
148
- */
149
- DocumentURI?: string | undefined;
150
- /**
151
- * <p>An array of document fields/attributes assigned to a document in the search results. For
152
- * example, the document author (<code>_author</code>) or the source URI
153
- * (<code>_source_uri</code>) of the document.</p>
154
- * @public
155
- */
156
- DocumentAttributes?: DocumentAttribute[] | undefined;
157
- /**
158
- * <p>Indicates the confidence level of Amazon Kendra providing a relevant result for the
159
- * query. Each result is placed into a bin that indicates the confidence,
160
- * <code>VERY_HIGH</code>, <code>HIGH</code>, <code>MEDIUM</code> and <code>LOW</code>. You
161
- * can use the score to determine if a response meets the confidence needed for your
162
- * application.</p>
163
- * <p>The field is only set to <code>LOW</code> when the <code>Type</code> field is set to
164
- * <code>DOCUMENT</code> and Amazon Kendra is not confident that the result is
165
- * relevant to the query.</p>
166
- * @public
167
- */
168
- ScoreAttributes?: ScoreAttributes | undefined;
169
- /**
170
- * <p>A token that identifies a particular result from a particular query. Use this token to
171
- * 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
172
- * feedback</a>.</p>
173
- * @public
174
- */
175
- FeedbackToken?: string | undefined;
176
- /**
177
- * <p>An excerpt from a table within a document.</p>
178
- * @public
179
- */
180
- TableExcerpt?: TableExcerpt | undefined;
181
- /**
182
- * <p>Provides details about a collapsed group of search results.</p>
183
- * @public
184
- */
185
- CollapsedResultDetail?: CollapsedResultDetail | undefined;
186
- }
187
- /**
188
- * <p>A corrected misspelled word in a query.</p>
189
- * @public
190
- */
191
- export interface Correction {
192
- /**
193
- * <p>The zero-based location in the response string or text where
194
- * the corrected word starts.</p>
195
- * @public
196
- */
197
- BeginOffset?: number | undefined;
198
- /**
199
- * <p>The zero-based location in the response string or text where
200
- * the corrected word ends.</p>
201
- * @public
202
- */
203
- EndOffset?: number | undefined;
204
- /**
205
- * <p>The string or text of a misspelled word in a query.</p>
206
- * @public
207
- */
208
- Term?: string | undefined;
209
- /**
210
- * <p>The string or text of a corrected misspelled word in a query.</p>
211
- * @public
212
- */
213
- CorrectedTerm?: string | undefined;
214
- }
215
- /**
216
- * <p>A query with suggested spell corrections. </p>
217
- * @public
218
- */
219
- export interface SpellCorrectedQuery {
220
- /**
221
- * <p>The query with the suggested spell corrections.</p>
222
- * @public
223
- */
224
- SuggestedQueryText?: string | undefined;
225
- /**
226
- * <p>The corrected misspelled word or words in a query.</p>
227
- * @public
228
- */
229
- Corrections?: Correction[] | undefined;
230
- }
231
- /**
232
- * @public
233
- * @enum
234
- */
235
- export declare const WarningCode: {
236
- readonly QUERY_LANGUAGE_INVALID_SYNTAX: "QUERY_LANGUAGE_INVALID_SYNTAX";
237
- };
238
- /**
239
- * @public
240
- */
241
- export type WarningCode = (typeof WarningCode)[keyof typeof WarningCode];
242
- /**
243
- * <p>The warning code and message that explains a problem with a query.</p>
244
- * @public
245
- */
246
- export interface Warning {
247
- /**
248
- * <p>The message that explains the problem with the query.</p>
249
- * @public
250
- */
251
- Message?: string | undefined;
252
- /**
253
- * <p>The code used to show the type of warning for the query.</p>
254
- * @public
255
- */
256
- Code?: WarningCode | undefined;
257
- }
258
- /**
259
- * <p>A single retrieved relevant passage result.</p>
260
- * @public
261
- */
262
- export interface RetrieveResultItem {
263
- /**
264
- * <p>The identifier of the relevant passage result.</p>
265
- * @public
266
- */
267
- Id?: string | undefined;
268
- /**
269
- * <p>The identifier of the document.</p>
270
- * @public
271
- */
272
- DocumentId?: string | undefined;
273
- /**
274
- * <p>The title of the document.</p>
275
- * @public
276
- */
277
- DocumentTitle?: string | undefined;
278
- /**
279
- * <p>The contents of the relevant passage.</p>
280
- * @public
281
- */
282
- Content?: string | undefined;
283
- /**
284
- * <p>The URI of the original location of the document.</p>
285
- * @public
286
- */
287
- DocumentURI?: string | undefined;
288
- /**
289
- * <p>An array of document fields/attributes assigned to a document in the search results.
290
- * For example, the document author (<code>_author</code>) or the source URI
291
- * (<code>_source_uri</code>) of the document.</p>
292
- * @public
293
- */
294
- DocumentAttributes?: DocumentAttribute[] | undefined;
295
- /**
296
- * <p>The confidence score bucket for a retrieved passage result. The confidence bucket
297
- * provides a relative ranking that indicates how confident Amazon Kendra is that the
298
- * response is relevant to the query.</p>
299
- * @public
300
- */
301
- ScoreAttributes?: ScoreAttributes | undefined;
302
- }
303
- /**
304
- * @public
305
- */
306
- export interface RetrieveResult {
307
- /**
308
- * <p>The identifier of query used for the search. You also use <code>QueryId</code> to
309
- * identify the search when using the <a href="https://docs.aws.amazon.com/kendra/latest/APIReference/API_SubmitFeedback.html">Submitfeedback</a>
310
- * API.</p>
311
- * @public
312
- */
313
- QueryId?: string | undefined;
314
- /**
315
- * <p>The results of the retrieved relevant passages for the search.</p>
316
- * @public
317
- */
318
- ResultItems?: RetrieveResultItem[] | undefined;
319
- }
320
- /**
321
- * <p>The resource you want to use is currently in use. Please check you have provided the
322
- * correct resource and try again.</p>
323
- * @public
324
- */
325
- export declare class ResourceInUseException extends __BaseException {
326
- readonly name: "ResourceInUseException";
327
- readonly $fault: "client";
328
- Message?: string | undefined;
329
- /**
330
- * @internal
331
- */
332
- constructor(opts: __ExceptionOptionType<ResourceInUseException, __BaseException>);
333
- }
334
- /**
335
- * @public
336
- */
337
- export interface StartDataSourceSyncJobRequest {
338
- /**
339
- * <p>The identifier of the data source connector to synchronize.</p>
340
- * @public
341
- */
342
- Id: string | undefined;
343
- /**
344
- * <p>The identifier of the index used with the data source connector.</p>
345
- * @public
346
- */
347
- IndexId: string | undefined;
348
- }
349
- /**
350
- * @public
351
- */
352
- export interface StartDataSourceSyncJobResponse {
353
- /**
354
- * <p>Identifies a particular synchronization job.</p>
355
- * @public
356
- */
357
- ExecutionId?: string | undefined;
358
- }
359
- /**
360
- * @public
361
- */
362
- export interface StopDataSourceSyncJobRequest {
363
- /**
364
- * <p>The identifier of the data source connector for which to stop the synchronization
365
- * jobs.</p>
366
- * @public
367
- */
368
- Id: string | undefined;
369
- /**
370
- * <p>The identifier of the index used with the data source connector.</p>
371
- * @public
372
- */
373
- IndexId: string | undefined;
374
- }
375
- /**
376
- * <p>Gathers information about when a particular result was clicked by a user. Your
377
- * application uses the <code>SubmitFeedback</code> API to provide click
378
- * information.</p>
379
- * @public
380
- */
381
- export interface ClickFeedback {
382
- /**
383
- * <p>The identifier of the search result that was clicked.</p>
384
- * @public
385
- */
386
- ResultId: string | undefined;
387
- /**
388
- * <p>The Unix timestamp when the result was clicked.</p>
389
- * @public
390
- */
391
- ClickTime: Date | undefined;
392
- }
393
- /**
394
- * @public
395
- * @enum
396
- */
397
- export declare const RelevanceType: {
398
- readonly NOT_RELEVANT: "NOT_RELEVANT";
399
- readonly RELEVANT: "RELEVANT";
400
- };
401
- /**
402
- * @public
403
- */
404
- export type RelevanceType = (typeof RelevanceType)[keyof typeof RelevanceType];
405
- /**
406
- * <p>Provides feedback on how relevant a document is to a search. Your application uses the
407
- * <code>SubmitFeedback</code> API to provide relevance information.</p>
408
- * @public
409
- */
410
- export interface RelevanceFeedback {
411
- /**
412
- * <p>The identifier of the search result that the user provided relevance feedback
413
- * for.</p>
414
- * @public
415
- */
416
- ResultId: string | undefined;
417
- /**
418
- * <p>Whether the document was relevant or not relevant to the search.</p>
419
- * @public
420
- */
421
- RelevanceValue: RelevanceType | undefined;
422
- }
423
- /**
424
- * @public
425
- */
426
- export interface SubmitFeedbackRequest {
427
- /**
428
- * <p>The identifier of the index that was queried.</p>
429
- * @public
430
- */
431
- IndexId: string | undefined;
432
- /**
433
- * <p>The identifier of the specific query for which you are submitting
434
- * feedback. The query ID is returned in the response to the
435
- * <code>Query</code> API.</p>
436
- * @public
437
- */
438
- QueryId: string | undefined;
439
- /**
440
- * <p>Tells Amazon Kendra that a particular search result link was chosen
441
- * by the user. </p>
442
- * @public
443
- */
444
- ClickFeedbackItems?: ClickFeedback[] | undefined;
445
- /**
446
- * <p>Provides Amazon Kendra with relevant or not relevant feedback for
447
- * whether a particular item was relevant to the search.</p>
448
- * @public
449
- */
450
- RelevanceFeedbackItems?: RelevanceFeedback[] | undefined;
451
- }
452
- /**
453
- * @public
454
- */
455
- export interface TagResourceRequest {
456
- /**
457
- * <p>The Amazon Resource Name (ARN) of the index, FAQ, data source, or other resource to add a tag.
458
- * For example, the ARN of an index is constructed as follows:
459
- * <i>arn:aws:kendra:your-region:your-account-id:index/index-id</i>
460
- * For information on how to construct an ARN for all types of Amazon Kendra resources, see
461
- * <a href="https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonkendra.html#amazonkendra-resources-for-iam-policies">Resource
462
- * types</a>.</p>
463
- * @public
464
- */
465
- ResourceARN: string | undefined;
466
- /**
467
- * <p>A list of tag keys to add to the index, FAQ, data source, or other resource. If a tag already
468
- * exists, the existing value is replaced with the new value.</p>
469
- * @public
470
- */
471
- Tags: Tag[] | undefined;
472
- }
473
- /**
474
- * @public
475
- */
476
- export interface TagResourceResponse {
477
- }
478
- /**
479
- * @public
480
- */
481
- export interface UntagResourceRequest {
482
- /**
483
- * <p>The Amazon Resource Name (ARN) of the index, FAQ, data source, or other resource to remove a tag.
484
- * For example, the ARN of an index is constructed as follows:
485
- * <i>arn:aws:kendra:your-region:your-account-id:index/index-id</i>
486
- * For information on how to construct an ARN for all types of Amazon Kendra resources, see
487
- * <a href="https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonkendra.html#amazonkendra-resources-for-iam-policies">Resource
488
- * types</a>.</p>
489
- * @public
490
- */
491
- ResourceARN: string | undefined;
492
- /**
493
- * <p>A list of tag keys to remove from the index, FAQ, data source, or other resource. If a tag
494
- * key doesn't exist for the resource, it is ignored.</p>
495
- * @public
496
- */
497
- TagKeys: string[] | undefined;
498
- }
499
- /**
500
- * @public
501
- */
502
- export interface UntagResourceResponse {
503
- }
504
- /**
505
- * @public
506
- */
507
- export interface UpdateAccessControlConfigurationRequest {
508
- /**
509
- * <p>The identifier of the index for an access control configuration.</p>
510
- * @public
511
- */
512
- IndexId: string | undefined;
513
- /**
514
- * <p>The identifier of the access control configuration you want to update.</p>
515
- * @public
516
- */
517
- Id: string | undefined;
518
- /**
519
- * <p>A new name for the access control configuration.</p>
520
- * @public
521
- */
522
- Name?: string | undefined;
523
- /**
524
- * <p>A new description for the access control configuration.</p>
525
- * @public
526
- */
527
- Description?: string | undefined;
528
- /**
529
- * <p>Information you want to update on principals (users and/or groups) and which documents
530
- * they should have access to. This is useful for user context filtering, where search
531
- * results are filtered based on the user or their group access to documents.</p>
532
- * @public
533
- */
534
- AccessControlList?: Principal[] | undefined;
535
- /**
536
- * <p>The updated list of <a href="https://docs.aws.amazon.com/kendra/latest/dg/API_Principal.html">principal</a> lists that define the
537
- * hierarchy for which documents users should have access to.</p>
538
- * @public
539
- */
540
- HierarchicalAccessControlList?: HierarchicalPrincipal[] | undefined;
541
- }
542
- /**
543
- * @public
544
- */
545
- export interface UpdateAccessControlConfigurationResponse {
546
- }
547
- /**
548
- * @public
549
- */
550
- export interface UpdateDataSourceRequest {
551
- /**
552
- * <p>The identifier of the data source connector you want to update.</p>
553
- * @public
554
- */
555
- Id: string | undefined;
556
- /**
557
- * <p>A new name for the data source connector.</p>
558
- * @public
559
- */
560
- Name?: string | undefined;
561
- /**
562
- * <p>The identifier of the index used with the data source connector.</p>
563
- * @public
564
- */
565
- IndexId: string | undefined;
566
- /**
567
- * <p>Configuration information you want to update for the data source connector.</p>
568
- * @public
569
- */
570
- Configuration?: DataSourceConfiguration | undefined;
571
- /**
572
- * <p>Configuration information for an Amazon Virtual Private Cloud to connect to your data source.
573
- * For more information, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/vpc-configuration.html">Configuring a VPC</a>.</p>
574
- * @public
575
- */
576
- VpcConfiguration?: DataSourceVpcConfiguration | undefined;
577
- /**
578
- * <p>A new description for the data source connector.</p>
579
- * @public
580
- */
581
- Description?: string | undefined;
582
- /**
583
- * <p>The sync schedule you want to update for the data source connector.</p>
584
- * @public
585
- */
586
- Schedule?: string | undefined;
587
- /**
588
- * <p>The Amazon Resource Name (ARN) of an IAM role with permission to access
589
- * the data source and 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>
590
- * @public
591
- */
592
- RoleArn?: string | undefined;
593
- /**
594
- * <p>The code for a language you want to update for the data source connector.
595
- * This allows you to support a language for all
596
- * documents when updating the data source. English is supported
597
- * by default. For more information on supported languages, including their codes,
598
- * see <a href="https://docs.aws.amazon.com/kendra/latest/dg/in-adding-languages.html">Adding
599
- * documents in languages other than English</a>.</p>
600
- * @public
601
- */
602
- LanguageCode?: string | undefined;
603
- /**
604
- * <p>Configuration information you want to update for altering document metadata and
605
- * content during the document ingestion process.</p>
606
- * <p>For more information on how to create, modify and delete document metadata, or make
607
- * other content alterations when you ingest documents into Amazon Kendra, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/custom-document-enrichment.html">Customizing document metadata during the ingestion process</a>.</p>
608
- * @public
609
- */
610
- CustomDocumentEnrichmentConfiguration?: CustomDocumentEnrichmentConfiguration | undefined;
611
- }
612
- /**
613
- * @public
614
- */
615
- export interface UpdateExperienceRequest {
616
- /**
617
- * <p>The identifier of your Amazon Kendra experience you want to update.</p>
618
- * @public
619
- */
620
- Id: string | undefined;
621
- /**
622
- * <p>A new name for your Amazon Kendra experience.</p>
623
- * @public
624
- */
625
- Name?: string | undefined;
626
- /**
627
- * <p>The identifier of the index for your Amazon Kendra experience.</p>
628
- * @public
629
- */
630
- IndexId: string | undefined;
631
- /**
632
- * <p>The Amazon Resource Name (ARN) of an IAM role with permission to access
633
- * the <code>Query</code> API, <code>QuerySuggestions</code> API, <code>SubmitFeedback</code>
634
- * API, and IAM Identity Center that stores your users and groups information.
635
- * For more information, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html">IAM roles for Amazon Kendra</a>.</p>
636
- * @public
637
- */
638
- RoleArn?: string | undefined;
639
- /**
640
- * <p>Configuration information you want to update for your Amazon Kendra experience.</p>
641
- * @public
642
- */
643
- Configuration?: ExperienceConfiguration | undefined;
644
- /**
645
- * <p>A new description for your Amazon Kendra experience.</p>
646
- * @public
647
- */
648
- Description?: string | undefined;
649
- }
650
- /**
651
- * @public
652
- */
653
- export interface UpdateFeaturedResultsSetRequest {
654
- /**
655
- * <p>The identifier of the index used for featuring results.</p>
656
- * @public
657
- */
658
- IndexId: string | undefined;
659
- /**
660
- * <p>The identifier of the set of featured results that you want to update.</p>
661
- * @public
662
- */
663
- FeaturedResultsSetId: string | undefined;
664
- /**
665
- * <p>A new name for the set of featured results.</p>
666
- * @public
667
- */
668
- FeaturedResultsSetName?: string | undefined;
669
- /**
670
- * <p>A new description for the set of featured results.</p>
671
- * @public
672
- */
673
- Description?: string | undefined;
674
- /**
675
- * <p>You can set the status to <code>ACTIVE</code> or <code>INACTIVE</code>.
676
- * When the value is <code>ACTIVE</code>, featured results are ready for
677
- * use. You can still configure your settings before setting the status
678
- * to <code>ACTIVE</code>. The queries you specify for featured results
679
- * must be unique per featured results set for each index, whether the
680
- * status is <code>ACTIVE</code> or <code>INACTIVE</code>.</p>
681
- * @public
682
- */
683
- Status?: FeaturedResultsSetStatus | undefined;
684
- /**
685
- * <p>A list of queries for featuring results. For more information on the
686
- * list of queries, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/API_FeaturedResultsSet.html">FeaturedResultsSet</a>.</p>
687
- * @public
688
- */
689
- QueryTexts?: string[] | undefined;
690
- /**
691
- * <p>A list of document IDs for the documents you want to feature at the
692
- * top of the search results page. For more information on the list of
693
- * featured documents, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/API_FeaturedResultsSet.html">FeaturedResultsSet</a>.</p>
694
- * @public
695
- */
696
- FeaturedDocuments?: FeaturedDocument[] | undefined;
697
- }
698
- /**
699
- * @public
700
- */
701
- export interface UpdateFeaturedResultsSetResponse {
702
- /**
703
- * <p>Information on the set of featured results. This includes the identifier
704
- * of the featured results set, whether the featured results set is active
705
- * or inactive, when the featured results set was last updated, and more.</p>
706
- * @public
707
- */
708
- FeaturedResultsSet?: FeaturedResultsSet | undefined;
709
- }
710
- /**
711
- * @public
712
- */
713
- export interface UpdateIndexRequest {
714
- /**
715
- * <p>The identifier of the index you want to update.</p>
716
- * @public
717
- */
718
- Id: string | undefined;
719
- /**
720
- * <p>A new name for the index.</p>
721
- * @public
722
- */
723
- Name?: string | undefined;
724
- /**
725
- * <p>An Identity and Access Management (IAM) role that gives Amazon Kendra
726
- * permission to access Amazon CloudWatch logs and metrics.</p>
727
- * @public
728
- */
729
- RoleArn?: string | undefined;
730
- /**
731
- * <p>A new description for the index.</p>
732
- * @public
733
- */
734
- Description?: string | undefined;
735
- /**
736
- * <p>The document metadata configuration you want to update for the index. Document metadata
737
- * are fields or attributes associated with your documents. For example, the company department
738
- * name associated with each document.</p>
739
- * @public
740
- */
741
- DocumentMetadataConfigurationUpdates?: DocumentMetadataConfiguration[] | undefined;
742
- /**
743
- * <p>Sets the number of additional document storage and query capacity units that should be
744
- * used by the index. You can change the capacity of the index up to 5 times per day, or make 5
745
- * API calls.</p>
746
- * <p>If you are using extra storage units, you can't reduce the storage capacity below what is
747
- * required to meet the storage needs for your index.</p>
748
- * @public
749
- */
750
- CapacityUnits?: CapacityUnitsConfiguration | undefined;
751
- /**
752
- * <p>The user token configuration.</p>
753
- * <important>
754
- * <p>If you're using an Amazon Kendra Gen AI Enterprise Edition index and you try to use
755
- * <code>UserTokenConfigurations</code> to configure user context policy, Amazon Kendra returns
756
- * a <code>ValidationException</code> error.</p>
757
- * </important>
758
- * @public
759
- */
760
- UserTokenConfigurations?: UserTokenConfiguration[] | undefined;
761
- /**
762
- * <p>The user context policy.</p>
763
- * <important>
764
- * <p>If you're using an Amazon Kendra Gen AI Enterprise Edition index, you can only use
765
- * <code>ATTRIBUTE_FILTER</code> to filter search results by user context. If you're
766
- * using an Amazon Kendra Gen AI Enterprise Edition index and you try to use
767
- * <code>USER_TOKEN</code> to configure user context policy, Amazon Kendra returns a
768
- * <code>ValidationException</code> error.</p>
769
- * </important>
770
- * @public
771
- */
772
- UserContextPolicy?: UserContextPolicy | undefined;
773
- /**
774
- * <p>Gets users and groups from IAM Identity Center identity source. To configure this,
775
- * see <a href="https://docs.aws.amazon.com/kendra/latest/dg/API_UserGroupResolutionConfiguration.html">UserGroupResolutionConfiguration</a>. This is useful for user context filtering,
776
- * where search results are filtered based on the user or their group access to
777
- * documents.</p>
778
- * <important>
779
- * <p>If you're using an Amazon Kendra Gen AI Enterprise Edition index,
780
- * <code>UserGroupResolutionConfiguration</code> isn't supported.</p>
781
- * </important>
782
- * @public
783
- */
784
- UserGroupResolutionConfiguration?: UserGroupResolutionConfiguration | undefined;
785
- }
786
- /**
787
- * @public
788
- */
789
- export interface UpdateQuerySuggestionsBlockListRequest {
790
- /**
791
- * <p>The identifier of the index for the block list.</p>
792
- * @public
793
- */
794
- IndexId: string | undefined;
795
- /**
796
- * <p>The identifier of the block list you want to update.</p>
797
- * @public
798
- */
799
- Id: string | undefined;
800
- /**
801
- * <p>A new name for the block list.</p>
802
- * @public
803
- */
804
- Name?: string | undefined;
805
- /**
806
- * <p>A new description for the block list.</p>
807
- * @public
808
- */
809
- Description?: string | undefined;
810
- /**
811
- * <p>The S3 path where your block list text file sits in S3.</p>
812
- * <p>If you update your block list and provide the same path to the
813
- * block list text file in S3, then Amazon Kendra reloads the file to refresh
814
- * the block list. Amazon Kendra does not automatically refresh your block list.
815
- * You need to call the <code>UpdateQuerySuggestionsBlockList</code> API
816
- * to refresh you block list.</p>
817
- * <p>If you update your block list, then Amazon Kendra asynchronously refreshes
818
- * all query suggestions with the latest content in the S3 file. This
819
- * means changes might not take effect immediately.</p>
820
- * @public
821
- */
822
- SourceS3Path?: S3Path | undefined;
823
- /**
824
- * <p>The IAM (Identity and Access Management) role used to access the
825
- * block list text file in S3.</p>
826
- * @public
827
- */
828
- RoleArn?: string | undefined;
829
- }
830
- /**
831
- * @public
832
- */
833
- export interface UpdateQuerySuggestionsConfigRequest {
834
- /**
835
- * <p> The identifier of the index with query suggestions you want to update.</p>
836
- * @public
837
- */
838
- IndexId: string | undefined;
839
- /**
840
- * <p>Set the mode to <code>ENABLED</code> or <code>LEARN_ONLY</code>.</p>
841
- * <p>By default, Amazon Kendra enables query suggestions.
842
- * <code>LEARN_ONLY</code> mode allows you to turn off query suggestions.
843
- * You can to update this at any time.</p>
844
- * <p>In <code>LEARN_ONLY</code> mode, Amazon Kendra continues to learn from new
845
- * queries to keep suggestions up to date for when you are ready to
846
- * switch to ENABLED mode again.</p>
847
- * @public
848
- */
849
- Mode?: Mode | undefined;
850
- /**
851
- * <p>How recent your queries are in your query log time window.</p>
852
- * <p>The time window is the number of days from current day to past days.</p>
853
- * <p>By default, Amazon Kendra sets this to 180.</p>
854
- * @public
855
- */
856
- QueryLogLookBackWindowInDays?: number | undefined;
857
- /**
858
- * <p>
859
- * <code>TRUE</code> to include queries without user information (i.e. all queries,
860
- * irrespective of the user), otherwise <code>FALSE</code> to only include queries
861
- * with user information.</p>
862
- * <p>If you pass user information to Amazon Kendra along with the queries, you can set this
863
- * flag to <code>FALSE</code> and instruct Amazon Kendra to only consider queries with user
864
- * information.</p>
865
- * <p>If you set to <code>FALSE</code>, Amazon Kendra only considers queries searched at least
866
- * <code>MinimumQueryCount</code> times across <code>MinimumNumberOfQueryingUsers</code>
867
- * unique users for suggestions.</p>
868
- * <p>If you set to <code>TRUE</code>, Amazon Kendra ignores all user information and learns
869
- * from all queries.</p>
870
- * @public
871
- */
872
- IncludeQueriesWithoutUserInformation?: boolean | undefined;
873
- /**
874
- * <p>The minimum number of unique users who must search a query in order for the query
875
- * to be eligible to suggest to your users.</p>
876
- * <p>Increasing this number might decrease the number of suggestions. However, this
877
- * ensures a query is searched by many users and is truly popular to suggest to users.</p>
878
- * <p>How you tune this setting depends on your specific needs.</p>
879
- * @public
880
- */
881
- MinimumNumberOfQueryingUsers?: number | undefined;
882
- /**
883
- * <p>The the minimum number of times a query must be searched in order to be
884
- * eligible to suggest to your users.</p>
885
- * <p>Decreasing this number increases the number of suggestions. However, this
886
- * affects the quality of suggestions as it sets a low bar for a query to be
887
- * considered popular to suggest to users.</p>
888
- * <p>How you tune this setting depends on your specific needs.</p>
889
- * @public
890
- */
891
- MinimumQueryCount?: number | undefined;
892
- /**
893
- * <p>Configuration information for the document fields/attributes that you want to base
894
- * query suggestions on.</p>
895
- * @public
896
- */
897
- AttributeSuggestionsConfig?: AttributeSuggestionsUpdateConfig | undefined;
898
- }
899
- /**
900
- * @public
901
- */
902
- export interface UpdateThesaurusRequest {
903
- /**
904
- * <p>The identifier of the thesaurus you want to update.</p>
905
- * @public
906
- */
907
- Id: string | undefined;
908
- /**
909
- * <p>A new name for the thesaurus.</p>
910
- * @public
911
- */
912
- Name?: string | undefined;
913
- /**
914
- * <p>The identifier of the index for the thesaurus.</p>
915
- * @public
916
- */
917
- IndexId: string | undefined;
918
- /**
919
- * <p>A new description for the thesaurus.</p>
920
- * @public
921
- */
922
- Description?: string | undefined;
923
- /**
924
- * <p>An IAM role that gives Amazon Kendra permissions to
925
- * access thesaurus file specified in <code>SourceS3Path</code>.</p>
926
- * @public
927
- */
928
- RoleArn?: string | undefined;
929
- /**
930
- * <p>Information required to find a specific file in an Amazon S3 bucket.</p>
931
- * @public
932
- */
933
- SourceS3Path?: S3Path | undefined;
934
- }
935
- /**
936
- * <p>Information about a document attribute or field. You can use document attributes as
937
- * facets.</p>
938
- * <p>For example, the document attribute or facet "Department" includes the values "HR",
939
- * "Engineering", and "Accounting". You can display these values in the search results so that
940
- * documents can be searched by department.</p>
941
- * <p>You can display up to 10 facet values per facet for a query. If you want to increase
942
- * this limit, contact <a href="http://aws.amazon.com/contact-us/">Support</a>.</p>
943
- * @public
944
- */
945
- export interface Facet {
946
- /**
947
- * <p>The unique key for the document attribute.</p>
948
- * @public
949
- */
950
- DocumentAttributeKey?: string | undefined;
951
- /**
952
- * <p>An array of document attributes that are nested facets within a facet.</p>
953
- * <p>For example, the document attribute or facet "Department" includes a value called
954
- * "Engineering". In addition, the document attribute or facet "SubDepartment" includes the
955
- * values "Frontend" and "Backend" for documents assigned to "Engineering". You can display
956
- * nested facets in the search results so that documents can be searched not only by
957
- * department but also by a sub department within a department. This helps your users further
958
- * narrow their search.</p>
959
- * <p>You can only have one nested facet within a facet. If you want to increase this limit,
960
- * contact <a href="http://aws.amazon.com/contact-us/">Support</a>.</p>
961
- * @public
962
- */
963
- Facets?: Facet[] | undefined;
964
- /**
965
- * <p>Maximum number of facet values per facet. The default is 10. You can use this to limit
966
- * the number of facet values to less than 10. If you want to increase the default, contact
967
- * <a href="http://aws.amazon.com/contact-us/">Support</a>.</p>
968
- * @public
969
- */
970
- MaxResults?: number | undefined;
971
- }
972
- /**
973
- * <p>Provides the count of documents that match a particular document attribute or field when
974
- * doing a faceted search.</p>
975
- * @public
976
- */
977
- export interface DocumentAttributeValueCountPair {
978
- /**
979
- * <p>The value of the attribute/field. For example, "HR".</p>
980
- * @public
981
- */
982
- DocumentAttributeValue?: DocumentAttributeValue | undefined;
983
- /**
984
- * <p>The number of documents in the response that have the attribute/field value for the
985
- * key.</p>
986
- * @public
987
- */
988
- Count?: number | undefined;
989
- /**
990
- * <p>Contains the results of a document attribute/field that is a nested facet. A
991
- * <code>FacetResult</code> contains the counts for each facet nested within a
992
- * facet.</p>
993
- * <p>For example, the document attribute or facet "Department" includes a value called
994
- * "Engineering". In addition, the document attribute or facet "SubDepartment" includes the
995
- * values "Frontend" and "Backend" for documents assigned to "Engineering". You can display
996
- * nested facets in the search results so that documents can be searched not only by
997
- * department but also by a sub department within a department. The counts for documents that
998
- * belong to "Frontend" and "Backend" within "Engineering" are returned for a query.</p>
999
- * <p></p>
1000
- * <p></p>
1001
- * @public
1002
- */
1003
- FacetResults?: FacetResult[] | undefined;
1004
- }
1005
- /**
1006
- * <p>The facet values for the documents in the response.</p>
1007
- * @public
1008
- */
1009
- export interface FacetResult {
1010
- /**
1011
- * <p>The key for the facet values. This is the same as the <code>DocumentAttributeKey</code>
1012
- * provided in the query.</p>
1013
- * @public
1014
- */
1015
- DocumentAttributeKey?: string | undefined;
1016
- /**
1017
- * <p>The data type of the facet value. This is the same as the type defined for the index
1018
- * field when it was created.</p>
1019
- * @public
1020
- */
1021
- DocumentAttributeValueType?: DocumentAttributeValueType | undefined;
1022
- /**
1023
- * <p>An array of key/value pairs, where the key is the value of the attribute and the count
1024
- * is the number of documents that share the key value.</p>
1025
- * @public
1026
- */
1027
- DocumentAttributeValueCountPairs?: DocumentAttributeValueCountPair[] | undefined;
1028
- }
1029
- /**
1030
- * <p>Filters the search results based on document attributes or fields.</p>
1031
- * <p>You can filter results using attributes for your particular documents. The attributes
1032
- * must exist in your index. For example, if your documents include the custom attribute
1033
- * "Department", you can filter documents that belong to the "HR" department. You would use
1034
- * the <code>EqualsTo</code> operation to filter results or documents with "Department" equals
1035
- * to "HR".</p>
1036
- * <p>You can use <code>AndAllFilters</code> and <code>OrAllFilters</code> in combination with
1037
- * each other or with other operations such as <code>EqualsTo</code>. For example:</p>
1038
- * <p>
1039
- * <code>AndAllFilters</code>
1040
- * </p>
1041
- * <ul>
1042
- * <li>
1043
- * <p>
1044
- * <code>EqualsTo</code>: "Department", "HR"</p>
1045
- * </li>
1046
- * <li>
1047
- * <p>
1048
- * <code>OrAllFilters</code>
1049
- * </p>
1050
- * <ul>
1051
- * <li>
1052
- * <p>
1053
- * <code>ContainsAny</code>: "Project Name", ["new hires", "new hiring"]</p>
1054
- * </li>
1055
- * </ul>
1056
- * </li>
1057
- * </ul>
1058
- * <p>This example filters results or documents that belong to the HR department
1059
- * <code>AND</code> belong to projects that contain "new hires"
1060
- * <code>OR</code> "new hiring" in the project name (must use
1061
- * <code>ContainAny</code> with <code>StringListValue</code>). This example is filtering
1062
- * with a depth of 2.</p>
1063
- * <p>You cannot filter more than a depth of 2, otherwise you receive a
1064
- * <code>ValidationException</code> exception with the message "AttributeFilter cannot have
1065
- * a depth of more than 2." Also, if you use more than 10 attribute filters in a given list
1066
- * for <code>AndAllFilters</code> or <code>OrAllFilters</code>, you receive a
1067
- * <code>ValidationException</code> with the message "AttributeFilter cannot have a length
1068
- * of more than 10".</p>
1069
- * <p>For examples of using <code>AttributeFilter</code>, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/filtering.html#search-filtering">Using document attributes to
1070
- * filter search results</a>.</p>
1071
- * @public
1072
- */
1073
- export interface AttributeFilter {
1074
- /**
1075
- * <p>Performs a logical <code>AND</code> operation on all filters that you specify.</p>
1076
- * @public
1077
- */
1078
- AndAllFilters?: AttributeFilter[] | undefined;
1079
- /**
1080
- * <p>Performs a logical <code>OR</code> operation on all filters that you specify.</p>
1081
- * @public
1082
- */
1083
- OrAllFilters?: AttributeFilter[] | undefined;
1084
- /**
1085
- * <p>Performs a logical <code>NOT</code> operation on all filters that you specify.</p>
1086
- * @public
1087
- */
1088
- NotFilter?: AttributeFilter | undefined;
1089
- /**
1090
- * <p>Performs an equals operation on document attributes/fields and their values.</p>
1091
- * @public
1092
- */
1093
- EqualsTo?: DocumentAttribute | undefined;
1094
- /**
1095
- * <p>Returns true when a document contains all of the specified document attributes/fields.
1096
- * This filter is only applicable to <a href="https://docs.aws.amazon.com/kendra/latest/APIReference/API_DocumentAttributeValue.html">StringListValue</a>.</p>
1097
- * @public
1098
- */
1099
- ContainsAll?: DocumentAttribute | undefined;
1100
- /**
1101
- * <p>Returns true when a document contains any of the specified document attributes/fields.
1102
- * This filter is only applicable to <a href="https://docs.aws.amazon.com/kendra/latest/APIReference/API_DocumentAttributeValue.html">StringListValue</a>.</p>
1103
- * @public
1104
- */
1105
- ContainsAny?: DocumentAttribute | undefined;
1106
- /**
1107
- * <p>Performs a greater than operation on document attributes/fields and their values. Use
1108
- * with the <a href="https://docs.aws.amazon.com/kendra/latest/APIReference/API_DocumentAttributeValue.html">document attribute
1109
- * type</a>
1110
- * <code>Date</code> or <code>Long</code>.</p>
1111
- * @public
1112
- */
1113
- GreaterThan?: DocumentAttribute | undefined;
1114
- /**
1115
- * <p>Performs a greater or equals than operation on document attributes/fields and their
1116
- * values. Use with the <a href="https://docs.aws.amazon.com/kendra/latest/APIReference/API_DocumentAttributeValue.html">document attribute
1117
- * type</a>
1118
- * <code>Date</code> or <code>Long</code>.</p>
1119
- * @public
1120
- */
1121
- GreaterThanOrEquals?: DocumentAttribute | undefined;
1122
- /**
1123
- * <p>Performs a less than operation on document attributes/fields and their values. Use with
1124
- * the <a href="https://docs.aws.amazon.com/kendra/latest/APIReference/API_DocumentAttributeValue.html">document attribute
1125
- * type</a>
1126
- * <code>Date</code> or <code>Long</code>.</p>
1127
- * @public
1128
- */
1129
- LessThan?: DocumentAttribute | undefined;
1130
- /**
1131
- * <p>Performs a less than or equals operation on document attributes/fields and their values.
1132
- * Use with the <a href="https://docs.aws.amazon.com/kendra/latest/APIReference/API_DocumentAttributeValue.html">document attribute
1133
- * type</a>
1134
- * <code>Date</code> or <code>Long</code>.</p>
1135
- * @public
1136
- */
1137
- LessThanOrEquals?: DocumentAttribute | undefined;
1138
- }
1139
- /**
1140
- * @public
1141
- */
1142
- export interface QueryResult {
1143
- /**
1144
- * <p>The identifier for the search. You also use <code>QueryId</code> to identify the search
1145
- * when using the <a href="https://docs.aws.amazon.com/kendra/latest/APIReference/API_SubmitFeedback.html">SubmitFeedback</a>
1146
- * API.</p>
1147
- * @public
1148
- */
1149
- QueryId?: string | undefined;
1150
- /**
1151
- * <p>The results of the search.</p>
1152
- * @public
1153
- */
1154
- ResultItems?: QueryResultItem[] | undefined;
1155
- /**
1156
- * <p>Contains the facet results. A <code>FacetResult</code> contains the counts for each
1157
- * field/attribute key that was specified in the <code>Facets</code> input parameter.</p>
1158
- * @public
1159
- */
1160
- FacetResults?: FacetResult[] | undefined;
1161
- /**
1162
- * <p>The total number of items found by the search. However, you can only retrieve up to 100
1163
- * items. For example, if the search found 192 items, you can only retrieve the first 100 of
1164
- * the items.</p>
1165
- * @public
1166
- */
1167
- TotalNumberOfResults?: number | undefined;
1168
- /**
1169
- * <p>A list of warning codes and their messages on problems with your query.</p>
1170
- * <p>Amazon Kendra currently only supports one type of warning, which is a warning on
1171
- * 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
1172
- * with advanced query syntax</a>.</p>
1173
- * @public
1174
- */
1175
- Warnings?: Warning[] | undefined;
1176
- /**
1177
- * <p>A list of information related to suggested spell corrections for a query.</p>
1178
- * @public
1179
- */
1180
- SpellCorrectedQueries?: SpellCorrectedQuery[] | undefined;
1181
- /**
1182
- * <p>The list of featured result items. Featured results are displayed at the top of the
1183
- * search results page, placed above all other results for certain queries. If there's an
1184
- * exact match of a query, then certain documents are featured in the search results.</p>
1185
- * @public
1186
- */
1187
- FeaturedResultsItems?: FeaturedResultsItem[] | undefined;
1188
- }
1189
- /**
1190
- * <p>Provides the configuration information for the document fields/attributes that you want
1191
- * to base query suggestions on.</p>
1192
- * @public
1193
- */
1194
- export interface AttributeSuggestionsGetConfig {
1195
- /**
1196
- * <p>The list of document field/attribute keys or field names to use for query suggestions.
1197
- * If the content within any of the fields match what your user starts typing as their query,
1198
- * then the field content is returned as a query suggestion.</p>
1199
- * @public
1200
- */
1201
- SuggestionAttributes?: string[] | undefined;
1202
- /**
1203
- * <p>The list of additional document field/attribute keys or field names to include in the
1204
- * response. You can use additional fields to provide extra information in the response.
1205
- * Additional fields are not used to based suggestions on.</p>
1206
- * @public
1207
- */
1208
- AdditionalResponseAttributes?: string[] | undefined;
1209
- /**
1210
- * <p>Filters the search results based on document fields/attributes.</p>
1211
- * @public
1212
- */
1213
- AttributeFilter?: AttributeFilter | undefined;
1214
- /**
1215
- * <p>Applies user context filtering so that only users who are given access to certain
1216
- * documents see these document in their search results.</p>
1217
- * @public
1218
- */
1219
- UserContext?: UserContext | undefined;
1220
- }
1221
- /**
1222
- * @public
1223
- */
1224
- export interface RetrieveRequest {
1225
- /**
1226
- * <p>The identifier of the index to retrieve relevant passages for the search.</p>
1227
- * @public
1228
- */
1229
- IndexId: string | undefined;
1230
- /**
1231
- * <p>The input query text to retrieve relevant passages for the search. Amazon Kendra
1232
- * truncates queries at 30 token words, which excludes punctuation and stop words.
1233
- * Truncation still applies if you use Boolean or more advanced, complex queries. For
1234
- * example, <code>Timeoff AND October AND Category:HR</code> is counted as 3 tokens:
1235
- * <code>timeoff</code>, <code>october</code>, <code>hr</code>. For more information,
1236
- * see <a href="https://docs.aws.amazon.com/kendra/latest/dg/searching-example.html#searching-index-query-syntax">Searching with advanced query syntax</a> in the Amazon Kendra Developer Guide. </p>
1237
- * @public
1238
- */
1239
- QueryText: string | undefined;
1240
- /**
1241
- * <p>Filters search results by document fields/attributes. You can only provide one
1242
- * attribute filter; however, the <code>AndAllFilters</code>, <code>NotFilter</code>, and
1243
- * <code>OrAllFilters</code> parameters contain a list of other filters.</p>
1244
- * <p>The <code>AttributeFilter</code> parameter means you can create a set of filtering
1245
- * rules that a document must satisfy to be included in the query results.</p>
1246
- * <note>
1247
- * <p>For Amazon Kendra Gen AI Enterprise Edition indices use <code>AttributeFilter</code> to
1248
- * enable document filtering for end users using <code>_email_id</code> or include
1249
- * public documents (<code>_email_id=null</code>).</p>
1250
- * </note>
1251
- * @public
1252
- */
1253
- AttributeFilter?: AttributeFilter | undefined;
1254
- /**
1255
- * <p>A list of document fields/attributes to include in the response. You can limit the
1256
- * response to include certain document fields. By default, all document fields are
1257
- * included in the response.</p>
1258
- * @public
1259
- */
1260
- RequestedDocumentAttributes?: string[] | undefined;
1261
- /**
1262
- * <p>Overrides relevance tuning configurations of fields/attributes set at the index
1263
- * level.</p>
1264
- * <p>If you use this API to override the relevance tuning configured at the index level,
1265
- * but there is no relevance tuning configured at the index level, then Amazon Kendra
1266
- * does not apply any relevance tuning.</p>
1267
- * <p>If there is relevance tuning configured for fields at the index level, and you use
1268
- * this API to override only some of these fields, then for the fields you did not
1269
- * override, the importance is set to 1.</p>
1270
- * @public
1271
- */
1272
- DocumentRelevanceOverrideConfigurations?: DocumentRelevanceConfiguration[] | undefined;
1273
- /**
1274
- * <p>Retrieved relevant passages are returned in pages the size of the
1275
- * <code>PageSize</code> parameter. By default, Amazon Kendra returns the first
1276
- * page of results. Use this parameter to get result pages after the first one.</p>
1277
- * @public
1278
- */
1279
- PageNumber?: number | undefined;
1280
- /**
1281
- * <p>Sets the number of retrieved relevant passages that are returned in each page of
1282
- * results. The default page size is 10. The maximum number of results returned is 100. If
1283
- * you ask for more than 100 results, only 100 are returned.</p>
1284
- * @public
1285
- */
1286
- PageSize?: number | undefined;
1287
- /**
1288
- * <p>The user context token or user and group information.</p>
1289
- * @public
1290
- */
1291
- UserContext?: UserContext | undefined;
1292
- }
1293
- /**
1294
- * @public
1295
- */
1296
- export interface GetQuerySuggestionsRequest {
1297
- /**
1298
- * <p>The identifier of the index you want to get query suggestions from.</p>
1299
- * @public
1300
- */
1301
- IndexId: string | undefined;
1302
- /**
1303
- * <p>The text of a user's query to generate query suggestions.</p>
1304
- * <p>A query is suggested if the query prefix matches
1305
- * what a user starts to type as their query.</p>
1306
- * <p>Amazon Kendra does not show any suggestions if a user
1307
- * types fewer than two characters or more than 60 characters.
1308
- * A query must also have at least one search result and contain
1309
- * at least one word of more than four characters.</p>
1310
- * @public
1311
- */
1312
- QueryText: string | undefined;
1313
- /**
1314
- * <p>The maximum number of query suggestions you want to show
1315
- * to your users.</p>
1316
- * @public
1317
- */
1318
- MaxSuggestionsCount?: number | undefined;
1319
- /**
1320
- * <p>The suggestions type to base query suggestions on. The suggestion
1321
- * types are query history or document fields/attributes. You can set
1322
- * one type or the other.</p>
1323
- * <p>If you set query history as your suggestions type, Amazon Kendra
1324
- * suggests queries relevant to your users based on popular queries in
1325
- * the query history.</p>
1326
- * <p>If you set document fields/attributes as your suggestions type,
1327
- * Amazon Kendra suggests queries relevant to your users based on the
1328
- * contents of document fields.</p>
1329
- * @public
1330
- */
1331
- SuggestionTypes?: SuggestionType[] | undefined;
1332
- /**
1333
- * <p>Configuration information for the document fields/attributes that you
1334
- * want to base query suggestions on.</p>
1335
- * @public
1336
- */
1337
- AttributeSuggestionsConfig?: AttributeSuggestionsGetConfig | undefined;
1338
- }
1339
- /**
1340
- * @public
1341
- */
1342
- export interface QueryRequest {
1343
- /**
1344
- * <p>The identifier of the index for the search.</p>
1345
- * @public
1346
- */
1347
- IndexId: string | undefined;
1348
- /**
1349
- * <p>The input query text for the search. Amazon Kendra truncates queries at 30 token
1350
- * words, which excludes punctuation and stop words. Truncation still applies if you use
1351
- * Boolean or more advanced, complex queries. For example, <code>Timeoff AND October AND
1352
- * Category:HR</code> is counted as 3 tokens: <code>timeoff</code>, <code>october</code>,
1353
- * <code>hr</code>. For more information, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/searching-example.html#searching-index-query-syntax">Searching with advanced query syntax</a> in the Amazon Kendra Developer Guide. </p>
1354
- * @public
1355
- */
1356
- QueryText?: string | undefined;
1357
- /**
1358
- * <p>Filters search results by document fields/attributes. You can only provide one attribute
1359
- * filter; however, the <code>AndAllFilters</code>, <code>NotFilter</code>, and
1360
- * <code>OrAllFilters</code> parameters contain a list of other filters.</p>
1361
- * <p>The <code>AttributeFilter</code> parameter means you can create a set of filtering rules
1362
- * that a document must satisfy to be included in the query results.</p>
1363
- * <note>
1364
- * <p>For Amazon Kendra Gen AI Enterprise Edition indices use <code>AttributeFilter</code> to
1365
- * enable document filtering for end users using <code>_email_id</code> or include public
1366
- * documents (<code>_email_id=null</code>).</p>
1367
- * </note>
1368
- * @public
1369
- */
1370
- AttributeFilter?: AttributeFilter | undefined;
1371
- /**
1372
- * <p>An array of documents fields/attributes for faceted search. Amazon Kendra returns a
1373
- * count for each field key specified. This helps your users narrow their search.</p>
1374
- * @public
1375
- */
1376
- Facets?: Facet[] | undefined;
1377
- /**
1378
- * <p>An array of document fields/attributes to include in the response. You can limit the
1379
- * response to include certain document fields. By default, all document attributes are
1380
- * included in the response.</p>
1381
- * @public
1382
- */
1383
- RequestedDocumentAttributes?: string[] | undefined;
1384
- /**
1385
- * <p>Sets the type of query result or response. Only results for the specified type are
1386
- * returned.</p>
1387
- * @public
1388
- */
1389
- QueryResultTypeFilter?: QueryResultType | undefined;
1390
- /**
1391
- * <p>Overrides relevance tuning configurations of fields/attributes set at the index
1392
- * level.</p>
1393
- * <p>If you use this API to override the relevance tuning configured at the index level, but
1394
- * there is no relevance tuning configured at the index level, then Amazon Kendra does
1395
- * not apply any relevance tuning.</p>
1396
- * <p>If there is relevance tuning configured for fields at the index level, and you use this
1397
- * API to override only some of these fields, then for the fields you did not override, the
1398
- * importance is set to 1.</p>
1399
- * @public
1400
- */
1401
- DocumentRelevanceOverrideConfigurations?: DocumentRelevanceConfiguration[] | undefined;
1402
- /**
1403
- * <p>Query results are returned in pages the size of the <code>PageSize</code> parameter. By
1404
- * default, Amazon Kendra returns the first page of results. Use this parameter to get
1405
- * result pages after the first one.</p>
1406
- * @public
1407
- */
1408
- PageNumber?: number | undefined;
1409
- /**
1410
- * <p>Sets the number of results that are returned in each page of results. The default page
1411
- * size is 10. The maximum number of results returned is 100. If you ask for more than 100
1412
- * results, only 100 are returned.</p>
1413
- * @public
1414
- */
1415
- PageSize?: number | undefined;
1416
- /**
1417
- * <p>Provides information that determines how the results of the query are sorted. You can
1418
- * set the field that Amazon Kendra should sort the results on, and specify whether the
1419
- * results should be sorted in ascending or descending order. In the case of ties in sorting
1420
- * the results, the results are sorted by relevance.</p>
1421
- * <p>If you don't provide sorting configuration, the results are sorted by the relevance that
1422
- * Amazon Kendra determines for the result.</p>
1423
- * @public
1424
- */
1425
- SortingConfiguration?: SortingConfiguration | undefined;
1426
- /**
1427
- * <p>Provides configuration information to determine how the results of a query are
1428
- * sorted.</p>
1429
- * <p>You can set upto 3 fields that Amazon Kendra should sort the results on, and
1430
- * specify whether the results should be sorted in ascending or descending order. The sort
1431
- * field quota can be increased.</p>
1432
- * <p>If you don't provide a sorting configuration, the results are sorted by the relevance
1433
- * that Amazon Kendra determines for the result. In the case of ties in sorting the
1434
- * results, the results are sorted by relevance. </p>
1435
- * @public
1436
- */
1437
- SortingConfigurations?: SortingConfiguration[] | undefined;
1438
- /**
1439
- * <p>The user context token or user and group information.</p>
1440
- * @public
1441
- */
1442
- UserContext?: UserContext | undefined;
1443
- /**
1444
- * <p>Provides an identifier for a specific user. The <code>VisitorId</code> should be a
1445
- * unique identifier, such as a GUID. Don't use personally identifiable information, such as
1446
- * the user's email address, as the <code>VisitorId</code>.</p>
1447
- * @public
1448
- */
1449
- VisitorId?: string | undefined;
1450
- /**
1451
- * <p>Enables suggested spell corrections for queries.</p>
1452
- * @public
1453
- */
1454
- SpellCorrectionConfiguration?: SpellCorrectionConfiguration | undefined;
1455
- /**
1456
- * <p>Provides configuration to determine how to group results by document attribute value,
1457
- * and how to display them (collapsed or expanded) under a designated primary document for
1458
- * each group.</p>
1459
- * @public
1460
- */
1461
- CollapseConfiguration?: CollapseConfiguration | undefined;
1462
- }