aws-sdk-bedrockagentruntime 1.15.0 → 1.16.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.
@@ -41,10 +41,24 @@ module Aws::BedrockAgentRuntime
41
41
  # The path to the API to call, based off the action group.
42
42
  # @return [String]
43
43
  #
44
+ # @!attribute [rw] execution_type
45
+ # How fulfillment of the action is handled. For more information, see
46
+ # [Handling fulfillment of the action][1].
47
+ #
48
+ #
49
+ #
50
+ # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/action-handle.html
51
+ # @return [String]
52
+ #
44
53
  # @!attribute [rw] function
45
54
  # The function in the action group to call.
46
55
  # @return [String]
47
56
  #
57
+ # @!attribute [rw] invocation_id
58
+ # The unique identifier of the invocation. Only returned if the
59
+ # `executionType` is `RETURN_CONTROL`.
60
+ # @return [String]
61
+ #
48
62
  # @!attribute [rw] parameters
49
63
  # The parameters in the Lambda input event.
50
64
  # @return [Array<Types::Parameter>]
@@ -62,7 +76,9 @@ module Aws::BedrockAgentRuntime
62
76
  class ActionGroupInvocationInput < Struct.new(
63
77
  :action_group_name,
64
78
  :api_path,
79
+ :execution_type,
65
80
  :function,
81
+ :invocation_id,
66
82
  :parameters,
67
83
  :request_body,
68
84
  :verb)
@@ -312,6 +328,28 @@ module Aws::BedrockAgentRuntime
312
328
  include Aws::Structure
313
329
  end
314
330
 
331
+ # The property contains the file to chat with, along with its
332
+ # attributes.
333
+ #
334
+ # @!attribute [rw] data
335
+ # The byte value of the file to attach, encoded as Base-64 string. The
336
+ # maximum size of all files that is attached is 10MB. You can attach a
337
+ # maximum of 5 files.
338
+ # @return [String]
339
+ #
340
+ # @!attribute [rw] media_type
341
+ # The MIME type of data contained in the file used for chat.
342
+ # @return [String]
343
+ #
344
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/ByteContentFile AWS API Documentation
345
+ #
346
+ class ByteContentFile < Struct.new(
347
+ :data,
348
+ :media_type)
349
+ SENSITIVE = [:data]
350
+ include Aws::Structure
351
+ end
352
+
315
353
  # An object containing a segment of the generated response that is based
316
354
  # on a source in the knowledge base, alongside information about the
317
355
  # source.
@@ -345,6 +383,55 @@ module Aws::BedrockAgentRuntime
345
383
  include Aws::Structure
346
384
  end
347
385
 
386
+ # Contains information about the code interpreter being invoked.
387
+ #
388
+ # @!attribute [rw] code
389
+ # The code for the code interpreter to use.
390
+ # @return [String]
391
+ #
392
+ # @!attribute [rw] files
393
+ # Files that are uploaded for code interpreter to use.
394
+ # @return [Array<String>]
395
+ #
396
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/CodeInterpreterInvocationInput AWS API Documentation
397
+ #
398
+ class CodeInterpreterInvocationInput < Struct.new(
399
+ :code,
400
+ :files)
401
+ SENSITIVE = []
402
+ include Aws::Structure
403
+ end
404
+
405
+ # Contains the JSON-formatted string returned by the API invoked by the
406
+ # code interpreter.
407
+ #
408
+ # @!attribute [rw] execution_error
409
+ # Contains the error returned from code execution.
410
+ # @return [String]
411
+ #
412
+ # @!attribute [rw] execution_output
413
+ # Contains the successful output returned from code execution
414
+ # @return [String]
415
+ #
416
+ # @!attribute [rw] execution_timeout
417
+ # Indicates if the execution of the code timed out.
418
+ # @return [Boolean]
419
+ #
420
+ # @!attribute [rw] files
421
+ # Contains output files, if generated by code execution.
422
+ # @return [Array<String>]
423
+ #
424
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/CodeInterpreterInvocationOutput AWS API Documentation
425
+ #
426
+ class CodeInterpreterInvocationOutput < Struct.new(
427
+ :execution_error,
428
+ :execution_output,
429
+ :execution_timeout,
430
+ :files)
431
+ SENSITIVE = []
432
+ include Aws::Structure
433
+ end
434
+
348
435
  # There was a conflict performing an operation. Resolve the conflict and
349
436
  # retry your request.
350
437
  #
@@ -385,6 +472,32 @@ module Aws::BedrockAgentRuntime
385
472
  include Aws::Structure
386
473
  end
387
474
 
475
+ # @!attribute [rw] agent_alias_id
476
+ # The unique identifier of an alias of an agent.
477
+ # @return [String]
478
+ #
479
+ # @!attribute [rw] agent_id
480
+ # The unique identifier of the agent to which the alias belongs.
481
+ # @return [String]
482
+ #
483
+ # @!attribute [rw] memory_id
484
+ # The unique identifier of the memory.
485
+ # @return [String]
486
+ #
487
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/DeleteAgentMemoryRequest AWS API Documentation
488
+ #
489
+ class DeleteAgentMemoryRequest < Struct.new(
490
+ :agent_alias_id,
491
+ :agent_id,
492
+ :memory_id)
493
+ SENSITIVE = []
494
+ include Aws::Structure
495
+ end
496
+
497
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/DeleteAgentMemoryResponse AWS API Documentation
498
+ #
499
+ class DeleteAgentMemoryResponse < Aws::EmptyStructure; end
500
+
388
501
  # There was an issue with a dependency. Check the resource
