@aws-sdk/client-bedrock-agent-runtime 3.533.0 → 3.540.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.
@@ -1,8 +1,8 @@
1
1
  import { ExceptionOptionType as __ExceptionOptionType } from "@smithy/smithy-client";
2
2
  import { BedrockAgentRuntimeServiceException as __BaseException } from "./BedrockAgentRuntimeServiceException";
3
3
  /**
4
- * @public
5
4
  * <p>The request is denied because of missing access permissions. Check your permissions and retry your request.</p>
5
+ * @public
6
6
  */
7
7
  export declare class AccessDeniedException extends __BaseException {
8
8
  readonly name: "AccessDeniedException";
@@ -13,89 +13,89 @@ export declare class AccessDeniedException extends __BaseException {
13
13
  constructor(opts: __ExceptionOptionType<AccessDeniedException, __BaseException>);
14
14
  }
15
15
  /**
16
- * @public
17
16
  * <p>A parameter in the Lambda input event.</p>
17
+ * @public
18
18
  */
19
19
  export interface Parameter {
20
20
  /**
21
- * @public
22
21
  * <p>The name of the parameter.</p>
22
+ * @public
23
23
  */
24
24
  name?: string;
25
25
  /**
26
- * @public
27
26
  * <p>The type of the parameter.</p>
27
+ * @public
28
28
  */
29
29
  type?: string;
30
30
  /**
31
- * @public
32
31
  * <p>The value of the parameter.</p>
32
+ * @public
33
33
  */
34
34
  value?: string;
35
35
  }
36
36
  /**
37
- * @public
38
37
  * <p>The parameters in the request body for the Lambda input event.</p>
38
+ * @public
39
39
  */
40
40
  export interface RequestBody {
41
41
  /**
42
- * @public
43
42
  * <p>The content in the request body.</p>
43
+ * @public
44
44
  */
45
45
  content?: Record<string, Parameter[]>;
46
46
  }
47
47
  /**
48
- * @public
49
48
  * <p>Contains information about the action group being invoked.</p>
49
+ * @public
50
50
  */
51
51
  export interface ActionGroupInvocationInput {
52
52
  /**
53
- * @public
54
53
  * <p>The name of the action group.</p>
54
+ * @public
55
55
  */
56
56
  actionGroupName?: string;
57
57
  /**
58
- * @public
59
58
  * <p>The API method being used, based off the action group.</p>
59
+ * @public
60
60
  */
61
61
  verb?: string;
62
62
  /**
63
- * @public
64
63
  * <p>The path to the API to call, based off the action group.</p>
64
+ * @public
65
65
  */
66
66
  apiPath?: string;
67
67
  /**
68
- * @public
69
68
  * <p>The parameters in the Lambda input event.</p>
69
+ * @public
70
70
  */
71
71
  parameters?: Parameter[];
72
72
  /**
73
- * @public
74
73
  * <p>The parameters in the request body for the Lambda input event.</p>
74
+ * @public
75
75
  */
76
76
  requestBody?: RequestBody;
77
77
  }
78
78
  /**
79
- * @public
80
79
  * <p>Contains the JSON-formatted string returned by the API invoked by the action group.</p>
80
+ * @public
81
81
  */
82
82
  export interface ActionGroupInvocationOutput {
83
83
  /**
84
- * @public
85
84
  * <p>The JSON-formatted string returned by the API invoked by the action group.</p>
85
+ * @public
86
86
  */
87
87
  text?: string;
88
88
  }
89
89
  /**
90
- * @public
91
90
  * <p>There was an issue with a dependency due to a server issue. Retry your request.</p>
91
+ * @public
92
92
  */
93
93
  export declare class BadGatewayException extends __BaseException {
94
94
  readonly name: "BadGatewayException";
95
95
  readonly $fault: "server";
96
96
  /**
97
- * @public
98
97
  * <p>The name of the dependency that caused the issue, such as Amazon Bedrock, Lambda, or STS.</p>
98
+ * @public
99
99
  */
100
100
  resourceName?: string;
101
101
  /**
@@ -104,8 +104,8 @@ export declare class BadGatewayException extends __BaseException {
104
104
  constructor(opts: __ExceptionOptionType<BadGatewayException, __BaseException>);
105
105
  }
106
106
  /**
107
- * @public
108
107
  * <p>There was a conflict performing an operation. Resolve the conflict and retry your request.</p>
108
+ * @public
109
109
  */
110
110
  export declare class ConflictException extends __BaseException {
111
111
  readonly name: "ConflictException";
@@ -116,15 +116,15 @@ export declare class ConflictException extends __BaseException {
116
116
  constructor(opts: __ExceptionOptionType<ConflictException, __BaseException>);
117
117
  }
118
118
  /**
119
- * @public
120
119
  * <p>There was an issue with a dependency. Check the resource configurations and retry the request.</p>
120
+ * @public
121
121
  */
122
122
  export declare class DependencyFailedException extends __BaseException {
123
123
  readonly name: "DependencyFailedException";
124
124
  readonly $fault: "client";
125
125
  /**
126
- * @public
127
126
  * <p>The name of the dependency that caused the issue, such as Amazon Bedrock, Lambda, or STS.</p>
127
+ * @public
128
128
  */
129
129
  resourceName?: string;
130
130
  /**
@@ -133,8 +133,8 @@ export declare class DependencyFailedException extends __BaseException {
133
133
  constructor(opts: __ExceptionOptionType<DependencyFailedException, __BaseException>);
134
134
  }
135
135
  /**
136
- * @public
137
136
  * <p>An internal server error occurred. Retry your request.</p>
137
+ * @public
138
138
  */
139
139
  export declare class InternalServerException extends __BaseException {
140
140
  readonly name: "InternalServerException";
@@ -145,18 +145,18 @@ export declare class InternalServerException extends __BaseException {
145
145
  constructor(opts: __ExceptionOptionType<InternalServerException, __BaseException>);
146
146
  }
147
147
  /**
148
- * @public
149
148
  * <p>Contains parameters that specify various attributes that persist across a session or prompt. You can define session state attributes as key-value pairs when writing a <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/agents-lambda.html">Lambda function</a> for an action group or pass them when making an <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html">InvokeAgent</a> request. Use session state attributes to control and provide conversational context for your agent and to help customize your agent's behavior. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/sessionstate.html">Session context</a>.</p>
149
+ * @public
150
150
  */
151
151
  export interface SessionState {
152
152
  /**
153
- * @public
154
153
  * <p>Contains attributes that persist across a session and the values of those attributes.</p>
154
+ * @public
155
155
  */
156
156
  sessionAttributes?: Record<string, string>;
157
157
  /**
158
- * @public
159
158
  * <p>Contains attributes that persist across a prompt and the values of those attributes. These attributes replace the $prompt_session_attributes$ placeholder variable in the orchestration prompt template. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/prompt-placeholders.html">Prompt template placeholder variables</a>.</p>
159
+ * @public
160
160
  */
161
161
  promptSessionAttributes?: Record<string, string>;
162
162
  }
@@ -165,103 +165,103 @@ export interface SessionState {
165
165
  */
166
166
  export interface InvokeAgentRequest {
167
167
  /**
168
- * @public
169
168
  * <p>Contains parameters that specify various attributes of the session.</p>
169
+ * @public
170
170
  */
171
171
  sessionState?: SessionState;
172
172
  /**
173
- * @public
174
173
  * <p>The unique identifier of the agent to use.</p>
174
+ * @public
175
175
  */
176
176
  agentId: string | undefined;
177
177
  /**
178
- * @public
179
178
  * <p>The alias of the agent to use.</p>
179
+ * @public
180
180
  */
181
181
  agentAliasId: string | undefined;
182
182
  /**
183
- * @public
184
183
  * <p>The unique identifier of the session. Use the same value across requests to continue the same conversation.</p>
184
+ * @public
185
185
  */
186
186
  sessionId: string | undefined;
187
187
  /**
188
- * @public
189
188
  * <p>Specifies whether to end the session with the agent or not.</p>
189
+ * @public
190
190
  */
191
191
  endSession?: boolean;
192
192
  /**
193
- * @public
194
193
  * <p>Specifies whether to turn on the trace or not to track the agent's reasoning process. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/agents-test.html#trace-events">Trace enablement</a>.</p>
194
+ * @public
195
195
  */
196
196
  enableTrace?: boolean;
197
197
  /**
198
- * @public
199
198
  * <p>The prompt text to send the agent.</p>
199
+ * @public
200
200
  */
201
201
  inputText: string | undefined;
202
202
  }
203
203
  /**
204
- * @public
205
204
  * <p>Contains information about where the text with a citation begins and ends in the generated output.</p>
205
+ * @public
206
206
  */
207
207
  export interface Span {
208
208
  /**
209
- * @public
210
209
  * <p>Where the text with a citation starts in the generated output.</p>
210
+ * @public
211
211
  */
212
212
  start?: number;
213
213
  /**
214
- * @public
215
214
  * <p>Where the text with a citation ends in the generated output.</p>
215
+ * @public
216
216
  */
217
217
  end?: number;
218
218
  }
219
219
  /**
220
- * @public
221
220
  * <p>Contains the part of the generated text that contains a citation, alongside where it begins and ends.</p>
221
+ * @public
222
222
  */
223
223
  export interface TextResponsePart {
224
224
  /**
225
- * @public
226
225
  * <p>The part of the generated text that contains a citation.</p>
226
+ * @public
227
227
  */
228
228
  text?: string;
229
229
  /**
230
- * @public
231
230
  * <p>Contains information about where the text with a citation begins and ends in the generated output.</p>
231
+ * @public
232
232
  */
233
233
  span?: Span;
234
234
  }
235
235
  /**
236
- * @public
237
236
  * <p>Contains metadata about a part of the generated response that is accompanied by a citation.</p>
237
+ * @public
238
238
  */
239
239
  export interface GeneratedResponsePart {
240
240
  /**
241
- * @public
242
241
  * <p>Contains metadata about a textual part of the generated response that is accompanied by a citation.</p>
242
+ * @public
243
243
  */
244
244
  textResponsePart?: TextResponsePart;
245
245
  }
246
246
  /**
247
- * @public
248
247
  * <p>Contains the cited text from the data source.</p>
248
+ * @public
249
249
  */
250
250
  export interface RetrievalResultContent {
251
251
  /**
252
- * @public
253
252
  * <p>The cited text from the data source.</p>
253
+ * @public
254
254
  */
255
255
  text: string | undefined;
256
256
  }
257
257
  /**
258
- * @public
259
258
  * <p>Contains the S3 location of the data source.</p>
259
+ * @public
260
260
  */
261
261
  export interface RetrievalResultS3Location {
262
262
  /**
263
- * @public
264
263
  * <p>The S3 URI of the data source.</p>
264
+ * @public
265
265
  */
266
266
  uri?: string;
267
267
  }
@@ -277,83 +277,83 @@ export declare const RetrievalResultLocationType: {
277
277
  */
278
278
  export type RetrievalResultLocationType = (typeof RetrievalResultLocationType)[keyof typeof RetrievalResultLocationType];
279
279
  /**
280
- * @public
281
280
  * <p>Contains information about the location of the data source.</p>
281
+ * @public
282
282
  */
283
283
  export interface RetrievalResultLocation {
284
284
  /**
285
- * @public
286
285
  * <p>The type of the location of the data source.</p>
286
+ * @public
287
287
  */
288
288
  type: RetrievalResultLocationType | undefined;
289
289
  /**
290
- * @public
291
290
  * <p>Contains the S3 location of the data source.</p>
291
+ * @public
292
292
  */
293
293
  s3Location?: RetrievalResultS3Location;
294
294
  }
295
295
  /**
296
- * @public
297
296
  * <p>Contains metadata about a sources cited for the generated response.</p>
297
+ * @public
298
298
  */
299
299
  export interface RetrievedReference {
300
300
  /**
301
- * @public
302
301
  * <p>Contains the cited text from the data source.</p>
302
+ * @public
303
303
  */
304
304
  content?: RetrievalResultContent;
305
305
  /**
306
- * @public
307
306
  * <p>Contains information about the location of the data source.</p>
307
+ * @public
308
308
  */
309
309
  location?: RetrievalResultLocation;
310
310
  }
311
311
  /**
312
- * @public
313
312
  * <p>An object containing a segment of the generated response that is based on a source in the knowledge base, alongside information about the source.</p>
313
+ * @public
314
314
  */
315
315
  export interface Citation {
316
316
  /**
317
- * @public
318
317
  * <p>Contains the generated response and metadata </p>
318
+ * @public
319
319
  */
320
320
  generatedResponsePart?: GeneratedResponsePart;
321
321
  /**
322
- * @public
323
322
  * <p>Contains metadata about the sources cited for the generated response.</p>
323
+ * @public
324
324
  */
325
325
  retrievedReferences?: RetrievedReference[];
326
326
  }
327
327
  /**
328
- * @public
329
328
  * <p>Contains citations for a part of an agent response.</p>
329
+ * @public
330
330
  */
331
331
  export interface Attribution {
332
332
  /**
333
- * @public
334
333
  * <p>A list of citations and related information for a part of an agent response.</p>
334
+ * @public
335
335
  */
336
336
  citations?: Citation[];
337
337
  }
338
338
  /**
339
- * @public
340
339
  * <p>Contains a part of an agent response and citations for it.</p>
340
+ * @public
341
341
  */
342
342
  export interface PayloadPart {
343
343
  /**
344
- * @public
345
344
  * <p>A part of the agent response in bytes.</p>
345
+ * @public
346
346
  */
347
347
  bytes?: Uint8Array;
348
348
  /**
349
- * @public
350
349
  * <p>Contains citations for a part of an agent response.</p>
350
+ * @public
351
351
  */
352
352
  attribution?: Attribution;
353
353
  }
354
354
  /**
355
- * @public
356
355
  * <p>The specified resource ARN was not found. Check the ARN and try your request again.</p>
356
+ * @public
357
357
  */
358
358
  export declare class ResourceNotFoundException extends __BaseException {
359
359
  readonly name: "ResourceNotFoundException";
@@ -364,8 +364,8 @@ export declare class ResourceNotFoundException extends __BaseException {
364
364
  constructor(opts: __ExceptionOptionType<ResourceNotFoundException, __BaseException>);
365
365
  }
366
366
  /**
367
- * @public
368
367
  * <p>The number of requests exceeds the service quota. Resubmit your request later.</p>
368
+ * @public
369
369
  */
370
370
  export declare class ServiceQuotaExceededException extends __BaseException {
371
371
  readonly name: "ServiceQuotaExceededException";
@@ -376,8 +376,8 @@ export declare class ServiceQuotaExceededException extends __BaseException {
376
376
  constructor(opts: __ExceptionOptionType<ServiceQuotaExceededException, __BaseException>);
377
377
  }
378
378
  /**
379
- * @public
380
379
  * <p>The number of requests exceeds the limit. Resubmit your request later.</p>
380
+ * @public
381
381
  */
382
382
  export declare class ThrottlingException extends __BaseException {
383
383
  readonly name: "ThrottlingException";
@@ -388,18 +388,18 @@ export declare class ThrottlingException extends __BaseException {
388
388
  constructor(opts: __ExceptionOptionType<ThrottlingException, __BaseException>);
389
389
  }
390
390
  /**
391
- * @public
392
391
  * <p>Contains information about the failure of the interaction.</p>
392
+ * @public
393
393
  */
394
394
  export interface FailureTrace {
395
395
  /**
396
- * @public
397
396
  * <p>The unique identifier of the trace.</p>
397
+ * @public
398
398
  */
399
399
  traceId?: string;
400
400
  /**
401
- * @public
402
401
  * <p>The reason the interaction failed.</p>
402
+ * @public
403
403
  */
404
404
  failureReason?: string;
405
405
  }
@@ -417,75 +417,75 @@ export declare const InvocationType: {
417
417
  */
418
418
  export type InvocationType = (typeof InvocationType)[keyof typeof InvocationType];
419
419
  /**
420
- * @public
421
420
  * <p>Contains details about the knowledge base to look up and the query to be made.</p>
421
+ * @public
422
422
  */
423
423
  export interface KnowledgeBaseLookupInput {
424
424
  /**
425
- * @public
426
425
  * <p>The query made to the knowledge base.</p>
426
+ * @public
427
427
  */
428
428
  text?: string;
429
429
  /**
430
- * @public
431
430
  * <p>The unique identifier of the knowledge base to look up.</p>
431
+ * @public
432
432
  */
433
433
  knowledgeBaseId?: string;
434
434
  }
435
435
  /**
436
- * @public
437
436
  * <p>Contains information pertaining to the action group or knowledge base that is being invoked.</p>
437
+ * @public
438
438
  */
439
439
  export interface InvocationInput {
440
440
  /**
441
- * @public
442
441
  * <p>The unique identifier of the trace.</p>
442
+ * @public
443
443
  */
444
444
  traceId?: string;
445
445
  /**
446
- * @public
447
446
  * <p>Specifies whether the agent is invoking an action group or a knowledge base.</p>
447
+ * @public
448
448
  */
449
449
  invocationType?: InvocationType;
450
450
  /**
451
- * @public
452
451
  * <p>Contains information about the action group to be invoked.</p>
452
+ * @public
453
453
  */
454
454
  actionGroupInvocationInput?: ActionGroupInvocationInput;
455
455
  /**
456
- * @public
457
456
  * <p>Contains details about the knowledge base to look up and the query to be made.</p>
457
+ * @public
458
458
  */
459
459
  knowledgeBaseLookupInput?: KnowledgeBaseLookupInput;
460
460
  }
461
461
  /**
462
- * @public
463
462
  * <p>Specifications about the inference parameters that were provided alongside the prompt. These are specified in the <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PromptOverrideConfiguration.html">PromptOverrideConfiguration</a> object that was set when the agent was created or updated. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters.html">Inference parameters for foundation models</a>.</p>
463
+ * @public
464
464
  */
465
465
  export interface InferenceConfiguration {
466
466
  /**
467
- * @public
468
467
  * <p>The likelihood of the model selecting higher-probability options while generating a response. A lower value makes the model more likely to choose higher-probability options, while a higher value makes the model more likely to choose lower-probability options.</p>
468
+ * @public
469
469
  */
470
470
  temperature?: number;
471
471
  /**
472
- * @public
473
472
  * <p>While generating a response, the model determines the probability of the following token at each point of generation. The value that you set for <code>Top P</code> determines the number of most-likely candidates from which the model chooses the next token in the sequence. For example, if you set <code>topP</code> to 80, the model only selects the next token from the top 80% of the probability distribution of next tokens.</p>
473
+ * @public
474
474
  */
475
475
  topP?: number;
476
476
  /**
477
- * @public
478
477
  * <p>While generating a response, the model determines the probability of the following token at each point of generation. The value that you set for <code>topK</code> is the number of most-likely candidates from which the model chooses the next token in the sequence. For example, if you set <code>topK</code> to 50, the model selects the next token from among the top 50 most likely choices.</p>
478
+ * @public
479
479
  */
480
480
  topK?: number;
481
481
  /**
482
- * @public
483
482
  * <p>The maximum number of tokens allowed in the generated response.</p>
483
+ * @public
484
484
  */
485
485
  maximumLength?: number;
486
486
  /**
487
- * @public
488
487
  * <p>A list of stop sequences. A stop sequence is a sequence of characters that causes the model to stop generating the response.</p>
488
+ * @public
489
489
  */
490
490
  stopSequences?: string[];
491
491
  }
@@ -516,7 +516,6 @@ export declare const PromptType: {
516
516
  */
517
517
  export type PromptType = (typeof PromptType)[keyof typeof PromptType];
518
518
  /**
519
- * @public
520
519
  * <p>The input for the pre-processing step.</p>
521
520
  * <ul>
522
521
  * <li>
@@ -529,63 +528,64 @@ export type PromptType = (typeof PromptType)[keyof typeof PromptType];
529
528
  * <p>The <code>inferenceConfiguration</code>, <code>parserMode</code>, and <code>overrideLambda</code> values are set in the <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PromptOverrideConfiguration.html">PromptOverrideConfiguration</a> object that was set when the agent was created or updated.</p>
530
529
  * </li>
531
530
  * </ul>
531
+ * @public
532
532
  */
533
533
  export interface ModelInvocationInput {
534
534
  /**
535
- * @public
536
535
  * <p>The unique identifier of the trace.</p>
536
+ * @public
537
537
  */
538
538
  traceId?: string;
539
539
  /**
540
- * @public
541
540
  * <p>The text that prompted the agent at this step.</p>
541
+ * @public
542
542
  */
543
543
  text?: string;
544
544
  /**
545
- * @public
546
545
  * <p>The step in the agent sequence.</p>
546
+ * @public
547
547
  */
548
548
  type?: PromptType;
549
549
  /**
550
- * @public
551
550
  * <p>Specifications about the inference parameters that were provided alongside the prompt. These are specified in the <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PromptOverrideConfiguration.html">PromptOverrideConfiguration</a> object that was set when the agent was created or updated. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters.html">Inference parameters for foundation models</a>.</p>
551
+ * @public
552
552
  */
553
553
  inferenceConfiguration?: InferenceConfiguration;
554
554
  /**
555
- * @public
556
555
  * <p>The ARN of the Lambda function to use when parsing the raw foundation model output in parts of the agent sequence.</p>
556
+ * @public
557
557
  */
558
558
  overrideLambda?: string;
559
559
  /**
560
- * @public
561
560
  * <p>Specifies whether the default prompt template was <code>OVERRIDDEN</code>. If it was, the <code>basePromptTemplate</code> that was set in the <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PromptOverrideConfiguration.html">PromptOverrideConfiguration</a> object when the agent was created or updated is used instead.</p>
561
+ * @public
562
562
  */
563
563
  promptCreationMode?: CreationMode;
564
564
  /**
565
- * @public
566
565
  * <p>Specifies whether to override the default parser Lambda function when parsing the raw foundation model output in the part of the agent sequence defined by the <code>promptType</code>.</p>
566
+ * @public
567
567
  */
568
568
  parserMode?: CreationMode;
569
569
  }
570
570
  /**
571
- * @public
572
571
  * <p>Contains details about the response to the user.</p>
572
+ * @public
573
573
  */
574
574
  export interface FinalResponse {
575
575
  /**
576
- * @public
577
576
  * <p>The text in the response to the user.</p>
577
+ * @public
578
578
  */
579
579
  text?: string;
580
580
  }
581
581
  /**
582
- * @public
583
582
  * <p>Contains details about the results from looking up the knowledge base.</p>
583
+ * @public
584
584
  */
585
585
  export interface KnowledgeBaseLookupOutput {
586
586
  /**
587
- * @public
588
587
  * <p>Contains metadata about the sources cited for the generated response.</p>
588
+ * @public
589
589
  */
590
590
  retrievedReferences?: RetrievedReference[];
591
591
  }
@@ -603,18 +603,18 @@ export declare const Source: {
603
603
  */
604
604
  export type Source = (typeof Source)[keyof typeof Source];
605
605
  /**
606
- * @public
607
606
  * <p>Contains details about the agent's response to reprompt the input.</p>
607
+ * @public
608
608
  */
609
609
  export interface RepromptResponse {
610
610
  /**
611
- * @public
612
611
  * <p>The text reprompting the input.</p>
612
+ * @public
613
613
  */
614
614
  text?: string;
615
615
  /**
616
- * @public
617
616
  * <p>Specifies what output is prompting the agent to reprompt the input.</p>
617
+ * @public
618
618
  */
619
619
  source?: Source;
620
620
  }
@@ -634,17 +634,16 @@ export declare const Type: {
634
634
  */
635
635
  export type Type = (typeof Type)[keyof typeof Type];
636
636
  /**
637
- * @public
638
637
  * <p>Contains the result or output of an action group or knowledge base, or the response to the user.</p>
638
+ * @public
639
639
  */
640
640
  export interface Observation {
641
641
  /**
642
- * @public
643
642
  * <p>The unique identifier of the trace.</p>
643
+ * @public
644
644
  */
645
645
  traceId?: string;
646
646
  /**
647
- * @public
648
647
  * <p>Specifies what kind of information the agent returns in the observation. The following values are possible.</p>
649
648
  * <ul>
650
649
  * <li>
@@ -668,48 +667,49 @@ export interface Observation {
668
667
  * <code>REPROMPT</code> – The agent prompts the user again for the same information.</p>
669
668
  * </li>
670
669
  * </ul>
670
+ * @public
671
671
  */
672
672
  type?: Type;
673
673
  /**
674
- * @public
675
674
  * <p>Contains the JSON-formatted string returned by the API invoked by the action group.</p>
675
+ * @public
676
676
  */
677
677
  actionGroupInvocationOutput?: ActionGroupInvocationOutput;
678
678
  /**
679
- * @public
680
679
  * <p>Contains details about the results from looking up the knowledge base.</p>
680
+ * @public
681
681
  */
682
682
  knowledgeBaseLookupOutput?: KnowledgeBaseLookupOutput;
683
683
  /**
684
- * @public
685
684
  * <p>Contains details about the response to the user.</p>
685
+ * @public
686
686
  */
687
687
  finalResponse?: FinalResponse;
688
688
  /**
689
- * @public
690
689
  * <p>Contains details about the response to reprompt the input.</p>
690
+ * @public
691
691
  */
692
692
  repromptResponse?: RepromptResponse;
693
693
  }
694
694
  /**
695
- * @public
696
695
  * <p>Contains the reasoning, based on the input, that the agent uses to justify carrying out an action group or getting information from a knowledge base.</p>
696
+ * @public
697
697
  */
698
698
  export interface Rationale {
699
699
  /**
700
- * @public
701
700
  * <p>The unique identifier of the trace step.</p>
701
+ * @public
702
702
  */
703
703
  traceId?: string;
704
704
  /**
705
- * @public
706
705
  * <p>The reasoning or thought process of the agent, based on the input.</p>
706
+ * @public
707
707
  */
708
708
  text?: string;
709
709
  }
710
710
  /**
711
- * @public
712
711
  * <p>Details about the orchestration step, in which the agent determines the order in which actions are executed and which knowledge bases are retrieved.</p>
712
+ * @public
713
713
  */
714
714
  export type OrchestrationTrace = OrchestrationTrace.InvocationInputMember | OrchestrationTrace.ModelInvocationInputMember | OrchestrationTrace.ObservationMember | OrchestrationTrace.RationaleMember | OrchestrationTrace.$UnknownMember;
715
715
  /**
@@ -717,8 +717,8 @@ export type OrchestrationTrace = OrchestrationTrace.InvocationInputMember | Orch
717
717
  */
718
718
  export declare namespace OrchestrationTrace {
719
719
  /**
720
- * @public
721
720
  * <p>Details about the reasoning, based on the input, that the agent uses to justify carrying out an action group or getting information from a knowledge base.</p>
721
+ * @public
722
722
  */
723
723
  interface RationaleMember {
724
724
  rationale: Rationale;
@@ -728,8 +728,8 @@ export declare namespace OrchestrationTrace {
728
728
  $unknown?: never;
729
729
  }
730
730
  /**
731
- * @public
732
731
  * <p>Contains information pertaining to the action group or knowledge base that is being invoked.</p>
732
+ * @public
733
733
  */
734
734
  interface InvocationInputMember {
735
735
  rationale?: never;
@@ -739,8 +739,8 @@ export declare namespace OrchestrationTrace {
739
739
  $unknown?: never;
740
740
  }
741
741
  /**
742
- * @public
743
742
  * <p>Details about the observation (the output of the action group Lambda or knowledge base) made by the agent.</p>
743
+ * @public
744
744
  */
745
745
  interface ObservationMember {
746
746
  rationale?: never;
@@ -750,7 +750,6 @@ export declare namespace OrchestrationTrace {
750
750
  $unknown?: never;
751
751
  }
752
752
  /**
753
- * @public
754
753
  * <p>The input for the orchestration step.</p>
755
754
  * <ul>
756
755
  * <li>
@@ -763,6 +762,7 @@ export declare namespace OrchestrationTrace {
763
762
  * <p>The <code>inferenceConfiguration</code>, <code>parserMode</code>, and <code>overrideLambda</code> values are set in the <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PromptOverrideConfiguration.html">PromptOverrideConfiguration</a> object that was set when the agent was created or updated.</p>
764
763
  * </li>
765
764
  * </ul>
765
+ * @public
766
766
  */
767
767
  interface ModelInvocationInputMember {
768
768
  rationale?: never;
@@ -791,35 +791,35 @@ export declare namespace OrchestrationTrace {
791
791
  const visit: <T>(value: OrchestrationTrace, visitor: Visitor<T>) => T;
792
792
  }
793
793
  /**
794
- * @public
795
794
  * <p>Details about the response from the Lambda parsing of the output from the post-processing step.</p>
795
+ * @public
796
796
  */
797
797
  export interface PostProcessingParsedResponse {
798
798
  /**
799
- * @public
800
799
  * <p>The text returned by the parser.</p>
800
+ * @public
801
801
  */
802
802
  text?: string;
803
803
  }
804
804
  /**
805
- * @public
806
805
  * <p>The foundation model output from the post-processing step.</p>
806
+ * @public
807
807
  */
808
808
  export interface PostProcessingModelInvocationOutput {
809
809
  /**
810
- * @public
811
810
  * <p>The unique identifier of the trace.</p>
811
+ * @public
812
812
  */
813
813
  traceId?: string;
814
814
  /**
815
- * @public
816
815
  * <p>Details about the response from the Lambda parsing of the output of the post-processing step.</p>
816
+ * @public
817
817
  */
818
818
  parsedResponse?: PostProcessingParsedResponse;
819
819
  }
820
820
  /**
821
- * @public
822
821
  * <p>Details about the post-processing step, in which the agent shapes the response.</p>
822
+ * @public
823
823
  */
824
824
  export type PostProcessingTrace = PostProcessingTrace.ModelInvocationInputMember | PostProcessingTrace.ModelInvocationOutputMember | PostProcessingTrace.$UnknownMember;
825
825
  /**
@@ -827,7 +827,6 @@ export type PostProcessingTrace = PostProcessingTrace.ModelInvocationInputMember
827
827
  */
828
828
  export declare namespace PostProcessingTrace {
829
829
  /**
830
- * @public
831
830
  * <p>The input for the post-processing step.</p>
832
831
  * <ul>
833
832
  * <li>
@@ -840,6 +839,7 @@ export declare namespace PostProcessingTrace {
840
839
  * <p>The <code>inferenceConfiguration</code>, <code>parserMode</code>, and <code>overrideLambda</code> values are set in the <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PromptOverrideConfiguration.html">PromptOverrideConfiguration</a> object that was set when the agent was created or updated.</p>
841
840
  * </li>
842
841
  * </ul>
842
+ * @public
843
843
  */
844
844
  interface ModelInvocationInputMember {
845
845
  modelInvocationInput: ModelInvocationInput;
@@ -847,8 +847,8 @@ export declare namespace PostProcessingTrace {
847
847
  $unknown?: never;
848
848
  }
849
849
  /**
850
- * @public
851
850
  * <p>The foundation model output from the post-processing step.</p>
851
+ * @public
852
852
  */
853
853
  interface ModelInvocationOutputMember {
854
854
  modelInvocationInput?: never;
@@ -871,40 +871,40 @@ export declare namespace PostProcessingTrace {
871
871
  const visit: <T>(value: PostProcessingTrace, visitor: Visitor<T>) => T;
872
872
  }
873
873
  /**
874
- * @public
875
874
  * <p>Details about the response from the Lambda parsing of the output from the pre-processing step.</p>
875
+ * @public
876
876
  */
877
877
  export interface PreProcessingParsedResponse {
878
878
  /**
879
- * @public
880
879
  * <p>The text returned by the parsing of the pre-processing step, explaining the steps that the agent plans to take in orchestration, if the user input is valid.</p>
880
+ * @public
881
881
  */
882
882
  rationale?: string;
883
883
  /**
884
- * @public
885
884
  * <p>Whether the user input is valid or not. If <code>false</code>, the agent doesn't proceed to orchestration.</p>
885
+ * @public
886
886
  */
887
887
  isValid?: boolean;
888
888
  }
889
889
  /**
890
- * @public
891
890
  * <p>The foundation model output from the pre-processing step.</p>
891
+ * @public
892
892
  */
893
893
  export interface PreProcessingModelInvocationOutput {
894
894
  /**
895
- * @public
896
895
  * <p>The unique identifier of the trace.</p>
896
+ * @public
897
897
  */
898
898
  traceId?: string;
899
899
  /**
900
- * @public
901
900
  * <p>Details about the response from the Lambda parsing of the output of the pre-processing step.</p>
901
+ * @public
902
902
  */
903
903
  parsedResponse?: PreProcessingParsedResponse;
904
904
  }
905
905
  /**
906
- * @public
907
906
  * <p>Details about the pre-processing step, in which the agent contextualizes and categorizes user inputs.</p>
907
+ * @public
908
908
  */
909
909
  export type PreProcessingTrace = PreProcessingTrace.ModelInvocationInputMember | PreProcessingTrace.ModelInvocationOutputMember | PreProcessingTrace.$UnknownMember;
910
910
  /**
@@ -912,7 +912,6 @@ export type PreProcessingTrace = PreProcessingTrace.ModelInvocationInputMember |
912
912
  */
913
913
  export declare namespace PreProcessingTrace {
914
914
  /**
915
- * @public
916
915
  * <p>The input for the pre-processing step.</p>
917
916
  * <ul>
918
917
  * <li>
@@ -925,6 +924,7 @@ export declare namespace PreProcessingTrace {
925
924
  * <p>The <code>inferenceConfiguration</code>, <code>parserMode</code>, and <code>overrideLambda</code> values are set in the <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PromptOverrideConfiguration.html">PromptOverrideConfiguration</a> object that was set when the agent was created or updated.</p>
926
925
  * </li>
927
926
  * </ul>
927
+ * @public
928
928
  */
929
929
  interface ModelInvocationInputMember {
930
930
  modelInvocationInput: ModelInvocationInput;
@@ -932,8 +932,8 @@ export declare namespace PreProcessingTrace {
932
932
  $unknown?: never;
933
933
  }
934
934
  /**
935
- * @public
936
935
  * <p>The foundation model output from the pre-processing step.</p>
936
+ * @public
937
937
  */
938
938
  interface ModelInvocationOutputMember {
939
939
  modelInvocationInput?: never;
@@ -956,8 +956,8 @@ export declare namespace PreProcessingTrace {
956
956
  const visit: <T>(value: PreProcessingTrace, visitor: Visitor<T>) => T;
957
957
  }
958
958
  /**
959
- * @public
960
959
  * <p>Contains one part of the agent's reasoning process and results from calling API actions and querying knowledge bases. You can use the trace to understand how the agent arrived at the response it provided the customer. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/agents-test.html#trace-enablement">Trace enablement</a>.</p>
960
+ * @public
961
961
  */
962
962
  export type Trace = Trace.FailureTraceMember | Trace.OrchestrationTraceMember | Trace.PostProcessingTraceMember | Trace.PreProcessingTraceMember | Trace.$UnknownMember;
963
963
  /**
@@ -965,8 +965,8 @@ export type Trace = Trace.FailureTraceMember | Trace.OrchestrationTraceMember |
965
965
  */
966
966
  export declare namespace Trace {
967
967
  /**
968
- * @public
969
968
  * <p>Details about the pre-processing step, in which the agent contextualizes and categorizes user inputs.</p>
969
+ * @public
970
970
  */
971
971
  interface PreProcessingTraceMember {
972
972
  preProcessingTrace: PreProcessingTrace;
@@ -976,8 +976,8 @@ export declare namespace Trace {
976
976
  $unknown?: never;
977
977
  }
978
978
  /**
979
- * @public
980
979
  * <p>Details about the orchestration step, in which the agent determines the order in which actions are executed and which knowledge bases are retrieved.</p>
980
+ * @public
981
981
  */
982
982
  interface OrchestrationTraceMember {
983
983
  preProcessingTrace?: never;
@@ -987,8 +987,8 @@ export declare namespace Trace {
987
987
  $unknown?: never;
988
988
  }
989
989
  /**
990
- * @public
991
990
  * <p>Details about the post-processing step, in which the agent shapes the response..</p>
991
+ * @public
992
992
  */
993
993
  interface PostProcessingTraceMember {
994
994
  preProcessingTrace?: never;
@@ -998,8 +998,8 @@ export declare namespace Trace {
998
998
  $unknown?: never;
999
999
  }
1000
1000
  /**
1001
- * @public
1002
1001
  * <p>Contains information about the failure of the interaction.</p>
1002
+ * @public
1003
1003
  */
1004
1004
  interface FailureTraceMember {
1005
1005
  preProcessingTrace?: never;
@@ -1028,34 +1028,34 @@ export declare namespace Trace {
1028
1028
  const visit: <T>(value: Trace, visitor: Visitor<T>) => T;
1029
1029
  }
1030
1030
  /**
1031
- * @public
1032
1031
  * <p>Contains information about the agent and session, alongside the agent's reasoning process and results from calling API actions and querying knowledge bases and metadata about the trace. You can use the trace to understand how the agent arrived at the response it provided the customer. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/agents-test.html#trace-enablement">Trace enablement</a>.</p>
1032
+ * @public
1033
1033
  */
1034
1034
  export interface TracePart {
1035
1035
  /**
1036
- * @public
1037
1036
  * <p>The unique identifier of the agent.</p>
1037
+ * @public
1038
1038
  */
1039
1039
  agentId?: string;
1040
1040
  /**
1041
- * @public
1042
1041
  * <p>The unique identifier of the alias of the agent.</p>
1042
+ * @public
1043
1043
  */
1044
1044
  agentAliasId?: string;
1045
1045
  /**
1046
- * @public
1047
1046
  * <p>The unique identifier of the session with the agent.</p>
1047
+ * @public
1048
1048
  */
1049
1049
  sessionId?: string;
1050
1050
  /**
1051
- * @public
1052
1051
  * <p>Contains one part of the agent's reasoning process and results from calling API actions and querying knowledge bases. You can use the trace to understand how the agent arrived at the response it provided the customer. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/agents-test.html#trace-enablement">Trace enablement</a>.</p>
1052
+ * @public
1053
1053
  */
1054
1054
  trace?: Trace;
1055
1055
  }
1056
1056
  /**
1057
- * @public
1058
1057
  * <p>Input validation failed. Check your request parameters and retry the request.</p>
1058
+ * @public
1059
1059
  */
1060
1060
  export declare class ValidationException extends __BaseException {
1061
1061
  readonly name: "ValidationException";
@@ -1066,8 +1066,8 @@ export declare class ValidationException extends __BaseException {
1066
1066
  constructor(opts: __ExceptionOptionType<ValidationException, __BaseException>);
1067
1067
  }
1068
1068
  /**
1069
- * @public
1070
1069
  * <p>The response from invoking the agent and associated citations and trace information.</p>
1070
+ * @public
1071
1071
  */
1072
1072
  export type ResponseStream = ResponseStream.AccessDeniedExceptionMember | ResponseStream.BadGatewayExceptionMember | ResponseStream.ChunkMember | ResponseStream.ConflictExceptionMember | ResponseStream.DependencyFailedExceptionMember | ResponseStream.InternalServerExceptionMember | ResponseStream.ResourceNotFoundExceptionMember | ResponseStream.ServiceQuotaExceededExceptionMember | ResponseStream.ThrottlingExceptionMember | ResponseStream.TraceMember | ResponseStream.ValidationExceptionMember | ResponseStream.$UnknownMember;
1073
1073
  /**
@@ -1075,8 +1075,8 @@ export type ResponseStream = ResponseStream.AccessDeniedExceptionMember | Respon
1075
1075
  */
1076
1076
  export declare namespace ResponseStream {
1077
1077
  /**
1078
- * @public
1079
1078
  * <p>Contains a part of an agent response and citations for it.</p>
1079
+ * @public
1080
1080
  */
1081
1081
  interface ChunkMember {
1082
1082
  chunk: PayloadPart;
@@ -1093,8 +1093,8 @@ export declare namespace ResponseStream {
1093
1093
  $unknown?: never;
1094
1094
  }
1095
1095
  /**
1096
- * @public
1097
1096
  * <p>Contains information about the agent and session, alongside the agent's reasoning process and results from calling API actions and querying knowledge bases and metadata about the trace. You can use the trace to understand how the agent arrived at the response it provided the customer. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/trace-events.html">Trace events</a>.</p>
1097
+ * @public
1098
1098
  */
1099
1099
  interface TraceMember {
1100
1100
  chunk?: never;
@@ -1111,8 +1111,8 @@ export declare namespace ResponseStream {
1111
1111
  $unknown?: never;
1112
1112
  }
1113
1113
  /**
1114
- * @public
1115
1114
  * <p>An internal server error occurred. Retry your request.</p>
1115
+ * @public
1116
1116
  */
1117
1117
  interface InternalServerExceptionMember {
1118
1118
  chunk?: never;
@@ -1129,8 +1129,8 @@ export declare namespace ResponseStream {
1129
1129
  $unknown?: never;
1130
1130
  }
1131
1131
  /**
1132
- * @public
1133
1132
  * <p>Input validation failed. Check your request parameters and retry the request.</p>
1133
+ * @public
1134
1134
  */
1135
1135
  interface ValidationExceptionMember {
1136
1136
  chunk?: never;
@@ -1147,8 +1147,8 @@ export declare namespace ResponseStream {
1147
1147
  $unknown?: never;
1148
1148
  }
1149
1149
  /**
1150
- * @public
1151
1150
  * <p>The specified resource ARN was not found. Check the ARN and try your request again.</p>
1151
+ * @public
1152
1152
  */
1153
1153
  interface ResourceNotFoundExceptionMember {
1154
1154
  chunk?: never;
@@ -1165,8 +1165,8 @@ export declare namespace ResponseStream {
1165
1165
  $unknown?: never;
1166
1166
  }
1167
1167
  /**
1168
- * @public
1169
1168
  * <p>The number of requests exceeds the service quota. Resubmit your request later.</p>
1169
+ * @public
1170
1170
  */
1171
1171
  interface ServiceQuotaExceededExceptionMember {
1172
1172
  chunk?: never;
@@ -1183,8 +1183,8 @@ export declare namespace ResponseStream {
1183
1183
  $unknown?: never;
1184
1184
  }
1185
1185
  /**
1186
- * @public
1187
1186
  * <p>The number of requests exceeds the limit. Resubmit your request later.</p>
1187
+ * @public
1188
1188
  */
1189
1189
  interface ThrottlingExceptionMember {
1190
1190
  chunk?: never;
@@ -1201,8 +1201,8 @@ export declare namespace ResponseStream {
1201
1201
  $unknown?: never;
1202
1202
  }
1203
1203
  /**
1204
- * @public
1205
1204
  * <p>The request is denied because of missing access permissions. Check your permissions and retry your request.</p>
1205
+ * @public
1206
1206
  */
1207
1207
  interface AccessDeniedExceptionMember {
1208
1208
  chunk?: never;
@@ -1219,8 +1219,8 @@ export declare namespace ResponseStream {
1219
1219
  $unknown?: never;
1220
1220
  }
1221
1221
  /**
1222
- * @public
1223
1222
  * <p>There was a conflict performing an operation. Resolve the conflict and retry your request.</p>
1223
+ * @public
1224
1224
  */
1225
1225
  interface ConflictExceptionMember {
1226
1226
  chunk?: never;
@@ -1237,8 +1237,8 @@ export declare namespace ResponseStream {
1237
1237
  $unknown?: never;
1238
1238
  }
1239
1239
  /**
1240
- * @public
1241
1240
  * <p>There was an issue with a dependency. Check the resource configurations and retry the request.</p>
1241
+ * @public
1242
1242
  */
1243
1243
  interface DependencyFailedExceptionMember {
1244
1244
  chunk?: never;
@@ -1255,8 +1255,8 @@ export declare namespace ResponseStream {
1255
1255
  $unknown?: never;
1256
1256
  }
1257
1257
  /**
1258
- * @public
1259
1258
  * <p>There was an issue with a dependency due to a server issue. Retry your request.</p>
1259
+ * @public
1260
1260
  */
1261
1261
  interface BadGatewayExceptionMember {
1262
1262
  chunk?: never;
@@ -1310,29 +1310,29 @@ export declare namespace ResponseStream {
1310
1310
  */
1311
1311
  export interface InvokeAgentResponse {
1312
1312
  /**
1313
- * @public
1314
1313
  * <p>The agent's response to the user prompt.</p>
1314
+ * @public
1315
1315
  */
1316
1316
  completion: AsyncIterable<ResponseStream> | undefined;
1317
1317
  /**
1318
- * @public
1319
1318
  * <p>The MIME type of the input data in the request. The default value is <code>application/json</code>.</p>
1319
+ * @public
1320
1320
  */
1321
1321
  contentType: string | undefined;
1322
1322
  /**
1323
- * @public
1324
1323
  * <p>The unique identifier of the session with the agent.</p>
1324
+ * @public
1325
1325
  */
1326
1326
  sessionId: string | undefined;
1327
1327
  }
1328
1328
  /**
1329
- * @public
1330
1329
  * <p>Contains the query made to the knowledge base.</p>
1330
+ * @public
1331
1331
  */
1332
1332
  export interface RetrieveAndGenerateInput {
1333
1333
  /**
1334
- * @public
1335
1334
  * <p>The query made to the knowledge base.</p>
1335
+ * @public
1336
1336
  */
1337
1337
  text: string | undefined;
1338
1338
  }
@@ -1349,26 +1349,25 @@ export declare const SearchType: {
1349
1349
  */
1350
1350
  export type SearchType = (typeof SearchType)[keyof typeof SearchType];
1351
1351
  /**
1352
- * @public
1353
1352
  * <p>Configurations for how to carry out the search.</p>
1353
+ * @public
1354
1354
  */
1355
1355
  export interface KnowledgeBaseVectorSearchConfiguration {
1356
1356
  /**
1357
- * @public
1358
1357
  * <p>The number of results to return.</p>
1359
1358
  * <note>
1360
1359
  * <p>The <code>numberOfResults</code> field is currently unsupported for <code>RetrieveAndGenerate</code>. Don't include it in this field if you are sending a <code>RetrieveAndGenerate</code> request.</p>
1361
1360
  * </note>
1361
+ * @public
1362
1362
  */
1363
1363
  numberOfResults?: number;
1364
1364
  /**
1365
- * @public
1366
1365
  * <p>By default, Amazon Bedrock decides a search strategy for you. If you're using an Amazon OpenSearch Serverless vector store that contains a filterable text field, you can specify whether to query the knowledge base with a <code>HYBRID</code> search using both vector embeddings and raw text, or <code>SEMANTIC</code> search using only vector embeddings. For other vector store configurations, only <code>SEMANTIC</code> search is available. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base-test.html">Test a knowledge base</a>.</p>
1366
+ * @public
1367
1367
  */
1368
1368
  overrideSearchType?: SearchType;
1369
1369
  }
1370
1370
  /**
1371
- * @public
1372
1371
  * <p>Contains details about how the results should be returned.</p>
1373
1372
  * <p>This data type is used in the following API operations:</p>
1374
1373
  * <ul>
@@ -1383,32 +1382,33 @@ export interface KnowledgeBaseVectorSearchConfiguration {
1383
1382
  * </p>
1384
1383
  * </li>
1385
1384
  * </ul>
1385
+ * @public
1386
1386
  */
1387
1387
  export interface KnowledgeBaseRetrievalConfiguration {
1388
1388
  /**
1389
- * @public
1390
1389
  * <p>Contains details about how the results from the vector search should be returned.</p>
1390
+ * @public
1391
1391
  */
1392
1392
  vectorSearchConfiguration: KnowledgeBaseVectorSearchConfiguration | undefined;
1393
1393
  }
1394
1394
  /**
1395
- * @public
1396
1395
  * <p>Contains details about the resource being queried.</p>
1396
+ * @public
1397
1397
  */
1398
1398
  export interface KnowledgeBaseRetrieveAndGenerateConfiguration {
1399
1399
  /**
1400
- * @public
1401
1400
  * <p>The unique identifier of the knowledge base that is queried and the foundation model used for generation.</p>
1401
+ * @public
1402
1402
  */
1403
1403
  knowledgeBaseId: string | undefined;
1404
1404
  /**
1405
- * @public
1406
1405
  * <p>The ARN of the foundation model used to generate a response.</p>
1406
+ * @public
1407
1407
  */
1408
1408
  modelArn: string | undefined;
1409
1409
  /**
1410
- * @public
1411
1410
  * <p>Contains configurations for how to retrieve and return the knowledge base query.</p>
1411
+ * @public
1412
1412
  */
1413
1413
  retrievalConfiguration?: KnowledgeBaseRetrievalConfiguration;
1414
1414
  }
@@ -1424,29 +1424,29 @@ export declare const RetrieveAndGenerateType: {
1424
1424
  */
1425
1425
  export type RetrieveAndGenerateType = (typeof RetrieveAndGenerateType)[keyof typeof RetrieveAndGenerateType];
1426
1426
  /**
1427
- * @public
1428
1427
  * <p>Contains details about the resource being queried.</p>
1428
+ * @public
1429
1429
  */
1430
1430
  export interface RetrieveAndGenerateConfiguration {
1431
1431
  /**
1432
- * @public
1433
1432
  * <p>The type of resource that is queried by the request.</p>
1433
+ * @public
1434
1434
  */
1435
1435
  type: RetrieveAndGenerateType | undefined;
1436
1436
  /**
1437
- * @public
1438
1437
  * <p>Contains details about the resource being queried.</p>
1438
+ * @public
1439
1439
  */
1440
1440
  knowledgeBaseConfiguration?: KnowledgeBaseRetrieveAndGenerateConfiguration;
1441
1441
  }
1442
1442
  /**
1443
- * @public
1444
1443
  * <p>Contains configuration about the session with the knowledge base.</p>
1444
+ * @public
1445
1445
  */
1446
1446
  export interface RetrieveAndGenerateSessionConfiguration {
1447
1447
  /**
1448
- * @public
1449
1448
  * <p>The ARN of the KMS key encrypting the session.</p>
1449
+ * @public
1450
1450
  */
1451
1451
  kmsKeyArn: string | undefined;
1452
1452
  }
@@ -1455,34 +1455,34 @@ export interface RetrieveAndGenerateSessionConfiguration {
1455
1455
  */
1456
1456
  export interface RetrieveAndGenerateRequest {
1457
1457
  /**
1458
- * @public
1459
1458
  * <p>The unique identifier of the session. Reuse the same value to continue the same session with the knowledge base.</p>
1459
+ * @public
1460
1460
  */
1461
1461
  sessionId?: string;
1462
1462
  /**
1463
- * @public
1464
1463
  * <p>Contains the query made to the knowledge base.</p>
1464
+ * @public
1465
1465
  */
1466
1466
  input: RetrieveAndGenerateInput | undefined;
1467
1467
  /**
1468
- * @public
1469
1468
  * <p>Contains details about the resource being queried and the foundation model used for generation.</p>
1469
+ * @public
1470
1470
  */
1471
1471
  retrieveAndGenerateConfiguration?: RetrieveAndGenerateConfiguration;
1472
1472
  /**
1473
- * @public
1474
1473
  * <p>Contains details about the session with the knowledge base.</p>
1474
+ * @public
1475
1475
  */
1476
1476
  sessionConfiguration?: RetrieveAndGenerateSessionConfiguration;
1477
1477
  }
1478
1478
  /**
1479
- * @public
1480
1479
  * <p>Contains the response generated from querying the knowledge base.</p>
1480
+ * @public
1481
1481
  */
1482
1482
  export interface RetrieveAndGenerateOutput {
1483
1483
  /**
1484
- * @public
1485
1484
  * <p>The response generated from querying the knowledge base.</p>
1485
+ * @public
1486
1486
  */
1487
1487
  text: string | undefined;
1488
1488
  }
@@ -1491,29 +1491,29 @@ export interface RetrieveAndGenerateOutput {
1491
1491
  */
1492
1492
  export interface RetrieveAndGenerateResponse {
1493
1493
  /**
1494
- * @public
1495
1494
  * <p>The unique identifier of the session. Reuse the same value to continue the same session with the knowledge base.</p>
1495
+ * @public
1496
1496
  */
1497
1497
  sessionId: string | undefined;
1498
1498
  /**
1499
- * @public
1500
1499
  * <p>Contains the response generated from querying the knowledge base.</p>
1500
+ * @public
1501
1501
  */
1502
1502
  output: RetrieveAndGenerateOutput | undefined;
1503
1503
  /**
1504
- * @public
1505
1504
  * <p>A list of segments of the generated response that are based on sources in the knowledge base, alongside information about the sources.</p>
1505
+ * @public
1506
1506
  */
1507
1507
  citations?: Citation[];
1508
1508
  }
1509
1509
  /**
1510
- * @public
1511
1510
  * <p>Contains the query made to the knowledge base.</p>
1511
+ * @public
1512
1512
  */
1513
1513
  export interface KnowledgeBaseQuery {
1514
1514
  /**
1515
- * @public
1516
1515
  * <p>The text of the query made to the knowledge base.</p>
1516
+ * @public
1517
1517
  */
1518
1518
  text: string | undefined;
1519
1519
  }
@@ -1522,44 +1522,44 @@ export interface KnowledgeBaseQuery {
1522
1522
  */
1523
1523
  export interface RetrieveRequest {
1524
1524
  /**
1525
- * @public
1526
1525
  * <p>The unique identifier of the knowledge base to query.</p>
1526
+ * @public
1527
1527
  */
1528
1528
  knowledgeBaseId: string | undefined;
1529
1529
  /**
1530
- * @public
1531
1530
  * <p>The query to send the knowledge base.</p>
1531
+ * @public
1532
1532
  */
1533
1533
  retrievalQuery: KnowledgeBaseQuery | undefined;
1534
1534
  /**
1535
- * @public
1536
1535
  * <p>Contains details about how the results should be returned.</p>
1536
+ * @public
1537
1537
  */
1538
1538
  retrievalConfiguration?: KnowledgeBaseRetrievalConfiguration;
1539
1539
  /**
1540
- * @public
1541
1540
  * <p>If there are more results than can fit in the response, the response returns a <code>nextToken</code>. Use this token in the <code>nextToken</code> field of another request to retrieve the next batch of results.</p>
1541
+ * @public
1542
1542
  */
1543
1543
  nextToken?: string;
1544
1544
  }
1545
1545
  /**
1546
- * @public
1547
1546
  * <p>Details about a result from querying the knowledge base.</p>
1547
+ * @public
1548
1548
  */
1549
1549
  export interface KnowledgeBaseRetrievalResult {
1550
1550
  /**
1551
- * @public
1552
1551
  * <p>Contains a chunk of text from a data source in the knowledge base.</p>
1552
+ * @public
1553
1553
  */
1554
1554
  content: RetrievalResultContent | undefined;
1555
1555
  /**
1556
- * @public
1557
1556
  * <p>Contains information about the location of the data source.</p>
1557
+ * @public
1558
1558
  */
1559
1559
  location?: RetrievalResultLocation;
1560
1560
  /**
1561
- * @public
1562
1561
  * <p>The level of relevance of the result to the query.</p>
1562
+ * @public
1563
1563
  */
1564
1564
  score?: number;
1565
1565
  }
@@ -1568,13 +1568,13 @@ export interface KnowledgeBaseRetrievalResult {
1568
1568
  */
1569
1569
  export interface RetrieveResponse {
1570
1570
  /**
1571
- * @public
1572
1571
  * <p>A list of results from querying the knowledge base.</p>
1572
+ * @public
1573
1573
  */
1574
1574
  retrievalResults: KnowledgeBaseRetrievalResult[] | undefined;
1575
1575
  /**
1576
- * @public
1577
1576
  * <p>If there are more results than can fit in the response, the response returns a <code>nextToken</code>. Use this token in the <code>nextToken</code> field of another request to retrieve the next batch of results.</p>
1577
+ * @public
1578
1578
  */
1579
1579
  nextToken?: string;
1580
1580
  }