aws-sdk-bedrockagentcore 1.5.0 → 1.7.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.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: e5e7dbeddeaf8af0361d11eacb320c2d3c2ca0f7a48c3701ce8d01d00cfedb99
4
- data.tar.gz: 1400b3ea9c6d89c6918ba6cd100a6c91990742a71a23f85afc7f6e44558fbcbf
3
+ metadata.gz: 83c5ec56ae941fc1cd2bfed4a901b2e66b9aac7ab73f4997d179874635f339ba
4
+ data.tar.gz: 5af4ae4d3c69cf6d96f14dd45186f5dfa08ebb6e847c00129fcf8d4cd1789271
5
5
  SHA512:
6
- metadata.gz: 0f8f65064f8e51b1dc24d5bed8831fb771f31bd7ba97ee85ce28d8adfd6066d2fbd534b289a81df96c6ddca82778e8957af1fc2043ad8390bae06a6be85ae5f9
7
- data.tar.gz: 50f4f752f74ae6b694aed1b102f4d3c8c60876eaa92e15d9da7b806f383520bd6c07ec3dfd3347d75246c5efcb5a6e8922ec41766a740ac70da022cb59436a5b
6
+ metadata.gz: 14ae88b3431febcf7802a8502c700af4319ac53f6f81f88293a5d38d58c036fb8d1969227c22a7b71605b66421aa74d3db947fb1258a074707898f3c4d4410d1
7
+ data.tar.gz: ef5e8434872c1ad9fefb7007e45b4736d43a7793aa04e0d3ec263ffb5180c1cf008929659b16b4a03fcab599f29a049800372fe6d95c7254c4947540bac9259a
data/CHANGELOG.md CHANGED
@@ -1,6 +1,16 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.7.0 (2025-10-10)
5
+ ------------------
6
+
7
+ * Feature - Bedrock AgentCore release for Runtime, and Memory.
8
+
9
+ 1.6.0 (2025-10-06)
10
+ ------------------
11
+
12
+ * Feature - Add support for batch memory management, agent card retrieval and session termination
13
+
4
14
  1.5.0 (2025-08-27)
5
15
  ------------------
6
16
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.5.0
1
+ 1.7.0
@@ -487,6 +487,176 @@ module Aws::BedrockAgentCore
487
487
 
488
488
  # @!group API Operations
489
489
 