389
502
  # configurations and retry the request.
390
503
  #
@@ -514,6 +627,46 @@ module Aws::BedrockAgentRuntime
514
627
  include Aws::Structure
515
628
  end
516
629
 
630
+ # Contains intermediate response for code interpreter if any files have
631
+ # been generated.
632
+ #
633
+ # @!attribute [rw] files
634
+ # Files containing intermediate response for the user.
635
+ # @return [Array<Types::OutputFile>]
636
+ #
637
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/FilePart AWS API Documentation
638
+ #
639
+ class FilePart < Struct.new(
640
+ :files,
641
+ :event_type)
642
+ SENSITIVE = []
643
+ include Aws::Structure
644
+ end
645
+
646
+ # The source file of the content contained in the wrapper object.
647
+ #
648
+ # @!attribute [rw] byte_content
649
+ # The data and the text of the attached files.
650
+ # @return [Types::ByteContentFile]
651
+ #
652
+ # @!attribute [rw] s3_location
653
+ # The s3 location of the files to attach.
654
+ # @return [Types::S3ObjectFile]
655
+ #
656
+ # @!attribute [rw] source_type
657
+ # The source type of the files to attach.
658
+ # @return [String]
659
+ #
660
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/FileSource AWS API Documentation
661
+ #
662
+ class FileSource < Struct.new(
663
+ :byte_content,
664
+ :s3_location,
665
+ :source_type)
666
+ SENSITIVE = []
667
+ include Aws::Structure
668
+ end
669
+
517
670
  # Specifies the name that the metadata attribute must match and the
518
671
  # value to which to compare the value of the metadata attribute. For
519
672
  # more information, see [Query configurations][1].
@@ -560,6 +713,163 @@ module Aws::BedrockAgentRuntime
560
713
  include Aws::Structure
561
714
  end
562
715
 
716
+ # Contains information about why a flow completed.
717
+ #
718
+ # This data type is used in the following API operations:
719
+ #
720
+ # * [InvokeFlow response][1]
721
+ #
722
+ # ^
723
+ #
724
+ #
725
+ #
726
+ # [1]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeFlow.html#API_agent_InvokeFlow_ResponseSyntax
727
+ #
728
+ # @!attribute [rw] completion_reason
729
+ # The reason that the flow completed.
730
+ # @return [String]
731
+ #
732
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/FlowCompletionEvent AWS API Documentation
733
+ #
734
+ class FlowCompletionEvent < Struct.new(
735
+ :completion_reason,
736
+ :event_type)
737
+ SENSITIVE = []
738
+ include Aws::Structure
739
+ end
740
+
741
+ # Contains information about an input into the flow and what to do with
742
+ # it.
743
+ #
744
+ # This data type is used in the following API operations:
745
+ #
746
+ # * [InvokeFlow request][1]
747
+ #
748
+ # ^
749
+ #
750
+ #
751
+ #
752
+ # [1]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeFlow.html#API_agent_InvokeFlow_RequestSyntax
753
+ #
754
+ # @!attribute [rw] content
755
+ # Contains information about an input into the flow.
756
+ # @return [Types::FlowInputContent]
757
+ #
758
+ # @!attribute [rw] node_name
759
+ # A name for the input of the flow input node.
760
+ # @return [String]
761
+ #
762
+ # @!attribute [rw] node_output_name
763
+ # A name for the output of the flow input node.
764
+ # @return [String]
765
+ #
766
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/FlowInput AWS API Documentation
767
+ #
768
+ class FlowInput < Struct.new(
769
+ :content,
770
+ :node_name,
771
+ :node_output_name)
772
+ SENSITIVE = [:content]
773
+ include Aws::Structure
774
+ end
775
+
776
+ # Contains information about an input into the flow.
777
+ #
778
+ # This data type is used in the following API operations:
779
+ #
780
+ # * [InvokeFlow request][1]
781
+ #
782
+ # ^
783
+ #
784
+ #
785
+ #
786
+ # [1]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeFlow.html#API_agent_InvokeFlow_RequestSyntax
787
+ #
788
+ # @note FlowInputContent is a union - when making an API calls you must set exactly one of the members.
789
+ #
790
+ # @!attribute [rw] document
791
+ # The input for the flow input node.
792
+ # @return [Hash,Array,String,Numeric,Boolean]
793
+ #
794
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/FlowInputContent AWS API Documentation
795
+ #
796
+ class FlowInputContent < Struct.new(
797
+ :document,
798
+ :unknown)
799
+ SENSITIVE = []
800
+ include Aws::Structure
801
+ include Aws::Structure::Union
802
+
803
+ class Document < FlowInputContent; end
804
+ class Unknown < FlowInputContent; end
805
+ end
806
+
807
+ # Contains information about the output node.
808
+ #
809
+ # This data type is used in the following API operations:
810
+ #
811
+ # * [InvokeFlow request][1]
812
+ #
813
+ # ^
814
+ #
815
+ #
816
+ #
817
+ # [1]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeFlow.html#API_agent_InvokeFlow_RequestSyntax
818
+ #
819
+ # @note FlowOutputContent is a union - when returned from an API call exactly one value will be set and the returned type will be a subclass of FlowOutputContent corresponding to the set member.
820
+ #
821
+ # @!attribute [rw] document
822
+ # A name for the output of the flow.
823
+ # @return [Hash,Array,String,Numeric,Boolean]
824
+ #
825
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/FlowOutputContent AWS API Documentation
826
+ #
827
+ class FlowOutputContent < Struct.new(
828
+ :document,
829
+ :unknown)
830
+ SENSITIVE = []
831
+ include Aws::Structure
832
+ include Aws::Structure::Union
833
+
834
+ class Document < FlowOutputContent; end
835
+ class Unknown < FlowOutputContent; end
836
+ end
837
+
838
+ # Contains information about an output from flow invoction.
839
+ #
840
+ # This data type is used in the following API operations:
841
+ #
842
+ # * [InvokeFlow response][1]
843
+ #
844
+ # ^
845
+ #
846
+ #
847
+ #
848
+ # [1]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeFlow.html#API_agent_InvokeFlow_ResponseSyntax
849
+ #
850
+ # @!attribute [rw] content
851
+ # The output of the node.
852
+ # @return [Types::FlowOutputContent]
853
+ #
854
+ # @!attribute [rw] node_name
855
+ # The name of the node to which input was provided.
856
+ # @return [String]
857
+ #
858
+ # @!attribute [rw] node_type
859
+ # The type of node to which input was provided.
860
+ # @return [String]
861
+ #
862
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/FlowOutputEvent AWS API Documentation
863
+ #
864
+ class FlowOutputEvent < Struct.new(
865
+ :content,
866
+ :node_name,
867
+ :node_type,
868
+ :event_type)
869
+ SENSITIVE = []
870
+ include Aws::Structure
871
+ end
872
+
563
873
  # Contains information about the function that the agent predicts should
