@aws-sdk/client-qbusiness 3.513.0 → 3.515.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/README.md CHANGED
@@ -6,8 +6,89 @@
6
6
 
7
7
  AWS SDK for JavaScript QBusiness Client for Node.js, Browser and React Native.
8
8
 
9
+ <note>
10
+ <p>Amazon Q is in preview release and is subject to change.</p>
11
+ </note>
12
+ <p>This is the <i>Amazon Q (for business use)</i> API Reference.
13
+ Amazon Q is a fully managed, generative-AI powered enterprise chat assistant that
14
+ you can deploy within your organization. Amazon Q enhances employee productivity by
15
+ supporting key tasks such as question-answering, knowledge discovery, writing email
16
+ messages, summarizing text, drafting document outlines, and brainstorming ideas. Users
17
+ ask questions of Amazon Q and get answers that are presented in a conversational
18
+ manner. For an introduction to the service, see the <a href="https://docs.aws.amazon.com/amazonq/latest/business-use-dg/what-is.html">
19
+ <i>Amazon Q (for business use) Developer
20
+ Guide</i>
21
+ </a>.</p>
22
+ <p>For an overview of the Amazon Q APIs, see <a href="https://docs.aws.amazon.com/amazonq/latest/business-use-dg/api-ref.html#api-overview">Overview of Amazon Q API operations</a>.</p>
23
+ <p>For information about the IAM access control permissions you need to
24
+ use this API, see <a href="https://docs.aws.amazon.com/amazonq/latest/business-use-dg/iam-roles.html">IAM roles for Amazon Q</a> in the
25
+ <i>Amazon Q (for business use) Developer Guide</i>.</p>
26
+ <p>You can use the following AWS SDKs to access Amazon Q APIs:</p>
27
+ <ul>
28
+ <li>
9
29
  <p>
30
+ <a href="https://docs.aws.amazon.com/sdk-for-cpp">AWS SDK for C++</a>
10
31
  </p>
32
+ </li>
33
+ <li>
34
+ <p>
35
+ <a href="https://docs.aws.amazon.com/sdk-for-go">AWS SDK for Go</a>
36
+ </p>
37
+ </li>
38
+ <li>
39
+ <p>
40
+ <a href="https://docs.aws.amazon.com/sdk-for-java">AWS SDK for Java</a>
41
+ </p>
42
+ </li>
43
+ <li>
44
+ <p>
45
+ <a href="https://docs.aws.amazon.com/sdk-for-javascript">AWS SDK for
46
+ JavaScript</a>
47
+ </p>
48
+ </li>
49
+ <li>
50
+ <p>
51
+ <a href="https://docs.aws.amazon.com/sdk-for-net">AWS SDK for .NET</a>
52
+ </p>
53
+ </li>
54
+ <li>
55
+ <p>
56
+ <a href="https://docs.aws.amazon.com/pythonsdk">AWS SDK for Python
57
+ (Boto3)</a>
58
+ </p>
59
+ </li>
60
+ <li>
61
+ <p>
62
+ <a href="https://docs.aws.amazon.com/sdk-for-ruby">AWS SDK for Ruby</a>
63
+ </p>
64
+ </li>
65
+ </ul>
66
+ <p>The following resources provide additional information about using the Amazon Q
67
+ API:</p>
68
+ <ul>
69
+ <li>
70
+ <p>
71
+ <i>
72
+ <a href="https://docs.aws.amazon.com/amazonq/latest/business-use-dg/setting-up.html">Setting up for
73
+ Amazon Q</a>
74
+ </i>
75
+ </p>
76
+ </li>
77
+ <li>
78
+ <p>
79
+ <i>
80
+ <a href="https://awscli.amazonaws.com/v2/documentation/api/latest/reference/qbusiness/index.html">Amazon Q CLI Reference</a>
81
+ </i>
82
+ </p>
83
+ </li>
84
+ <li>
85
+ <p>
86
+ <i>
87
+ <a href="https://docs.aws.amazon.com/general/latest/gr/amazonq.html">Amazon Web Services General Reference</a>
88
+ </i>
89
+ </p>
90
+ </li>
91
+ </ul>
11
92
 
12
93
  ## Installing
13
94
 