490
+ # Creates multiple memory records in a single batch operation for the
491
+ # specified memory with custom content.
492
+ #
493
+ # @option params [required, String] :memory_id
494
+ # The unique ID of the memory resource where records will be created.
495
+ #
496
+ # @option params [required, Array<Types::MemoryRecordCreateInput>] :records
497
+ # A list of memory record creation inputs to be processed in the batch
498
+ # operation.
499
+ #
500
+ # @option params [String] :client_token
501
+ # A unique, case-sensitive identifier to ensure idempotent processing of
502
+ # the batch request.
503
+ #
504
+ # **A suitable default value is auto-generated.** You should normally
505
+ # not need to pass this option.**
506
+ #
507
+ # @return [Types::BatchCreateMemoryRecordsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
508
+ #
509
+ # * {Types::BatchCreateMemoryRecordsOutput#successful_records #successful_records} => Array&lt;Types::MemoryRecordOutput&gt;
510
+ # * {Types::BatchCreateMemoryRecordsOutput#failed_records #failed_records} => Array&lt;Types::MemoryRecordOutput&gt;
511
+ #
512
+ # @example Request syntax with placeholder values
513
+ #
514
+ # resp = client.batch_create_memory_records({
515
+ # memory_id: "MemoryId", # required
516
+ # records: [ # required
517
+ # {
518
+ # request_identifier: "RequestIdentifier", # required
519
+ # namespaces: ["Namespace"], # required
520
+ # content: { # required
521
+ # text: "MemoryContentTextString",
522
+ # },
523
+ # timestamp: Time.now, # required
524
+ # memory_strategy_id: "MemoryStrategyId",
525
+ # },
526
+ # ],
527
+ # client_token: "String",
528
+ # })
529
+ #
530
+ # @example Response structure
531
+ #
532
+ # resp.successful_records #=> Array
533
+ # resp.successful_records[0].memory_record_id #=> String
534
+ # resp.successful_records[0].status #=> String, one of "SUCCEEDED", "FAILED"
535
+ # resp.successful_records[0].request_identifier #=> String
536
+ # resp.successful_records[0].error_code #=> Integer
537
+ # resp.successful_records[0].error_message #=> String
538
+ # resp.failed_records #=> Array
539
+ # resp.failed_records[0].memory_record_id #=> String
540
+ # resp.failed_records[0].status #=> String, one of "SUCCEEDED", "FAILED"
541
+ # resp.failed_records[0].request_identifier #=> String
542
+ # resp.failed_records[0].error_code #=> Integer
543
+ # resp.failed_records[0].error_message #=> String
544
+ #
545
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/BatchCreateMemoryRecords AWS API Documentation
546
+ #
547
+ # @overload batch_create_memory_records(params = {})
548
+ # @param [Hash] params ({})
549
+ def batch_create_memory_records(params = {}, options = {})
550
+ req = build_request(:batch_create_memory_records, params)
551
+ req.send_request(options)
552
+ end
553
+
554
+ # Deletes multiple memory records in a single batch operation from the
555
+ # specified memory.
556
+ #
557
+ # @option params [required, String] :memory_id
558
+ # The unique ID of the memory resource where records will be deleted.
559
+ #
560
+ # @option params [required, Array<Types::MemoryRecordDeleteInput>] :records
561
+ # A list of memory record deletion inputs to be processed in the batch
562
+ # operation.
563
+ #
564
+ # @return [Types::BatchDeleteMemoryRecordsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
565
+ #
566
+ # * {Types::BatchDeleteMemoryRecordsOutput#successful_records #successful_records} => Array&lt;Types::MemoryRecordOutput&gt;
567
+ # * {Types::BatchDeleteMemoryRecordsOutput#failed_records #failed_records} => Array&lt;Types::MemoryRecordOutput&gt;
568
+ #
569
+ # @example Request syntax with placeholder values
570
+ #
571
+ # resp = client.batch_delete_memory_records({
572
+ # memory_id: "MemoryId", # required
573
+ # records: [ # required
574
+ # {
575
+ # memory_record_id: "MemoryRecordId", # required
576
+ # },
577
+ # ],
578
+ # })
579
+ #
580
+ # @example Response structure
581
+ #
582
+ # resp.successful_records #=> Array
583
+ # resp.successful_records[0].memory_record_id #=> String
584
+ # resp.successful_records[0].status #=> String, one of "SUCCEEDED", "FAILED"
585
+ # resp.successful_records[0].request_identifier #=> String
586
+ # resp.successful_records[0].error_code #=> Integer
587
+ # resp.successful_records[0].error_message #=> String
588
+ # resp.failed_records #=> Array
589
+ # resp.failed_records[0].memory_record_id #=> String
590
+ # resp.failed_records[0].status #=> String, one of "SUCCEEDED", "FAILED"
591
+ # resp.failed_records[0].request_identifier #=> String
592
+ # resp.failed_records[0].error_code #=> Integer
593
+ # resp.failed_records[0].error_message #=> String
594
+ #
595
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/BatchDeleteMemoryRecords AWS API Documentation
596
+ #
597
+ # @overload batch_delete_memory_records(params = {})
598
+ # @param [Hash] params ({})
599
+ def batch_delete_memory_records(params = {}, options = {})
600
+ req = build_request(:batch_delete_memory_records, params)
601
+ req.send_request(options)
602
+ end
603
+
604
+ # Updates multiple memory records with custom content in a single batch
605
+ # operation within the specified memory.
606
+ #
607
+ # @option params [required, String] :memory_id
608
+ # The unique ID of the memory resource where records will be updated.
609
+ #
610
+ # @option params [required, Array<Types::MemoryRecordUpdateInput>] :records
611
+ # A list of memory record update inputs to be processed in the batch
612
+ # operation.
613
+ #
614
+ # @return [Types::BatchUpdateMemoryRecordsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
615
+ #
616
+ # * {Types::BatchUpdateMemoryRecordsOutput#successful_records #successful_records} => Array&lt;Types::MemoryRecordOutput&gt;
617
+ # * {Types::BatchUpdateMemoryRecordsOutput#failed_records #failed_records} => Array&lt;Types::MemoryRecordOutput&gt;
618
+ #
619
+ # @example Request syntax with placeholder values
620
+ #
621
+ # resp = client.batch_update_memory_records({
622
+ # memory_id: "MemoryId", # required
623
+ # records: [ # required
624
+ # {
625
+ # memory_record_id: "MemoryRecordId", # required
626
+ # timestamp: Time.now, # required
627
+ # content: {
628
+ # text: "MemoryContentTextString",
629
+ # },
630
+ # namespaces: ["Namespace"],
631
+ # memory_strategy_id: "MemoryStrategyId",
632
+ # },
633
+ # ],
634
+ # })
635
+ #
636
+ # @example Response structure
637
+ #
638
+ # resp.successful_records #=> Array
639
+ # resp.successful_records[0].memory_record_id #=> String
640
+ # resp.successful_records[0].status #=> String, one of "SUCCEEDED", "FAILED"
641
+ # resp.successful_records[0].request_identifier #=> String
642
+ # resp.successful_records[0].error_code #=> Integer
643
+ # resp.successful_records[0].error_message #=> String
644
+ # resp.failed_records #=> Array
645
+ # resp.failed_records[0].memory_record_id #=> String
646
+ # resp.failed_records[0].status #=> String, one of "SUCCEEDED", "FAILED"
647
+ # resp.failed_records[0].request_identifier #=> String
648
+ # resp.failed_records[0].error_code #=> Integer
649
+ # resp.failed_records[0].error_message #=> String
650
+ #
651
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/BatchUpdateMemoryRecords AWS API Documentation
652
+ #
653
+ # @overload batch_update_memory_records(params = {})
654
+ # @param [Hash] params ({})
655
+ def batch_update_memory_records(params = {}, options = {})
656
+ req = build_request(:batch_update_memory_records, params)
657
+ req.send_request(options)
658
+ end
659
+
490
660
  # Creates an event in an AgentCore Memory resource. Events represent