564
874
  # be called.
565
875
  #
@@ -750,6 +1060,68 @@ module Aws::BedrockAgentRuntime
750
1060
  include Aws::Structure
751
1061
  end
752
1062
 
1063
+ # @!attribute [rw] agent_alias_id
1064
+ # The unique identifier of an alias of an agent.
1065
+ # @return [String]
1066
+ #
1067
+ # @!attribute [rw] agent_id
1068
+ # The unique identifier of the agent to which the alias belongs.
1069
+ # @return [String]
1070
+ #
1071
+ # @!attribute [rw] max_items
1072
+ # The maximum number of items to return in the response. If the total
1073
+ # number of results is greater than this value, use the token returned
1074
+ # in the response in the `nextToken` field when making another request
1075
+ # to return the next batch of results.
1076
+ # @return [Integer]
1077
+ #
1078
+ # @!attribute [rw] memory_id
1079
+ # The unique identifier of the memory.
1080
+ # @return [String]
1081
+ #
1082
+ # @!attribute [rw] memory_type
1083
+ # The type of memory.
1084
+ # @return [String]
1085
+ #
1086
+ # @!attribute [rw] next_token
1087
+ # If the total number of results is greater than the maxItems value
1088
+ # provided in the request, enter the token returned in the `nextToken`
1089
+ # field in the response in this field to return the next batch of
1090
+ # results.
1091
+ # @return [String]
1092
+ #
1093
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/GetAgentMemoryRequest AWS API Documentation
1094
+ #
1095
+ class GetAgentMemoryRequest < Struct.new(
1096
+ :agent_alias_id,
1097
+ :agent_id,
1098
+ :max_items,
1099
+ :memory_id,
1100
+ :memory_type,
1101
+ :next_token)
1102
+ SENSITIVE = []
1103
+ include Aws::Structure
1104
+ end
1105
+
1106
+ # @!attribute [rw] memory_contents
1107
+ # Contains details of the sessions stored in the memory
1108
+ # @return [Array<Types::Memory>]
1109
+ #
1110
+ # @!attribute [rw] next_token
1111
+ # If the total number of results is greater than the maxItems value
1112
+ # provided in the request, use this token when making another request
1113
+ # in the `nextToken` field to return the next batch of results.
1114
+ # @return [String]
1115
+ #
1116
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/GetAgentMemoryResponse AWS API Documentation
1117
+ #
1118
+ class GetAgentMemoryResponse < Struct.new(
1119
+ :memory_contents,
1120
+ :next_token)
1121
+ SENSITIVE = []
1122
+ include Aws::Structure
1123
+ end
1124
+
753
1125
  # Assessment details of the content analyzed by Guardrails.
754
1126
  #
755
1127
  # @!attribute [rw] content_policy
@@ -1116,6 +1488,30 @@ module Aws::BedrockAgentRuntime
1116
1488
  include Aws::Structure
1117
1489
  end
1118
1490
 
