@aws-sdk/client-bedrock-agent-runtime 3.799.0 → 3.800.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,4 +1,65 @@
1
- import { AgentActionGroup, AgentCollaboration, BedrockModelConfigurations, CollaboratorConfiguration, ConversationHistory, ExternalSourcesRetrieveAndGenerateConfiguration, FilterAttribute, GenerationConfiguration, GuardrailConfiguration, GuardrailConfigurationWithArn, ImplicitFilterConfiguration, InlineBedrockModelConfigurations, InlineSessionState, InputFile, InvocationResultMember, KnowledgeBaseQuery, OrchestrationConfiguration, PromptOverrideConfiguration, RetrieveAndGenerateInput, RetrieveAndGenerateSessionConfiguration, RetrieveAndGenerateType, SearchType, SessionStatus, StreamingConfigurations, VectorSearchRerankingConfiguration } from "./models_0";
1
+ import { AgentActionGroup, AgentCollaboration, BedrockModelConfigurations, CollaboratorConfiguration, ConversationHistory, CustomOrchestration, ExternalSourcesRetrieveAndGenerateConfiguration, FilterAttribute, GenerationConfiguration, GuardrailConfiguration, GuardrailConfigurationWithArn, ImplicitFilterConfiguration, InlineBedrockModelConfigurations, InlineSessionState, InputFile, InvocationResultMember, KnowledgeBaseQuery, OrchestrationConfiguration, OrchestrationType, PromptOverrideConfiguration, RetrieveAndGenerateInput, RetrieveAndGenerateSessionConfiguration, RetrieveAndGenerateType, SearchType, SessionStatus, StreamingConfigurations, VectorSearchRerankingConfiguration } from "./models_0";
2
+ /**
3
+ * <p>Contains details about a session. For more information about sessions, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/sessions.html">Store and retrieve conversation history and context with Amazon Bedrock sessions</a>.</p>
4
+ * @public
5
+ */
6
+ export interface SessionSummary {
7
+ /**
8
+ * <p>The unique identifier for the session.</p>
9
+ * @public
10
+ */
11
+ sessionId: string | undefined;
12
+ /**
13
+ * <p>The Amazon Resource Name (ARN) of the session.</p>
14
+ * @public
15
+ */
16
+ sessionArn: string | undefined;
17
+ /**
18
+ * <p>The current status of the session.</p>
19
+ * @public
20
+ */
21
+ sessionStatus: SessionStatus | undefined;
22
+ /**
23
+ * <p>The timestamp for when the session was created.</p>
24
+ * @public
25
+ */
26
+ createdAt: Date | undefined;
27
+ /**
28
+ * <p>The timestamp for when the session was last modified.</p>
29
+ * @public
30
+ */
31
+ lastUpdatedAt: Date | undefined;
32
+ }
33
+ /**
34
+ * @public
35
+ */
36
+ export interface ListSessionsResponse {
37
+ /**
38
+ * <p>A list of summaries for each session in your Amazon Web Services account.</p>
39
+ * @public
40
+ */
41
+ sessionSummaries: SessionSummary[] | undefined;
42
+ /**
43
+ * <p>If the total number of results is greater than the <code>maxResults</code> value provided in the request, use this token when making another request in the <code>nextToken</code> field to return the next batch of results.</p>
44
+ * @public
45
+ */
46
+ nextToken?: string | undefined;
47
+ }
48
+ /**
49
+ * @public
50
+ */
51
+ export interface UpdateSessionRequest {
52
+ /**
53
+ * <p>A map of key-value pairs containing attributes to be persisted across the session. For example the user's ID, their language preference, and the type of device they are using.</p>
54
+ * @public
55
+ */
56
+ sessionMetadata?: Record<string, string> | undefined;
57
+ /**
58
+ * <p>The unique identifier of the session to modify. You can specify either the session's <code>sessionId</code> or its Amazon Resource Name (ARN).</p>
59
+ * @public
60
+ */
61
+ sessionIdentifier: string | undefined;
62
+ }
2
63
  /**
3
64
  * @public
4
65
  */
