aws-sdk-bedrockruntime 1.63.0 → 1.67.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.
@@ -43,6 +43,46 @@ module Aws::BedrockRuntime
43
43
  #
44
44
  class AnyToolChoice < Aws::EmptyStructure; end
45
45
 
46
+ # Details about the specific guardrail that was applied during this
47
+ # assessment, including its identifier, version, ARN, origin, and
48
+ # ownership information.
49
+ #
50
+ # @!attribute [rw] guardrail_id
51
+ # The unique ID of the guardrail that was applied.
52
+ # @return [String]
53
+ #
54
+ # @!attribute [rw] guardrail_version
55
+ # The version of the guardrail that was applied.
56
+ # @return [String]
57
+ #
58
+ # @!attribute [rw] guardrail_arn
59
+ # The ARN of the guardrail that was applied.
60
+ # @return [String]
61
+ #
62
+ # @!attribute [rw] guardrail_origin
63
+ # The origin of how the guardrail was applied. This can be either
64
+ # requested at the API level or enforced at the account or
65
+ # organization level as a default guardrail.
66
+ # @return [Array<String>]
67
+ #
68
+ # @!attribute [rw] guardrail_ownership
69
+ # The ownership type of the guardrail, indicating whether it is owned
70
+ # by the requesting account or is a cross-account guardrail shared
71
+ # from another AWS account.
72
+ # @return [String]
73
+ #
74
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/AppliedGuardrailDetails AWS API Documentation
75
+ #
76
+ class AppliedGuardrailDetails < Struct.new(
77
+ :guardrail_id,
78
+ :guardrail_version,
79
+ :guardrail_arn,
80
+ :guardrail_origin,
81
+ :guardrail_ownership)
82
+ SENSITIVE = []
83
+ include Aws::Structure
84
+ end
85
+
46
86
  # @!attribute [rw] guardrail_identifier
47
87
  # The guardrail identifier used in the request to apply the guardrail.
48
88
  # @return [String]
@@ -292,6 +332,11 @@ module Aws::BedrockRuntime
292
332
  # The title or identifier of the source document being cited.
293
333
  # @return [String]
294
334
  #
335
+ # @!attribute [rw] source
336
+ # The source from the original search result that provided the cited
337
+ # content.
338
+ # @return [String]
339
+ #
295
340
  # @!attribute [rw] source_content
296
341
  # The specific content from the source document that was referenced or
297
342
  # cited in the generated response.
@@ -307,6 +352,7 @@ module Aws::BedrockRuntime
307
352
  #
308
353
  class Citation < Struct.new(
309
354
  :title,
355
+ :source,
310
356
  :source_content,
311
357
  :location)
312
358
  SENSITIVE = []
@@ -367,6 +413,12 @@ module Aws::BedrockRuntime
367
413
  # logical chunks.
368
414
  # @return [Types::DocumentChunkLocation]
369
415
  #
416
+ # @!attribute [rw] search_result_location
417
+ # The search result location where the cited content is found,
418
+ # including the search result index and block positions within the
419
+ # content array.
420
+ # @return [Types::SearchResultLocation]
421
+ #
370
422
  # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/CitationLocation AWS API Documentation
371
423
  #
372
424
  class CitationLocation < Struct.new(
@@ -374,6 +426,7 @@ module Aws::BedrockRuntime
374
426
  :document_char,
375
427
  :document_page,
376
428
  :document_chunk,
429
+ :search_result_location,
377
430
  :unknown)
378
431
  SENSITIVE = []
379
432
  include Aws::Structure
@@ -383,6 +436,7 @@ module Aws::BedrockRuntime
383
436
  class DocumentChar < CitationLocation; end
384
437
  class DocumentPage < CitationLocation; end
385
438
  class DocumentChunk < CitationLocation; end
439
+ class SearchResultLocation < CitationLocation; end
386
440
  class Unknown < CitationLocation; end
387
441
  end
388
442
 
@@ -478,6 +532,11 @@ module Aws::BedrockRuntime
478
532
  # The title or identifier of the source document being cited.
479
533
  # @return [String]
480
534
  #
535
+ # @!attribute [rw] source
536
+ # The source from the original search result that provided the cited
537
+ # content.
538
+ # @return [String]
539
+ #
481
540
  # @!attribute [rw] source_content
482
541
  # The specific content from the source document that was referenced or
483
542
  # cited in the generated response.