1491
+ # Contains details of the source files.
1492
+ #
1493
+ # @!attribute [rw] name
1494
+ # The name of the source file.
1495
+ # @return [String]
1496
+ #
1497
+ # @!attribute [rw] source
1498
+ # Specifies where the files are located.
1499
+ # @return [Types::FileSource]
1500
+ #
1501
+ # @!attribute [rw] use_case
1502
+ # Specifies how the source files will be used by the code interpreter.
1503
+ # @return [String]
1504
+ #
1505
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/InputFile AWS API Documentation
1506
+ #
1507
+ class InputFile < Struct.new(
1508
+ :name,
1509
+ :source,
1510
+ :use_case)
1511
+ SENSITIVE = []
1512
+ include Aws::Structure
1513
+ end
1514
+
1119
1515
  # An internal server error occurred. Retry your request.
1120
1516
  #
1121
1517
  # @!attribute [rw] message
@@ -1137,6 +1533,10 @@ module Aws::BedrockAgentRuntime
1137
1533
  # Contains information about the action group to be invoked.
1138
1534
  # @return [Types::ActionGroupInvocationInput]
1139
1535
  #
1536
+ # @!attribute [rw] code_interpreter_invocation_input
1537
+ # Contains information about the code interpreter to be invoked.
1538
+ # @return [Types::CodeInterpreterInvocationInput]
1539
+ #
1140
1540
  # @!attribute [rw] invocation_type
1141
1541
  # Specifies whether the agent is invoking an action group or a
1142
1542
  # knowledge base.
@@ -1155,6 +1555,7 @@ module Aws::BedrockAgentRuntime
1155
1555
  #
1156
1556
  class InvocationInput < Struct.new(
1157
1557
  :action_group_invocation_input,
1558
+ :code_interpreter_invocation_input,
1158
1559
  :invocation_type,
1159
1560
  :knowledge_base_lookup_input,
1160
1561
  :trace_id)
@@ -1273,6 +1674,10 @@ module Aws::BedrockAgentRuntime
1273
1674
  # </note>
1274
1675
  # @return [String]
1275
1676
  #
1677
+ # @!attribute [rw] memory_id
1678
+ # The unique identifier of the agent memory.
1679
+ # @return [String]
1680
+ #
1276
1681
  # @!attribute [rw] session_id
1277
1682
  # The unique identifier of the session. Use the same value across
1278
1683
  # requests to continue the same conversation.
@@ -1300,6 +1705,7 @@ module Aws::BedrockAgentRuntime
1300
1705
  :enable_trace,
1301
1706
  :end_session,
1302
1707
  :input_text,
1708
+ :memory_id,
1303
1709
  :session_id,
1304
1710
  :session_state)
1305
1711
  SENSITIVE = [:input_text]
@@ -1315,6 +1721,10 @@ module Aws::BedrockAgentRuntime
1315
1721
  # `application/json`.
1316
1722
  # @return [String]
1317
1723
  #
1724
+ # @!attribute [rw] memory_id
1725
+ # The unique identifier of the agent memory.
1726
+ # @return [String]
1727
+ #
1318
1728
  # @!attribute [rw] session_id
1319
1729
  # The unique identifier of the session with the agent.
1320
1730
  # @return [String]
@@ -1324,11 +1734,78 @@ module Aws::BedrockAgentRuntime
1324
1734
  class InvokeAgentResponse < Struct.new(
1325
1735
  :completion,
1326
1736
  :content_type,
1737
+ :memory_id,
1327
1738
  :session_id)
1328
1739
  SENSITIVE = []
1329
1740
  include Aws::Structure
1330
1741
  end
1331
1742
 
1743
+ # @!attribute [rw] flow_alias_identifier
1744
+ # The unique identifier of the flow alias.
1745
+ # @return [String]
1746
+ #
1747
+ # @!attribute [rw] flow_identifier
1748
+ # The unique identifier of the flow.
1749
+ # @return [String]
1750
+ #
1751
+ # @!attribute [rw] inputs
1752
+ # A list of objects, each containing information about an input into
1753
+ # the flow.
1754
+ # @return [Array<Types::FlowInput>]
1755
+ #
1756
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/InvokeFlowRequest AWS API Documentation
1757
+ #
1758
+ class InvokeFlowRequest < Struct.new(
1759
+ :flow_alias_identifier,
1760
+ :flow_identifier,
1761
+ :inputs)
1762
+ SENSITIVE = []
1763
+ include Aws::Structure
1764
+ end
1765
+
1766
+ # @!attribute [rw] response_stream
1767
+ # The output of the flow, returned as a stream. If there's an error,
1768
+ # the error is returned.
1769
+ # @return [Types::FlowResponseStream]
1770
+ #
1771
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/InvokeFlowResponse AWS API Documentation
1772
+ #
1773
+ class InvokeFlowResponse < Struct.new(
1774
+ :response_stream)
1775
+ SENSITIVE = []
1776
+ include Aws::Structure
1777
+ end
1778
+
1779
+ # Configurations to apply to a knowledge base attached to the agent
1780
+ # during query. For more information, see [Knowledge base retrieval
1781
+ # configurations][1].
1782
+ #
1783
+ #
1784
+ #
1785
+ # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/agents-session-state.html#session-state-kb
1786
+ #
1787
+ # @!attribute [rw] knowledge_base_id
1788
+ # The unique identifier for a knowledge base attached to the agent.
1789
+ # @return [String]
1790
+ #
1791
+ # @!attribute [rw] retrieval_configuration
1792
+ # The configurations to apply to the knowledge base during query. For
1793
+ # more information, see [Query configurations][1].
1794
+ #
1795
+ #
1796
+ #
1797
+ # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/kb-test-config.html
1798
+ # @return [Types::KnowledgeBaseRetrievalConfiguration]
1799
+ #
1800
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/KnowledgeBaseConfiguration AWS API Documentation
1801
+ #
1802
+ class KnowledgeBaseConfiguration < Struct.new(
1803
+ :knowledge_base_id,
1804
+ :retrieval_configuration)
1805
+ SENSITIVE = []
1806
+ include Aws::Structure
1807
+ end
1808
+
1332
1809
  # Contains details about the knowledge base to look up and the query to
