@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.
- package/dist-cjs/index.js +396 -396
- package/dist-es/index.js +2 -1
- package/dist-es/models/enums.js +382 -0
- package/dist-es/models/errors.js +171 -0
- package/dist-es/models/models_0.js +1 -525
- package/dist-es/schemas/schemas_0.js +1 -1
- package/dist-types/commands/GetQuerySuggestionsCommand.d.ts +1 -2
- package/dist-types/commands/QueryCommand.d.ts +1 -1
- package/dist-types/commands/RetrieveCommand.d.ts +1 -1
- package/dist-types/commands/StartDataSourceSyncJobCommand.d.ts +1 -1
- package/dist-types/commands/StopDataSourceSyncJobCommand.d.ts +1 -1
- package/dist-types/commands/SubmitFeedbackCommand.d.ts +1 -1
- package/dist-types/commands/TagResourceCommand.d.ts +1 -1
- package/dist-types/commands/UntagResourceCommand.d.ts +1 -1
- package/dist-types/commands/UpdateAccessControlConfigurationCommand.d.ts +1 -1
- package/dist-types/commands/UpdateDataSourceCommand.d.ts +1 -1
- package/dist-types/commands/UpdateExperienceCommand.d.ts +1 -1
- package/dist-types/commands/UpdateFeaturedResultsSetCommand.d.ts +1 -1
- package/dist-types/commands/UpdateIndexCommand.d.ts +1 -1
- package/dist-types/commands/UpdateQuerySuggestionsBlockListCommand.d.ts +1 -1
- package/dist-types/commands/UpdateQuerySuggestionsConfigCommand.d.ts +1 -1
- package/dist-types/commands/UpdateThesaurusCommand.d.ts +1 -1
- package/dist-types/index.d.ts +3 -1
- package/dist-types/models/enums.d.ts +878 -0
- package/dist-types/models/errors.d.ts +185 -0
- package/dist-types/models/models_0.d.ts +1402 -1004
- package/dist-types/ts3.4/commands/GetQuerySuggestionsCommand.d.ts +4 -2
- package/dist-types/ts3.4/commands/QueryCommand.d.ts +1 -1
- package/dist-types/ts3.4/commands/RetrieveCommand.d.ts +1 -1
- package/dist-types/ts3.4/commands/StartDataSourceSyncJobCommand.d.ts +1 -1
- package/dist-types/ts3.4/commands/StopDataSourceSyncJobCommand.d.ts +1 -1
- package/dist-types/ts3.4/commands/SubmitFeedbackCommand.d.ts +1 -1
- package/dist-types/ts3.4/commands/TagResourceCommand.d.ts +1 -1
- package/dist-types/ts3.4/commands/UntagResourceCommand.d.ts +1 -1
- package/dist-types/ts3.4/commands/UpdateAccessControlConfigurationCommand.d.ts +1 -1
- package/dist-types/ts3.4/commands/UpdateDataSourceCommand.d.ts +1 -1
- package/dist-types/ts3.4/commands/UpdateExperienceCommand.d.ts +1 -1
- package/dist-types/ts3.4/commands/UpdateFeaturedResultsSetCommand.d.ts +1 -1
- package/dist-types/ts3.4/commands/UpdateIndexCommand.d.ts +1 -1
- package/dist-types/ts3.4/commands/UpdateQuerySuggestionsBlockListCommand.d.ts +1 -1
- package/dist-types/ts3.4/commands/UpdateQuerySuggestionsConfigCommand.d.ts +1 -1
- package/dist-types/ts3.4/commands/UpdateThesaurusCommand.d.ts +1 -1
- package/dist-types/ts3.4/index.d.ts +3 -1
- package/dist-types/ts3.4/models/enums.d.ts +485 -0
- package/dist-types/ts3.4/models/errors.d.ts +101 -0
- package/dist-types/ts3.4/models/models_0.d.ts +322 -559
- package/package.json +12 -12
- package/dist-es/models/index.js +0 -2
- package/dist-es/models/models_1.js +0 -29
- package/dist-types/models/index.d.ts +0 -2
- package/dist-types/models/models_1.d.ts +0 -1462
- package/dist-types/ts3.4/models/index.d.ts +0 -2
- 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
|
-
}
|