@@ -494,6 +553,7 @@ module Aws::BedrockRuntime
494
553
  #
495
554
  class CitationsDelta < Struct.new(
496
555
  :title,
556
+ :source,
497
557
  :source_content,
498
558
  :location)
499
559
  SENSITIVE = []
@@ -578,6 +638,10 @@ module Aws::BedrockRuntime
578
638
  # and source documents.
579
639
  # @return [Types::CitationsContentBlock]
580
640
  #
641
+ # @!attribute [rw] search_result
642
+ # Search result to include in the message.
643
+ # @return [Types::SearchResultBlock]
644
+ #
581
645
  # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/ContentBlock AWS API Documentation
582
646
  #
583
647
  class ContentBlock < Struct.new(
@@ -591,6 +655,7 @@ module Aws::BedrockRuntime
591
655
  :cache_point,
592
656
  :reasoning_content,
593
657
  :citations_content,
658
+ :search_result,
594
659
  :unknown)
595
660
  SENSITIVE = [:reasoning_content]
596
661
  include Aws::Structure
@@ -606,6 +671,7 @@ module Aws::BedrockRuntime
606
671
  class CachePoint < ContentBlock; end
607
672
  class ReasoningContent < ContentBlock; end
608
673
  class CitationsContent < ContentBlock; end
674
+ class SearchResult < ContentBlock; end
609
675
  class Unknown < ContentBlock; end
610
676
  end
611
677
 
@@ -906,6 +972,11 @@ module Aws::BedrockRuntime
906
972
  # Model performance settings for the request.
907
973
  # @return [Types::PerformanceConfiguration]
908
974
  #
975
+ # @!attribute [rw] service_tier
976
+ # Specifies the processing tier configuration used for serving the
977
+ # request.
978
+ # @return [Types::ServiceTier]
979
+ #
909
980
  # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/ConverseRequest AWS API Documentation
910
981
  #
911
982
  class ConverseRequest < Struct.new(
@@ -919,7 +990,8 @@ module Aws::BedrockRuntime
919
990
  :prompt_variables,
920
991
  :additional_model_response_field_paths,
921
992
  :request_metadata,
922
- :performance_config)
993
+ :performance_config,
994
+ :service_tier)
923
995
  SENSITIVE = [:prompt_variables, :request_metadata]
924
996
  include Aws::Structure
925
997
  end
@@ -955,6 +1027,11 @@ module Aws::BedrockRuntime
955
1027
  # Model performance settings for the request.
956
1028
  # @return [Types::PerformanceConfiguration]
957
1029
  #
1030
+ # @!attribute [rw] service_tier
1031
+ # Specifies the processing tier configuration used for serving the
1032
+ # request.
1033
+ # @return [Types::ServiceTier]
1034
+ #
958
1035
  # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/ConverseResponse AWS API Documentation
959
1036
  #
960
1037
  class ConverseResponse < Struct.new(
@@ -964,7 +1041,8 @@ module Aws::BedrockRuntime
964
1041
  :metrics,
965
1042
  :additional_model_response_fields,
966
1043
  :trace,
967
- :performance_config)
1044
+ :performance_config,
1045
+ :service_tier)
968
1046
  SENSITIVE = []
969
1047
  include Aws::Structure
970
1048
  end
@@ -993,6 +1071,11 @@ module Aws::BedrockRuntime
993
1071
  # event.
994
1072
  # @return [Types::PerformanceConfiguration]
995
1073
  #
1074
+ # @!attribute [rw] service_tier
1075
+ # Specifies the processing tier configuration used for serving the
1076
+ # request.
1077
+ # @return [Types::ServiceTier]
1078
+ #
996
1079
  # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/ConverseStreamMetadataEvent AWS API Documentation
997
1080
  #
998
1081
  class ConverseStreamMetadataEvent < Struct.new(
@@ -1000,6 +1083,7 @@ module Aws::BedrockRuntime
1000
1083
  :metrics,
1001
1084
  :trace,
1002
1085
  :performance_config,
1086
+ :service_tier,
1003
1087
  :event_type)
1004
1088
  SENSITIVE = []
1005
1089
  include Aws::Structure
@@ -1143,6 +1227,11 @@ module Aws::BedrockRuntime
1143
1227
  # Model performance settings for the request.
1144
1228
  # @return [Types::PerformanceConfiguration]
1145
1229
  #