1333
1810
  # be made.
1334
1811
  #
@@ -1388,8 +1865,8 @@ module Aws::BedrockAgentRuntime
1388
1865
  include Aws::Structure
1389
1866
  end
1390
1867
 
1391
- # Contains configurations for the knowledge base query and retrieval
1392
- # process. For more information, see [Query configurations][1].
1868
+ # Contains configurations for knowledge base query. For more
1869
+ # information, see [Query configurations][1].
1393
1870
  #
1394
1871
  # This data type is used in the following API operations:
1395
1872
  #
@@ -1481,7 +1958,7 @@ module Aws::BedrockAgentRuntime
1481
1958
  #
1482
1959
  # @!attribute [rw] generation_configuration
1483
1960
  # Contains configurations for response generation based on the
1484
- # knowwledge base query results.
1961
+ # knowledge base query results.
1485
1962
  # @return [Types::GenerationConfiguration]
1486
1963
  #
1487
1964
  # @!attribute [rw] knowledge_base_id
@@ -1493,6 +1970,11 @@ module Aws::BedrockAgentRuntime
1493
1970
  # The ARN of the foundation model used to generate a response.
1494
1971
  # @return [String]
1495
1972
  #
1973
+ # @!attribute [rw] orchestration_configuration
1974
+ # Settings for how the model processes the prompt prior to retrieval
1975
+ # and generation.
1976
+ # @return [Types::OrchestrationConfiguration]
1977
+ #
1496
1978
  # @!attribute [rw] retrieval_configuration
1497
1979
  # Contains configurations for how to retrieve and return the knowledge
1498
1980
  # base query.
@@ -1504,6 +1986,7 @@ module Aws::BedrockAgentRuntime
1504
1986
  :generation_configuration,
1505
1987
  :knowledge_base_id,
1506
1988
  :model_arn,
1989
+ :orchestration_configuration,
1507
1990
  :retrieval_configuration)
1508
1991
  SENSITIVE = []
1509
1992
  include Aws::Structure
@@ -1564,6 +2047,62 @@ module Aws::BedrockAgentRuntime
1564
2047
  include Aws::Structure
1565
2048
  end
1566
2049
 
2050
+ # Contains sessions summaries.
2051
+ #
2052
+ # @note Memory is a union - when returned from an API call exactly one value will be set and the returned type will be a subclass of Memory corresponding to the set member.
2053
+ #
2054
+ # @!attribute [rw] session_summary
2055
+ # Contains summary of a session.
2056
+ # @return [Types::MemorySessionSummary]
2057
+ #
2058
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/Memory AWS API Documentation
2059
+ #
2060
+ class Memory < Struct.new(
2061
+ :session_summary,
2062
+ :unknown)
2063
+ SENSITIVE = []
2064
+ include Aws::Structure
2065
+ include Aws::Structure::Union
2066
+
2067
+ class SessionSummary < Memory; end
2068
+ class Unknown < Memory; end
2069
+ end
2070
+
2071
+ # Contains details of a session summary.
2072
+ #
2073
+ # @!attribute [rw] memory_id
2074
+ # The unique identifier of the memory where the session summary is
2075
+ # stored.
2076
+ # @return [String]
2077
+ #
2078
+ # @!attribute [rw] session_expiry_time
2079
+ # The time when the memory duration for the session is set to end.
2080
+ # @return [Time]
2081
+ #
2082
+ # @!attribute [rw] session_id
2083
+ # The identifier for this session.
2084
+ # @return [String]
2085
+ #
2086
+ # @!attribute [rw] session_start_time
2087
+ # The start time for this session.
2088
+ # @return [Time]
2089
+ #
2090
+ # @!attribute [rw] summary_text
2091
+ # The summarized text for this session.
2092
+ # @return [String]
2093
+ #
2094
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/MemorySessionSummary AWS API Documentation
2095
+ #
2096
+ class MemorySessionSummary < Struct.new(
2097
+ :memory_id,
2098
+ :session_expiry_time,
2099
+ :session_id,
2100
+ :session_start_time,
2101
+ :summary_text)
2102
+ SENSITIVE = []
2103
+ include Aws::Structure
2104
+ end
2105
+
1567
2106
  # The input for the pre-processing step.
1568
2107
  #
1569
2108
  # * The `type` matches the agent step.
@@ -1647,6 +2186,11 @@ module Aws::BedrockAgentRuntime
1647
2186
  # the action group.
1648
2187
  # @return [Types::ActionGroupInvocationOutput]
1649
2188
  #
