@aws-sdk/client-qconnect 3.1135.0 → 3.1137.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.
Files changed (38) hide show
  1. package/README.md +1 -1
  2. package/dist-cjs/index.js +88 -18
  3. package/dist-es/models/enums.js +11 -0
  4. package/dist-es/schemas/schemas_0.js +70 -17
  5. package/dist-types/QConnect.d.ts +1 -1
  6. package/dist-types/QConnectClient.d.ts +1 -1
  7. package/dist-types/commands/CreateAIAgentCommand.d.ts +74 -2
  8. package/dist-types/commands/CreateAIAgentVersionCommand.d.ts +37 -1
  9. package/dist-types/commands/CreateContentAssociationCommand.d.ts +1 -1
  10. package/dist-types/commands/CreateMessageTemplateVersionCommand.d.ts +2 -1
  11. package/dist-types/commands/CreateQuickResponseCommand.d.ts +1 -2
  12. package/dist-types/commands/CreateSessionCommand.d.ts +1 -1
  13. package/dist-types/commands/DeleteContentAssociationCommand.d.ts +1 -1
  14. package/dist-types/commands/GetAIAgentCommand.d.ts +37 -1
  15. package/dist-types/commands/GetContentAssociationCommand.d.ts +1 -1
  16. package/dist-types/commands/GetNextMessageCommand.d.ts +1 -0
  17. package/dist-types/commands/GetRecommendationsCommand.d.ts +1 -1
  18. package/dist-types/commands/ListAIAgentVersionsCommand.d.ts +37 -1
  19. package/dist-types/commands/ListAIAgentsCommand.d.ts +37 -1
  20. package/dist-types/commands/ListContentAssociationsCommand.d.ts +1 -1
  21. package/dist-types/commands/ListMessagesCommand.d.ts +1 -0
  22. package/dist-types/commands/ListSpansCommand.d.ts +3 -0
  23. package/dist-types/commands/QueryAssistantCommand.d.ts +1 -1
  24. package/dist-types/commands/SendMessageCommand.d.ts +1 -0
  25. package/dist-types/commands/UpdateAIAgentCommand.d.ts +74 -2
  26. package/dist-types/commands/UpdateSessionCommand.d.ts +1 -1
  27. package/dist-types/index.d.ts +1 -1
  28. package/dist-types/models/enums.d.ts +27 -0
  29. package/dist-types/models/models_0.d.ts +187 -267
  30. package/dist-types/models/models_1.d.ts +279 -7
  31. package/dist-types/schemas/schemas_0.d.ts +5 -0
  32. package/dist-types/ts3.4/commands/CreateMessageTemplateVersionCommand.d.ts +2 -4
  33. package/dist-types/ts3.4/commands/CreateQuickResponseCommand.d.ts +1 -2
  34. package/dist-types/ts3.4/models/enums.d.ts +13 -0
  35. package/dist-types/ts3.4/models/models_0.d.ts +81 -76
  36. package/dist-types/ts3.4/models/models_1.d.ts +81 -3
  37. package/dist-types/ts3.4/schemas/schemas_0.d.ts +5 -0
  38. package/package.json +1 -1