1230
+ # @!attribute [rw] service_tier
1231
+ # Specifies the processing tier configuration used for serving the
1232
+ # request.
1233
+ # @return [Types::ServiceTier]
1234
+ #
1146
1235
  # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/ConverseStreamRequest AWS API Documentation
1147
1236
  #
1148
1237
  class ConverseStreamRequest < Struct.new(
@@ -1156,7 +1245,8 @@ module Aws::BedrockRuntime
1156
1245
  :prompt_variables,
1157
1246
  :additional_model_response_field_paths,
1158
1247
  :request_metadata,
1159
- :performance_config)
1248
+ :performance_config,
1249
+ :service_tier)
1160
1250
  SENSITIVE = [:prompt_variables, :request_metadata]
1161
1251
  include Aws::Structure
1162
1252
  end
@@ -1213,11 +1303,25 @@ module Aws::BedrockRuntime
1213
1303
  # provided.
1214
1304
  # @return [Array<Types::SystemContentBlock>]
1215
1305
  #
1306
+ # @!attribute [rw] tool_config
1307
+ # The toolConfig of Converse input request to count tokens for.
1308
+ # Configuration information for the tools that the model can use when
1309
+ # generating a response.
1310
+ # @return [Types::ToolConfiguration]
1311
+ #
1312
+ # @!attribute [rw] additional_model_request_fields
1313
+ # The additionalModelRequestFields of Converse input request to count
1314
+ # tokens for. Use this field when you want to pass additional
1315
+ # parameters that the model supports.
1316
+ # @return [Hash,Array,String,Numeric,Boolean]
1317
+ #
1216
1318
  # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/ConverseTokensRequest AWS API Documentation
1217
1319
  #
1218
1320
  class ConverseTokensRequest < Struct.new(
1219
1321
  :messages,
1220
- :system)
1322
+ :system,
1323
+ :tool_config,
1324
+ :additional_model_request_fields)
1221
1325
  SENSITIVE = []
1222
1326
  include Aws::Structure
1223
1327
  end
@@ -1631,6 +1735,12 @@ module Aws::BedrockRuntime
1631
1735
  # The invocation metrics for the guardrail assessment.
1632
1736
  # @return [Types::GuardrailInvocationMetrics]
1633
1737
  #
1738
+ # @!attribute [rw] applied_guardrail_details
1739
+ # Details about the specific guardrail that was applied during this
1740
+ # assessment, including its identifier, version, ARN, origin, and
1741
+ # ownership information.
1742
+ # @return [Types::AppliedGuardrailDetails]
1743
+ #
1634
1744
  # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/GuardrailAssessment AWS API Documentation
1635
1745
  #
1636
1746
  class GuardrailAssessment < Struct.new(
@@ -1640,7 +1750,8 @@ module Aws::BedrockRuntime
1640
1750
  :sensitive_information_policy,
1641
1751
  :contextual_grounding_policy,
1642
1752
  :automated_reasoning_policy,
1643
- :invocation_metrics)
1753
+ :invocation_metrics,
1754
+ :applied_guardrail_details)
1644
1755
  SENSITIVE = []
1645
1756
  include Aws::Structure
1646
1757
  end
@@ -3047,6 +3158,10 @@ module Aws::BedrockRuntime
3047
3158
  # Model performance settings for the request.
3048
3159
  # @return [String]
3049
3160
  #
3161
+ # @!attribute [rw] service_tier
3162
+ # Specifies the processing tier type used for serving the request.
3163
+ # @return [String]
3164
+ #
3050
3165
  # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/InvokeModelRequest AWS API Documentation
3051
3166
  #
3052
3167
  class InvokeModelRequest < Struct.new(
@@ -3057,7 +3172,8 @@ module Aws::BedrockRuntime
3057
3172
  :trace,
3058
3173
  :guardrail_identifier,
3059
3174
  :guardrail_version,
3060
- :performance_config_latency)
3175
+ :performance_config_latency,
3176
+ :service_tier)
3061
3177
  SENSITIVE = [:body]
3062
3178
  include Aws::Structure
3063
3179
  end
@@ -3081,12 +3197,17 @@ module Aws::BedrockRuntime
3081
3197
  # Model performance settings for the request.
3082
3198
  # @return [String]
3083
3199
  #
3200
+ # @!attribute [rw] service_tier
3201
+ # Specifies the processing tier type used for serving the request.
3202
+ # @return [String]
3203
+ #
3084
3204
  # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/InvokeModelResponse AWS API Documentation
