@aws-sdk/client-bedrock-agent-runtime 3.533.0 → 3.535.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist-types/BedrockAgentRuntime.d.ts +1 -1
- package/dist-types/BedrockAgentRuntimeClient.d.ts +1 -1
- package/dist-types/commands/InvokeAgentCommand.d.ts +2 -1
- package/dist-types/commands/RetrieveAndGenerateCommand.d.ts +2 -1
- package/dist-types/commands/RetrieveCommand.d.ts +2 -1
- package/dist-types/models/models_0.d.ts +187 -187
- package/dist-types/ts3.4/commands/InvokeAgentCommand.d.ts +9 -0
- package/dist-types/ts3.4/commands/RetrieveAndGenerateCommand.d.ts +9 -0
- package/dist-types/ts3.4/commands/RetrieveCommand.d.ts +9 -0
- package/package.json +43 -43
|
@@ -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
|
}
|