491
661
  # interactions or activities that occur within a session and are
492
662
  # associated with specific actors.
@@ -529,6 +699,9 @@ module Aws::BedrockAgentCore
529
699
  # **A suitable default value is auto-generated.** You should normally
530
700
  # not need to pass this option.**
531
701
  #
702
+ # @option params [Hash<String,Types::MetadataValue>] :metadata
703
+ # The key-value metadata to attach to the event.
704
+ #
532
705
  # @return [Types::CreateEventOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
533
706
  #
534
707
  # * {Types::CreateEventOutput#event #event} => Types::Event
@@ -557,6 +730,11 @@ module Aws::BedrockAgentCore
557
730
  # name: "BranchName", # required
558
731
  # },
559
732
  # client_token: "String",
733
+ # metadata: {
734
+ # "MetadataKey" => {
735
+ # string_value: "MetadataValueStringValueString",
736
+ # },
737
+ # },
560
738
  # })
561
739
  #
562
740
  # @example Response structure
@@ -571,6 +749,8 @@ module Aws::BedrockAgentCore
571
749
  # resp.event.payload[0].conversational.role #=> String, one of "ASSISTANT", "USER", "TOOL", "OTHER"
572
750
  # resp.event.branch.root_event_id #=> String
573
751
  # resp.event.branch.name #=> String
752
+ # resp.event.metadata #=> Hash
753
+ # resp.event.metadata["MetadataKey"].string_value #=> String
574
754
  #
575
755
  # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/CreateEvent AWS API Documentation
576
756
  #
@@ -647,7 +827,7 @@ module Aws::BedrockAgentCore
647
827
  #
648
828
  # resp = client.delete_memory_record({
649
829
  # memory_id: "MemoryId", # required
650
- # memory_record_id: "String", # required
830
+ # memory_record_id: "MemoryRecordId", # required
651
831
  # })
652
832
  #
653
833
  # @example Response structure
@@ -663,6 +843,51 @@ module Aws::BedrockAgentCore
663
843
  req.send_request(options)
664
844
  end
665
845
 