3085
3205
  #
3086
3206
  class InvokeModelResponse < Struct.new(
3087
3207
  :body,
3088
3208
  :content_type,
3089
- :performance_config_latency)
3209
+ :performance_config_latency,
3210
+ :service_tier)
3090
3211
  SENSITIVE = [:body]
3091
3212
  include Aws::Structure
3092
3213
  end
@@ -3246,6 +3367,10 @@ module Aws::BedrockRuntime
3246
3367
  # Model performance settings for the request.
3247
3368
  # @return [String]
3248
3369
  #
3370
+ # @!attribute [rw] service_tier
3371
+ # Specifies the processing tier type used for serving the request.
3372
+ # @return [String]
3373
+ #
3249
3374
  # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/InvokeModelWithResponseStreamRequest AWS API Documentation
3250
3375
  #
3251
3376
  class InvokeModelWithResponseStreamRequest < Struct.new(
@@ -3256,7 +3381,8 @@ module Aws::BedrockRuntime
3256
3381
  :trace,
3257
3382
  :guardrail_identifier,
3258
3383
  :guardrail_version,
3259
- :performance_config_latency)
3384
+ :performance_config_latency,
3385
+ :service_tier)
3260
3386
  SENSITIVE = [:body]
3261
3387
  include Aws::Structure
3262
3388
  end
@@ -3279,12 +3405,17 @@ module Aws::BedrockRuntime
3279
3405
  # Model performance settings for the request.
3280
3406
  # @return [String]
3281
3407
  #
3408
+ # @!attribute [rw] service_tier
3409
+ # Specifies the processing tier type used for serving the request.
3410
+ # @return [String]
3411
+ #
3282
3412
  # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/InvokeModelWithResponseStreamResponse AWS API Documentation
3283
3413
  #
3284
3414
  class InvokeModelWithResponseStreamResponse < Struct.new(
3285
3415
  :body,
3286
3416
  :content_type,
3287
- :performance_config_latency)
3417
+ :performance_config_latency,
3418
+ :service_tier)
3288
3419
  SENSITIVE = []
3289
3420
  include Aws::Structure
3290
3421
  end
@@ -3708,6 +3839,84 @@ module Aws::BedrockRuntime
3708
3839
  include Aws::Structure
3709
3840
  end
3710
3841
 
3842
+ # A search result block that enables natural citations with proper
3843
+ # source attribution for retrieved content.
3844
+ #
3845
+ # <note markdown="1"> This field is only supported by Anthropic Claude Opus 4.1, Opus 4,
3846
+ # Sonnet 4.5, Sonnet 4, Sonnet 3.7, and 3.5 Haiku models.
3847
+ #
3848
+ # </note>
3849
+ #
3850
+ # @!attribute [rw] source
3851
+ # The source URL or identifier for the content.
3852
+ # @return [String]
3853
+ #
3854
+ # @!attribute [rw] title
3855
+ # A descriptive title for the search result.
3856
+ # @return [String]
3857
+ #
3858
+ # @!attribute [rw] content
3859
+ # An array of search result content block.
3860
+ # @return [Array<Types::SearchResultContentBlock>]
3861
+ #
3862
+ # @!attribute [rw] citations
3863
+ # Configuration setting for citations
3864
+ # @return [Types::CitationsConfig]
3865
+ #
3866
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/SearchResultBlock AWS API Documentation
3867
+ #
3868
+ class SearchResultBlock < Struct.new(
3869
+ :source,
3870
+ :title,
3871
+ :content,
3872
+ :citations)
3873
+ SENSITIVE = []
3874
+ include Aws::Structure
3875
+ end
3876
+
3877
+ # A block within a search result that contains the content.
3878
+ #
3879
+ # @!attribute [rw] text
3880
+ # The actual text content
3881
+ # @return [String]
3882
+ #
3883
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/SearchResultContentBlock AWS API Documentation
3884
+ #
3885
+ class SearchResultContentBlock < Struct.new(
3886
+ :text)
3887
+ SENSITIVE = []
3888
+ include Aws::Structure
3889
+ end
3890
+
3891
+ # Specifies a search result location within the content array, providing
3892
+ # positioning information for cited content using search result index
3893
+ # and block positions.
3894
+ #
3895
+ # @!attribute [rw] search_result_index
3896
+ # The index of the search result content block where the cited content
3897
+ # is found.
3898
+ # @return [Integer]
3899
+ #
3900
+ # @!attribute [rw] start
3901
+ # The starting position in the content array where the cited content
3902
+ # begins.
3903
+ # @return [Integer]
3904
+ #
3905
+ # @!attribute [rw] end
3906
+ # The ending position in the content array where the cited content
3907
+ # ends.
3908
+ # @return [Integer]
3909
+ #
3910
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/SearchResultLocation AWS API Documentation
3911
+ #
3912
+ class SearchResultLocation < Struct.new(
3913
+ :search_result_index,
3914
+ :start,
3915
+ :end)
3916
+ SENSITIVE = []
3917
+ include Aws::Structure
3918
+ end
3919
+
3711
3920
  # Your request exceeds the service quota for your account. You can view