2189
+ # @!attribute [rw] code_interpreter_invocation_output
2190
+ # Contains the JSON-formatted string returned by the API invoked by
2191
+ # the code interpreter.
2192
+ # @return [Types::CodeInterpreterInvocationOutput]
2193
+ #
1650
2194
  # @!attribute [rw] final_response
1651
2195
  # Contains details about the response to the user.
1652
2196
  # @return [Types::FinalResponse]
@@ -1686,6 +2230,7 @@ module Aws::BedrockAgentRuntime
1686
2230
  #
1687
2231
  class Observation < Struct.new(
1688
2232
  :action_group_invocation_output,
2233
+ :code_interpreter_invocation_output,
1689
2234
  :final_response,
1690
2235
  :knowledge_base_lookup_output,
1691
2236
  :reprompt_response,
@@ -1695,6 +2240,22 @@ module Aws::BedrockAgentRuntime
1695
2240
  include Aws::Structure
1696
2241
  end
1697
2242
 
2243
+ # Settings for how the model processes the prompt prior to retrieval and
2244
+ # generation.
2245
+ #
2246
+ # @!attribute [rw] query_transformation_configuration
2247
+ # To split up the prompt and retrieve multiple sources, set the
2248
+ # transformation type to `QUERY_DECOMPOSITION`.
2249
+ # @return [Types::QueryTransformationConfiguration]
2250
+ #
2251
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/OrchestrationConfiguration AWS API Documentation
2252
+ #
2253
+ class OrchestrationConfiguration < Struct.new(
2254
+ :query_transformation_configuration)
2255
+ SENSITIVE = []
2256
+ include Aws::Structure
2257
+ end
2258
+
1698
2259
  # Details about the orchestration step, in which the agent determines
1699
2260
  # the order in which actions are executed and which knowledge bases are
1700
2261
  # retrieved.
@@ -1752,6 +2313,31 @@ module Aws::BedrockAgentRuntime
1752
2313
  class Unknown < OrchestrationTrace; end
1753
2314
  end
1754
2315
 
2316
+ # Contains details of the response from code interpreter.
2317
+ #
2318
+ # @!attribute [rw] bytes
2319
+ # The byte count of files that contains response from code
2320
+ # interpreter.
2321
+ # @return [String]
2322
+ #
2323
+ # @!attribute [rw] name
2324
+ # The name of the file containing response from code interpreter.
2325
+ # @return [String]
2326
+ #
2327
+ # @!attribute [rw] type
2328
+ # The type of file that contains response from the code interpreter.
2329
+ # @return [String]
2330
+ #
2331
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/OutputFile AWS API Documentation
2332
+ #
2333
+ class OutputFile < Struct.new(
2334
+ :bytes,
2335
+ :name,
2336
+ :type)
2337
+ SENSITIVE = [:bytes]
2338
+ include Aws::Structure
2339
+ end
2340
+
1755
2341
  # A parameter for the API request or function.
1756
2342
  #
1757
2343
  # @!attribute [rw] name
@@ -2010,6 +2596,21 @@ module Aws::BedrockAgentRuntime
2010
2596
  include Aws::Structure
2011
2597
  end
2012
2598
 
2599
+ # To split up the prompt and retrieve multiple sources, set the
2600
+ # transformation type to `QUERY_DECOMPOSITION`.
2601
+ #
2602
+ # @!attribute [rw] type
2603
+ # The type of transformation to apply to the prompt.
2604
+ # @return [String]
2605
+ #
2606
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/QueryTransformationConfiguration AWS API Documentation
2607
+ #
2608
+ class QueryTransformationConfiguration < Struct.new(
2609
+ :type)
2610
+ SENSITIVE = []
2611
+ include Aws::Structure
2612
+ end
2613
+
2013
2614
  # Contains the reasoning, based on the input, that the agent uses to
2014
2615
  # justify carrying out an action group or getting information from a
2015
2616
  # knowledge base.
@@ -2277,6 +2878,20 @@ module Aws::BedrockAgentRuntime
2277
2878
  class Unknown < RetrievalFilter; end
2278
2879
  end
2279
2880
 
2881
+ # The Confluence data source location.
2882
+ #
2883
+ # @!attribute [rw] url
2884
+ # The Confluence host URL for the data source location.
2885
+ # @return [String]
2886
+ #
2887
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/RetrievalResultConfluenceLocation AWS API Documentation
2888
+ #
2889
+ class RetrievalResultConfluenceLocation < Struct.new(
2890
+ :url)
2891
+ SENSITIVE = []
2892
+ include Aws::Structure
2893
+ end
2894
+
2280
2895
  # Contains the cited text from the data source.
2281
2896
  #
2282
2897
  # This data type is used in the following API operations:
@@ -2305,7 +2920,7 @@ module Aws::BedrockAgentRuntime
2305
2920
  include Aws::Structure
2306
2921
  end
2307
2922
 
2308
- # Contains information about the location of the data source.
2923
+ # Contains information about the data source location.
2309
2924
  #
2310
2925
  # This data type is used in the following API operations:
2311
2926
  #
@@ -2321,24 +2936,44 @@ module Aws::BedrockAgentRuntime
2321
2936
  # [2]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html#API_agent-runtime_RetrieveAndGenerate_ResponseSyntax
2322
2937
  # [3]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html#API_agent-runtime_InvokeAgent_ResponseSyntax
2323
2938
  #
2939
+ # @!attribute [rw] confluence_location
2940
+ # The Confluence data source location.
2941
+ # @return [Types::RetrievalResultConfluenceLocation]
2942
+ #
2324
2943
  # @!attribute [rw] s3_location
2325
- # Contains the S3 location of the data source.
2944
+ # The S3 data source location.
2326
2945
  # @return [Types::RetrievalResultS3Location]
2327
2946
  #
2947
+ # @!attribute [rw] salesforce_location
2948
+ # The Salesforce data source location.
2949
+ # @return [Types::RetrievalResultSalesforceLocation]
2950
+ #
2951
+ # @!attribute [rw] share_point_location
2952
+ # The SharePoint data source location.
2953
+ # @return [Types::RetrievalResultSharePointLocation]
2954
+ #
2328
2955
  # @!attribute [rw] type
2329
- # The type of the location of the data source.
2956
+ # The type of data source location.
2330
2957
  # @return [String]
2331
2958
  #
2959
+ # @!attribute [rw] web_location
2960
+ # The web URL/URLs data source location.
2961
+ # @return [Types::RetrievalResultWebLocation]
2962
+ #
2332
2963
  # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/RetrievalResultLocation AWS API Documentation
2333
2964
  #
2334
2965
  class RetrievalResultLocation < Struct.new(
2966
+ :confluence_location,
2335
2967
  :s3_location,
2336
- :type)
2968
+ :salesforce_location,
2969
+ :share_point_location,
2970
+ :type,
2971
+ :web_location)
2337
2972
  SENSITIVE = []