846
+ # Retrieves the A2A agent card associated with an AgentCore Runtime
847
+ # agent.
848
+ #
849
+ # @option params [String] :runtime_session_id
850
+ # The session ID that the AgentCore Runtime agent is using.
851
+ #
852
+ # **A suitable default value is auto-generated.** You should normally
853
+ # not need to pass this option.**
854
+ #
855
+ # @option params [required, String] :agent_runtime_arn
856
+ # The ARN of the AgentCore Runtime agent for which you want to get the
857
+ # A2A agent card.
858
+ #
859
+ # @option params [String] :qualifier
860
+ # Optional qualifier to specify an agent alias, such as `prod`code&gt;
861
+ # or `dev`. If you don't provide a value, the DEFAULT alias is used.
862
+ #
863
+ # @return [Types::GetAgentCardResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
864
+ #
865
+ # * {Types::GetAgentCardResponse#runtime_session_id #runtime_session_id} => String
866
+ # * {Types::GetAgentCardResponse#agent_card #agent_card} => Hash,Array,String,Numeric,Boolean
867
+ # * {Types::GetAgentCardResponse#status_code #status_code} => Integer
868
+ #
869
+ # @example Request syntax with placeholder values
870
+ #
871
+ # resp = client.get_agent_card({
872
+ # runtime_session_id: "SessionType",
873
+ # agent_runtime_arn: "String", # required
874
+ # qualifier: "String",
875
+ # })
876
+ #
877
+ # @example Response structure
878
+ #
879
+ # resp.runtime_session_id #=> String
880
+ # resp.status_code #=> Integer
881
+ #
882
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/GetAgentCard AWS API Documentation
883
+ #
884
+ # @overload get_agent_card(params = {})
885
+ # @param [Hash] params ({})
886
+ def get_agent_card(params = {}, options = {})
887
+ req = build_request(:get_agent_card, params)
888
+ req.send_request(options)
889
+ end
890
+
666
891
  # Retrieves detailed information about a specific browser session in
667
892
  # Amazon Bedrock. This operation returns the session's configuration,
668
893
  # current status, associated streams, and metadata.
@@ -843,6 +1068,8 @@ module Aws::BedrockAgentCore
843
1068
  # resp.event.payload[0].conversational.role #=> String, one of "ASSISTANT", "USER", "TOOL", "OTHER"
844
1069
  # resp.event.branch.root_event_id #=> String
845
1070
  # resp.event.branch.name #=> String
1071
+ # resp.event.metadata #=> Hash
1072
+ # resp.event.metadata["MetadataKey"].string_value #=> String
846
1073
  #
847
1074
  # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/GetEvent AWS API Documentation
848
1075
  #
@@ -873,7 +1100,7 @@ module Aws::BedrockAgentCore
873
1100
  #
874
1101
  # resp = client.get_memory_record({
875
1102
  # memory_id: "MemoryId", # required
876
- # memory_record_id: "String", # required
1103
+ # memory_record_id: "MemoryRecordId", # required
877
1104
  # })
878
1105
  #
879
1106
  # @example Response structure
@@ -894,14 +1121,15 @@ module Aws::BedrockAgentCore
894
1121
  req.send_request(options)
895
1122
  end
896
1123
 
897
- # Retrieves an API Key associated with an API Key Credential Provider
1124
+ # Retrieves the API key associated with an API key credential provider.
898
1125
  #
899
1126
  # @option params [required, String] :workload_identity_token
900
- # The identity token of the workload you want to get the API Key of.
1127
+ # The identity token of the workload from which you want to retrieve the
1128
+ # API key.
901
1129
  #
902
1130
  # @option params [required, String] :resource_credential_provider_name
903
- # The credential provider name of the resource you are retrieving the
904
- # API Key of.
1131
+ # The credential provider name for the resource from which you are
1132
+ # retrieving the API key.
905
1133
  #
906
1134
  # @return [Types::GetResourceApiKeyResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
907
1135
  #
@@ -927,32 +1155,34 @@ module Aws::BedrockAgentCore
927
1155
  req.send_request(options)
928
1156
  end
929
1157
 
930
- # Returns the OAuth 2.0 token of the provided resource
1158
+ # Returns the OAuth 2.0 token of the provided resource.
931
1159
  #
932
1160
  # @option params [required, String] :workload_identity_token