package/dist-cjs/index.js CHANGED
@@ -53,6 +53,8 @@ __export(src_exports, {
53
53
  DeleteRetrieverCommand: () => DeleteRetrieverCommand,
54
54
  DeleteUserCommand: () => DeleteUserCommand,
55
55
  DeleteWebExperienceCommand: () => DeleteWebExperienceCommand,
56
+ DocumentAttributeBoostingConfiguration: () => DocumentAttributeBoostingConfiguration,
57
+ DocumentAttributeBoostingLevel: () => DocumentAttributeBoostingLevel,
56
58
  DocumentAttributeValue: () => DocumentAttributeValue,
57
59
  DocumentContent: () => DocumentContent,
58
60
  DocumentContentOperator: () => DocumentContentOperator,
@@ -91,6 +93,7 @@ __export(src_exports, {
91
93
  MessageType: () => MessageType,
92
94
  MessageUsefulness: () => MessageUsefulness,
93
95
  MessageUsefulnessReason: () => MessageUsefulnessReason,
96
+ NumberAttributeBoostingType: () => NumberAttributeBoostingType,
94
97
  PluginAuthConfiguration: () => PluginAuthConfiguration,
95
98
  PluginState: () => PluginState,
96
99
  PluginType: () => PluginType,
@@ -112,6 +115,7 @@ __export(src_exports, {
112
115
  StartDataSourceSyncJobCommand: () => StartDataSourceSyncJobCommand,
113
116
  Status: () => Status,
114
117
  StopDataSourceSyncJobCommand: () => StopDataSourceSyncJobCommand,
118
+ StringAttributeValueBoostingLevel: () => StringAttributeValueBoostingLevel,
115
119
  TagResourceCommand: () => TagResourceCommand,
116
120
  ThrottlingException: () => ThrottlingException,
117
121
  UntagResourceCommand: () => UntagResourceCommand,
@@ -573,6 +577,37 @@ var PluginState = {
573
577
  DISABLED: "DISABLED",
574
578
  ENABLED: "ENABLED"
575
579
  };
580
+ var DocumentAttributeBoostingLevel = {
581
+ HIGH: "HIGH",
582
+ LOW: "LOW",
583
+ MEDIUM: "MEDIUM",
584
+ NONE: "NONE",
585
+ VERY_HIGH: "VERY_HIGH"
586
+ };
587
+ var NumberAttributeBoostingType = {
588
+ PRIORITIZE_LARGER_VALUES: "PRIORITIZE_LARGER_VALUES",
589
+ PRIORITIZE_SMALLER_VALUES: "PRIORITIZE_SMALLER_VALUES"
590
+ };
591
+ var StringAttributeValueBoostingLevel = {
592
+ HIGH: "HIGH",
593
+ LOW: "LOW",
594
+ MEDIUM: "MEDIUM",
595
+ VERY_HIGH: "VERY_HIGH"
596
+ };
597
+ var DocumentAttributeBoostingConfiguration;
598
+ ((DocumentAttributeBoostingConfiguration3) => {
599
+ DocumentAttributeBoostingConfiguration3.visit = /* @__PURE__ */ __name((value, visitor) => {
600
+ if (value.numberConfiguration !== void 0)
601
+ return visitor.numberConfiguration(value.numberConfiguration);
602
+ if (value.stringConfiguration !== void 0)
603
+ return visitor.stringConfiguration(value.stringConfiguration);
604
+ if (value.dateConfiguration !== void 0)
605
+ return visitor.dateConfiguration(value.dateConfiguration);
606
+ if (value.stringListConfiguration !== void 0)
607
+ return visitor.stringListConfiguration(value.stringListConfiguration);
608
+ return visitor._(value.$unknown[0], value.$unknown[1]);
609
+ }, "visit");
610
+ })(DocumentAttributeBoostingConfiguration || (DocumentAttributeBoostingConfiguration = {}));
576
611
  var RetrieverConfiguration;
577
612
  ((RetrieverConfiguration3) => {
578
613
  RetrieverConfiguration3.visit = /* @__PURE__ */ __name((value, visitor) => {
@@ -710,8 +745,12 @@ var MessageUsefulnessReason = {
710
745
  HARMFUL_OR_UNSAFE: "HARMFUL_OR_UNSAFE",
711
746
  HELPFUL: "HELPFUL",
712
747
  INCORRECT_OR_MISSING_SOURCES: "INCORRECT_OR_MISSING_SOURCES",
748
+ NOT_BASED_ON_DOCUMENTS: "NOT_BASED_ON_DOCUMENTS",
749
+ NOT_COMPLETE: "NOT_COMPLETE",
750
+ NOT_CONCISE: "NOT_CONCISE",
713
751
  NOT_FACTUALLY_CORRECT: "NOT_FACTUALLY_CORRECT",
714
752
  NOT_HELPFUL: "NOT_HELPFUL",
753
+ OTHER: "OTHER",
715
754
  RELEVANT_SOURCES: "RELEVANT_SOURCES"
716
755
  };
717
756
  var MessageUsefulness = {
@@ -4160,6 +4199,10 @@ var import_util_endpoints = require("@aws-sdk/util-endpoints");
4160
4199
  IndexStatus,
4161
4200
  PluginAuthConfiguration,
4162
4201
  PluginState,
4202
+ DocumentAttributeBoostingLevel,
4203
+ NumberAttributeBoostingType,
4204
+ StringAttributeValueBoostingLevel,
4205
+ DocumentAttributeBoostingConfiguration,
4163
4206
  RetrieverConfiguration,
4164
4207
  RetrieverType,
4165
4208
  RetrieverStatus,
@@ -220,6 +220,37 @@ export const PluginState = {
220
220
  DISABLED: "DISABLED",
221
221
  ENABLED: "ENABLED",
222
222
  };
223
+ export const DocumentAttributeBoostingLevel = {
224
+ HIGH: "HIGH",
225
+ LOW: "LOW",
226
+ MEDIUM: "MEDIUM",
227
+ NONE: "NONE",
228
+ VERY_HIGH: "VERY_HIGH",
229
+ };
230
+ export const NumberAttributeBoostingType = {
231
+ PRIORITIZE_LARGER_VALUES: "PRIORITIZE_LARGER_VALUES",
232
+ PRIORITIZE_SMALLER_VALUES: "PRIORITIZE_SMALLER_VALUES",
233
+ };
234
+ export const StringAttributeValueBoostingLevel = {
235
+ HIGH: "HIGH",
236
+ LOW: "LOW",
237
+ MEDIUM: "MEDIUM",
238
+ VERY_HIGH: "VERY_HIGH",
239
+ };
240
+ export var DocumentAttributeBoostingConfiguration;
241
+ (function (DocumentAttributeBoostingConfiguration) {
242
+ DocumentAttributeBoostingConfiguration.visit = (value, visitor) => {
243
+ if (value.numberConfiguration !== undefined)
244
+ return visitor.numberConfiguration(value.numberConfiguration);
245
+ if (value.stringConfiguration !== undefined)
246
+ return visitor.stringConfiguration(value.stringConfiguration);
247
+ if (value.dateConfiguration !== undefined)
248
+ return visitor.dateConfiguration(value.dateConfiguration);
249
+ if (value.stringListConfiguration !== undefined)
250
+ return visitor.stringListConfiguration(value.stringListConfiguration);
251
+ return visitor._(value.$unknown[0], value.$unknown[1]);
252
+ };
253
+ })(DocumentAttributeBoostingConfiguration || (DocumentAttributeBoostingConfiguration = {}));
223
254
  export var RetrieverConfiguration;
224
255
  (function (RetrieverConfiguration) {
225
256
  RetrieverConfiguration.visit = (value, visitor) => {
@@ -352,8 +383,12 @@ export const MessageUsefulnessReason = {
352
383
  HARMFUL_OR_UNSAFE: "HARMFUL_OR_UNSAFE",
353
384
  HELPFUL: "HELPFUL",
354
385
  INCORRECT_OR_MISSING_SOURCES: "INCORRECT_OR_MISSING_SOURCES",
386
+ NOT_BASED_ON_DOCUMENTS: "NOT_BASED_ON_DOCUMENTS",
387
+ NOT_COMPLETE: "NOT_COMPLETE",
388
+ NOT_CONCISE: "NOT_CONCISE",
355
389
  NOT_FACTUALLY_CORRECT: "NOT_FACTUALLY_CORRECT",
356
390
  NOT_HELPFUL: "NOT_HELPFUL",
391
+ OTHER: "OTHER",
357
392
  RELEVANT_SOURCES: "RELEVANT_SOURCES",
358
393
  };
359
394
  export const MessageUsefulness = {
@@ -389,8 +389,89 @@ export interface QBusiness {
389
389
  }
390
390
  /**
391
391
  * @public
392
- * <p>
393
- * </p>
392
+ * <note>
393
+ * <p>Amazon Q is in preview release and is subject to change.</p>
394
+ * </note>
395
+ * <p>This is the <i>Amazon Q (for business use)</i> API Reference.
396
+ * Amazon Q is a fully managed, generative-AI powered enterprise chat assistant that
397
+ * you can deploy within your organization. Amazon Q enhances employee productivity by
398
+ * supporting key tasks such as question-answering, knowledge discovery, writing email
399
+ * messages, summarizing text, drafting document outlines, and brainstorming ideas. Users
400
+ * ask questions of Amazon Q and get answers that are presented in a conversational
401
+ * manner. For an introduction to the service, see the <a href="https://docs.aws.amazon.com/amazonq/latest/business-use-dg/what-is.html">
402
+ * <i>Amazon Q (for business use) Developer
403
+ * Guide</i>
404
+ * </a>.</p>
405
+ * <p>For an overview of the Amazon Q APIs, see <a href="https://docs.aws.amazon.com/amazonq/latest/business-use-dg/api-ref.html#api-overview">Overview of Amazon Q API operations</a>.</p>
406
+ * <p>For information about the IAM access control permissions you need to
407
+ * use this API, see <a href="https://docs.aws.amazon.com/amazonq/latest/business-use-dg/iam-roles.html">IAM roles for Amazon Q</a> in the
408
+ * <i>Amazon Q (for business use) Developer Guide</i>.</p>
409
+ * <p>You can use the following AWS SDKs to access Amazon Q APIs:</p>
410
+ * <ul>
411
+ * <li>
412
+ * <p>
413
+ * <a href="https://docs.aws.amazon.com/sdk-for-cpp">AWS SDK for C++</a>
414
+ * </p>
415
+ * </li>
416
+ * <li>
417
+ * <p>
418
+ * <a href="https://docs.aws.amazon.com/sdk-for-go">AWS SDK for Go</a>
419
+ * </p>
420
+ * </li>
421
+ * <li>
422
+ * <p>
423
+ * <a href="https://docs.aws.amazon.com/sdk-for-java">AWS SDK for Java</a>
424
+ * </p>
425
+ * </li>
426
+ * <li>
427
+ * <p>
428
+ * <a href="https://docs.aws.amazon.com/sdk-for-javascript">AWS SDK for
429
+ * JavaScript</a>
430
+ * </p>
431
+ * </li>
432
+ * <li>
433
+ * <p>
434
+ * <a href="https://docs.aws.amazon.com/sdk-for-net">AWS SDK for .NET</a>
435
+ * </p>
436
+ * </li>
437
+ * <li>
438
+ * <p>
439
+ * <a href="https://docs.aws.amazon.com/pythonsdk">AWS SDK for Python
440
+ * (Boto3)</a>
441
+ * </p>
442
+ * </li>
443
+ * <li>
444
+ * <p>
445
+ * <a href="https://docs.aws.amazon.com/sdk-for-ruby">AWS SDK for Ruby</a>
446
+ * </p>
447
+ * </li>
448
+ * </ul>
449
+ * <p>The following resources provide additional information about using the Amazon Q
450
+ * API:</p>
451
+ * <ul>
452
+ * <li>
453
+ * <p>
454
+ * <i>
455
+ * <a href="https://docs.aws.amazon.com/amazonq/latest/business-use-dg/setting-up.html">Setting up for
456
+ * Amazon Q</a>
457
+ * </i>
458
+ * </p>
459
+ * </li>
460
+ * <li>
461
+ * <p>
462
+ * <i>
463
+ * <a href="https://awscli.amazonaws.com/v2/documentation/api/latest/reference/qbusiness/index.html">Amazon Q CLI Reference</a>
464
+ * </i>
465
+ * </p>
466
+ * </li>
467
+ * <li>
468
+ * <p>
469
+ * <i>
470
+ * <a href="https://docs.aws.amazon.com/general/latest/gr/amazonq.html">Amazon Web Services General Reference</a>
471
+ * </i>
472
+ * </p>
473
+ * </li>
474
+ * </ul>
394
475
  */
395
476
  export declare class QBusiness extends QBusinessClient implements QBusiness {
396
477
  }
@@ -207,8 +207,89 @@ export interface QBusinessClientResolvedConfig extends QBusinessClientResolvedCo
207
207
  }
208
208
  /**
209
209
  * @public
210
- * <p>
211
- * </p>
210
+ * <note>
211
+ * <p>Amazon Q is in preview release and is subject to change.</p>
212
+ * </note>
213
+ * <p>This is the <i>Amazon Q (for business use)</i> API Reference.
214
+ * Amazon Q is a fully managed, generative-AI powered enterprise chat assistant that
215
+ * you can deploy within your organization. Amazon Q enhances employee productivity by
216
+ * supporting key tasks such as question-answering, knowledge discovery, writing email
217
+ * messages, summarizing text, drafting document outlines, and brainstorming ideas. Users
218
+ * ask questions of Amazon Q and get answers that are presented in a conversational
219
+ * manner. For an introduction to the service, see the <a href="https://docs.aws.amazon.com/amazonq/latest/business-use-dg/what-is.html">
220
+ * <i>Amazon Q (for business use) Developer
221
+ * Guide</i>
222
+ * </a>.</p>
223
+ * <p>For an overview of the Amazon Q APIs, see <a href="https://docs.aws.amazon.com/amazonq/latest/business-use-dg/api-ref.html#api-overview">Overview of Amazon Q API operations</a>.</p>
224
+ * <p>For information about the IAM access control permissions you need to
225
+ * use this API, see <a href="https://docs.aws.amazon.com/amazonq/latest/business-use-dg/iam-roles.html">IAM roles for Amazon Q</a> in the
226
+ * <i>Amazon Q (for business use) Developer Guide</i>.</p>
227
+ * <p>You can use the following AWS SDKs to access Amazon Q APIs:</p>
228
+ * <ul>
229
+ * <li>
230
+ * <p>
231
+ * <a href="https://docs.aws.amazon.com/sdk-for-cpp">AWS SDK for C++</a>
232
+ * </p>
233
+ * </li>
234
+ * <li>
235
+ * <p>
236
+ * <a href="https://docs.aws.amazon.com/sdk-for-go">AWS SDK for Go</a>
237
+ * </p>
238
+ * </li>
239
+ * <li>
240
+ * <p>
241
+ * <a href="https://docs.aws.amazon.com/sdk-for-java">AWS SDK for Java</a>
242
+ * </p>
243
+ * </li>
244
+ * <li>
245
+ * <p>
246
+ * <a href="https://docs.aws.amazon.com/sdk-for-javascript">AWS SDK for
247
+ * JavaScript</a>
248
+ * </p>
249
+ * </li>
250
+ * <li>
251
+ * <p>
252
+ * <a href="https://docs.aws.amazon.com/sdk-for-net">AWS SDK for .NET</a>
253
+ * </p>
254
+ * </li>
255
+ * <li>
256
+ * <p>
257
+ * <a href="https://docs.aws.amazon.com/pythonsdk">AWS SDK for Python
258
+ * (Boto3)</a>
259
+ * </p>
260
+ * </li>
261
+ * <li>
262
+ * <p>
263
+ * <a href="https://docs.aws.amazon.com/sdk-for-ruby">AWS SDK for Ruby</a>
264
+ * </p>
265
+ * </li>
266
+ * </ul>
267
+ * <p>The following resources provide additional information about using the Amazon Q
268
+ * API:</p>
269
+ * <ul>
270
+ * <li>
271
+ * <p>
272
+ * <i>
273
+ * <a href="https://docs.aws.amazon.com/amazonq/latest/business-use-dg/setting-up.html">Setting up for
274
+ * Amazon Q</a>
275
+ * </i>
276
+ * </p>
277
+ * </li>
278
+ * <li>
279
+ * <p>
280
+ * <i>
281
+ * <a href="https://awscli.amazonaws.com/v2/documentation/api/latest/reference/qbusiness/index.html">Amazon Q CLI Reference</a>
282
+ * </i>
283
+ * </p>
284
+ * </li>
285
+ * <li>
286
+ * <p>
287
+ * <i>
288
+ * <a href="https://docs.aws.amazon.com/general/latest/gr/amazonq.html">Amazon Web Services General Reference</a>
289
+ * </i>
290
+ * </p>
291
+ * </li>
292
+ * </ul>
212
293
  */
213
294
  export declare class QBusinessClient extends __Client<__HttpHandlerOptions, ServiceInputTypes, ServiceOutputTypes, QBusinessClientResolvedConfig> {
214
295
  /**
@@ -30,9 +30,9 @@ declare const CreateIndexCommand_base: {
30
30
  * <p>To determine if index creation has completed, check the <code>Status</code> field
31
31
  * returned from a call to <code>DescribeIndex</code>. The <code>Status</code> field is set
32
32
  * to <code>ACTIVE</code> when the index is ready to use.</p>
33
- * <p>Once the index is active, you can index your documents using the <a href="https://docs.aws.amazon.com/enterpriseq/latest/APIReference/API_BatchPutDocument.html">
33
+ * <p>Once the index is active, you can index your documents using the <a href="https://docs.aws.amazon.com/amazonq/latest/api-reference/API_BatchPutDocument.html">
34
34
  * <code>BatchPutDocument</code>
35
- * </a> API or the <a href="https://docs.aws.amazon.com/enterpriseq/latest/APIReference/API_CreateDataSource.html">
35
+ * </a> API or the <a href="https://docs.aws.amazon.com/amazonq/latest/api-reference/API_CreateDataSource.html">
36
36
  * <code>CreateDataSource</code>
37
37
  * </a> API.</p>
38
38
  * @example
@@ -40,6 +40,27 @@ declare const CreateRetrieverCommand_base: {
40
40
  * configuration: { // RetrieverConfiguration Union: only one key present
41
41
  * nativeIndexConfiguration: { // NativeIndexConfiguration
42
42
  * indexId: "STRING_VALUE", // required
43
+ * boostingOverride: { // DocumentAttributeBoostingOverrideMap
44
+ * "<keys>": { // DocumentAttributeBoostingConfiguration Union: only one key present
45
+ * numberConfiguration: { // NumberAttributeBoostingConfiguration
46
+ * boostingLevel: "NONE" || "LOW" || "MEDIUM" || "HIGH" || "VERY_HIGH", // required
47
+ * boostingType: "PRIORITIZE_LARGER_VALUES" || "PRIORITIZE_SMALLER_VALUES",
48
+ * },
49
+ * stringConfiguration: { // StringAttributeBoostingConfiguration
50
+ * boostingLevel: "NONE" || "LOW" || "MEDIUM" || "HIGH" || "VERY_HIGH", // required
51
+ * attributeValueBoosting: { // StringAttributeValueBoosting
52
+ * "<keys>": "LOW" || "MEDIUM" || "HIGH" || "VERY_HIGH",
53
+ * },
54
+ * },
55
+ * dateConfiguration: { // DateAttributeBoostingConfiguration
56
+ * boostingLevel: "NONE" || "LOW" || "MEDIUM" || "HIGH" || "VERY_HIGH", // required
57
+ * boostingDurationInSeconds: Number("long"),
58
+ * },
59
+ * stringListConfiguration: { // StringListAttributeBoostingConfiguration
60
+ * boostingLevel: "NONE" || "LOW" || "MEDIUM" || "HIGH" || "VERY_HIGH", // required
61
+ * },
62
+ * },
63
+ * },
43
64
  * },
44
65
  * kendraIndexConfiguration: { // KendraIndexConfiguration
45
66
  * indexId: "STRING_VALUE", // required
@@ -50,6 +50,27 @@ declare const GetRetrieverCommand_base: {
50
50
  * // configuration: { // RetrieverConfiguration Union: only one key present
51
51
  * // nativeIndexConfiguration: { // NativeIndexConfiguration
52
52
  * // indexId: "STRING_VALUE", // required
53
+ * // boostingOverride: { // DocumentAttributeBoostingOverrideMap
54
+ * // "<keys>": { // DocumentAttributeBoostingConfiguration Union: only one key present
55
+ * // numberConfiguration: { // NumberAttributeBoostingConfiguration
56
+ * // boostingLevel: "NONE" || "LOW" || "MEDIUM" || "HIGH" || "VERY_HIGH", // required
57
+ * // boostingType: "PRIORITIZE_LARGER_VALUES" || "PRIORITIZE_SMALLER_VALUES",
58
+ * // },
59
+ * // stringConfiguration: { // StringAttributeBoostingConfiguration
60
+ * // boostingLevel: "NONE" || "LOW" || "MEDIUM" || "HIGH" || "VERY_HIGH", // required
61
+ * // attributeValueBoosting: { // StringAttributeValueBoosting
62
+ * // "<keys>": "LOW" || "MEDIUM" || "HIGH" || "VERY_HIGH",
63
+ * // },
64
+ * // },
65
+ * // dateConfiguration: { // DateAttributeBoostingConfiguration
66
+ * // boostingLevel: "NONE" || "LOW" || "MEDIUM" || "HIGH" || "VERY_HIGH", // required
67
+ * // boostingDurationInSeconds: Number("long"),
68
+ * // },
69
+ * // stringListConfiguration: { // StringListAttributeBoostingConfiguration
70
+ * // boostingLevel: "NONE" || "LOW" || "MEDIUM" || "HIGH" || "VERY_HIGH", // required
71
+ * // },
72
+ * // },
73
+ * // },
53
74
  * // },
54
75
  * // kendraIndexConfiguration: { // KendraIndexConfiguration
55
76
  * // indexId: "STRING_VALUE", // required
@@ -42,7 +42,7 @@ declare const PutFeedbackCommand_base: {
42
42
  * messageCopiedAt: new Date("TIMESTAMP"),
43
43
  * messageUsefulness: { // MessageUsefulnessFeedback
44
44
  * usefulness: "USEFUL" || "NOT_USEFUL", // required
45
- * reason: "NOT_FACTUALLY_CORRECT" || "HARMFUL_OR_UNSAFE" || "INCORRECT_OR_MISSING_SOURCES" || "NOT_HELPFUL" || "FACTUALLY_CORRECT" || "COMPLETE" || "RELEVANT_SOURCES" || "HELPFUL",
45
+ * reason: "NOT_FACTUALLY_CORRECT" || "HARMFUL_OR_UNSAFE" || "INCORRECT_OR_MISSING_SOURCES" || "NOT_HELPFUL" || "FACTUALLY_CORRECT" || "COMPLETE" || "RELEVANT_SOURCES" || "HELPFUL" || "NOT_BASED_ON_DOCUMENTS" || "NOT_COMPLETE" || "NOT_CONCISE" || "OTHER",
46
46
  * comment: "STRING_VALUE",
47
47
  * submittedAt: new Date("TIMESTAMP"), // required
48
48
  * },
@@ -39,6 +39,27 @@ declare const UpdateRetrieverCommand_base: {
39
39
  * configuration: { // RetrieverConfiguration Union: only one key present
40
40
  * nativeIndexConfiguration: { // NativeIndexConfiguration
41
41
  * indexId: "STRING_VALUE", // required
42
+ * boostingOverride: { // DocumentAttributeBoostingOverrideMap
43
+ * "<keys>": { // DocumentAttributeBoostingConfiguration Union: only one key present
44
+ * numberConfiguration: { // NumberAttributeBoostingConfiguration
45
+ * boostingLevel: "NONE" || "LOW" || "MEDIUM" || "HIGH" || "VERY_HIGH", // required
46
+ * boostingType: "PRIORITIZE_LARGER_VALUES" || "PRIORITIZE_SMALLER_VALUES",
47
+ * },
48
+ * stringConfiguration: { // StringAttributeBoostingConfiguration
49
+ * boostingLevel: "NONE" || "LOW" || "MEDIUM" || "HIGH" || "VERY_HIGH", // required
50
+ * attributeValueBoosting: { // StringAttributeValueBoosting
51
+ * "<keys>": "LOW" || "MEDIUM" || "HIGH" || "VERY_HIGH",
52
+ * },
53
+ * },
54
+ * dateConfiguration: { // DateAttributeBoostingConfiguration
55
+ * boostingLevel: "NONE" || "LOW" || "MEDIUM" || "HIGH" || "VERY_HIGH", // required
56
+ * boostingDurationInSeconds: Number("long"),
57
+ * },
58
+ * stringListConfiguration: { // StringListAttributeBoostingConfiguration
59
+ * boostingLevel: "NONE" || "LOW" || "MEDIUM" || "HIGH" || "VERY_HIGH", // required
60
+ * },
61
+ * },
62
+ * },
42
63
  * },
43
64
  * kendraIndexConfiguration: { // KendraIndexConfiguration
44
65
  * indexId: "STRING_VALUE", // required
@@ -1,6 +1,87 @@
1
1
  /**
2
- * <p>
3
- * </p>
2
+ * <note>
3
+ * <p>Amazon Q is in preview release and is subject to change.</p>
4
+ * </note>
5
+ * <p>This is the <i>Amazon Q (for business use)</i> API Reference.
6
+ * Amazon Q is a fully managed, generative-AI powered enterprise chat assistant that
7
+ * you can deploy within your organization. Amazon Q enhances employee productivity by
8
+ * supporting key tasks such as question-answering, knowledge discovery, writing email
9
+ * messages, summarizing text, drafting document outlines, and brainstorming ideas. Users
10
+ * ask questions of Amazon Q and get answers that are presented in a conversational
11
+ * manner. For an introduction to the service, see the <a href="https://docs.aws.amazon.com/amazonq/latest/business-use-dg/what-is.html">
12
+ * <i>Amazon Q (for business use) Developer
13
+ * Guide</i>
14
+ * </a>.</p>
15
+ * <p>For an overview of the Amazon Q APIs, see <a href="https://docs.aws.amazon.com/amazonq/latest/business-use-dg/api-ref.html#api-overview">Overview of Amazon Q API operations</a>.</p>
16
+ * <p>For information about the IAM access control permissions you need to
17
+ * use this API, see <a href="https://docs.aws.amazon.com/amazonq/latest/business-use-dg/iam-roles.html">IAM roles for Amazon Q</a> in the
18
+ * <i>Amazon Q (for business use) Developer Guide</i>.</p>
19
+ * <p>You can use the following AWS SDKs to access Amazon Q APIs:</p>
20
+ * <ul>
21
+ * <li>
22
+ * <p>
23
+ * <a href="https://docs.aws.amazon.com/sdk-for-cpp">AWS SDK for C++</a>
24
+ * </p>
25
+ * </li>
26
+ * <li>
27
+ * <p>
28
+ * <a href="https://docs.aws.amazon.com/sdk-for-go">AWS SDK for Go</a>
29
+ * </p>
30
+ * </li>
31
+ * <li>
32
+ * <p>
33
+ * <a href="https://docs.aws.amazon.com/sdk-for-java">AWS SDK for Java</a>
34
+ * </p>
35
+ * </li>
36
+ * <li>
37
+ * <p>
38
+ * <a href="https://docs.aws.amazon.com/sdk-for-javascript">AWS SDK for
39
+ * JavaScript</a>
40
+ * </p>
41
+ * </li>
42
+ * <li>
43
+ * <p>
44
+ * <a href="https://docs.aws.amazon.com/sdk-for-net">AWS SDK for .NET</a>
45
+ * </p>
46
+ * </li>
47
+ * <li>
48
+ * <p>
49
+ * <a href="https://docs.aws.amazon.com/pythonsdk">AWS SDK for Python
50
+ * (Boto3)</a>
51
+ * </p>
52
+ * </li>
53
+ * <li>
54
+ * <p>
55
+ * <a href="https://docs.aws.amazon.com/sdk-for-ruby">AWS SDK for Ruby</a>
56
+ * </p>
57
+ * </li>
58
+ * </ul>
59
+ * <p>The following resources provide additional information about using the Amazon Q
60
+ * API:</p>
61
+ * <ul>
62
+ * <li>
63
+ * <p>
64
+ * <i>
65
+ * <a href="https://docs.aws.amazon.com/amazonq/latest/business-use-dg/setting-up.html">Setting up for
66
+ * Amazon Q</a>
67
+ * </i>
68
+ * </p>
69
+ * </li>
70
+ * <li>
71
+ * <p>
72
+ * <i>
73
+ * <a href="https://awscli.amazonaws.com/v2/documentation/api/latest/reference/qbusiness/index.html">Amazon Q CLI Reference</a>
74
+ * </i>
75
+ * </p>
76
+ * </li>
77
+ * <li>
78
+ * <p>
79
+ * <i>
80
+ * <a href="https://docs.aws.amazon.com/general/latest/gr/amazonq.html">Amazon Web Services General Reference</a>
81
+ * </i>
82
+ * </p>
83
+ * </li>
84
+ * </ul>
4
85
  *
5
86
  * @packageDocumentation
6
87
  */
@@ -930,7 +930,7 @@ export declare namespace DocumentAttributeValue {
930
930
  /**
931
931
  * @public
932
932
  * <p>The condition used for the target document attribute or metadata field when ingesting
933
- * documents into Amazon Q. You use this with <a href="https://docs.aws.amazon.com/enterpriseq/latest/APIReference/API_DocumentAttributeTarget.html">
933
+ * documents into Amazon Q. You use this with <a href="https://docs.aws.amazon.com/amazonq/latest/api-reference/API_DocumentAttributeTarget.html">
934
934
  * <code>DocumentAttributeTarget</code>
935
935
  * </a> to apply the condition.</p>
936
936
  * <p>For example, you can create the 'Department' target field and have it prefill
@@ -1002,11 +1002,11 @@ export type AttributeValueOperator = (typeof AttributeValueOperator)[keyof typeo
1002
1002
  * information from each document's metadata.</p>
1003
1003
  * <p>Amazon Q can't create a target field if it has not already been created as an
1004
1004
  * index field. After you create your index field, you can create a document metadata field
1005
- * using <a href="https://docs.aws.amazon.com/enterpriseq/latest/APIReference/API_DocumentAttributeTarget.html">
1005
+ * using <a href="https://docs.aws.amazon.com/amazonq/latest/api-reference/API_DocumentAttributeTarget.html">
1006
1006
  * <code>DocumentAttributeTarget</code>
1007
1007
  * </a>. Amazon Q
1008
1008
  * will then map your newly created document attribute to your index field.</p>
1009
- * <p>You can also use this with <a href="https://docs.aws.amazon.com/enterpriseq/latest/APIReference/API_DocumentAttributeCondition.html">
1009
+ * <p>You can also use this with <a href="https://docs.aws.amazon.com/amazonq/latest/api-reference/API_DocumentAttributeCondition.html">
1010
1010
  * <code>DocumentAttributeCondition</code>
1011
1011
  * </a>.</p>
1012
1012
  */
@@ -1037,7 +1037,7 @@ export interface DocumentAttributeTarget {
1037
1037
  * @public
1038
1038
  * <p>Provides the configuration information for applying basic logic to alter document
1039
1039
  * metadata and content when ingesting documents into Amazon Q.</p>
1040
- * <p>To apply advanced logic, to go beyond what you can do with basic logic, see <a href="https://docs.aws.amazon.com/enterpriseq/latest/APIReference/API_HookConfiguration.html">
1040
+ * <p>To apply advanced logic, to go beyond what you can do with basic logic, see <a href="https://docs.aws.amazon.com/amazonq/latest/api-reference/API_HookConfiguration.html">
1041
1041
  * <code>HookConfiguration</code>
1042
1042
  * </a>.</p>
1043
1043
  * <p>For more information, see <a href="https://docs.aws.amazon.com/amazonq/latest/business-use-dg/custom-document-enrichment.html">Custom document enrichment</a>. </p>
@@ -1046,7 +1046,7 @@ export interface InlineDocumentEnrichmentConfiguration {
1046
1046
  /**
1047
1047
  * @public
1048
1048
  * <p>The condition used for the target document attribute or metadata field when ingesting
1049
- * documents into Amazon Q. You use this with <a href="https://docs.aws.amazon.com/enterpriseq/latest/APIReference/API_DocumentAttributeTarget.html">
1049
+ * documents into Amazon Q. You use this with <a href="https://docs.aws.amazon.com/amazonq/latest/api-reference/API_DocumentAttributeTarget.html">
1050
1050
  * <code>DocumentAttributeTarget</code>
1051
1051
  * </a> to apply the condition.</p>
1052
1052
  * <p>For example, you can create the 'Department' target field and have it prefill
@@ -1071,11 +1071,11 @@ export interface InlineDocumentEnrichmentConfiguration {
1071
1071
  * information from each document's metadata.</p>
1072
1072
  * <p>Amazon Q can't create a target field if it has not already been created as an
1073
1073
  * index field. After you create your index field, you can create a document metadata field
1074
- * using <a href="https://docs.aws.amazon.com/enterpriseq/latest/APIReference/API_DocumentAttributeTarget.html">
1074
+ * using <a href="https://docs.aws.amazon.com/amazonq/latest/api-reference/API_DocumentAttributeTarget.html">
1075
1075
  * <code>DocumentAttributeTarget</code>
1076
1076
  * </a>. Amazon Q
1077
1077
  * will then map your newly created document attribute to your index field.</p>
1078
- * <p>You can also use this with <a href="https://docs.aws.amazon.com/enterpriseq/latest/APIReference/API_DocumentAttributeCondition.html">
1078
+ * <p>You can also use this with <a href="https://docs.aws.amazon.com/amazonq/latest/api-reference/API_DocumentAttributeCondition.html">
1079
1079
  * <code>DocumentAttributeCondition</code>
1080
1080
  * </a>.</p>
1081
1081
  */
@@ -1093,10 +1093,10 @@ export interface InlineDocumentEnrichmentConfiguration {
1093
1093
  * <p>Provides the configuration information for invoking a Lambda function in
1094
1094
  * Lambda to alter document metadata and content when ingesting
1095
1095
  * documents into Amazon Q.</p>
1096
- * <p>You can configure your Lambda function using <a href="https://docs.aws.amazon.com/enterpriseq/latest/APIReference/API_CustomDocumentEnrichmentConfiguration.html">PreExtractionHookConfiguration</a> if you want to apply advanced alterations on
1096
+ * <p>You can configure your Lambda function using <a href="https://docs.aws.amazon.com/amazonq/latest/api-reference/API_DocumentEnrichmentConfiguration.html">PreExtractionHookConfiguration</a> if you want to apply advanced alterations on
1097
1097
  * the original or raw documents.</p>
1098
1098
  * <p>If you want to apply advanced alterations on the Amazon Q structured documents,
1099
- * you must configure your Lambda function using <a href="https://docs.aws.amazon.com/enterpriseq/latest/APIReference/API_CustomDocumentEnrichmentConfiguration.html">PostExtractionHookConfiguration</a>.</p>
1099
+ * you must configure your Lambda function using <a href="https://docs.aws.amazon.com/amazonq/latest/api-reference/API_DocumentEnrichmentConfiguration.html">PostExtractionHookConfiguration</a>.</p>
1100
1100
  * <p>You can only invoke one Lambda function. However, this function can invoke
1101
1101
  * other functions it requires.</p>
1102
1102
  * <p>For more information, see <a href="https://docs.aws.amazon.com/amazonq/latest/business-use-dg/custom-document-enrichment.html">Custom document enrichment</a>. </p>
@@ -1112,8 +1112,8 @@ export interface HookConfiguration {
1112
1112
  /**
1113
1113
  * @public
1114
1114
  * <p>The Amazon Resource Name (ARN) of a role with permission to run a Lambda
1115
- * function during ingestion. For more information, see <a href="https://docs.aws.amazon.com/amazonq/latest/business-use-dg/iam-roles.html#cde-iam-role">IAM roles for Custom
1116
- * Document Enrichment (CDE)</a>.</p>
1115
+ * function during ingestion. For more information, see <a href="https://docs.aws.amazon.com/amazonq/latest/business-use-dg/iam-roles.html#cde-iam-role">IAM roles for
1116
+ * Custom Document Enrichment (CDE)</a>.</p>
1117
1117
  */
1118
1118
  lambdaArn?: string;
1119
1119
  /**
@@ -1150,10 +1150,10 @@ export interface DocumentEnrichmentConfiguration {
1150
1150
  * <p>Provides the configuration information for invoking a Lambda function in
1151
1151
  * Lambda to alter document metadata and content when ingesting
1152
1152
  * documents into Amazon Q.</p>
1153
- * <p>You can configure your Lambda function using <a href="https://docs.aws.amazon.com/enterpriseq/latest/APIReference/API_CustomDocumentEnrichmentConfiguration.html">PreExtractionHookConfiguration</a> if you want to apply advanced alterations on
1153
+ * <p>You can configure your Lambda function using <a href="https://docs.aws.amazon.com/amazonq/latest/api-reference/API_DocumentEnrichmentConfiguration.html">PreExtractionHookConfiguration</a> if you want to apply advanced alterations on
1154
1154
  * the original or raw documents.</p>
1155
1155
  * <p>If you want to apply advanced alterations on the Amazon Q structured documents,
1156
- * you must configure your Lambda function using <a href="https://docs.aws.amazon.com/enterpriseq/latest/APIReference/API_CustomDocumentEnrichmentConfiguration.html">PostExtractionHookConfiguration</a>.</p>
1156
+ * you must configure your Lambda function using <a href="https://docs.aws.amazon.com/amazonq/latest/api-reference/API_DocumentEnrichmentConfiguration.html">PostExtractionHookConfiguration</a>.</p>
1157
1157
  * <p>You can only invoke one Lambda function. However, this function can invoke
1158
1158
  * other functions it requires.</p>
1159
1159
  * <p>For more information, see <a href="https://docs.aws.amazon.com/amazonq/latest/business-use-dg/custom-document-enrichment.html">Custom document enrichment</a>. </p>
@@ -1164,10 +1164,10 @@ export interface DocumentEnrichmentConfiguration {
1164
1164
  * <p>Provides the configuration information for invoking a Lambda function in
1165
1165
  * Lambda to alter document metadata and content when ingesting
1166
1166
  * documents into Amazon Q.</p>
1167
- * <p>You can configure your Lambda function using <a href="https://docs.aws.amazon.com/enterpriseq/latest/APIReference/API_CustomDocumentEnrichmentConfiguration.html">PreExtractionHookConfiguration</a> if you want to apply advanced alterations on
1167
+ * <p>You can configure your Lambda function using <a href="https://docs.aws.amazon.com/amazonq/latest/api-reference/API_DocumentEnrichmentConfiguration.html">PreExtractionHookConfiguration</a> if you want to apply advanced alterations on
1168
1168
  * the original or raw documents.</p>
1169
1169
  * <p>If you want to apply advanced alterations on the Amazon Q structured documents,
1170
- * you must configure your Lambda function using <a href="https://docs.aws.amazon.com/enterpriseq/latest/APIReference/API_CustomDocumentEnrichmentConfiguration.html">PostExtractionHookConfiguration</a>.</p>
1170
+ * you must configure your Lambda function using <a href="https://docs.aws.amazon.com/amazonq/latest/api-reference/API_DocumentEnrichmentConfiguration.html">PostExtractionHookConfiguration</a>.</p>
1171
1171
  * <p>You can only invoke one Lambda function. However, this function can invoke
1172
1172
  * other functions it requires.</p>
1173
1173
  * <p>For more information, see <a href="https://docs.aws.amazon.com/amazonq/latest/business-use-dg/custom-document-enrichment.html">Custom document enrichment</a>. </p>
@@ -2315,6 +2315,217 @@ export interface KendraIndexConfiguration {
2315
2315
  */
2316
2316
  indexId: string | undefined;
2317
2317
  }
2318
+ /**
2319
+ * @public
2320
+ * @enum
2321
+ */
2322
+ export declare const DocumentAttributeBoostingLevel: {
2323
+ readonly HIGH: "HIGH";
2324
+ readonly LOW: "LOW";
2325
+ readonly MEDIUM: "MEDIUM";
2326
+ readonly NONE: "NONE";
2327
+ readonly VERY_HIGH: "VERY_HIGH";
2328
+ };
2329
+ /**
2330
+ * @public
2331
+ */
2332
+ export type DocumentAttributeBoostingLevel = (typeof DocumentAttributeBoostingLevel)[keyof typeof DocumentAttributeBoostingLevel];
2333
+ /**
2334
+ * @public
2335
+ * <p>Provides information on boosting <code>DATE</code> type document attributes.</p>
2336
+ * <p>For more information on how boosting document attributes work in Amazon Q, see
2337
+ * <a href="https://docs.aws.amazon.com/amazonq/latest/business-use-dg/metadata-boosting.html">Boosting using document attributes</a>.</p>
2338
+ */
2339
+ export interface DateAttributeBoostingConfiguration {
2340
+ /**
2341
+ * @public
2342
+ * <p>Specifies how much a document attribute is boosted.</p>
2343
+ */
2344
+ boostingLevel: DocumentAttributeBoostingLevel | undefined;
2345
+ /**
2346
+ * @public
2347
+ * <p>Specifies the duration, in seconds, of a boost applies to a <code>DATE</code> type
2348
+ * document attribute.</p>
2349
+ */
2350
+ boostingDurationInSeconds?: number;
2351
+ }
2352
+ /**
2353
+ * @public
2354
+ * @enum
2355
+ */
2356
+ export declare const NumberAttributeBoostingType: {
2357
+ readonly PRIORITIZE_LARGER_VALUES: "PRIORITIZE_LARGER_VALUES";
2358
+ readonly PRIORITIZE_SMALLER_VALUES: "PRIORITIZE_SMALLER_VALUES";
2359
+ };
2360
+ /**
2361
+ * @public
2362
+ */
2363
+ export type NumberAttributeBoostingType = (typeof NumberAttributeBoostingType)[keyof typeof NumberAttributeBoostingType];
2364
+ /**
2365
+ * @public
2366
+ * <p>Provides information on boosting <code>NUMBER</code> type document attributes.</p>
2367
+ * <p>For more information on how boosting document attributes work in Amazon Q, see
2368
+ * <a href="https://docs.aws.amazon.com/amazonq/latest/business-use-dg/metadata-boosting.html">Boosting using document attributes</a>.</p>
2369
+ */
2370
+ export interface NumberAttributeBoostingConfiguration {
2371
+ /**
2372
+ * @public
2373
+ * <p>Specifies the duration, in seconds, of a boost applies to a <code>NUMBER</code> type
2374
+ * document attribute.</p>
2375
+ */
2376
+ boostingLevel: DocumentAttributeBoostingLevel | undefined;
2377
+ /**
2378
+ * @public
2379
+ * <p>Specifies how much a document attribute is boosted.</p>
2380
+ */
2381
+ boostingType?: NumberAttributeBoostingType;
2382
+ }
2383
+ /**
2384
+ * @public
2385
+ * @enum
2386
+ */
2387
+ export declare const StringAttributeValueBoostingLevel: {
2388
+ readonly HIGH: "HIGH";
2389
+ readonly LOW: "LOW";
2390
+ readonly MEDIUM: "MEDIUM";
2391
+ readonly VERY_HIGH: "VERY_HIGH";
2392
+ };
2393
+ /**
2394
+ * @public
2395
+ */
2396
+ export type StringAttributeValueBoostingLevel = (typeof StringAttributeValueBoostingLevel)[keyof typeof StringAttributeValueBoostingLevel];
2397
+ /**
2398
+ * @public
2399
+ * <p>Provides information on boosting <code>STRING</code> type document attributes.</p>
2400
+ * <note>
2401
+ * <p>For <code>STRING</code> and <code>STRING_LIST</code> type document attributes to
2402
+ * be used for boosting on the console and the API, they must be enabled for search
2403
+ * using the <a href="https://docs.aws.amazon.com/amazonq/latest/api-reference/API_DocumentAttributeConfiguration.html">DocumentAttributeConfiguration</a> object of the <a href="https://docs.aws.amazon.com/amazonq/latest/api-reference/API_UpdateIndex.html">UpdateIndex</a> API. If you haven't enabled searching on these attributes,
2404
+ * you can't boost attributes of these data types on either the console or the
2405
+ * API.</p>
2406
+ * </note>
2407
+ * <p>For more information on how boosting document attributes work in Amazon Q, see
2408
+ * <a href="https://docs.aws.amazon.com/amazonq/latest/business-use-dg/metadata-boosting.html">Boosting using document attributes</a>.</p>
2409
+ */
2410
+ export interface StringAttributeBoostingConfiguration {
2411
+ /**
2412
+ * @public
2413
+ * <p>Specifies how much a document attribute is boosted.</p>
2414
+ */
2415
+ boostingLevel: DocumentAttributeBoostingLevel | undefined;
2416
+ /**
2417
+ * @public
2418
+ * <p>Specifies specific values of a <code>STRING</code> type document attribute being
2419
+ * boosted.</p>
2420
+ */
2421
+ attributeValueBoosting?: Record<string, StringAttributeValueBoostingLevel>;
2422
+ }
2423
+ /**
2424
+ * @public
2425
+ * <p>Provides information on boosting <code>STRING_LIST</code> type document
2426
+ * attributes.</p>
2427
+ * <note>
2428
+ * <p>For <code>STRING</code> and <code>STRING_LIST</code> type document attributes to
2429
+ * be used for boosting on the console and the API, they must be enabled for search
2430
+ * using the <a href="https://docs.aws.amazon.com/amazonq/latest/api-reference/API_DocumentAttributeConfiguration.html">DocumentAttributeConfiguration</a> object of the <a href="https://docs.aws.amazon.com/amazonq/latest/api-reference/API_UpdateIndex.html">UpdateIndex</a> API. If you haven't enabled searching on these attributes,
2431
+ * you can't boost attributes of these data types on either the console or the
2432
+ * API.</p>
2433
+ * </note>
2434
+ * <p>For more information on how boosting document attributes work in Amazon Q, see
2435
+ * <a href="https://docs.aws.amazon.com/amazonq/latest/business-use-dg/metadata-boosting.html">Boosting using document attributes</a>.</p>
2436
+ */
2437
+ export interface StringListAttributeBoostingConfiguration {
2438
+ /**
2439
+ * @public
2440
+ * <p>Specifies how much a document attribute is boosted.</p>
2441
+ */
2442
+ boostingLevel: DocumentAttributeBoostingLevel | undefined;
2443
+ }
2444
+ /**
2445
+ * @public
2446
+ * <p>Provides information on boosting supported Amazon Q document attribute types.
2447
+ * When an end user chat query matches document attributes that have been boosted,
2448
+ * Amazon Q prioritizes generating responses from content that matches the boosted
2449
+ * document attributes.</p>
2450
+ * <note>
2451
+ * <p>For <code>STRING</code> and <code>STRING_LIST</code> type document attributes to
2452
+ * be used for boosting on the console and the API, they must be enabled for search
2453
+ * using the <a href="https://docs.aws.amazon.com/amazonq/latest/api-reference/API_DocumentAttributeConfiguration.html">DocumentAttributeConfiguration</a> object of the <a href="https://docs.aws.amazon.com/amazonq/latest/api-reference/API_UpdateIndex.html">UpdateIndex</a> API. If you haven't enabled searching on these attributes,
2454
+ * you can't boost attributes of these data types on either the console or the
2455
+ * API.</p>
2456
+ * </note>
2457
+ * <p>For more information on how boosting document attributes work in Amazon Q, see
2458
+ * <a href="https://docs.aws.amazon.com/amazonq/latest/business-use-dg/metadata-boosting.html">Boosting using document attributes</a>.</p>
2459
+ */
2460
+ export type DocumentAttributeBoostingConfiguration = DocumentAttributeBoostingConfiguration.DateConfigurationMember | DocumentAttributeBoostingConfiguration.NumberConfigurationMember | DocumentAttributeBoostingConfiguration.StringConfigurationMember | DocumentAttributeBoostingConfiguration.StringListConfigurationMember | DocumentAttributeBoostingConfiguration.$UnknownMember;
2461
+ /**
2462
+ * @public
2463
+ */
2464
+ export declare namespace DocumentAttributeBoostingConfiguration {
2465
+ /**
2466
+ * @public
2467
+ * <p>Provides information on boosting <code>NUMBER</code> type document attributes.</p>
2468
+ */
2469
+ interface NumberConfigurationMember {
2470
+ numberConfiguration: NumberAttributeBoostingConfiguration;
2471
+ stringConfiguration?: never;
2472
+ dateConfiguration?: never;
2473
+ stringListConfiguration?: never;
2474
+ $unknown?: never;
2475
+ }
2476
+ /**
2477
+ * @public
2478
+ * <p>Provides information on boosting <code>STRING</code> type document attributes.</p>
2479
+ */
2480
+ interface StringConfigurationMember {
2481
+ numberConfiguration?: never;
2482
+ stringConfiguration: StringAttributeBoostingConfiguration;
2483
+ dateConfiguration?: never;
2484
+ stringListConfiguration?: never;
2485
+ $unknown?: never;
2486
+ }
2487
+ /**
2488
+ * @public
2489
+ * <p>Provides information on boosting <code>DATE</code> type document attributes.</p>
2490
+ */
2491
+ interface DateConfigurationMember {
2492
+ numberConfiguration?: never;
2493
+ stringConfiguration?: never;
2494
+ dateConfiguration: DateAttributeBoostingConfiguration;
2495
+ stringListConfiguration?: never;
2496
+ $unknown?: never;
2497
+ }
2498
+ /**
2499
+ * @public
2500
+ * <p>Provides information on boosting <code>STRING_LIST</code> type document
2501
+ * attributes.</p>
2502
+ */
2503
+ interface StringListConfigurationMember {
2504
+ numberConfiguration?: never;
2505
+ stringConfiguration?: never;
2506
+ dateConfiguration?: never;
2507
+ stringListConfiguration: StringListAttributeBoostingConfiguration;
2508
+ $unknown?: never;
2509
+ }
2510
+ /**
2511
+ * @public
2512
+ */
2513
+ interface $UnknownMember {
2514
+ numberConfiguration?: never;
2515
+ stringConfiguration?: never;
2516
+ dateConfiguration?: never;
2517
+ stringListConfiguration?: never;
2518
+ $unknown: [string, any];
2519
+ }
2520
+ interface Visitor<T> {
2521
+ numberConfiguration: (value: NumberAttributeBoostingConfiguration) => T;
2522
+ stringConfiguration: (value: StringAttributeBoostingConfiguration) => T;
2523
+ dateConfiguration: (value: DateAttributeBoostingConfiguration) => T;
2524
+ stringListConfiguration: (value: StringListAttributeBoostingConfiguration) => T;
2525
+ _: (name: string, value: any) => T;
2526
+ }
2527
+ const visit: <T>(value: DocumentAttributeBoostingConfiguration, visitor: Visitor<T>) => T;
2528
+ }
2318
2529
  /**
2319
2530
  * @public
2320
2531
  * <p>Configuration information for an Amazon Q index.</p>
@@ -2325,6 +2536,12 @@ export interface NativeIndexConfiguration {
2325
2536
  * <p>The identifier for the Amazon Q index.</p>
2326
2537
  */
2327
2538
  indexId: string | undefined;
2539
+ /**
2540
+ * @public
2541
+ * <p>Overrides the default boosts applied by Amazon Q to supported document attribute
2542
+ * data types.</p>
2543
+ */
2544
+ boostingOverride?: Record<string, DocumentAttributeBoostingConfiguration>;
2328
2545
  }
2329
2546
  /**
2330
2547
  * @public
@@ -4032,7 +4249,7 @@ export interface Rule {
4032
4249
  excludedUsersAndGroups?: UsersAndGroups;
4033
4250
  /**
4034
4251
  * @public
4035
- * <p>The type fo rule.</p>
4252
+ * <p>The type of rule.</p>
4036
4253
  */
4037
4254
  ruleType: RuleType | undefined;
4038
4255
  /**
@@ -4053,7 +4270,7 @@ export interface TopicConfiguration {
4053
4270
  name: string | undefined;
4054
4271
  /**
4055
4272
  * @public
4056
- * <p>A description for your topic control configuration. Use this outline how the large
4273
+ * <p>A description for your topic control configuration. Use this to outline how the large
4057
4274
  * language model (LLM) should use this topic control configuration.</p>
4058
4275
  */
4059
4276
  description?: string;
@@ -4566,8 +4783,12 @@ export declare const MessageUsefulnessReason: {
4566
4783
  readonly HARMFUL_OR_UNSAFE: "HARMFUL_OR_UNSAFE";
4567
4784
  readonly HELPFUL: "HELPFUL";
4568
4785
  readonly INCORRECT_OR_MISSING_SOURCES: "INCORRECT_OR_MISSING_SOURCES";
4786
+ readonly NOT_BASED_ON_DOCUMENTS: "NOT_BASED_ON_DOCUMENTS";
4787
+ readonly NOT_COMPLETE: "NOT_COMPLETE";
4788
+ readonly NOT_CONCISE: "NOT_CONCISE";
4569
4789
  readonly NOT_FACTUALLY_CORRECT: "NOT_FACTUALLY_CORRECT";
4570
4790
  readonly NOT_HELPFUL: "NOT_HELPFUL";
4791
+ readonly OTHER: "OTHER";
4571
4792
  readonly RELEVANT_SOURCES: "RELEVANT_SOURCES";
4572
4793
  };
4573
4794
  /**
@@ -4942,8 +5163,7 @@ export interface UpdateUserResponse {
4942
5163
  }
4943
5164
  /**
4944
5165
  * @public
4945
- * <p>Enables filtering of Amazon Q web experience responses based on document
4946
- * attributes or metadata fields.</p>
5166
+ * <p>Enables filtering of responses based on document attributes or metadata fields.</p>
4947
5167
  */
4948
5168
  export interface AttributeFilter {
4949
5169
  /**
@@ -652,8 +652,103 @@ export interface UpdatePluginResponse {}
652
652
  export interface KendraIndexConfiguration {
653
653
  indexId: string | undefined;
654
654
  }
655
+ export declare const DocumentAttributeBoostingLevel: {
656
+ readonly HIGH: "HIGH";
657
+ readonly LOW: "LOW";
658
+ readonly MEDIUM: "MEDIUM";
659
+ readonly NONE: "NONE";
660
+ readonly VERY_HIGH: "VERY_HIGH";
661
+ };
662
+ export type DocumentAttributeBoostingLevel =
663
+ (typeof DocumentAttributeBoostingLevel)[keyof typeof DocumentAttributeBoostingLevel];
664
+ export interface DateAttributeBoostingConfiguration {
665
+ boostingLevel: DocumentAttributeBoostingLevel | undefined;
666
+ boostingDurationInSeconds?: number;
667
+ }
668
+ export declare const NumberAttributeBoostingType: {
669
+ readonly PRIORITIZE_LARGER_VALUES: "PRIORITIZE_LARGER_VALUES";
670
+ readonly PRIORITIZE_SMALLER_VALUES: "PRIORITIZE_SMALLER_VALUES";
671
+ };
672
+ export type NumberAttributeBoostingType =
673
+ (typeof NumberAttributeBoostingType)[keyof typeof NumberAttributeBoostingType];
674
+ export interface NumberAttributeBoostingConfiguration {
675
+ boostingLevel: DocumentAttributeBoostingLevel | undefined;
676
+ boostingType?: NumberAttributeBoostingType;
677
+ }
678
+ export declare const StringAttributeValueBoostingLevel: {
679
+ readonly HIGH: "HIGH";
680
+ readonly LOW: "LOW";
681
+ readonly MEDIUM: "MEDIUM";
682
+ readonly VERY_HIGH: "VERY_HIGH";
683
+ };
684
+ export type StringAttributeValueBoostingLevel =
685
+ (typeof StringAttributeValueBoostingLevel)[keyof typeof StringAttributeValueBoostingLevel];
686
+ export interface StringAttributeBoostingConfiguration {
687
+ boostingLevel: DocumentAttributeBoostingLevel | undefined;
688
+ attributeValueBoosting?: Record<string, StringAttributeValueBoostingLevel>;
689
+ }
690
+ export interface StringListAttributeBoostingConfiguration {
691
+ boostingLevel: DocumentAttributeBoostingLevel | undefined;
692
+ }
693
+ export type DocumentAttributeBoostingConfiguration =
694
+ | DocumentAttributeBoostingConfiguration.DateConfigurationMember
695
+ | DocumentAttributeBoostingConfiguration.NumberConfigurationMember
696
+ | DocumentAttributeBoostingConfiguration.StringConfigurationMember
697
+ | DocumentAttributeBoostingConfiguration.StringListConfigurationMember
698
+ | DocumentAttributeBoostingConfiguration.$UnknownMember;
699
+ export declare namespace DocumentAttributeBoostingConfiguration {
700
+ interface NumberConfigurationMember {
701
+ numberConfiguration: NumberAttributeBoostingConfiguration;
702
+ stringConfiguration?: never;
703
+ dateConfiguration?: never;
704
+ stringListConfiguration?: never;
705
+ $unknown?: never;
706
+ }
707
+ interface StringConfigurationMember {
708
+ numberConfiguration?: never;
709
+ stringConfiguration: StringAttributeBoostingConfiguration;
710
+ dateConfiguration?: never;
711
+ stringListConfiguration?: never;
712
+ $unknown?: never;
713
+ }
714
+ interface DateConfigurationMember {
715
+ numberConfiguration?: never;
716
+ stringConfiguration?: never;
717
+ dateConfiguration: DateAttributeBoostingConfiguration;
718
+ stringListConfiguration?: never;
719
+ $unknown?: never;
720
+ }
721
+ interface StringListConfigurationMember {
722
+ numberConfiguration?: never;
723
+ stringConfiguration?: never;
724
+ dateConfiguration?: never;
725
+ stringListConfiguration: StringListAttributeBoostingConfiguration;
726
+ $unknown?: never;
727
+ }
728
+ interface $UnknownMember {
729
+ numberConfiguration?: never;
730
+ stringConfiguration?: never;
731
+ dateConfiguration?: never;
732
+ stringListConfiguration?: never;
733
+ $unknown: [string, any];
734
+ }
735
+ interface Visitor<T> {
736
+ numberConfiguration: (value: NumberAttributeBoostingConfiguration) => T;
737
+ stringConfiguration: (value: StringAttributeBoostingConfiguration) => T;
738
+ dateConfiguration: (value: DateAttributeBoostingConfiguration) => T;
739
+ stringListConfiguration: (
740
+ value: StringListAttributeBoostingConfiguration
741
+ ) => T;
742
+ _: (name: string, value: any) => T;
743
+ }
744
+ const visit: <T>(
745
+ value: DocumentAttributeBoostingConfiguration,
746
+ visitor: Visitor<T>
747
+ ) => T;
748
+ }
655
749
  export interface NativeIndexConfiguration {
656
750
  indexId: string | undefined;
751
+ boostingOverride?: Record<string, DocumentAttributeBoostingConfiguration>;
657
752
  }
658
753
  export type RetrieverConfiguration =
659
754
  | RetrieverConfiguration.KendraIndexConfigurationMember
@@ -1280,8 +1375,12 @@ export declare const MessageUsefulnessReason: {
1280
1375
  readonly HARMFUL_OR_UNSAFE: "HARMFUL_OR_UNSAFE";
1281
1376
  readonly HELPFUL: "HELPFUL";
1282
1377
  readonly INCORRECT_OR_MISSING_SOURCES: "INCORRECT_OR_MISSING_SOURCES";
1378
+ readonly NOT_BASED_ON_DOCUMENTS: "NOT_BASED_ON_DOCUMENTS";
1379
+ readonly NOT_COMPLETE: "NOT_COMPLETE";
1380
+ readonly NOT_CONCISE: "NOT_CONCISE";
1283
1381
  readonly NOT_FACTUALLY_CORRECT: "NOT_FACTUALLY_CORRECT";
1284
1382
  readonly NOT_HELPFUL: "NOT_HELPFUL";
1383
+ readonly OTHER: "OTHER";
1285
1384
  readonly RELEVANT_SOURCES: "RELEVANT_SOURCES";
1286
1385
  };
1287
1386
  export type MessageUsefulnessReason =
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@aws-sdk/client-qbusiness",
3
3
  "description": "AWS SDK for JavaScript Qbusiness Client for Node.js, Browser and React Native",
4
- "version": "3.513.0",
4
+ "version": "3.515.0",
5
5
  "scripts": {
6
6
  "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
7
7
  "build:cjs": "node ../../scripts/compilation/inline client-qbusiness",
@@ -20,18 +20,18 @@
20
20
  "dependencies": {
21
21
  "@aws-crypto/sha256-browser": "3.0.0",
22
22
  "@aws-crypto/sha256-js": "3.0.0",
23
- "@aws-sdk/client-sts": "3.513.0",
23
+ "@aws-sdk/client-sts": "3.515.0",
24
24
  "@aws-sdk/core": "3.513.0",
25
- "@aws-sdk/credential-provider-node": "3.513.0",
26
- "@aws-sdk/middleware-host-header": "3.511.0",
27
- "@aws-sdk/middleware-logger": "3.511.0",
28
- "@aws-sdk/middleware-recursion-detection": "3.511.0",
29
- "@aws-sdk/middleware-user-agent": "3.511.0",
30
- "@aws-sdk/region-config-resolver": "3.511.0",
31
- "@aws-sdk/types": "3.511.0",
32
- "@aws-sdk/util-endpoints": "3.511.0",
33
- "@aws-sdk/util-user-agent-browser": "3.511.0",
34
- "@aws-sdk/util-user-agent-node": "3.511.0",
25
+ "@aws-sdk/credential-provider-node": "3.515.0",
26
+ "@aws-sdk/middleware-host-header": "3.515.0",
27
+ "@aws-sdk/middleware-logger": "3.515.0",
28
+ "@aws-sdk/middleware-recursion-detection": "3.515.0",
29
+ "@aws-sdk/middleware-user-agent": "3.515.0",
30
+ "@aws-sdk/region-config-resolver": "3.515.0",
31
+ "@aws-sdk/types": "3.515.0",
32
+ "@aws-sdk/util-endpoints": "3.515.0",
33
+ "@aws-sdk/util-user-agent-browser": "3.515.0",
34
+ "@aws-sdk/util-user-agent-node": "3.515.0",
35
35
  "@smithy/config-resolver": "^2.1.1",
36
36
  "@smithy/core": "^1.3.2",
37
37
  "@smithy/fetch-http-handler": "^2.4.1",
@@ -58,13 +58,13 @@
58
58
  "@smithy/util-retry": "^2.1.1",
59
59
  "@smithy/util-utf8": "^2.1.1",
60
60
  "tslib": "^2.5.0",
61
- "uuid": "^8.3.2"
61
+ "uuid": "^9.0.1"
62
62
  },
63
63
  "devDependencies": {
64
64
  "@smithy/service-client-documentation-generator": "^2.1.1",
65
65
  "@tsconfig/node14": "1.0.3",
66
66
  "@types/node": "^14.14.31",
67
- "@types/uuid": "^8.3.0",
67
+ "@types/uuid": "^9.0.4",
68
68
  "concurrently": "7.0.0",
69
69
  "downlevel-dts": "0.10.1",
70
70
  "rimraf": "3.0.2",