@@ -90,18 +151,7 @@ export interface UntagResourceRequest {
90
151
  export interface UntagResourceResponse {
91
152
  }
92
153
  /**
93
- * <p>Specifies the filters to use on the metadata attributes in the knowledge base data sources before returning results. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/kb-test-config.html">Query configurations</a>. See the examples below to see how to use these filters.</p>
94
- * <p>This data type is used in the following API operations:</p>
95
- * <ul>
96
- * <li>
97
- * <p>
98
- * <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html#API_agent-runtime_Retrieve_RequestSyntax">Retrieve request</a> – in the <code>filter</code> field</p>
99
- * </li>
100
- * <li>
101
- * <p>
102
- * <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html#API_agent-runtime_RetrieveAndGenerate_RequestSyntax">RetrieveAndGenerate request</a> – in the <code>filter</code> field</p>
103
- * </li>
104
- * </ul>
154
+ * <p>Specifies the filters to use on the metadata attributes in the knowledge base data sources before returning results. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/kb-test-config.html">Query configurations</a>. See the examples below to see how to use these filters.</p> <p>This data type is used in the following API operations:</p> <ul> <li> <p> <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html#API_agent-runtime_Retrieve_RequestSyntax">Retrieve request</a> – in the <code>filter</code> field</p> </li> <li> <p> <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html#API_agent-runtime_RetrieveAndGenerate_RequestSyntax">RetrieveAndGenerate request</a> – in the <code>filter</code> field</p> </li> </ul>
105
155
  * @public
106
156
  */
107
157
  export type RetrievalFilter = RetrievalFilter.AndAllMember | RetrievalFilter.EqualsMember | RetrievalFilter.GreaterThanMember | RetrievalFilter.GreaterThanOrEqualsMember | RetrievalFilter.InMember | RetrievalFilter.LessThanMember | RetrievalFilter.LessThanOrEqualsMember | RetrievalFilter.ListContainsMember | RetrievalFilter.NotEqualsMember | RetrievalFilter.NotInMember | RetrievalFilter.OrAllMember | RetrievalFilter.StartsWithMember | RetrievalFilter.StringContainsMember | RetrievalFilter.$UnknownMember;
@@ -110,11 +160,7 @@ export type RetrievalFilter = RetrievalFilter.AndAllMember | RetrievalFilter.Equ
110
160
  */
111
161
  export declare namespace RetrievalFilter {
112
162
  /**
113
- * <p>Knowledge base data sources are returned if they contain a metadata attribute whose name matches the <code>key</code> and whose value matches the <code>value</code> in this object.</p>
114
- * <p>The following example would return data sources with an <code>animal</code> attribute whose value is <code>cat</code>:</p>
115
- * <p>
116
- * <code>"equals": \{ "key": "animal", "value": "cat" \}</code>
117
- * </p>
163
+ * <p>Knowledge base data sources are returned if they contain a metadata attribute whose name matches the <code>key</code> and whose value matches the <code>value</code> in this object.</p> <p>The following example would return data sources with an <code>animal</code> attribute whose value is <code>cat</code>:</p> <p> <code>"equals": \{ "key": "animal", "value": "cat" \}</code> </p>
118
164
  * @public
119
165
  */
120
166
  interface EqualsMember {
@@ -134,20 +180,7 @@ export declare namespace RetrievalFilter {
134
180
  $unknown?: never;
135
181
  }
136
182
  /**
137
- * <p>Knowledge base data sources are returned when:</p>
138
- * <ul>
139
- * <li>
140
- * <p>It contains a metadata attribute whose name matches the <code>key</code> and whose value doesn't match the <code>value</code>
141
- * in this object.</p>
142
- * </li>
143
- * <li>
144
- * <p>The key is not present in the document.</p>
145
- * </li>
146
- * </ul>
147
- * <p>The following example would return data sources that don't contain an <code>animal</code> attribute whose value is <code>cat</code>.</p>
148
- * <p>
149
- * <code>"notEquals": \{ "key": "animal", "value": "cat" \}</code>
150
- * </p>
183
+ * <p>Knowledge base data sources are returned when:</p> <ul> <li> <p>It contains a metadata attribute whose name matches the <code>key</code> and whose value doesn't match the <code>value</code> in this object.</p> </li> <li> <p>The key is not present in the document.</p> </li> </ul> <p>The following example would return data sources that don't contain an <code>animal</code> attribute whose value is <code>cat</code>.</p> <p> <code>"notEquals": \{ "key": "animal", "value": "cat" \}</code> </p>
151
184
  * @public
152
185
  */
153
186
  interface NotEqualsMember {
@@ -167,11 +200,7 @@ export declare namespace RetrievalFilter {
167
200
  $unknown?: never;
168
201
  }
169
202
  /**
170
- * <p>Knowledge base data sources are returned if they contain a metadata attribute whose name matches the <code>key</code> and whose value is greater than the <code>value</code> in this object.</p>
171
- * <p>The following example would return data sources with an <code>year</code> attribute whose value is greater than <code>1989</code>:</p>
172
- * <p>
173
- * <code>"greaterThan": \{ "key": "year", "value": 1989 \}</code>
174
- * </p>
203
+ * <p>Knowledge base data sources are returned if they contain a metadata attribute whose name matches the <code>key</code> and whose value is greater than the <code>value</code> in this object.</p> <p>The following example would return data sources with an <code>year</code> attribute whose value is greater than <code>1989</code>:</p> <p> <code>"greaterThan": \{ "key": "year", "value": 1989 \}</code> </p>
175
204
  * @public
176
205
  */
177
206
  interface GreaterThanMember {
@@ -191,11 +220,7 @@ export declare namespace RetrievalFilter {
191
220
  $unknown?: never;
192
221
  }
193
222
  /**
194
- * <p>Knowledge base data sources are returned if they contain a metadata attribute whose name matches the <code>key</code> and whose value is greater than or equal to the <code>value</code> in this object.</p>
195
- * <p>The following example would return data sources with an <code>year</code> attribute whose value is greater than or equal to <code>1989</code>:</p>
196
- * <p>
197
- * <code>"greaterThanOrEquals": \{ "key": "year", "value": 1989 \}</code>
198
- * </p>
223
+ * <p>Knowledge base data sources are returned if they contain a metadata attribute whose name matches the <code>key</code> and whose value is greater than or equal to the <code>value</code> in this object.</p> <p>The following example would return data sources with an <code>year</code> attribute whose value is greater than or equal to <code>1989</code>:</p> <p> <code>"greaterThanOrEquals": \{ "key": "year", "value": 1989 \}</code> </p>
199
224
  * @public
200
225
  */
201
226
  interface GreaterThanOrEqualsMember {
@@ -215,11 +240,7 @@ export declare namespace RetrievalFilter {
215
240
  $unknown?: never;
216
241
  }
217
242
  /**
218
- * <p>Knowledge base data sources are returned if they contain a metadata attribute whose name matches the <code>key</code> and whose value is less than the <code>value</code> in this object.</p>
219
- * <p>The following example would return data sources with an <code>year</code> attribute whose value is less than to <code>1989</code>.</p>
220
- * <p>
221
- * <code>"lessThan": \{ "key": "year", "value": 1989 \}</code>
222
- * </p>
243
+ * <p>Knowledge base data sources are returned if they contain a metadata attribute whose name matches the <code>key</code> and whose value is less than the <code>value</code> in this object.</p> <p>The following example would return data sources with an <code>year</code> attribute whose value is less than to <code>1989</code>.</p> <p> <code>"lessThan": \{ "key": "year", "value": 1989 \}</code> </p>
223
244
  * @public
224
245
  */
225
246
  interface LessThanMember {
@@ -239,11 +260,7 @@ export declare namespace RetrievalFilter {
239
260
  $unknown?: never;
240
261
  }
241
262
  /**
242
- * <p>Knowledge base data sources are returned if they contain a metadata attribute whose name matches the <code>key</code> and whose value is less than or equal to the <code>value</code> in this object.</p>
243
- * <p>The following example would return data sources with an <code>year</code> attribute whose value is less than or equal to <code>1989</code>.</p>
244
- * <p>
245
- * <code>"lessThanOrEquals": \{ "key": "year", "value": 1989 \}</code>
246
- * </p>
263
+ * <p>Knowledge base data sources are returned if they contain a metadata attribute whose name matches the <code>key</code> and whose value is less than or equal to the <code>value</code> in this object.</p> <p>The following example would return data sources with an <code>year</code> attribute whose value is less than or equal to <code>1989</code>.</p> <p> <code>"lessThanOrEquals": \{ "key": "year", "value": 1989 \}</code> </p>
247
264
  * @public
248
265
  */
249
266
  interface LessThanOrEqualsMember {
@@ -263,11 +280,7 @@ export declare namespace RetrievalFilter {
263
280
  $unknown?: never;
264
281
  }
265
282
  /**
266
- * <p>Knowledge base data sources are returned if they contain a metadata attribute whose name matches the <code>key</code> and whose value is in the list specified in the <code>value</code> in this object.</p>
267
- * <p>The following example would return data sources with an <code>animal</code> attribute that is either <code>cat</code> or <code>dog</code>:</p>
268
- * <p>
269
- * <code>"in": \{ "key": "animal", "value": ["cat", "dog"] \}</code>
270
- * </p>
283
+ * <p>Knowledge base data sources are returned if they contain a metadata attribute whose name matches the <code>key</code> and whose value is in the list specified in the <code>value</code> in this object.</p> <p>The following example would return data sources with an <code>animal</code> attribute that is either <code>cat</code> or <code>dog</code>:</p> <p> <code>"in": \{ "key": "animal", "value": ["cat", "dog"] \}</code> </p>
271
284
  * @public
272
285
  */
273
286
  interface InMember {
@@ -287,11 +300,7 @@ export declare namespace RetrievalFilter {
287
300
  $unknown?: never;
288
301
  }
289
302
  /**
290
- * <p>Knowledge base data sources are returned if they contain a metadata attribute whose name matches the <code>key</code> and whose value isn't in the list specified in the <code>value</code> in this object.</p>
291
- * <p>The following example would return data sources whose <code>animal</code> attribute is neither <code>cat</code> nor <code>dog</code>.</p>
292
- * <p>
293
- * <code>"notIn": \{ "key": "animal", "value": ["cat", "dog"] \}</code>
294
- * </p>
303
+ * <p>Knowledge base data sources are returned if they contain a metadata attribute whose name matches the <code>key</code> and whose value isn't in the list specified in the <code>value</code> in this object.</p> <p>The following example would return data sources whose <code>animal</code> attribute is neither <code>cat</code> nor <code>dog</code>.</p> <p> <code>"notIn": \{ "key": "animal", "value": ["cat", "dog"] \}</code> </p>
295
304
  * @public
296
305
  */
297
306
  interface NotInMember {
@@ -311,11 +320,7 @@ export declare namespace RetrievalFilter {
311
320
  $unknown?: never;
312
321
  }
313
322
  /**
314
- * <p>Knowledge base data sources are returned if they contain a metadata attribute whose name matches the <code>key</code> and whose value starts with the <code>value</code> in this object. This filter is currently only supported for Amazon OpenSearch Serverless vector stores.</p>
315
- * <p>The following example would return data sources with an <code>animal</code> attribute starts with <code>ca</code> (for example, <code>cat</code> or <code>camel</code>).</p>
316
- * <p>
317
- * <code>"startsWith": \{ "key": "animal", "value": "ca" \}</code>
318
- * </p>
323
+ * <p>Knowledge base data sources are returned if they contain a metadata attribute whose name matches the <code>key</code> and whose value starts with the <code>value</code> in this object. This filter is currently only supported for Amazon OpenSearch Serverless vector stores.</p> <p>The following example would return data sources with an <code>animal</code> attribute starts with <code>ca</code> (for example, <code>cat</code> or <code>camel</code>).</p> <p> <code>"startsWith": \{ "key": "animal", "value": "ca" \}</code> </p>
319
324
  * @public
320
325
  */
321
326
  interface StartsWithMember {
@@ -335,11 +340,7 @@ export declare namespace RetrievalFilter {
335
340
  $unknown?: never;
336
341
  }
337
342
  /**
338
- * <p>Knowledge base data sources are returned if they contain a metadata attribute whose name matches the <code>key</code> and whose value is a list that contains the <code>value</code> as one of its members.</p>
339
- * <p>The following example would return data sources with an <code>animals</code> attribute that is a list containing a <code>cat</code> member (for example <code>["dog", "cat"]</code>).</p>
340
- * <p>
341
- * <code>"listContains": \{ "key": "animals", "value": "cat" \}</code>
342
- * </p>
343
+ * <p>Knowledge base data sources are returned if they contain a metadata attribute whose name matches the <code>key</code> and whose value is a list that contains the <code>value</code> as one of its members.</p> <p>The following example would return data sources with an <code>animals</code> attribute that is a list containing a <code>cat</code> member (for example <code>["dog", "cat"]</code>).</p> <p> <code>"listContains": \{ "key": "animals", "value": "cat" \}</code> </p>
343
344
  * @public
344
345
  */
345
346
  interface ListContainsMember {
@@ -359,21 +360,7 @@ export declare namespace RetrievalFilter {
359
360
  $unknown?: never;
360
361
  }
361
362
  /**
362
- * <p>Knowledge base data sources are returned if they contain a metadata attribute whose name matches the <code>key</code> and whose value is one of the following:</p>
363
- * <ul>
364
- * <li>
365
- * <p>A string that contains the <code>value</code> as a substring. The following example would return data sources with an <code>animal</code> attribute that contains the substring <code>at</code> (for example <code>cat</code>).</p>
366
- * <p>
367
- * <code>"stringContains": \{ "key": "animal", "value": "at" \}</code>
368
- * </p>
369
- * </li>
370
- * <li>
371
- * <p>A list with a member that contains the <code>value</code> as a substring. The following example would return data sources with an <code>animals</code> attribute that is a list containing a member that contains the substring <code>at</code> (for example <code>["dog", "cat"]</code>).</p>
372
- * <p>
373
- * <code>"stringContains": \{ "key": "animals", "value": "at" \}</code>
374
- * </p>
375
- * </li>
376
- * </ul>
363
+ * <p>Knowledge base data sources are returned if they contain a metadata attribute whose name matches the <code>key</code> and whose value is one of the following:</p> <ul> <li> <p>A string that contains the <code>value</code> as a substring. The following example would return data sources with an <code>animal</code> attribute that contains the substring <code>at</code> (for example <code>cat</code>).</p> <p> <code>"stringContains": \{ "key": "animal", "value": "at" \}</code> </p> </li> <li> <p>A list with a member that contains the <code>value</code> as a substring. The following example would return data sources with an <code>animals</code> attribute that is a list containing a member that contains the substring <code>at</code> (for example <code>["dog", "cat"]</code>).</p> <p> <code>"stringContains": \{ "key": "animals", "value": "at" \}</code> </p> </li> </ul>
377
364
  * @public
378
365
  */
379
366
  interface StringContainsMember {
@@ -470,18 +457,7 @@ export declare namespace RetrievalFilter {
470
457
  const visit: <T>(value: RetrievalFilter, visitor: Visitor<T>) => T;
471
458
  }
472
459
  /**
473
- * <p>Configurations for how to perform the search query and return results. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/kb-test-config.html">Query configurations</a>.</p>
474
- * <p>This data type is used in the following API operations:</p>
475
- * <ul>
476
- * <li>
477
- * <p>
478
- * <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html#API_agent-runtime_Retrieve_RequestSyntax">Retrieve request</a> – in the <code>vectorSearchConfiguration</code> field</p>
479
- * </li>
480
- * <li>
481
- * <p>
482
- * <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html#API_agent-runtime_RetrieveAndGenerate_RequestSyntax">RetrieveAndGenerate request</a> – in the <code>vectorSearchConfiguration</code> field</p>
483
- * </li>
484
- * </ul>
460
+ * <p>Configurations for how to perform the search query and return results. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/kb-test-config.html">Query configurations</a>.</p> <p>This data type is used in the following API operations:</p> <ul> <li> <p> <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html#API_agent-runtime_Retrieve_RequestSyntax">Retrieve request</a> – in the <code>vectorSearchConfiguration</code> field</p> </li> <li> <p> <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html#API_agent-runtime_RetrieveAndGenerate_RequestSyntax">RetrieveAndGenerate request</a> – in the <code>vectorSearchConfiguration</code> field</p> </li> </ul>
485
461
  * @public
486
462
  */
487
463
  export interface KnowledgeBaseVectorSearchConfiguration {
@@ -512,18 +488,7 @@ export interface KnowledgeBaseVectorSearchConfiguration {
512
488
  implicitFilterConfiguration?: ImplicitFilterConfiguration | undefined;
513
489
  }
514
490
  /**
515
- * <p>Contains configurations for knowledge base query. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/kb-test-config.html">Query configurations</a>.</p>
516
- * <p>This data type is used in the following API operations:</p>
517
- * <ul>
518
- * <li>
519
- * <p>
520
- * <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html#API_agent-runtime_Retrieve_RequestSyntax">Retrieve request</a> – in the <code>retrievalConfiguration</code> field</p>
521
- * </li>
522
- * <li>
523
- * <p>
524
- * <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html#API_agent-runtime_RetrieveAndGenerate_RequestSyntax">RetrieveAndGenerate request</a> – in the <code>retrievalConfiguration</code> field</p>
525
- * </li>
526
- * </ul>
491
+ * <p>Contains configurations for knowledge base query. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/kb-test-config.html">Query configurations</a>.</p> <p>This data type is used in the following API operations:</p> <ul> <li> <p> <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html#API_agent-runtime_Retrieve_RequestSyntax">Retrieve request</a> – in the <code>retrievalConfiguration</code> field</p> </li> <li> <p> <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html#API_agent-runtime_RetrieveAndGenerate_RequestSyntax">RetrieveAndGenerate request</a> – in the <code>retrievalConfiguration</code> field</p> </li> </ul>
527
492
  * @public
528
493
  */
529
494
  export interface KnowledgeBaseRetrievalConfiguration {
@@ -534,30 +499,22 @@ export interface KnowledgeBaseRetrievalConfiguration {
534
499
  vectorSearchConfiguration: KnowledgeBaseVectorSearchConfiguration | undefined;
535
500
  }
536
501
  /**
537
- * <p>
538
- * Details of the knowledge base associated withe inline agent.
539
- * </p>
502
+ * <p> Details of the knowledge base associated withe inline agent. </p>
540
503
  * @public
541
504
  */
542
505
  export interface KnowledgeBase {
543
506
  /**
544
- * <p>
545
- * The unique identifier for a knowledge base associated with the inline agent.
546
- * </p>
507
+ * <p> The unique identifier for a knowledge base associated with the inline agent. </p>
547
508
  * @public
548
509
  */
549
510
  knowledgeBaseId: string | undefined;
550
511
  /**
551
- * <p>
552
- * The description of the knowledge base associated with the inline agent.
553
- * </p>
512
+ * <p> The description of the knowledge base associated with the inline agent. </p>
554
513
  * @public
555
514
  */
556
515
  description: string | undefined;
557
516
  /**
558
- * <p>
559
- * The configurations to apply to the knowledge base during query. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/kb-test-config.html">Query configurations</a>.
560
- * </p>
517
+ * <p> The configurations to apply to the knowledge base during query. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/kb-test-config.html">Query configurations</a>. </p>
561
518
  * @public
562
519
  */
563
520
  retrievalConfiguration?: KnowledgeBaseRetrievalConfiguration | undefined;
@@ -579,18 +536,7 @@ export interface KnowledgeBaseConfiguration {
579
536
  retrievalConfiguration: KnowledgeBaseRetrievalConfiguration | undefined;
580
537
  }
581
538
  /**
582
- * <p>Contains details about the resource being queried.</p>
583
- * <p>This data type is used in the following API operations:</p>
584
- * <ul>
585
- * <li>
586
- * <p>
587
- * <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html#API_agent-runtime_Retrieve_RequestSyntax">Retrieve request</a> – in the <code>knowledgeBaseConfiguration</code> field</p>
588
- * </li>
589
- * <li>
590
- * <p>
591
- * <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html#API_agent-runtime_RetrieveAndGenerate_RequestSyntax">RetrieveAndGenerate request</a> – in the <code>knowledgeBaseConfiguration</code> field</p>
592
- * </li>
593
- * </ul>
539
+ * <p>Contains details about the resource being queried.</p> <p>This data type is used in the following API operations:</p> <ul> <li> <p> <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html#API_agent-runtime_Retrieve_RequestSyntax">Retrieve request</a> – in the <code>knowledgeBaseConfiguration</code> field</p> </li> <li> <p> <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html#API_agent-runtime_RetrieveAndGenerate_RequestSyntax">RetrieveAndGenerate request</a> – in the <code>knowledgeBaseConfiguration</code> field</p> </li> </ul>
594
540
  * @public
595
541
  */
596
542
  export interface KnowledgeBaseRetrieveAndGenerateConfiguration {
@@ -651,22 +597,12 @@ export interface RetrieveRequest {
651
597
  nextToken?: string | undefined;
652
598
  }
653
599
  /**
654
- * <p>Contains details about the resource being queried.</p>
655
- * <p>This data type is used in the following API operations:</p>
656
- * <ul>
657
- * <li>
658
- * <p>
659
- * <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html#API_agent-runtime_RetrieveAndGenerate_RequestSyntax">RetrieveAndGenerate request</a> – in the <code>retrieveAndGenerateConfiguration</code> field</p>
660
- * </li>
661
- * </ul>
600
+ * <p>Contains details about the resource being queried.</p> <p>This data type is used in the following API operations:</p> <ul> <li> <p> <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html#API_agent-runtime_RetrieveAndGenerate_RequestSyntax">RetrieveAndGenerate request</a> – in the <code>retrieveAndGenerateConfiguration</code> field</p> </li> </ul>
662
601
  * @public
663
602
  */
664
603
  export interface RetrieveAndGenerateConfiguration {
665
604
  /**
666
- * <p>The type of resource that contains your data for retrieving information and generating responses.</p>
667
- * <note>
668
- * <p>If you choose to use <code>EXTERNAL_SOURCES</code>, then currently only Anthropic Claude 3 Sonnet models for knowledge bases are supported.</p>
669
- * </note>
605
+ * <p>The type of resource that contains your data for retrieving information and generating responses.</p> <note> <p>If you choose to use <code>EXTERNAL_SOURCES</code>, then currently only Anthropic Claude 3 Sonnet models for knowledge bases are supported.</p> </note>
670
606
  * @public
671
607
  */
672
608
  type: RetrieveAndGenerateType | undefined;
@@ -682,87 +618,62 @@ export interface RetrieveAndGenerateConfiguration {
682
618
  externalSourcesConfiguration?: ExternalSourcesRetrieveAndGenerateConfiguration | undefined;
683
619
  }
684
620
  /**
685
- * <p>
686
- * List of inline collaborators.
687
- * </p>
621
+ * <p> List of inline collaborators. </p>
688
622
  * @public
689
623
  */
690
624
  export interface Collaborator {
691
625
  /**
692
- * <p>
693
- * The Amazon Resource Name (ARN) of the AWS KMS key that encrypts the inline collaborator.
694
- * </p>
626
+ * <p> The Amazon Resource Name (ARN) of the AWS KMS key that encrypts the inline collaborator. </p>
695
627
  * @public
696
628
  */
697
629
  customerEncryptionKeyArn?: string | undefined;
698
630
  /**
699
- * <p>
700
- * The foundation model used by the inline collaborator agent.
701
- * </p>
631
+ * <p> The foundation model used by the inline collaborator agent. </p>
702
632
  * @public
703
633
  */
704
634
  foundationModel: string | undefined;
705
635
  /**
706
- * <p>
707
- * Instruction that tell the inline collaborator agent what it should do and how it should interact with users.
708
- * </p>
636
+ * <p> Instruction that tell the inline collaborator agent what it should do and how it should interact with users. </p>
709
637
  * @public
710
638
  */
711
639
  instruction: string | undefined;
712
640
  /**
713
- * <p>
714
- * The number of seconds for which the Amazon Bedrock keeps information about the user's conversation with the inline collaborator agent.</p>
715
- * <p>A user interaction remains active for the amount of time specified. If no conversation occurs during this time, the session expires and Amazon Bedrock deletes any data provided before the timeout.
716
- * </p>
641
+ * <p> The number of seconds for which the Amazon Bedrock keeps information about the user's conversation with the inline collaborator agent.</p> <p>A user interaction remains active for the amount of time specified. If no conversation occurs during this time, the session expires and Amazon Bedrock deletes any data provided before the timeout. </p>
717
642
  * @public
718
643
  */
719
644
  idleSessionTTLInSeconds?: number | undefined;
720
645
  /**
721
- * <p>
722
- * List of action groups with each action group defining tasks the inline collaborator agent needs to carry out.
723
- * </p>
646
+ * <p> List of action groups with each action group defining tasks the inline collaborator agent needs to carry out. </p>
724
647
  * @public
725
648
  */
726
649
  actionGroups?: AgentActionGroup[] | undefined;
727
650
  /**
728
- * <p>
729
- * Knowledge base associated with the inline collaborator agent.
730
- * </p>
651
+ * <p> Knowledge base associated with the inline collaborator agent. </p>
731
652
  * @public
732
653
  */
733
654
  knowledgeBases?: KnowledgeBase[] | undefined;
734
655
  /**
735
- * <p>
736
- * Details of the guardwrail associated with the inline collaborator.
737
- * </p>
656
+ * <p> Details of the guardwrail associated with the inline collaborator. </p>
738
657
  * @public
739
658
  */
740
659
  guardrailConfiguration?: GuardrailConfigurationWithArn | undefined;
741
660
  /**
742
- * <p>
743
- * Contains configurations to override prompt templates in different parts of an inline collaborator sequence. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/advanced-prompts.html">Advanced prompts</a>.
744
- * </p>
661
+ * <p> Contains configurations to override prompt templates in different parts of an inline collaborator sequence. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/advanced-prompts.html">Advanced prompts</a>. </p>
745
662
  * @public
746
663
  */
747
664
  promptOverrideConfiguration?: PromptOverrideConfiguration | undefined;
748
665
  /**
749
- * <p>
750
- * Defines how the inline supervisor agent handles information across multiple collaborator agents to coordinate a final response.
751
- * </p>
666
+ * <p> Defines how the inline supervisor agent handles information across multiple collaborator agents to coordinate a final response. </p>
752
667
  * @public
753
668
  */
754
669
  agentCollaboration?: AgentCollaboration | undefined;
755
670
  /**
756
- * <p>
757
- * Settings of the collaborator agent.
758
- * </p>
671
+ * <p> Settings of the collaborator agent. </p>
759
672
  * @public
760
673
  */
761
674
  collaboratorConfigurations?: CollaboratorConfiguration[] | undefined;
762
675
  /**
763
- * <p>
764
- * Name of the inline collaborator agent which must be the same name as specified for <code>collaboratorName</code>.
765
- * </p>
676
+ * <p> Name of the inline collaborator agent which must be the same name as specified for <code>collaboratorName</code>. </p>
766
677
  * @public
767
678
  */
768
679
  agentName?: string | undefined;
@@ -828,23 +739,12 @@ export interface SessionState {
828
739
  */
829
740
  sessionAttributes?: Record<string, string> | undefined;
830
741
  /**
831
- * <p>Contains attributes that persist across a prompt and the values of those attributes. </p>
832
- * <ul>
833
- * <li>
834
- * <p>In orchestration prompt template, these attributes replace the $prompt_session_attributes$ placeholder variable. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/prompt-placeholders.html">Prompt template placeholder variables</a>.</p>
835
- * </li>
836
- * <li>
837
- * <p>In <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/agents-multi-agent-collaboration.html">multi-agent collaboration</a>, the <code>promptSessionAttributes</code> will only be used by supervisor agent when $prompt_session_attributes$ is present in prompt template. </p>
838
- * </li>
839
- * </ul>
742
+ * <p>Contains attributes that persist across a prompt and the values of those attributes. </p> <ul> <li> <p>In orchestration prompt template, these attributes replace the $prompt_session_attributes$ placeholder variable. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/prompt-placeholders.html">Prompt template placeholder variables</a>.</p> </li> <li> <p>In <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/agents-multi-agent-collaboration.html">multi-agent collaboration</a>, the <code>promptSessionAttributes</code> will only be used by supervisor agent when $prompt_session_attributes$ is present in prompt template. </p> </li> </ul>
840
743
  * @public
841
744
  */
842
745
  promptSessionAttributes?: Record<string, string> | undefined;
843
746
  /**
844
- * <p>Contains information about the results from the action group invocation. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/agents-returncontrol.html">Return control to the agent developer</a> and <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/agents-session-state.html">Control session context</a>.</p>
845
- * <note>
846
- * <p>If you include this field, the <code>inputText</code> field will be ignored.</p>
847
- * </note>
747
+ * <p>Contains information about the results from the action group invocation. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/agents-returncontrol.html">Return control to the agent developer</a> and <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/agents-session-state.html">Control session context</a>.</p> <note> <p>If you include this field, the <code>inputText</code> field will be ignored.</p> </note>
848
748
  * @public
849
749
  */
850
750
  returnControlInvocationResults?: InvocationResultMember[] | undefined;
@@ -874,10 +774,7 @@ export interface SessionState {
874
774
  */
875
775
  export interface InvokeAgentRequest {
876
776
  /**
877
- * <p>Contains parameters that specify various attributes of the session. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/agents-session-state.html">Control session context</a>.</p>
878
- * <note>
879
- * <p>If you include <code>returnControlInvocationResults</code> in the <code>sessionState</code> field, the <code>inputText</code> field will be ignored.</p>
880
- * </note>
777
+ * <p>Contains parameters that specify various attributes of the session. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/agents-session-state.html">Control session context</a>.</p> <note> <p>If you include <code>returnControlInvocationResults</code> in the <code>sessionState</code> field, the <code>inputText</code> field will be ignored.</p> </note>
881
778
  * @public
882
779
  */
883
780
  sessionState?: SessionState | undefined;
@@ -907,10 +804,7 @@ export interface InvokeAgentRequest {
907
804
  */
908
805
  enableTrace?: boolean | undefined;
909
806
  /**
910
- * <p>The prompt text to send the agent.</p>
911
- * <note>
912
- * <p>If you include <code>returnControlInvocationResults</code> in the <code>sessionState</code> field, the <code>inputText</code> field will be ignored.</p>
913
- * </note>
807
+ * <p>The prompt text to send the agent.</p> <note> <p>If you include <code>returnControlInvocationResults</code> in the <code>sessionState</code> field, the <code>inputText</code> field will be ignored.</p> </note>
914
808
  * @public
915
809
  */
916
810
  inputText?: string | undefined;
@@ -925,12 +819,7 @@ export interface InvokeAgentRequest {
925
819
  */
926
820
  bedrockModelConfigurations?: BedrockModelConfigurations | undefined;
927
821
  /**
928
- * <p>
929
- * Specifies the configurations for streaming.
930
- * </p>
931
- * <note>
932
- * <p>To use agent streaming, you need permissions to perform the <code>bedrock:InvokeModelWithResponseStream</code> action.</p>
933
- * </note>
822
+ * <p> Specifies the configurations for streaming. </p> <note> <p>To use agent streaming, you need permissions to perform the <code>bedrock:InvokeModelWithResponseStream</code> action.</p> </note>
934
823
  * @public
935
824
  */
936
825
  streamingConfigurations?: StreamingConfigurations | undefined;
@@ -945,133 +834,92 @@ export interface InvokeAgentRequest {
945
834
  */
946
835
  export interface InvokeInlineAgentRequest {
947
836
  /**
948
- * <p>
949
- * The Amazon Resource Name (ARN) of the Amazon Web Services KMS key to use to encrypt your inline agent.
950
- * </p>
837
+ * <p> The Amazon Resource Name (ARN) of the Amazon Web Services KMS key to use to encrypt your inline agent. </p>
951
838
  * @public
952
839
  */
953
840
  customerEncryptionKeyArn?: string | undefined;
954
841
  /**
955
- * <p>
956
- * The <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/model-ids.html#model-ids-arns">model identifier (ID)</a> of the model to use for orchestration by the inline agent. For example, <code>meta.llama3-1-70b-instruct-v1:0</code>.
957
- * </p>
842
+ * <p> The <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/model-ids.html#model-ids-arns">model identifier (ID)</a> of the model to use for orchestration by the inline agent. For example, <code>meta.llama3-1-70b-instruct-v1:0</code>. </p>
958
843
  * @public
959
844
  */
960
845
  foundationModel: string | undefined;
961
846
  /**
962
- * <p>
963
- * The instructions that tell the inline agent what it should do and how it should interact with users.
964
- * </p>
847
+ * <p> The instructions that tell the inline agent what it should do and how it should interact with users. </p>
965
848
  * @public
966
849
  */
967
850
  instruction: string | undefined;
968
851
  /**
969
- * <p>
970
- * The number of seconds for which the inline agent should maintain session information. After this time expires, the subsequent <code>InvokeInlineAgent</code> request begins a new session.
971
- * </p>
972
- * <p>A user interaction remains active for the amount of time specified. If no conversation occurs during this time, the session expires and the data provided before the timeout is deleted.</p>
852
+ * <p> The number of seconds for which the inline agent should maintain session information. After this time expires, the subsequent <code>InvokeInlineAgent</code> request begins a new session. </p> <p>A user interaction remains active for the amount of time specified. If no conversation occurs during this time, the session expires and the data provided before the timeout is deleted.</p>
973
853
  * @public
974
854
  */
975
855
  idleSessionTTLInSeconds?: number | undefined;
976
856
  /**
977
- * <p>
978
- * A list of action groups with each action group defining the action the inline agent needs to carry out.
979
- * </p>
857
+ * <p> A list of action groups with each action group defining the action the inline agent needs to carry out. </p>
980
858
  * @public
981
859
  */
982
860
  actionGroups?: AgentActionGroup[] | undefined;
983
861
  /**
984
- * <p>
985
- * Contains information of the knowledge bases to associate with.
986
- * </p>
862
+ * <p> Contains information of the knowledge bases to associate with. </p>
987
863
  * @public
988
864
  */
989
865
  knowledgeBases?: KnowledgeBase[] | undefined;
990
866
  /**
991
- * <p>
992
- * The <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails.html">guardrails</a> to assign to the inline agent.
993
- * </p>
867
+ * <p> The <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails.html">guardrails</a> to assign to the inline agent. </p>
994
868
  * @public
995
869
  */
996
870
  guardrailConfiguration?: GuardrailConfigurationWithArn | undefined;
997
871
  /**
998
- * <p>
999
- * Configurations for advanced prompts used to override the default prompts to enhance the accuracy of the inline agent.
1000
- * </p>
872
+ * <p> Configurations for advanced prompts used to override the default prompts to enhance the accuracy of the inline agent. </p>
1001
873
  * @public
1002
874
  */
1003
875
  promptOverrideConfiguration?: PromptOverrideConfiguration | undefined;
1004
876
  /**
1005
- * <p>
1006
- * Defines how the inline collaborator agent handles information across multiple collaborator agents to coordinate a final response. The inline collaborator agent can also be the supervisor.
1007
- * </p>
877
+ * <p> Defines how the inline collaborator agent handles information across multiple collaborator agents to coordinate a final response. The inline collaborator agent can also be the supervisor. </p>
1008
878
  * @public
1009
879
  */
1010
880
  agentCollaboration?: AgentCollaboration | undefined;
1011
881
  /**
1012
- * <p>
1013
- * Settings for an inline agent collaborator called with <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeInlineAgent.html">InvokeInlineAgent</a>.
1014
- * </p>
882
+ * <p> Settings for an inline agent collaborator called with <a href="https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeInlineAgent.html">InvokeInlineAgent</a>. </p>
1015
883
  * @public
1016
884
  */
1017
885
  collaboratorConfigurations?: CollaboratorConfiguration[] | undefined;
1018
886
  /**
1019
- * <p>
1020
- * The unique identifier of the session. Use the same value across requests to continue the same conversation.
1021
- * </p>
887
+ * <p>The name for the agent.</p>
888
+ * @public
889
+ */
890
+ agentName?: string | undefined;
891
+ /**
892
+ * <p> The unique identifier of the session. Use the same value across requests to continue the same conversation. </p>
1022
893
  * @public
1023
894
  */
1024
895
  sessionId: string | undefined;
1025
896
  /**
1026
- * <p>
1027
- * Specifies whether to end the session with the inline agent or not.
1028
- * </p>
897
+ * <p> Specifies whether to end the session with the inline agent or not. </p>
1029
898
  * @public
1030
899
  */
1031
900
  endSession?: boolean | undefined;
1032
901
  /**
1033
- * <p>
1034
- * 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/trace-events.html">Using trace</a>.
1035
- *
1036
- * </p>
902
+ * <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/trace-events.html">Using trace</a>. </p>
1037
903
  * @public
1038
904
  */
1039
905
  enableTrace?: boolean | undefined;
1040
906
  /**
1041
- * <p>
1042
- * The prompt text to send to the agent.
1043
- * </p>
1044
- * <note>
1045
- * <p>If you include <code>returnControlInvocationResults</code> in the <code>sessionState</code> field, the <code>inputText</code> field will be ignored.</p>
1046
- * </note>
907
+ * <p> The prompt text to send to the agent. </p> <note> <p>If you include <code>returnControlInvocationResults</code> in the <code>sessionState</code> field, the <code>inputText</code> field will be ignored.</p> </note>
1047
908
  * @public
1048
909
  */
1049
910
  inputText?: string | undefined;
1050
911
  /**
1051
- * <p>
1052
- * Specifies the configurations for streaming.
1053
- * </p>
1054
- * <note>
1055
- * <p>To use agent streaming, you need permissions to perform the <code>bedrock:InvokeModelWithResponseStream</code> action.</p>
1056
- * </note>
912
+ * <p> Specifies the configurations for streaming. </p> <note> <p>To use agent streaming, you need permissions to perform the <code>bedrock:InvokeModelWithResponseStream</code> action.</p> </note>
1057
913
  * @public
1058
914
  */
1059
915
  streamingConfigurations?: StreamingConfigurations | undefined;
1060
916
  /**
1061
- * <p>
1062
- * Parameters that specify the various attributes of a sessions. You can include attributes for the session or prompt or, if you configured an
1063
- * action group to return control, results from invocation of the action group. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/agents-session-state.html">Control session context</a>.
1064
- * </p>
1065
- * <note>
1066
- * <p>If you include <code>returnControlInvocationResults</code> in the <code>sessionState</code> field, the <code>inputText</code> field will be ignored.</p>
1067
- * </note>
917
+ * <p> Parameters that specify the various attributes of a sessions. You can include attributes for the session or prompt or, if you configured an action group to return control, results from invocation of the action group. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/agents-session-state.html">Control session context</a>. </p> <note> <p>If you include <code>returnControlInvocationResults</code> in the <code>sessionState</code> field, the <code>inputText</code> field will be ignored.</p> </note>
1068
918
  * @public
1069
919
  */
1070
920
  inlineSessionState?: InlineSessionState | undefined;
1071
921
  /**
1072
- * <p>
1073
- * List of collaborator inline agents.
1074
- * </p>
922
+ * <p> List of collaborator inline agents. </p>
1075
923
  * @public
1076
924
  */
1077
925
  collaborators?: Collaborator[] | undefined;
@@ -1080,6 +928,16 @@ export interface InvokeInlineAgentRequest {
1080
928
  * @public
1081
929
  */
1082
930
  bedrockModelConfigurations?: InlineBedrockModelConfigurations | undefined;
931
+ /**
932
+ * <p>Specifies the type of orchestration strategy for the agent. This is set to DEFAULT orchestration type, by default. </p>
933
+ * @public
934
+ */
935
+ orchestrationType?: OrchestrationType | undefined;
936
+ /**
937
+ * <p>Contains details of the custom orchestration configured for the agent. </p>
938
+ * @public
939
+ */
940
+ customOrchestration?: CustomOrchestration | undefined;
1083
941
  }
1084
942
  /**
1085
943
  * @internal