933
- # The identity token of the workload you want to retrive the Oauth2
934
- # Token of.
1161
+ # The identity token of the workload from which you want to retrieve the
1162
+ # OAuth2 token.
935
1163
  #
936
1164
  # @option params [required, String] :resource_credential_provider_name
937
- # Reference to the credential provider
1165
+ # The name of the resource's credential provider.
938
1166
  #
939
1167
  # @option params [required, Array<String>] :scopes
940
- # The OAuth scopes requested
1168
+ # The OAuth scopes being requested.
941
1169
  #
942
1170
  # @option params [required, String] :oauth2_flow
943
- # The type of flow to be performed
1171
+ # The type of flow to be performed.
944
1172
  #
945
1173
  # @option params [String] :resource_oauth_2_return_url
946
- # Callback url to redirect after token retrieval completes. Should be
947
- # one of the provideded urls during WorkloadIdentity creation
1174
+ # The callback URL to redirect to after the OAuth 2.0 token retrieval is
1175
+ # complete. This URL must be one of the provided URLs configured for the
1176
+ # workload identity.
948
1177
  #
949
1178
  # @option params [Boolean] :force_authentication
950
- # If true, always initiate a new 3LO flow
1179
+ # Indicates whether to always initiate a new three-legged OAuth (3LO)
1180
+ # flow, regardless of any existing session.
951
1181
  #
952
1182
  # @option params [Hash<String,String>] :custom_parameters
953
- # Gives the ability to send extra/custom parameters to the resource
954
- # credentials provider during the authorization process. Standard OAuth2
955
- # flow parameters will not be overriden.
1183
+ # A map of custom parameters to include in the authorization request to
1184
+ # the resource credential provider. These parameters are in addition to
1185
+ # the standard OAuth 2.0 flow parameters, and will not override them.
956
1186
  #
957
1187
  # @return [Types::GetResourceOauth2TokenResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
958
1188
  #
@@ -987,11 +1217,11 @@ module Aws::BedrockAgentCore
987
1217
  req.send_request(options)
988
1218
  end
989
1219
 
990
- # Obtains an Workload access token for agentic workloads not acting on
991
- # behalf of user.
1220
+ # Obtains a workload access token for agentic workloads not acting on
1221
+ # behalf of a user.
992
1222
  #
993
1223
  # @option params [required, String] :workload_name
994
- # Unique identifier for the registered agent
1224
+ # The unique identifier for the registered workload.
995
1225
  #
996
1226
  # @return [Types::GetWorkloadAccessTokenResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
997
1227
  #
@@ -1016,14 +1246,14 @@ module Aws::BedrockAgentCore
1016
1246
  req.send_request(options)
1017
1247
  end
1018
1248
 
1019
- # Obtains an Workload access token for agentic workloads acting on
1020
- # behalf of user with JWT token
1249
+ # Obtains a workload access token for agentic workloads acting on behalf
1250
+ # of a user, using a JWT token.
1021
1251
  #
1022
1252
  # @option params [required, String] :workload_name
1023
- # Unique identifier for the registered agent
1253
+ # The unique identifier for the registered workload.
1024
1254
  #
1025
1255
  # @option params [required, String] :user_token
1026
- # OAuth2 token issued by the user's identity provider
1256
+ # The OAuth 2.0 token issued by the user's identity provider.
1027
1257
  #
1028
1258
  # @return [Types::GetWorkloadAccessTokenForJWTResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1029
1259
  #
@@ -1049,14 +1279,15 @@ module Aws::BedrockAgentCore
1049
1279
  req.send_request(options)
1050
1280
  end
1051
1281
 
1052
- # Obtains an Workload access token for agentic workloads acting on
1053
- # behalf of user with User Id.
1282
+ # Obtains a workload access token for agentic workloads acting on behalf
1283
+ # of a user, using the user's ID.
1054
1284
  #
1055
1285
  # @option params [required, String] :workload_name
1056
- # The name of the worklaod you want to get the access token of.
1286
+ # The name of the workload from which you want to retrieve the access
1287
+ # token.
1057
1288
  #
1058
1289
  # @option params [required, String] :user_id
1059
- # The user id of the user you are retrieving the access token for.
1290
+ # The ID of the user for whom you are retrieving the access token.
1060
1291
  #
