@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.
- package/dist-cjs/index.js +27 -2
- package/dist-es/models/models_0.js +14 -0
- package/dist-es/models/models_1.js +2 -0
- package/dist-es/protocols/Aws_restJson1.js +6 -0
- package/dist-types/commands/CreateInvocationCommand.d.ts +1 -20
- package/dist-types/commands/CreateSessionCommand.d.ts +1 -36
- package/dist-types/commands/DeleteSessionCommand.d.ts +1 -3
- package/dist-types/commands/EndSessionCommand.d.ts +1 -3
- package/dist-types/commands/InvokeAgentCommand.d.ts +5 -42
- package/dist-types/commands/InvokeFlowCommand.d.ts +1 -4
- package/dist-types/commands/InvokeInlineAgentCommand.d.ts +15 -25
- package/dist-types/commands/ListSessionsCommand.d.ts +3 -1
- package/dist-types/commands/PutInvocationStepCommand.d.ts +1 -24
- package/dist-types/commands/RetrieveAndGenerateStreamCommand.d.ts +1 -5
- package/dist-types/commands/TagResourceCommand.d.ts +1 -1
- package/dist-types/commands/UpdateSessionCommand.d.ts +1 -2
- package/dist-types/models/models_0.d.ts +218 -824
- package/dist-types/models/models_1.d.ts +132 -274
- package/dist-types/ts3.4/commands/ListSessionsCommand.d.ts +2 -1
- package/dist-types/ts3.4/commands/UpdateSessionCommand.d.ts +4 -2
- package/dist-types/ts3.4/models/models_0.d.ts +33 -18
- package/dist-types/ts3.4/models/models_1.d.ts +20 -0
- package/package.json +1 -1
|
@@ -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
|
-
*
|
|
1021
|
-
|
|
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
|