aws-sdk-bedrockagentruntime 1.15.0 → 1.16.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -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,