1061
1292
  # @return [Types::GetWorkloadAccessTokenForUserIdResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1062
1293
  #
@@ -1102,7 +1333,11 @@ module Aws::BedrockAgentCore
1102
1333
  # [Authenticate and authorize with Inbound Auth and Outbound Auth][2].
1103
1334
  #
1104
1335
  # To use this operation, you must have the
1105
- # `bedrock-agentcore:InvokeAgentRuntime` permission.
1336
+ # `bedrock-agentcore:InvokeAgentRuntime` permission. If you are making a
1337
+ # call to `InvokeAgentRuntime` on behalf of a user ID with the
1338
+ # `X-Amzn-Bedrock-AgentCore-Runtime-User-Id` header, You require
1339
+ # permissions to both actions (`bedrock-agentcore:InvokeAgentRuntime`
1340
+ # and `bedrock-agentcore:InvokeAgentRuntimeForUser`).
1106
1341
  #
1107
1342
  #
1108
1343
  #
@@ -1250,6 +1485,12 @@ module Aws::BedrockAgentCore
1250
1485
  # must be an active session created with `StartCodeInterpreterSession`.
1251
1486
  # If the session has expired or been stopped, the request will fail.
1252
1487
  #
1488
+ # @option params [String] :trace_id
1489
+ # The trace identifier for request tracking.
1490
+ #
1491
+ # @option params [String] :trace_parent
1492
+ # The parent trace information for distributed tracing.
1493
+ #
1253
1494
  # @option params [required, String] :name
1254
1495
  # The name of the code interpreter to invoke.
1255
1496
  #
@@ -1422,6 +1663,8 @@ module Aws::BedrockAgentCore
1422
1663
  # resp = client.invoke_code_interpreter({
1423
1664
  # code_interpreter_identifier: "String", # required
1424
1665
  # session_id: "CodeInterpreterSessionId",
1666
+ # trace_id: "InvokeCodeInterpreterRequestTraceIdString",
1667
+ # trace_parent: "InvokeCodeInterpreterRequestTraceParentString",
1425
1668
  # name: "executeCode", # required, accepts executeCode, executeCommand, readFiles, listFiles, removeFiles, writeFiles, startCommandExecution, getTask, stopTask
1426
1669
  # arguments: {
1427
1670
  # code: "MaxLenString",
@@ -1785,6 +2028,19 @@ module Aws::BedrockAgentCore
1785
2028
  # name: "BranchName", # required
1786
2029
  # include_parent_branches: false,
1787
2030
  # },
2031
+ # event_metadata: [
2032
+ # {
2033
+ # left: { # required
2034
+ # metadata_key: "MetadataKey",
2035
+ # },
2036
+ # operator: "EQUALS_TO", # required, accepts EQUALS_TO, EXISTS, NOT_EXISTS
2037
+ # right: {
2038
+ # metadata_value: {
2039
+ # string_value: "MetadataValueStringValueString",
2040
+ # },
2041
+ # },
2042
+ # },
2043
+ # ],
1788
2044
  # },
1789
2045
  # max_results: 1,
1790
2046
  # next_token: "PaginationToken",
@@ -1803,6 +2059,8 @@ module Aws::BedrockAgentCore
1803
2059
  # resp.events[0].payload[0].conversational.role #=> String, one of "ASSISTANT", "USER", "TOOL", "OTHER"
1804
2060
  # resp.events[0].branch.root_event_id #=> String
1805
2061
  # resp.events[0].branch.name #=> String
2062
+ # resp.events[0].metadata #=> Hash
2063
+ # resp.events[0].metadata["MetadataKey"].string_value #=> String
1806
2064
  # resp.next_token #=> String
1807
2065
  #
1808
2066
  # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/ListEvents AWS API Documentation
@@ -2033,6 +2291,12 @@ module Aws::BedrockAgentCore
2033
2291
  # [2]: https://docs.aws.amazon.com/API_UpdateBrowserStream.html
2034
2292
  # [3]: https://docs.aws.amazon.com/API_StopBrowserSession.html
2035
2293
  #