3712
3921
  # your quotas at [Viewing service quotas][1]. You can resubmit your
3713
3922
  # request later.
@@ -3727,6 +3936,21 @@ module Aws::BedrockRuntime
3727
3936
  include Aws::Structure
3728
3937
  end
3729
3938
 
3939
+ # Specifies the processing tier configuration used for serving the
3940
+ # request.
3941
+ #
3942
+ # @!attribute [rw] type
3943
+ # Specifies the processing tier type used for serving the request.
3944
+ # @return [String]
3945
+ #
3946
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/ServiceTier AWS API Documentation
3947
+ #
3948
+ class ServiceTier < Struct.new(
3949
+ :type)
3950
+ SENSITIVE = []
3951
+ include Aws::Structure
3952
+ end
3953
+
3730
3954
  # The service isn't currently available. For troubleshooting this
3731
3955
  # error, see [ServiceUnavailable][1] in the Amazon Bedrock User Guide
3732
3956
  #
@@ -4219,6 +4443,10 @@ module Aws::BedrockRuntime
4219
4443
  # A tool result that is video.
4220
4444
  # @return [Types::VideoBlock]
4221
4445
  #
4446
+ # @!attribute [rw] search_result
4447
+ # A tool result that is a search result.
4448
+ # @return [Types::SearchResultBlock]
4449
+ #
4222
4450
  # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/ToolResultContentBlock AWS API Documentation
4223
4451
  #
4224
4452
  class ToolResultContentBlock < Struct.new(
@@ -4227,6 +4455,7 @@ module Aws::BedrockRuntime
4227
4455
  :image,
4228
4456
  :document,
4229
4457
  :video,
4458
+ :search_result,
4230
4459
  :unknown)
4231
4460
  SENSITIVE = []
4232
4461
  include Aws::Structure
@@ -4237,6 +4466,7 @@ module Aws::BedrockRuntime
4237
4466
  class Image < ToolResultContentBlock; end
4238
4467
  class Document < ToolResultContentBlock; end
4239
4468
  class Video < ToolResultContentBlock; end
4469
+ class SearchResult < ToolResultContentBlock; end
4240
4470
  class Unknown < ToolResultContentBlock; end
4241
4471
  end
4242
4472
 
@@ -27,6 +27,22 @@ Aws::Plugins::GlobalConfiguration.add_identifier(:bedrockruntime)
27
27
  #
28
28
  # See {Client} for more information.
29
29
  #
30
+ # # Async Client
31
+ #
32
+ # The {AsyncClient} class provides one asynchronous method for each API operation.
33
+ # Operation methods each accept a hash of request parameters and return an async
34
+ # response. For streaming operations, you can signal input events and register
35
+ # output event callbacks before waiting on the response.
36
+ #
37
+ # bedrock_runtime = Aws::BedrockRuntime::AsyncClient.new
38
+ # resp = bedrock_runtime.apply_guardrail(
39
+ # # params and input stream
40
+ # ) do |output_stream|
41
+ # # register callbacks for events
42
+ # end
43
+ #
44
+ # See {AsyncClient} for more information.
45
+ #
30
46
  # # Errors
31
47
  #
32
48
  # Errors returned from Amazon Bedrock Runtime are defined in the
@@ -57,7 +73,7 @@ module Aws::BedrockRuntime
57
73
  autoload :AsyncClient, 'aws-sdk-bedrockruntime/async_client'
58
74
  autoload :EventStreams, 'aws-sdk-bedrockruntime/event_streams'
59
75
 
60
- GEM_VERSION = '1.63.0'
76
+ GEM_VERSION = '1.67.0'
61
77
 
62
78
  end
63
79