2338
2973
  include Aws::Structure
2339
2974
  end
2340
2975
 
2341
- # Contains the S3 location of the data source.
2976
+ # The S3 data source location.
2342
2977
  #
2343
2978
  # This data type is used in the following API operations:
2344
2979
  #
@@ -2355,7 +2990,7 @@ module Aws::BedrockAgentRuntime
2355
2990
  # [3]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html#API_agent-runtime_InvokeAgent_ResponseSyntax
2356
2991
  #
2357
2992
  # @!attribute [rw] uri
2358
- # The S3 URI of the data source.
2993
+ # The S3 URI for the data source location.
2359
2994
  # @return [String]
2360
2995
  #
2361
2996
  # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/RetrievalResultS3Location AWS API Documentation
@@ -2366,6 +3001,48 @@ module Aws::BedrockAgentRuntime
2366
3001
  include Aws::Structure
2367
3002
  end
2368
3003
 
3004
+ # The Salesforce data source location.
3005
+ #
3006
+ # @!attribute [rw] url
3007
+ # The Salesforce host URL for the data source location.
3008
+ # @return [String]
3009
+ #
3010
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/RetrievalResultSalesforceLocation AWS API Documentation
3011
+ #
3012
+ class RetrievalResultSalesforceLocation < Struct.new(
3013
+ :url)
3014
+ SENSITIVE = []
3015
+ include Aws::Structure
3016
+ end
3017
+
3018
+ # The SharePoint data source location.
3019
+ #
3020
+ # @!attribute [rw] url
3021
+ # The SharePoint site URL for the data source location.
3022
+ # @return [String]
3023
+ #
3024
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/RetrievalResultSharePointLocation AWS API Documentation
3025
+ #
3026
+ class RetrievalResultSharePointLocation < Struct.new(
3027
+ :url)
3028
+ SENSITIVE = []
3029
+ include Aws::Structure
3030
+ end
3031
+
3032
+ # The web URL/URLs data source location.
3033
+ #
3034
+ # @!attribute [rw] url
3035
+ # The web URL/URLs for the data source location.
3036
+ # @return [String]
3037
+ #
3038
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/RetrievalResultWebLocation AWS API Documentation
3039
+ #
3040
+ class RetrievalResultWebLocation < Struct.new(
3041
+ :url)
3042
+ SENSITIVE = []
3043
+ include Aws::Structure
3044
+ end
3045
+
2369
3046
  # Contains details about the resource being queried.
2370
3047
  #
2371
3048
  # This data type is used in the following API operations:
@@ -2468,8 +3145,12 @@ module Aws::BedrockAgentRuntime
2468
3145
  # @return [Types::RetrieveAndGenerateSessionConfiguration]
2469
3146
  #
2470
3147
  # @!attribute [rw] session_id
2471
- # The unique identifier of the session. Reuse the same value to
2472
- # continue the same session with the knowledge base.
3148
+ # The unique identifier of the session. When you first make a
3149
+ # `RetrieveAndGenerate` request, Amazon Bedrock automatically
3150
+ # generates this value. You must reuse this value for all subsequent
3151
+ # requests in the same conversational session. This value allows
3152
+ # Amazon Bedrock to maintain context and knowledge from previous
3153
+ # interactions. You can't explicitly set the `sessionId` yourself.
2473
3154
  # @return [String]
2474
3155
  #
2475
3156
  # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/RetrieveAndGenerateRequest AWS API Documentation
@@ -2498,8 +3179,12 @@ module Aws::BedrockAgentRuntime
2498
3179
  # @return [Types::RetrieveAndGenerateOutput]