2294
+ # @option params [String] :trace_id
2295
+ # The trace identifier for request tracking.
2296
+ #
2297
+ # @option params [String] :trace_parent
2298
+ # The parent trace information for distributed tracing.
2299
+ #
2036
2300
  # @option params [required, String] :browser_identifier
2037
2301
  # The unique identifier of the browser to use for this session. This
2038
2302
  # identifier specifies which browser environment to initialize for the
@@ -2074,6 +2338,8 @@ module Aws::BedrockAgentCore
2074
2338
  # @example Request syntax with placeholder values
2075
2339
  #
2076
2340
  # resp = client.start_browser_session({
2341
+ # trace_id: "StartBrowserSessionRequestTraceIdString",
2342
+ # trace_parent: "StartBrowserSessionRequestTraceParentString",
2077
2343
  # browser_identifier: "String", # required
2078
2344
  # name: "Name",
2079
2345
  # session_timeout_seconds: 1,
@@ -2125,6 +2391,12 @@ module Aws::BedrockAgentCore
2125
2391
  # [2]: https://docs.aws.amazon.com/API_GetCodeInterpreterSession.html
2126
2392
  # [3]: https://docs.aws.amazon.com/API_StopCodeInterpreterSession.html
2127
2393
  #
2394
+ # @option params [String] :trace_id
2395
+ # The trace identifier for request tracking.
2396
+ #
2397
+ # @option params [String] :trace_parent
2398
+ # The parent trace information for distributed tracing.
2399
+ #
2128
2400
  # @option params [required, String] :code_interpreter_identifier
2129
2401
  # The unique identifier of the code interpreter to use for this session.
2130
2402
  # This identifier specifies which code interpreter environment to
@@ -2136,9 +2408,9 @@ module Aws::BedrockAgentCore
2136
2408
  #
2137
2409
  # @option params [Integer] :session_timeout_seconds
2138
2410
  # The time in seconds after which the session automatically terminates
2139
- # if there is no activity. The default value is 3600 seconds (1 hour).
2140
- # The minimum allowed value is 60 seconds, and the maximum allowed value
2141
- # is 28800 seconds (8 hours).
2411
+ # if there is no activity. The default value is 900 seconds (15
2412
+ # minutes). The minimum allowed value is 60 seconds, and the maximum
2413
+ # allowed value is 28800 seconds (8 hours).
2142
2414
  #
2143
2415
  # @option params [String] :client_token
2144
2416
  # A unique, case-sensitive identifier to ensure that the API request
@@ -2159,6 +2431,8 @@ module Aws::BedrockAgentCore
2159
2431
  # @example Request syntax with placeholder values
2160
2432
  #
2161
2433
  # resp = client.start_code_interpreter_session({
2434
+ # trace_id: "StartCodeInterpreterSessionRequestTraceIdString",
2435
+ # trace_parent: "StartCodeInterpreterSessionRequestTraceParentString",
2162
2436
  # code_interpreter_identifier: "String", # required
2163
2437
  # name: "Name",
2164
2438
  # session_timeout_seconds: 1,
@@ -2199,6 +2473,12 @@ module Aws::BedrockAgentCore
2199
2473
  # [1]: https://docs.aws.amazon.com/API_StartBrowserSession.html
2200
2474
  # [2]: https://docs.aws.amazon.com/API_GetBrowserSession.html
2201
2475
  #
2476
+ # @option params [String] :trace_id
2477
+ # The trace identifier for request tracking.
2478
+ #
2479
+ # @option params [String] :trace_parent
2480
+ # The parent trace information for distributed tracing.
2481
+ #
2202
2482
  # @option params [required, String] :browser_identifier
2203
2483
  # The unique identifier of the browser associated with the session.
2204
2484
  #
@@ -2223,6 +2503,8 @@ module Aws::BedrockAgentCore
2223
2503
  # @example Request syntax with placeholder values
2224
2504
  #
2225
2505
  # resp = client.stop_browser_session({
2506
+ # trace_id: "StopBrowserSessionRequestTraceIdString",
2507
+ # trace_parent: "StopBrowserSessionRequestTraceParentString",
2226
2508
  # browser_identifier: "String", # required
2227
2509
  # session_id: "BrowserSessionId", # required
2228
2510
  # client_token: "ClientToken",