@@ -216,7 +216,7 @@ declare const ListAIAgentVersionsCommand_base: {
216
216
  * // ],
217
217
  * // },
218
218
  * // orchestrationAIAgentConfiguration: { // OrchestrationAIAgentConfiguration
219
- * // orchestrationAIPromptId: "STRING_VALUE", // required
219
+ * // orchestrationAIPromptId: "STRING_VALUE",
220
220
  * // orchestrationAIGuardrailId: "STRING_VALUE",
221
221
  * // toolConfigurations: [ // ToolConfigurationList
222
222
  * // { // ToolConfiguration
@@ -262,8 +262,44 @@ declare const ListAIAgentVersionsCommand_base: {
262
262
  * // },
263
263
  * // },
264
264
  * // ],
265
+ * // multiAgentConfigurations: [ // MultiAgentConfigurationList
266
+ * // { // MultiAgentConfiguration Union: only one key present
267
+ * // delegateAgentConfiguration: { // DelegateAgentConfiguration
268
+ * // agentTarget: { // AgentTarget Union: only one key present
269
+ * // aiAgentId: "STRING_VALUE",
270
+ * // applicationId: "STRING_VALUE",
271
+ * // },
272
+ * // instruction: { // MultiAgentInstruction
273
+ * // instruction: "STRING_VALUE",
274
+ * // examples: [ // MultiAgentExampleList
275
+ * // "STRING_VALUE",
276
+ * // ],
277
+ * // },
278
+ * // },
279
+ * // handoffAgentConfiguration: { // HandoffAgentConfiguration
280
+ * // agentTarget: {// Union: only one key present
281
+ * // aiAgentId: "STRING_VALUE",
282
+ * // applicationId: "STRING_VALUE",
283
+ * // },
284
+ * // instruction: {
285
+ * // instruction: "STRING_VALUE",
286
+ * // examples: [
287
+ * // "STRING_VALUE",
288
+ * // ],
289
+ * // },
290
+ * // audioStreamingEnabled: true || false,
291
+ * // immediateHandoff: true || false,
292
+ * // },
293
+ * // },
294
+ * // ],
265
295
  * // connectInstanceArn: "STRING_VALUE",
266
296
  * // locale: "STRING_VALUE",
297
+ * // inputSchemas: [ // JSONDocumentList
298
+ * // "DOCUMENT_VALUE",
299
+ * // ],
300
+ * // outputSchemas: [
301
+ * // "DOCUMENT_VALUE",
302
+ * // ],
267
303
  * // },
268
304
  * // noteTakingAIAgentConfiguration: { // NoteTakingAIAgentConfiguration
269
305
  * // noteTakingAIPromptId: "STRING_VALUE",
@@ -214,7 +214,7 @@ declare const ListAIAgentsCommand_base: {
214
214
  * // ],
215
215
  * // },
216
216
  * // orchestrationAIAgentConfiguration: { // OrchestrationAIAgentConfiguration
217
- * // orchestrationAIPromptId: "STRING_VALUE", // required
217
+ * // orchestrationAIPromptId: "STRING_VALUE",
218
218
  * // orchestrationAIGuardrailId: "STRING_VALUE",
219
219
  * // toolConfigurations: [ // ToolConfigurationList
220
220
  * // { // ToolConfiguration
@@ -260,8 +260,44 @@ declare const ListAIAgentsCommand_base: {
260
260
  * // },
261
261
  * // },
262
262
  * // ],
263
+ * // multiAgentConfigurations: [ // MultiAgentConfigurationList
264
+ * // { // MultiAgentConfiguration Union: only one key present
265
+ * // delegateAgentConfiguration: { // DelegateAgentConfiguration
266
+ * // agentTarget: { // AgentTarget Union: only one key present
267
+ * // aiAgentId: "STRING_VALUE",
268
+ * // applicationId: "STRING_VALUE",
269
+ * // },
270
+ * // instruction: { // MultiAgentInstruction
271
+ * // instruction: "STRING_VALUE",
272
+ * // examples: [ // MultiAgentExampleList
273
+ * // "STRING_VALUE",
274
+ * // ],
275
+ * // },
276
+ * // },
277
+ * // handoffAgentConfiguration: { // HandoffAgentConfiguration
278
+ * // agentTarget: {// Union: only one key present
279
+ * // aiAgentId: "STRING_VALUE",
280
+ * // applicationId: "STRING_VALUE",
281
+ * // },
282
+ * // instruction: {
283
+ * // instruction: "STRING_VALUE",
284
+ * // examples: [
285
+ * // "STRING_VALUE",
286
+ * // ],
287
+ * // },
288
+ * // audioStreamingEnabled: true || false,
289
+ * // immediateHandoff: true || false,
290
+ * // },
291
+ * // },
292
+ * // ],
263
293
  * // connectInstanceArn: "STRING_VALUE",
264
294
  * // locale: "STRING_VALUE",
295
+ * // inputSchemas: [ // JSONDocumentList
296
+ * // "DOCUMENT_VALUE",
297
+ * // ],
298
+ * // outputSchemas: [
299
+ * // "DOCUMENT_VALUE",
300
+ * // ],
265
301
  * // },
266
302
  * // noteTakingAIAgentConfiguration: { // NoteTakingAIAgentConfiguration
267
303
  * // noteTakingAIPromptId: "STRING_VALUE",
@@ -24,7 +24,7 @@ declare const ListContentAssociationsCommand_base: {
24
24
  getEndpointParameterInstructions(): import("@smithy/types").EndpointParameterInstructions;
25
25
  };
26
26
  /**
27
- * <p>Lists the content associations.</p> <p>For more information about content associations--what they are and when they are used--see <a href="https://docs.aws.amazon.com/connect/latest/adminguide/integrate-q-with-guides.html">Integrate Amazon Q in Connect with step-by-step guides</a> in the <i>Amazon Connect Administrator Guide</i>.</p>
27
+ * <p>Lists the content associations.</p> <p>For more information about content associations--what they are and when they are used--see <a href="https://docs.aws.amazon.com/connect/latest/adminguide/integrate-q-with-guides.html">Integrate Amazon Q in Connect with step-by-step guides</a> in the <i>Connect Customer Administrator Guide</i>.</p>
28
28
  * @example
29
29
  * Use a bare-bones client and the command you need to make an API call.
30
30
  * ```javascript
@@ -71,6 +71,7 @@ declare const ListMessagesCommand_base: {
71
71
  * // toolResult: "DOCUMENT_VALUE", // required
72
72
  * // inputSchema: "DOCUMENT_VALUE",
73
73
  * // },
74
+ * // data: "DOCUMENT_VALUE",
74
75
  * // },
75
76
  * // messageId: "STRING_VALUE", // required
76
77
  * // participant: "STRING_VALUE", // required
@@ -73,6 +73,9 @@ declare const ListSpansCommand_base: {
73
73
  * // aiAgentVersion: Number("int"),
74
74
  * // aiAgentInvoker: "STRING_VALUE",
75
75
  * // aiAgentOrchestratorUseCase: "STRING_VALUE",
76
+ * // interactionMode: "STRING_VALUE",
77
+ * // targetAgentId: "STRING_VALUE",
78
+ * // returnReason: "STRING_VALUE",
76
79
  * // requestModel: "STRING_VALUE",
77
80
  * // requestMaxTokens: Number("int"),
78
81
  * // temperature: Number("float"),
@@ -25,7 +25,7 @@ declare const QueryAssistantCommand_base: {
25
25
  getEndpointParameterInstructions(): import("@smithy/types").EndpointParameterInstructions;
26
26
  };
27
27
  /**
28
- * <important> <p>This API will be discontinued starting June 1, 2024. To receive generative responses after March 1, 2024, you will need to create a new Assistant in the Amazon Connect console and integrate the Amazon Q in Connect JavaScript library (amazon-q-connectjs) into your applications.</p> </important> <p>Performs a manual search against the specified assistant. To retrieve recommendations for an assistant, use <a href="https://docs.aws.amazon.com/amazon-q-connect/latest/APIReference/API_GetRecommendations.html">GetRecommendations</a>. </p>
28
+ * <important> <p>This API will be discontinued starting June 1, 2024. To receive generative responses after March 1, 2024, you will need to create a new Assistant in the Connect Customer console and integrate the Amazon Q in Connect JavaScript library (amazon-q-connectjs) into your applications.</p> </important> <p>Performs a manual search against the specified assistant. To retrieve recommendations for an assistant, use <a href="https://docs.aws.amazon.com/amazon-q-connect/latest/APIReference/API_GetRecommendations.html">GetRecommendations</a>. </p>
29
29
  *
30
30
  * @deprecated QueryAssistant API will be discontinued starting June 1, 2024. To receive generative responses after March 1, 2024 you will need to create a new Assistant in the Connect console and integrate the Amazon Q in Connect JavaScript library (amazon-q-connectjs) into your applications.
31
31
  * @example
@@ -64,6 +64,7 @@ declare const SendMessageCommand_base: {
64
64
  * toolResult: "DOCUMENT_VALUE", // required
65
65
  * inputSchema: "DOCUMENT_VALUE",
66
66
  * },
67
+ * data: "DOCUMENT_VALUE",
67
68
  * },
68
69
  * },
69
70
  * aiAgentId: "STRING_VALUE",
@@ -200,7 +200,7 @@ declare const UpdateAIAgentCommand_base: {
200
200
  * ],
201
201
  * },
202
202
  * orchestrationAIAgentConfiguration: { // OrchestrationAIAgentConfiguration
203
- * orchestrationAIPromptId: "STRING_VALUE", // required
203
+ * orchestrationAIPromptId: "STRING_VALUE",
204
204
  * orchestrationAIGuardrailId: "STRING_VALUE",
205
205
  * toolConfigurations: [ // ToolConfigurationList
206
206
  * { // ToolConfiguration
@@ -246,8 +246,44 @@ declare const UpdateAIAgentCommand_base: {
246
246
  * },
247
247
  * },
248
248
  * ],
249
+ * multiAgentConfigurations: [ // MultiAgentConfigurationList
250
+ * { // MultiAgentConfiguration Union: only one key present
251
+ * delegateAgentConfiguration: { // DelegateAgentConfiguration
252
+ * agentTarget: { // AgentTarget Union: only one key present
253
+ * aiAgentId: "STRING_VALUE",
254
+ * applicationId: "STRING_VALUE",
255
+ * },
256
+ * instruction: { // MultiAgentInstruction
257
+ * instruction: "STRING_VALUE",
258
+ * examples: [ // MultiAgentExampleList
259
+ * "STRING_VALUE",
260
+ * ],
261
+ * },
262
+ * },
263
+ * handoffAgentConfiguration: { // HandoffAgentConfiguration
264
+ * agentTarget: {// Union: only one key present
265
+ * aiAgentId: "STRING_VALUE",
266
+ * applicationId: "STRING_VALUE",
267
+ * },
268
+ * instruction: {
269
+ * instruction: "STRING_VALUE",
270
+ * examples: [
271
+ * "STRING_VALUE",
272
+ * ],
273
+ * },
274
+ * audioStreamingEnabled: true || false,
275
+ * immediateHandoff: true || false,
276
+ * },
277
+ * },
278
+ * ],
249
279
  * connectInstanceArn: "STRING_VALUE",
250
280
  * locale: "STRING_VALUE",
281
+ * inputSchemas: [ // JSONDocumentList
282
+ * "DOCUMENT_VALUE",
283
+ * ],
284
+ * outputSchemas: [
285
+ * "DOCUMENT_VALUE",
286
+ * ],
251
287
  * },
252
288
  * noteTakingAIAgentConfiguration: { // NoteTakingAIAgentConfiguration
253
289
  * noteTakingAIPromptId: "STRING_VALUE",
@@ -434,7 +470,7 @@ declare const UpdateAIAgentCommand_base: {
434
470
  * // ],
435
471
  * // },
436
472
  * // orchestrationAIAgentConfiguration: { // OrchestrationAIAgentConfiguration
437
- * // orchestrationAIPromptId: "STRING_VALUE", // required
473
+ * // orchestrationAIPromptId: "STRING_VALUE",
438
474
  * // orchestrationAIGuardrailId: "STRING_VALUE",
439
475
  * // toolConfigurations: [ // ToolConfigurationList
440
476
  * // { // ToolConfiguration
@@ -480,8 +516,44 @@ declare const UpdateAIAgentCommand_base: {
480
516
  * // },
481
517
  * // },
482
518
  * // ],
519
+ * // multiAgentConfigurations: [ // MultiAgentConfigurationList
520
+ * // { // MultiAgentConfiguration Union: only one key present
521
+ * // delegateAgentConfiguration: { // DelegateAgentConfiguration
522
+ * // agentTarget: { // AgentTarget Union: only one key present
523
+ * // aiAgentId: "STRING_VALUE",
524
+ * // applicationId: "STRING_VALUE",
525
+ * // },
526
+ * // instruction: { // MultiAgentInstruction
527
+ * // instruction: "STRING_VALUE",
528
+ * // examples: [ // MultiAgentExampleList
529
+ * // "STRING_VALUE",
530
+ * // ],
531
+ * // },
532
+ * // },
533
+ * // handoffAgentConfiguration: { // HandoffAgentConfiguration
534
+ * // agentTarget: {// Union: only one key present
535
+ * // aiAgentId: "STRING_VALUE",
536
+ * // applicationId: "STRING_VALUE",
537
+ * // },
538
+ * // instruction: {
539
+ * // instruction: "STRING_VALUE",
540
+ * // examples: [
541
+ * // "STRING_VALUE",
542
+ * // ],
543
+ * // },
544
+ * // audioStreamingEnabled: true || false,
545
+ * // immediateHandoff: true || false,
546
+ * // },
547
+ * // },
548
+ * // ],
483
549
  * // connectInstanceArn: "STRING_VALUE",
484
550
  * // locale: "STRING_VALUE",
551
+ * // inputSchemas: [ // JSONDocumentList
552
+ * // "DOCUMENT_VALUE",
553
+ * // ],
554
+ * // outputSchemas: [
555
+ * // "DOCUMENT_VALUE",
556
+ * // ],
485
557
  * // },
486
558
  * // noteTakingAIAgentConfiguration: { // NoteTakingAIAgentConfiguration
487
559
  * // noteTakingAIPromptId: "STRING_VALUE",
@@ -24,7 +24,7 @@ declare const UpdateSessionCommand_base: {
24
24
  getEndpointParameterInstructions(): import("@smithy/types").EndpointParameterInstructions;
25
25
  };
26
26
  /**
27
- * <p>Updates a session. A session is a contextual container used for generating recommendations. Amazon Connect updates the existing Amazon Q in Connect session for each contact on which Amazon Q in Connect is enabled.</p>
27
+ * <p>Updates a session. A session is a contextual container used for generating recommendations. Connect Customer updates the existing Amazon Q in Connect session for each contact on which Amazon Q in Connect is enabled.</p>
28
28
  * @example
29
29
  * Use a bare-bones client and the command you need to make an API call.
30
30
  * ```javascript
@@ -1,5 +1,5 @@
1
1
  /**
2
- * <ul> <li> <p> <a href="https://docs.aws.amazon.com/connect/latest/APIReference/API_Operations_Amazon_Q_Connect.html">Amazon Q actions</a> </p> </li> <li> <p> <a href="https://docs.aws.amazon.com/connect/latest/APIReference/API_Types_Amazon_Q_Connect.html">Amazon Q data types</a> </p> </li> </ul> <note> <p> <b>Powered by Amazon Bedrock</b>: Amazon Web Services implements <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/abuse-detection.html">automated abuse detection</a>. Because Amazon Q in Connect is built on Amazon Bedrock, users can take full advantage of the controls implemented in Amazon Bedrock to enforce safety, security, and the responsible use of artificial intelligence (AI).</p> </note> <p>Amazon Q in Connect is a generative AI customer service assistant. It is an LLM-enhanced evolution of Amazon Connect Wisdom that delivers real-time recommendations to help contact center agents resolve customer issues quickly and accurately.</p> <p>Amazon Q in Connect automatically detects customer intent during calls and chats using conversational analytics and natural language understanding (NLU). It then provides agents with immediate, real-time generative responses and suggested actions, and links to relevant documents and articles. Agents can also query Amazon Q in Connect directly using natural language or keywords to answer customer requests.</p> <p>Use the Amazon Q in Connect APIs to create an assistant and a knowledge base, for example, or manage content by uploading custom files.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/connect/latest/adminguide/amazon-q-connect.html">Use Amazon Q in Connect for generative AI powered agent assistance in real-time</a> in the <i>Amazon Connect Administrator Guide</i>.</p>
2
+ * <ul> <li> <p> <a href="https://docs.aws.amazon.com/connect/latest/APIReference/API_Operations_Amazon_Q_Connect.html">Amazon Q actions</a> </p> </li> <li> <p> <a href="https://docs.aws.amazon.com/connect/latest/APIReference/API_Types_Amazon_Q_Connect.html">Amazon Q data types</a> </p> </li> </ul> <note> <p> <b>Powered by Amazon Bedrock</b>: Amazon Web Services implements <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/abuse-detection.html">automated abuse detection</a>. Because Amazon Q in Connect is built on Amazon Bedrock, users can take full advantage of the controls implemented in Amazon Bedrock to enforce safety, security, and the responsible use of artificial intelligence (AI).</p> </note> <p>Amazon Q in Connect is a generative AI customer service assistant. It is an LLM-enhanced evolution of Connect Customer Wisdom that delivers real-time recommendations to help contact center agents resolve customer issues quickly and accurately.</p> <p>Amazon Q in Connect automatically detects customer intent during calls and chats using conversational analytics and natural language understanding (NLU). It then provides agents with immediate, real-time generative responses and suggested actions, and links to relevant documents and articles. Agents can also query Amazon Q in Connect directly using natural language or keywords to answer customer requests.</p> <p>Use the Amazon Q in Connect APIs to create an assistant and a knowledge base, for example, or manage content by uploading custom files.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/connect/latest/adminguide/amazon-q-connect.html">Use Amazon Q in Connect for generative AI powered agent assistance in real-time</a> in the <i>Connect Customer Administrator Guide</i>.</p>
3
3
  *
4
4
  * @packageDocumentation
5
5
  */
@@ -579,6 +579,7 @@ export type Participant = (typeof Participant)[keyof typeof Participant];
579
579
  * @enum
580
580
  */
581
581
  export declare const MessageType: {
582
+ readonly DATA: "DATA";
582
583
  readonly TEXT: "TEXT";
583
584
  readonly TOOL_USE_RESULT: "TOOL_USE_RESULT";
584
585
  };
@@ -639,6 +640,32 @@ export declare const GuardrailSource: {
639
640
  * @public
640
641
  */
641
642
  export type GuardrailSource = (typeof GuardrailSource)[keyof typeof GuardrailSource];
643
+ /**
644
+ * @public
645
+ * @enum
646
+ */
647
+ export declare const InteractionMode: {
648
+ readonly DELEGATE: "DELEGATE";
649
+ readonly HANDOFF: "HANDOFF";
650
+ };
651
+ /**
652
+ * @public
653
+ */
654
+ export type InteractionMode = (typeof InteractionMode)[keyof typeof InteractionMode];
655
+ /**
656
+ * @public
657
+ * @enum
658
+ */
659
+ export declare const ReturnReason: {
660
+ readonly COMPLETE: "COMPLETE";
661
+ readonly COMPLETE_WITH_ERROR: "COMPLETE_WITH_ERROR";
662
+ readonly ESCALATE: "ESCALATE";
663
+ readonly OUT_OF_DOMAIN: "OUT_OF_DOMAIN";
664
+ };
665
+ /**
666
+ * @public
667
+ */
668
+ export type ReturnReason = (typeof ReturnReason)[keyof typeof ReturnReason];
642
669
  /**
643
670
  * @public
644
671
  * @enum