2499
3180
  #
2500
3181
  # @!attribute [rw] session_id
2501
- # The unique identifier of the session. Reuse the same value to
2502
- # continue the same session with the knowledge base.
3182
+ # The unique identifier of the session. When you first make a
3183
+ # `RetrieveAndGenerate` request, Amazon Bedrock automatically
3184
+ # generates this value. You must reuse this value for all subsequent
3185
+ # requests in the same conversational session. This value allows
3186
+ # Amazon Bedrock to maintain context and knowledge from previous
3187
+ # interactions. You can't explicitly set the `sessionId` yourself.
2503
3188
  # @return [String]
2504
3189
  #
2505
3190
  # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/RetrieveAndGenerateResponse AWS API Documentation
@@ -2679,6 +3364,20 @@ module Aws::BedrockAgentRuntime
2679
3364
  include Aws::Structure
2680
3365
  end
2681
3366
 
3367
+ # Contains details of the s3 object where the source file is located.
3368
+ #
3369
+ # @!attribute [rw] uri
3370
+ # The uri of the s3 object.
3371
+ # @return [String]
3372
+ #
3373
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/S3ObjectFile AWS API Documentation
3374
+ #
3375
+ class S3ObjectFile < Struct.new(
3376
+ :uri)
3377
+ SENSITIVE = []
3378
+ include Aws::Structure
3379
+ end
3380
+
2682
3381
  # The number of requests exceeds the service quota. Resubmit your
2683
3382
  # request later.
2684
3383
  #
@@ -2708,6 +3407,10 @@ module Aws::BedrockAgentRuntime
2708
3407
  # [2]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html
2709
3408
  # [3]: https://docs.aws.amazon.com/bedrock/latest/userguide/agents-session-state.html
2710
3409
  #
3410
+ # @!attribute [rw] files
3411
+ # Contains information about the files used by code interpreter.
3412
+ # @return [Array<Types::InputFile>]
3413
+ #
2711
3414
  # @!attribute [rw] invocation_id
2712
3415
  # The identifier of the invocation of an action. This value must match
2713
3416
  # the `invocationId` returned in the `InvokeAgent` response for the
@@ -2722,6 +3425,11 @@ module Aws::BedrockAgentRuntime
2722
3425
  # [2]: https://docs.aws.amazon.com/bedrock/latest/userguide/agents-session-state.html
2723
3426
  # @return [String]
2724
3427
  #
3428
+ # @!attribute [rw] knowledge_base_configurations
3429
+ # An array of configurations, each of which applies to a knowledge
3430
+ # base attached to the agent.
3431
+ # @return [Array<Types::KnowledgeBaseConfiguration>]
3432
+ #
2725
3433
  # @!attribute [rw] prompt_session_attributes
2726
3434
  # Contains attributes that persist across a prompt and the values of
2727
3435
  # those attributes. These attributes replace the
@@ -2757,7 +3465,9 @@ module Aws::BedrockAgentRuntime
2757
3465
  # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/SessionState AWS API Documentation
2758
3466
  #
2759
3467
  class SessionState < Struct.new(
3468
+ :files,
2760
3469
  :invocation_id,
3470
+ :knowledge_base_configurations,
2761
3471
  :prompt_session_attributes,
2762
3472
  :return_control_invocation_results,
2763
3473
  :session_attributes)
@@ -3020,6 +3730,43 @@ module Aws::BedrockAgentRuntime
3020
3730
  include Aws::Structure
3021
3731
  end
3022
3732
 
3733
+ # The output of the flow.
3734
+ #
3735
+ # This data type is used in the following API operations:
3736
+ #
3737
+ # * [InvokeFlow response][1]
3738
+ #
3739
+ # ^
3740
+ #
3741
+ #
3742
+ #
3743
+ # [1]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeFlow.html#API_agent_InvokeFlow_ResponseSyntax
3744
+ #
3745
+ # EventStream is an Enumerator of Events.
3746
+ # #event_types #=> Array, returns all modeled event types in the stream
3747
+ #
3748
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/FlowResponseStream AWS API Documentation
3749
+ #
3750
+ class FlowResponseStream < Enumerator
3751
+
3752
+ def event_types
3753
+ [
3754
+ :access_denied_exception,
3755
+ :bad_gateway_exception,
3756
+ :conflict_exception,
3757
+ :dependency_failed_exception,
3758
+ :flow_completion_event,
3759
+ :flow_output_event,
3760
+ :internal_server_exception,
3761
+ :resource_not_found_exception,
3762
+ :service_quota_exceeded_exception,
3763
+ :throttling_exception,
3764
+ :validation_exception
3765
+ ]
3766
+ end
3767
+
3768
+ end
3769
+
3023
3770
  # The response from invoking the agent and associated citations and
3024
3771
  # trace information.
3025
3772
  #
@@ -3037,6 +3784,7 @@ module Aws::BedrockAgentRuntime
3037
3784
  :chunk,
3038
3785
  :conflict_exception,
3039
3786
  :dependency_failed_exception,
3787
+ :files,
3040
3788
  :internal_server_exception,
3041
3789
  :resource_not_found_exception,
3042
3790
  :return_control,