@@ -2263,6 +2545,12 @@ module Aws::BedrockAgentCore
2263
2545
  # [1]: https://docs.aws.amazon.com/API_StartCodeInterpreterSession.html
2264
2546
  # [2]: https://docs.aws.amazon.com/API_GetCodeInterpreterSession.html
2265
2547
  #
2548
+ # @option params [String] :trace_id
2549
+ # The trace identifier for request tracking.
2550
+ #
2551
+ # @option params [String] :trace_parent
2552
+ # The parent trace information for distributed tracing.
2553
+ #
2266
2554
  # @option params [required, String] :code_interpreter_identifier
2267
2555
  # The unique identifier of the code interpreter associated with the
2268
2556
  # session.
@@ -2288,6 +2576,8 @@ module Aws::BedrockAgentCore
2288
2576
  # @example Request syntax with placeholder values
2289
2577
  #
2290
2578
  # resp = client.stop_code_interpreter_session({
2579
+ # trace_id: "StopCodeInterpreterSessionRequestTraceIdString",
2580
+ # trace_parent: "StopCodeInterpreterSessionRequestTraceParentString",
2291
2581
  # code_interpreter_identifier: "String", # required
2292
2582
  # session_id: "CodeInterpreterSessionId", # required
2293
2583
  # client_token: "ClientToken",
@@ -2308,6 +2598,55 @@ module Aws::BedrockAgentCore
2308
2598
  req.send_request(options)
2309
2599
  end
2310
2600
 
2601
+ # Stops a session that is running in an running AgentCore Runtime agent.
2602
+ #
2603
+ # @option params [required, String] :runtime_session_id
2604
+ # The ID of the session that you want to stop.
2605
+ #
2606
+ # @option params [required, String] :agent_runtime_arn
2607
+ # The ARN of the agent that contains the session that you want to stop.
2608
+ #
2609
+ # @option params [String] :qualifier
2610
+ # Optional qualifier to specify an agent alias, such as `prod`code&gt;
2611
+ # or `dev`. If you don't provide a value, the DEFAULT alias is used.
2612
+ #
2613
+ # @option params [String] :client_token
2614
+ # Idempotent token used to identify the request. If you use the same
2615
+ # token with multiple requests, the same response is returned. Use
2616
+ # ClientToken to prevent the same request from being processed more than
2617
+ # once.
2618
+ #
2619
+ # **A suitable default value is auto-generated.** You should normally
2620
+ # not need to pass this option.**
2621
+ #
2622
+ # @return [Types::StopRuntimeSessionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2623
+ #
2624
+ # * {Types::StopRuntimeSessionResponse#runtime_session_id #runtime_session_id} => String
2625
+ # * {Types::StopRuntimeSessionResponse#status_code #status_code} => Integer
2626
+ #
2627
+ # @example Request syntax with placeholder values
2628
+ #
2629
+ # resp = client.stop_runtime_session({
2630
+ # runtime_session_id: "SessionType", # required
2631
+ # agent_runtime_arn: "String", # required
2632
+ # qualifier: "String",
2633
+ # client_token: "ClientToken",
2634
+ # })
2635
+ #
2636
+ # @example Response structure
2637
+ #
2638
+ # resp.runtime_session_id #=> String
2639
+ # resp.status_code #=> Integer
2640
+ #
2641
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/StopRuntimeSession AWS API Documentation
2642
+ #
2643
+ # @overload stop_runtime_session(params = {})
2644
+ # @param [Hash] params ({})
2645
+ def stop_runtime_session(params = {}, options = {})
2646
+ req = build_request(:stop_runtime_session, params)
2647
+ req.send_request(options)
2648
+ end
2649
+
2311
2650
  # Updates a browser stream. To use this operation, you must have
2312
2651
  # permissions to perform the bedrock:UpdateBrowserStream action.
2313
2652
  #
@@ -2385,7 +2724,7 @@ module Aws::BedrockAgentCore
2385
2724
  tracer: tracer
2386
2725
  )
2387
2726
  context[:gem_name] = 'aws-sdk-bedrockagentcore'
2388
- context[:gem_version] = '1.5.0'
2727
+ context[:gem_version] = '1.7.0'
2389
2728
  Seahorse::Client::Request.new(handlers, context)
2390
2729
  end
2391
2730