aws-sdk-bedrockruntime 1.71.0 → 1.73.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: d921b47acca94d9951cd91cdeef9723e09f3430c4b58e949ae29ce16beab02c0
4
- data.tar.gz: 8759178f8b225b655c3fb892b0918e9c4cb5d905d7d138e8771e63fff7a1121e
3
+ metadata.gz: c954e566176ffe4a5115d952631cc095d293077a32c450c87ef0e3878de327b0
4
+ data.tar.gz: b07886b2813cbe2495823f3b9d7566beea3a259c91bf5a63b95889410ff6d53b
5
5
  SHA512:
6
- metadata.gz: abb320924257441dce34d26e0455f424144080ce923fd0415211b862fa6dab64b9c1a7f664cdd62fe96aa4203a643e26e8d3b1086a270a9ee67292c44acb3e62
7
- data.tar.gz: 66a58aa04a468810651cfe032f46e5cfc70902f43dbe3643ed330ffa05f2a4e75427f4fc6759ac02b0e88cac974094775890c87da9824402b45bb607d0ae4488
6
+ metadata.gz: 29e837287df6da304eec950765ce7560356073c1d3f4b524194964ebf8cd7838b808fcffa10981d7c37e460a2a95869c06a0eacc803ecd2e3998323363645faf
7
+ data.tar.gz: df49c34aaec9871bf6c5b09f5324cde2d29a7ff23a52d2d0c335e29b9919f660f472268302d4613196b6e46cdbe356d2111b3fe813c4bdb241a4ea0f9aac056f
data/CHANGELOG.md CHANGED
@@ -1,6 +1,16 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.73.0 (2026-02-04)
5
+ ------------------
6
+
7
+ * Feature - Added support for structured outputs to Converse and ConverseStream APIs.
8
+
9
+ 1.72.0 (2026-01-20)
10
+ ------------------
11
+
12
+ * Feature - Added support for extended prompt caching with one hour TTL.
13
+
4
14
  1.71.0 (2026-01-16)
5
15
  ------------------
6
16
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.71.0
1
+ 1.73.0
@@ -621,7 +621,7 @@ module Aws::BedrockRuntime
621
621
  tracer: tracer
622
622
  )
623
623
  context[:gem_name] = 'aws-sdk-bedrockruntime'
624
- context[:gem_version] = '1.71.0'
624
+ context[:gem_version] = '1.73.0'
625
625
  Seahorse::Client::Request.new(handlers, context)
626
626
  end
627
627
 
@@ -924,6 +924,9 @@ module Aws::BedrockRuntime
924
924
  # Specifies the processing tier configuration used for serving the
925
925
  # request.
926
926
  #
927
+ # @option params [Types::OutputConfig] :output_config
928
+ # Output configuration for a model response.
929
+ #
927
930
  # @return [Types::ConverseResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
928
931
  #
929
932
  # * {Types::ConverseResponse#output #output} => Types::ConverseOutput
@@ -1091,6 +1094,7 @@ module Aws::BedrockRuntime
1091
1094
  # },
1092
1095
  # cache_point: {
1093
1096
  # type: "default", # required, accepts default
1097
+ # ttl: "5m", # accepts 5m, 1h
1094
1098
  # },
1095
1099
  # reasoning_content: {
1096
1100
  # reasoning_text: {
@@ -1176,6 +1180,7 @@ module Aws::BedrockRuntime
1176
1180
  # },
1177
1181
  # cache_point: {
1178
1182
  # type: "default", # required, accepts default
1183
+ # ttl: "5m", # accepts 5m, 1h
1179
1184
  # },
1180
1185
  # },
1181
1186
  # ],
@@ -1195,12 +1200,14 @@ module Aws::BedrockRuntime
1195
1200
  # json: {
1196
1201
  # },
1197
1202
  # },
1203
+ # strict: false,
1198
1204
  # },
1199
1205
  # system_tool: {
1200
1206
  # name: "ToolName", # required
1201
1207
  # },
1202
1208
  # cache_point: {
1203
1209
  # type: "default", # required, accepts default
1210
+ # ttl: "5m", # accepts 5m, 1h
1204
1211
  # },
1205
1212
  # },
1206
1213
  # ],
@@ -1236,6 +1243,18 @@ module Aws::BedrockRuntime
1236
1243
  # service_tier: {
1237
1244
  # type: "priority", # required, accepts priority, default, flex, reserved
1238
1245
  # },
1246
+ # output_config: {
1247
+ # text_format: {
1248
+ # type: "json_schema", # required, accepts json_schema
1249
+ # structure: { # required
1250
+ # json_schema: {
1251
+ # schema: "String", # required
1252
+ # name: "String",
1253
+ # description: "String",
1254
+ # },
1255
+ # },
1256
+ # },
1257
+ # },
1239
1258
  # })
1240
1259
  #
1241
1260
  # @example Response structure
@@ -1305,6 +1324,7 @@ module Aws::BedrockRuntime
1305
1324
  # resp.output.message.content[0].guard_content.image.format #=> String, one of "png", "jpeg"
1306
1325
  # resp.output.message.content[0].guard_content.image.source.bytes #=> String
1307
1326
  # resp.output.message.content[0].cache_point.type #=> String, one of "default"
1327
+ # resp.output.message.content[0].cache_point.ttl #=> String, one of "5m", "1h"
1308
1328
  # resp.output.message.content[0].reasoning_content.reasoning_text.text #=> String
1309
1329
  # resp.output.message.content[0].reasoning_content.reasoning_text.signature #=> String
1310
1330
  # resp.output.message.content[0].reasoning_content.redacted_content #=> String
@@ -1340,6 +1360,9 @@ module Aws::BedrockRuntime
1340
1360
  # resp.usage.total_tokens #=> Integer
1341
1361
  # resp.usage.cache_read_input_tokens #=> Integer
1342
1362
  # resp.usage.cache_write_input_tokens #=> Integer
1363
+ # resp.usage.cache_details #=> Array
1364
+ # resp.usage.cache_details[0].ttl #=> String, one of "5m", "1h"
1365
+ # resp.usage.cache_details[0].input_tokens #=> Integer
1343
1366
  # resp.metrics.latency_ms #=> Integer
1344
1367
  # resp.trace.guardrail.model_output #=> Array
1345
1368
  # resp.trace.guardrail.model_output[0] #=> String
@@ -1877,6 +1900,9 @@ module Aws::BedrockRuntime
1877
1900
  # Specifies the processing tier configuration used for serving the
1878
1901
  # request.
1879
1902
  #
1903
+ # @option params [Types::OutputConfig] :output_config
1904
+ # Output configuration for a model response.
1905
+ #
1880
1906
  # @return [Types::ConverseStreamResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1881
1907
  #
1882
1908
  # * {Types::ConverseStreamResponse#stream #stream} => Types::ConverseStreamOutput
@@ -2216,6 +2242,7 @@ module Aws::BedrockRuntime
2216
2242
  # },
2217
2243
  # cache_point: {
2218
2244
  # type: "default", # required, accepts default
2245
+ # ttl: "5m", # accepts 5m, 1h
2219
2246
  # },
2220
2247
  # reasoning_content: {
2221
2248
  # reasoning_text: {
@@ -2301,6 +2328,7 @@ module Aws::BedrockRuntime
2301
2328
  # },
2302
2329
  # cache_point: {
2303
2330
  # type: "default", # required, accepts default
2331
+ # ttl: "5m", # accepts 5m, 1h
2304
2332
  # },
2305
2333
  # },
2306
2334
  # ],
@@ -2320,12 +2348,14 @@ module Aws::BedrockRuntime
2320
2348
  # json: {
2321
2349
  # },
2322
2350
  # },
2351
+ # strict: false,
2323
2352
  # },
2324
2353
  # system_tool: {
2325
2354
  # name: "ToolName", # required
2326
2355
  # },
2327
2356
  # cache_point: {
2328
2357
  # type: "default", # required, accepts default
2358
+ # ttl: "5m", # accepts 5m, 1h
2329
2359
  # },
2330
2360
  # },
2331
2361
  # ],
@@ -2362,6 +2392,18 @@ module Aws::BedrockRuntime
2362
2392
  # service_tier: {
2363
2393
  # type: "priority", # required, accepts priority, default, flex, reserved
2364
2394
  # },
2395
+ # output_config: {
2396
+ # text_format: {
2397
+ # type: "json_schema", # required, accepts json_schema
2398
+ # structure: { # required
2399
+ # json_schema: {
2400
+ # schema: "String", # required
2401
+ # name: "String",
2402
+ # description: "String",
2403
+ # },
2404
+ # },
2405
+ # },
2406
+ # },
2365
2407
  # })
2366
2408
  #
2367
2409
  # @example Response structure
@@ -2427,6 +2469,9 @@ module Aws::BedrockRuntime
2427
2469
  # event.usage.total_tokens #=> Integer
2428
2470
  # event.usage.cache_read_input_tokens #=> Integer
2429
2471
  # event.usage.cache_write_input_tokens #=> Integer
2472
+ # event.usage.cache_details #=> Array
2473
+ # event.usage.cache_details[0].ttl #=> String, one of "5m", "1h"
2474
+ # event.usage.cache_details[0].input_tokens #=> Integer
2430
2475
  # event.metrics.latency_ms #=> Integer
2431
2476
  # event.trace.guardrail.model_output #=> Array
2432
2477
  # event.trace.guardrail.model_output[0] #=> String
@@ -3031,6 +3076,7 @@ module Aws::BedrockRuntime
3031
3076
  # },
3032
3077
  # cache_point: {
3033
3078
  # type: "default", # required, accepts default
3079
+ # ttl: "5m", # accepts 5m, 1h
3034
3080
  # },
3035
3081
  # reasoning_content: {
3036
3082
  # reasoning_text: {
@@ -3116,6 +3162,7 @@ module Aws::BedrockRuntime
3116
3162
  # },
3117
3163
  # cache_point: {
3118
3164
  # type: "default", # required, accepts default
3165
+ # ttl: "5m", # accepts 5m, 1h
3119
3166
  # },
3120
3167
  # },
3121
3168
  # ],
@@ -3129,12 +3176,14 @@ module Aws::BedrockRuntime
3129
3176
  # json: {
3130
3177
  # },
3131
3178
  # },
3179
+ # strict: false,
3132
3180
  # },
3133
3181
  # system_tool: {
3134
3182
  # name: "ToolName", # required
3135
3183
  # },
3136
3184
  # cache_point: {
3137
3185
  # type: "default", # required, accepts default
3186
+ # ttl: "5m", # accepts 5m, 1h
3138
3187
  # },
3139
3188
  # },
3140
3189
  # ],
@@ -3877,7 +3926,7 @@ module Aws::BedrockRuntime
3877
3926
  tracer: tracer
3878
3927
  )
3879
3928
  context[:gem_name] = 'aws-sdk-bedrockruntime'
3880
- context[:gem_version] = '1.71.0'
3929
+ context[:gem_version] = '1.73.0'
3881
3930
  Seahorse::Client::Request.new(handlers, context)
3882
3931
  end
3883
3932
 
@@ -40,8 +40,12 @@ module Aws::BedrockRuntime
40
40
  Blob = Shapes::BlobShape.new(name: 'Blob')
41
41
  Body = Shapes::BlobShape.new(name: 'Body')
42
42
  Boolean = Shapes::BooleanShape.new(name: 'Boolean')
43
+ CacheDetail = Shapes::StructureShape.new(name: 'CacheDetail')
44
+ CacheDetailInputTokensInteger = Shapes::IntegerShape.new(name: 'CacheDetailInputTokensInteger')
45
+ CacheDetailsList = Shapes::ListShape.new(name: 'CacheDetailsList')
43
46
  CachePointBlock = Shapes::StructureShape.new(name: 'CachePointBlock')
44
47
  CachePointType = Shapes::StringShape.new(name: 'CachePointType')
48
+ CacheTTL = Shapes::StringShape.new(name: 'CacheTTL')
45
49
  Citation = Shapes::StructureShape.new(name: 'Citation')
46
50
  CitationGeneratedContent = Shapes::UnionShape.new(name: 'CitationGeneratedContent')
47
51
  CitationGeneratedContentList = Shapes::ListShape.new(name: 'CitationGeneratedContentList')
@@ -249,6 +253,7 @@ module Aws::BedrockRuntime
249
253
  InvokeModelWithResponseStreamRequest = Shapes::StructureShape.new(name: 'InvokeModelWithResponseStreamRequest')
250
254
  InvokeModelWithResponseStreamResponse = Shapes::StructureShape.new(name: 'InvokeModelWithResponseStreamResponse')
251
255
  InvokedModelId = Shapes::StringShape.new(name: 'InvokedModelId')
256
+ JsonSchemaDefinition = Shapes::StructureShape.new(name: 'JsonSchemaDefinition')
252
257
  KmsKeyId = Shapes::StringShape.new(name: 'KmsKeyId')
253
258
  ListAsyncInvokesRequest = Shapes::StructureShape.new(name: 'ListAsyncInvokesRequest')
254
259
  ListAsyncInvokesResponse = Shapes::StructureShape.new(name: 'ListAsyncInvokesResponse')
@@ -268,6 +273,10 @@ module Aws::BedrockRuntime
268
273
  NonBlankString = Shapes::StringShape.new(name: 'NonBlankString')
269
274
  NonEmptyString = Shapes::StringShape.new(name: 'NonEmptyString')
270
275
  NonNegativeInteger = Shapes::IntegerShape.new(name: 'NonNegativeInteger')
276
+ OutputConfig = Shapes::StructureShape.new(name: 'OutputConfig')
277
+ OutputFormat = Shapes::StructureShape.new(name: 'OutputFormat')
278
+ OutputFormatStructure = Shapes::UnionShape.new(name: 'OutputFormatStructure')
279
+ OutputFormatType = Shapes::StringShape.new(name: 'OutputFormatType')
271
280
  PaginationToken = Shapes::StringShape.new(name: 'PaginationToken')
272
281
  PartBody = Shapes::BlobShape.new(name: 'PartBody')
273
282
  PayloadPart = Shapes::StructureShape.new(name: 'PayloadPart')
@@ -421,7 +430,14 @@ module Aws::BedrockRuntime
421
430
  BidirectionalOutputPayloadPart.add_member(:bytes, Shapes::ShapeRef.new(shape: PartBody, location_name: "bytes"))
422
431
  BidirectionalOutputPayloadPart.struct_class = Types::BidirectionalOutputPayloadPart
423
432
 
433
+ CacheDetail.add_member(:ttl, Shapes::ShapeRef.new(shape: CacheTTL, required: true, location_name: "ttl"))
434
+ CacheDetail.add_member(:input_tokens, Shapes::ShapeRef.new(shape: CacheDetailInputTokensInteger, required: true, location_name: "inputTokens"))
435
+ CacheDetail.struct_class = Types::CacheDetail
436
+
437
+ CacheDetailsList.member = Shapes::ShapeRef.new(shape: CacheDetail)
438
+
424
439
  CachePointBlock.add_member(:type, Shapes::ShapeRef.new(shape: CachePointType, required: true, location_name: "type"))
440
+ CachePointBlock.add_member(:ttl, Shapes::ShapeRef.new(shape: CacheTTL, location_name: "ttl"))
425
441
  CachePointBlock.struct_class = Types::CachePointBlock
426
442
 
427
443
  Citation.add_member(:title, Shapes::ShapeRef.new(shape: String, location_name: "title"))
@@ -571,6 +587,7 @@ module Aws::BedrockRuntime
571
587
  ConverseRequest.add_member(:request_metadata, Shapes::ShapeRef.new(shape: RequestMetadata, location_name: "requestMetadata"))
572
588
  ConverseRequest.add_member(:performance_config, Shapes::ShapeRef.new(shape: PerformanceConfiguration, location_name: "performanceConfig"))
573
589
  ConverseRequest.add_member(:service_tier, Shapes::ShapeRef.new(shape: ServiceTier, location_name: "serviceTier"))
590
+ ConverseRequest.add_member(:output_config, Shapes::ShapeRef.new(shape: OutputConfig, location_name: "outputConfig"))
574
591
  ConverseRequest.struct_class = Types::ConverseRequest
575
592
 
576
593
  ConverseRequestAdditionalModelResponseFieldPathsList.member = Shapes::ShapeRef.new(shape: ConverseRequestAdditionalModelResponseFieldPathsListMemberString)
@@ -620,6 +637,7 @@ module Aws::BedrockRuntime
620
637
  ConverseStreamRequest.add_member(:request_metadata, Shapes::ShapeRef.new(shape: RequestMetadata, location_name: "requestMetadata"))
621
638
  ConverseStreamRequest.add_member(:performance_config, Shapes::ShapeRef.new(shape: PerformanceConfiguration, location_name: "performanceConfig"))
622
639
  ConverseStreamRequest.add_member(:service_tier, Shapes::ShapeRef.new(shape: ServiceTier, location_name: "serviceTier"))
640
+ ConverseStreamRequest.add_member(:output_config, Shapes::ShapeRef.new(shape: OutputConfig, location_name: "outputConfig"))
623
641
  ConverseStreamRequest.struct_class = Types::ConverseStreamRequest
624
642
 
625
643
  ConverseStreamRequestAdditionalModelResponseFieldPathsList.member = Shapes::ShapeRef.new(shape: ConverseStreamRequestAdditionalModelResponseFieldPathsListMemberString)
@@ -1105,6 +1123,11 @@ module Aws::BedrockRuntime
1105
1123
  InvokeModelWithResponseStreamResponse[:payload] = :body
1106
1124
  InvokeModelWithResponseStreamResponse[:payload_member] = InvokeModelWithResponseStreamResponse.member(:body)
1107
1125
 
1126
+ JsonSchemaDefinition.add_member(:schema, Shapes::ShapeRef.new(shape: String, required: true, location_name: "schema"))
1127
+ JsonSchemaDefinition.add_member(:name, Shapes::ShapeRef.new(shape: String, location_name: "name"))
1128
+ JsonSchemaDefinition.add_member(:description, Shapes::ShapeRef.new(shape: String, location_name: "description"))
1129
+ JsonSchemaDefinition.struct_class = Types::JsonSchemaDefinition
1130
+
1108
1131
  ListAsyncInvokesRequest.add_member(:submit_time_after, Shapes::ShapeRef.new(shape: Timestamp, location: "querystring", location_name: "submitTimeAfter"))
1109
1132
  ListAsyncInvokesRequest.add_member(:submit_time_before, Shapes::ShapeRef.new(shape: Timestamp, location: "querystring", location_name: "submitTimeBefore"))
1110
1133
  ListAsyncInvokesRequest.add_member(:status_equals, Shapes::ShapeRef.new(shape: AsyncInvokeStatus, location: "querystring", location_name: "statusEquals"))
@@ -1149,6 +1172,19 @@ module Aws::BedrockRuntime
1149
1172
  ModelTimeoutException.add_member(:message, Shapes::ShapeRef.new(shape: NonBlankString, location_name: "message"))
1150
1173
  ModelTimeoutException.struct_class = Types::ModelTimeoutException
1151
1174
 
1175
+ OutputConfig.add_member(:text_format, Shapes::ShapeRef.new(shape: OutputFormat, location_name: "textFormat"))
1176
+ OutputConfig.struct_class = Types::OutputConfig
1177
+
1178
+ OutputFormat.add_member(:type, Shapes::ShapeRef.new(shape: OutputFormatType, required: true, location_name: "type"))
1179
+ OutputFormat.add_member(:structure, Shapes::ShapeRef.new(shape: OutputFormatStructure, required: true, location_name: "structure"))
1180
+ OutputFormat.struct_class = Types::OutputFormat
1181
+
1182
+ OutputFormatStructure.add_member(:json_schema, Shapes::ShapeRef.new(shape: JsonSchemaDefinition, location_name: "jsonSchema"))
1183
+ OutputFormatStructure.add_member(:unknown, Shapes::ShapeRef.new(shape: nil, location_name: 'unknown'))
1184
+ OutputFormatStructure.add_member_subclass(:json_schema, Types::OutputFormatStructure::JsonSchema)
1185
+ OutputFormatStructure.add_member_subclass(:unknown, Types::OutputFormatStructure::Unknown)
1186
+ OutputFormatStructure.struct_class = Types::OutputFormatStructure
1187
+
1152
1188
  PayloadPart.add_member(:bytes, Shapes::ShapeRef.new(shape: PartBody, location_name: "bytes"))
1153
1189
  PayloadPart.struct_class = Types::PayloadPart
1154
1190
 
@@ -1275,6 +1311,7 @@ module Aws::BedrockRuntime
1275
1311
  TokenUsage.add_member(:total_tokens, Shapes::ShapeRef.new(shape: TokenUsageTotalTokensInteger, required: true, location_name: "totalTokens"))
1276
1312
  TokenUsage.add_member(:cache_read_input_tokens, Shapes::ShapeRef.new(shape: TokenUsageCacheReadInputTokensInteger, location_name: "cacheReadInputTokens"))
1277
1313
  TokenUsage.add_member(:cache_write_input_tokens, Shapes::ShapeRef.new(shape: TokenUsageCacheWriteInputTokensInteger, location_name: "cacheWriteInputTokens"))
1314
+ TokenUsage.add_member(:cache_details, Shapes::ShapeRef.new(shape: CacheDetailsList, location_name: "cacheDetails"))
1278
1315
  TokenUsage.struct_class = Types::TokenUsage
1279
1316
 
1280
1317
  Tool.add_member(:tool_spec, Shapes::ShapeRef.new(shape: ToolSpecification, location_name: "toolSpec"))
@@ -1351,6 +1388,7 @@ module Aws::BedrockRuntime
1351
1388
  ToolSpecification.add_member(:name, Shapes::ShapeRef.new(shape: ToolName, required: true, location_name: "name"))
1352
1389
  ToolSpecification.add_member(:description, Shapes::ShapeRef.new(shape: NonEmptyString, location_name: "description"))
1353
1390
  ToolSpecification.add_member(:input_schema, Shapes::ShapeRef.new(shape: ToolInputSchema, required: true, location_name: "inputSchema"))
1391
+ ToolSpecification.add_member(:strict, Shapes::ShapeRef.new(shape: Boolean, location_name: "strict"))
1354
1392
  ToolSpecification.struct_class = Types::ToolSpecification
1355
1393
 
1356
1394
  ToolUseBlock.add_member(:tool_use_id, Shapes::ShapeRef.new(shape: ToolUseId, required: true, location_name: "toolUseId"))
@@ -372,6 +372,26 @@ module Aws::BedrockRuntime
372
372
  include Aws::Structure
373
373
  end
374
374
 
375
+ # Cache creation metrics for a specific TTL duration
376
+ #
377
+ # @!attribute [rw] ttl
378
+ # TTL duration for these cached tokens
379
+ # @return [String]
380
+ #
381
+ # @!attribute [rw] input_tokens
382
+ # Number of tokens written to cache with this TTL (cache creation
383
+ # tokens)
384
+ # @return [Integer]
385
+ #
386
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/CacheDetail AWS API Documentation
387
+ #
388
+ class CacheDetail < Struct.new(
389
+ :ttl,
390
+ :input_tokens)
391
+ SENSITIVE = []
392
+ include Aws::Structure
393
+ end
394
+
375
395
  # Defines a section of content to be cached for reuse in subsequent API
376
396
  # calls.
377
397
  #
@@ -379,10 +399,17 @@ module Aws::BedrockRuntime
379
399
  # Specifies the type of cache point within the CachePointBlock.
380
400
  # @return [String]
381
401
  #
402
+ # @!attribute [rw] ttl
403
+ # Optional TTL duration for cache entries. When specified, enables
404
+ # extended TTL caching with the specified duration. When omitted, uses
405
+ # `type` value for caching behavior.
406
+ # @return [String]
407
+ #
382
408
  # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/CachePointBlock AWS API Documentation
383
409
  #
384
410
  class CachePointBlock < Struct.new(
385
- :type)
411
+ :type,
412
+ :ttl)
386
413
  SENSITIVE = []
387
414
  include Aws::Structure
388
415
  end
@@ -1059,6 +1086,10 @@ module Aws::BedrockRuntime
1059
1086
  # request.
1060
1087
  # @return [Types::ServiceTier]
1061
1088
  #
1089
+ # @!attribute [rw] output_config
1090
+ # Output configuration for a model response.
1091
+ # @return [Types::OutputConfig]
1092
+ #
1062
1093
  # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/ConverseRequest AWS API Documentation
1063
1094
  #
1064
1095
  class ConverseRequest < Struct.new(
@@ -1073,7 +1104,8 @@ module Aws::BedrockRuntime
1073
1104
  :additional_model_response_field_paths,
1074
1105
  :request_metadata,
1075
1106
  :performance_config,
1076
- :service_tier)
1107
+ :service_tier,
1108
+ :output_config)
1077
1109
  SENSITIVE = [:prompt_variables, :request_metadata]
1078
1110
  include Aws::Structure
1079
1111
  end
@@ -1314,6 +1346,10 @@ module Aws::BedrockRuntime
1314
1346
  # request.
1315
1347
  # @return [Types::ServiceTier]
1316
1348
  #
1349
+ # @!attribute [rw] output_config
1350
+ # Output configuration for a model response.
1351
+ # @return [Types::OutputConfig]
1352
+ #
1317
1353
  # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/ConverseStreamRequest AWS API Documentation
1318
1354
  #
1319
1355
  class ConverseStreamRequest < Struct.new(
@@ -1328,7 +1364,8 @@ module Aws::BedrockRuntime
1328
1364
  :additional_model_response_field_paths,
1329
1365
  :request_metadata,
1330
1366
  :performance_config,
1331
- :service_tier)
1367
+ :service_tier,
1368
+ :output_config)
1332
1369
  SENSITIVE = [:prompt_variables, :request_metadata]
1333
1370
  include Aws::Structure
1334
1371
  end
@@ -3559,6 +3596,35 @@ module Aws::BedrockRuntime
3559
3596
  include Aws::Structure
3560
3597
  end
3561
3598
 
3599
+ # JSON schema structured output format options.
3600
+ #
3601
+ # @!attribute [rw] schema
3602
+ # The JSON schema to constrain the model's output. For more
3603
+ # information, see [JSON Schema Reference][1].
3604
+ #
3605
+ #
3606
+ #
3607
+ # [1]: https://json-schema.org/understanding-json-schema/reference
3608
+ # @return [String]
3609
+ #
3610
+ # @!attribute [rw] name
3611
+ # The name of the JSON schema.
3612
+ # @return [String]
3613
+ #
3614
+ # @!attribute [rw] description
3615
+ # A description of the JSON schema.
3616
+ # @return [String]
3617
+ #
3618
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/JsonSchemaDefinition AWS API Documentation
3619
+ #
3620
+ class JsonSchemaDefinition < Struct.new(
3621
+ :schema,
3622
+ :name,
3623
+ :description)
3624
+ SENSITIVE = []
3625
+ include Aws::Structure
3626
+ end
3627
+
3562
3628
  # @!attribute [rw] submit_time_after
3563
3629
  # Include invocations submitted after this time.
3564
3630
  # @return [Time]
@@ -3774,6 +3840,66 @@ module Aws::BedrockRuntime
3774
3840
  include Aws::Structure
3775
3841
  end
3776
3842
 
3843
+ # Output configuration for a model response in a call to [Converse][1]
3844
+ # or [ConverseStream][2].
3845
+ #
3846
+ #
3847
+ #
3848
+ # [1]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html
3849
+ # [2]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_ConverseStream.html
3850
+ #
3851
+ # @!attribute [rw] text_format
3852
+ # Structured output parameters to control the model's text response.
3853
+ # @return [Types::OutputFormat]
3854
+ #
3855
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/OutputConfig AWS API Documentation
3856
+ #
3857
+ class OutputConfig < Struct.new(
3858
+ :text_format)
3859
+ SENSITIVE = []
3860
+ include Aws::Structure
3861
+ end
3862
+
3863
+ # Structured output parameters to control the model's response.
3864
+ #
3865
+ # @!attribute [rw] type
3866
+ # The type of structured output format.
3867
+ # @return [String]
3868
+ #
3869
+ # @!attribute [rw] structure
3870
+ # The structure that the model's output must adhere to.
3871
+ # @return [Types::OutputFormatStructure]
3872
+ #
3873
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/OutputFormat AWS API Documentation
3874
+ #
3875
+ class OutputFormat < Struct.new(
3876
+ :type,
3877
+ :structure)
3878
+ SENSITIVE = [:structure]
3879
+ include Aws::Structure
3880
+ end
3881
+
3882
+ # The structure that the model's output must adhere to.
3883
+ #
3884
+ # @note OutputFormatStructure is a union - when making an API calls you must set exactly one of the members.
3885
+ #
3886
+ # @!attribute [rw] json_schema
3887
+ # A JSON schema structure that the model's output must adhere to.
3888
+ # @return [Types::JsonSchemaDefinition]
3889
+ #
3890
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/OutputFormatStructure AWS API Documentation
3891
+ #
3892
+ class OutputFormatStructure < Struct.new(
3893
+ :json_schema,
3894
+ :unknown)
3895
+ SENSITIVE = []
3896
+ include Aws::Structure
3897
+ include Aws::Structure::Union
3898
+
3899
+ class JsonSchema < OutputFormatStructure; end
3900
+ class Unknown < OutputFormatStructure; end
3901
+ end
3902
+
3777
3903
  # Payload content included in the response.
3778
3904
  #
3779
3905
  # @!attribute [rw] bytes
@@ -4304,6 +4430,11 @@ module Aws::BedrockRuntime
4304
4430
  # The number of input tokens written to the cache for the request.
4305
4431
  # @return [Integer]
4306
4432
  #
4433
+ # @!attribute [rw] cache_details
4434
+ # Detailed breakdown of cache writes by TTL. Empty if no cache
4435
+ # creation occurred. Sorted by TTL duration (1h before 5m).
4436
+ # @return [Array<Types::CacheDetail>]
4437
+ #
4307
4438
  # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/TokenUsage AWS API Documentation
4308
4439
  #
4309
4440
  class TokenUsage < Struct.new(
@@ -4311,7 +4442,8 @@ module Aws::BedrockRuntime
4311
4442
  :output_tokens,
4312
4443
  :total_tokens,
4313
4444
  :cache_read_input_tokens,
4314
- :cache_write_input_tokens)
4445
+ :cache_write_input_tokens,
4446
+ :cache_details)
4315
4447
  SENSITIVE = []
4316
4448
  include Aws::Structure
4317
4449
  end
@@ -4639,12 +4771,18 @@ module Aws::BedrockRuntime
4639
4771
  # The input schema for the tool in JSON format.
4640
4772
  # @return [Types::ToolInputSchema]
4641
4773
  #
4774
+ # @!attribute [rw] strict
4775
+ # Flag to enable structured output enforcement on a tool usage
4776
+ # response.
4777
+ # @return [Boolean]
4778
+ #
4642
4779
  # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/ToolSpecification AWS API Documentation
4643
4780
  #
4644
4781
  class ToolSpecification < Struct.new(
4645
4782
  :name,
4646
4783
  :description,
4647
- :input_schema)
4784
+ :input_schema,
4785
+ :strict)
4648
4786
  SENSITIVE = []
4649
4787
  include Aws::Structure
4650
4788
  end
@@ -73,7 +73,7 @@ module Aws::BedrockRuntime
73
73
  autoload :AsyncClient, 'aws-sdk-bedrockruntime/async_client'
74
74
  autoload :EventStreams, 'aws-sdk-bedrockruntime/event_streams'
75
75
 
76
- GEM_VERSION = '1.71.0'
76
+ GEM_VERSION = '1.73.0'
77
77
 
78
78
  end
79
79
 
data/sig/client.rbs CHANGED
@@ -278,7 +278,8 @@ module Aws
278
278
  }?
279
279
  }?,
280
280
  cache_point: {
281
- type: ("default")
281
+ type: ("default"),
282
+ ttl: ("5m" | "1h")?
282
283
  }?,
283
284
  reasoning_content: {
284
285
  reasoning_text: {
@@ -363,7 +364,8 @@ module Aws
363
364
  }?
364
365
  }?,
365
366
  cache_point: {
366
- type: ("default")
367
+ type: ("default"),
368
+ ttl: ("5m" | "1h")?
367
369
  }?
368
370
  },
369
371
  ],
@@ -382,13 +384,15 @@ module Aws
382
384
  input_schema: {
383
385
  json: {
384
386
  }?
385
- }
387
+ },
388
+ strict: bool?
386
389
  }?,
387
390
  system_tool: {
388
391
  name: ::String
389
392
  }?,
390
393
  cache_point: {
391
- type: ("default")
394
+ type: ("default"),
395
+ ttl: ("5m" | "1h")?
392
396
  }?
393
397
  },
394
398
  ],
@@ -419,6 +423,18 @@ module Aws
419
423
  },
420
424
  ?service_tier: {
421
425
  type: ("priority" | "default" | "flex" | "reserved")
426
+ },
427
+ ?output_config: {
428
+ text_format: {
429
+ type: ("json_schema"),
430
+ structure: {
431
+ json_schema: {
432
+ schema: ::String,
433
+ name: ::String?,
434
+ description: ::String?
435
+ }?
436
+ }
437
+ }?
422
438
  }
423
439
  ) -> _ConverseResponseSuccess
424
440
  | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _ConverseResponseSuccess
@@ -581,7 +597,8 @@ module Aws
581
597
  }?
582
598
  }?,
583
599
  cache_point: {
584
- type: ("default")
600
+ type: ("default"),
601
+ ttl: ("5m" | "1h")?
585
602
  }?,
586
603
  reasoning_content: {
587
604
  reasoning_text: {
@@ -666,7 +683,8 @@ module Aws
666
683
  }?
667
684
  }?,
668
685
  cache_point: {
669
- type: ("default")
686
+ type: ("default"),
687
+ ttl: ("5m" | "1h")?
670
688
  }?
671
689
  },
672
690
  ],
@@ -685,13 +703,15 @@ module Aws
685
703
  input_schema: {
686
704
  json: {
687
705
  }?
688
- }
706
+ },
707
+ strict: bool?
689
708
  }?,
690
709
  system_tool: {
691
710
  name: ::String
692
711
  }?,
693
712
  cache_point: {
694
- type: ("default")
713
+ type: ("default"),
714
+ ttl: ("5m" | "1h")?
695
715
  }?
696
716
  },
697
717
  ],
@@ -723,6 +743,18 @@ module Aws
723
743
  },
724
744
  ?service_tier: {
725
745
  type: ("priority" | "default" | "flex" | "reserved")
746
+ },
747
+ ?output_config: {
748
+ text_format: {
749
+ type: ("json_schema"),
750
+ structure: {
751
+ json_schema: {
752
+ schema: ::String,
753
+ name: ::String?,
754
+ description: ::String?
755
+ }?
756
+ }
757
+ }?
726
758
  }
727
759
  ) ?{ (*untyped) -> void } -> _ConverseStreamResponseSuccess
728
760
  | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) ?{ (*untyped) -> void } -> _ConverseStreamResponseSuccess
@@ -890,7 +922,8 @@ module Aws
890
922
  }?
891
923
  }?,
892
924
  cache_point: {
893
- type: ("default")
925
+ type: ("default"),
926
+ ttl: ("5m" | "1h")?
894
927
  }?,
895
928
  reasoning_content: {
896
929
  reasoning_text: {
@@ -975,7 +1008,8 @@ module Aws
975
1008
  }?
976
1009
  }?,
977
1010
  cache_point: {
978
- type: ("default")
1011
+ type: ("default"),
1012
+ ttl: ("5m" | "1h")?
979
1013
  }?
980
1014
  },
981
1015
  ]?,
@@ -988,13 +1022,15 @@ module Aws
988
1022
  input_schema: {
989
1023
  json: {
990
1024
  }?
991
- }
1025
+ },
1026
+ strict: bool?
992
1027
  }?,
993
1028
  system_tool: {
994
1029
  name: ::String
995
1030
  }?,
996
1031
  cache_point: {
997
- type: ("default")
1032
+ type: ("default"),
1033
+ ttl: ("5m" | "1h")?
998
1034
  }?
999
1035
  },
1000
1036
  ],
data/sig/types.rbs CHANGED
@@ -111,8 +111,15 @@ module Aws::BedrockRuntime
111
111
  SENSITIVE: [:bytes]
112
112
  end
113
113
 
114
+ class CacheDetail
115
+ attr_accessor ttl: ("5m" | "1h")
116
+ attr_accessor input_tokens: ::Integer
117
+ SENSITIVE: []
118
+ end
119
+
114
120
  class CachePointBlock
115
121
  attr_accessor type: ("default")
122
+ attr_accessor ttl: ("5m" | "1h")
116
123
  SENSITIVE: []
117
124
  end
118
125
 
@@ -334,6 +341,7 @@ module Aws::BedrockRuntime
334
341
  attr_accessor request_metadata: ::Hash[::String, ::String]
335
342
  attr_accessor performance_config: Types::PerformanceConfiguration
336
343
  attr_accessor service_tier: Types::ServiceTier
344
+ attr_accessor output_config: Types::OutputConfig
337
345
  SENSITIVE: [:prompt_variables, :request_metadata]
338
346
  end
339
347
 
@@ -377,6 +385,7 @@ module Aws::BedrockRuntime
377
385
  attr_accessor request_metadata: ::Hash[::String, ::String]
378
386
  attr_accessor performance_config: Types::PerformanceConfiguration
379
387
  attr_accessor service_tier: Types::ServiceTier
388
+ attr_accessor output_config: Types::OutputConfig
380
389
  SENSITIVE: [:prompt_variables, :request_metadata]
381
390
  end
382
391
 
@@ -974,6 +983,13 @@ module Aws::BedrockRuntime
974
983
  SENSITIVE: []
975
984
  end
976
985
 
986
+ class JsonSchemaDefinition
987
+ attr_accessor schema: ::String
988
+ attr_accessor name: ::String
989
+ attr_accessor description: ::String
990
+ SENSITIVE: []
991
+ end
992
+
977
993
  class ListAsyncInvokesRequest
978
994
  attr_accessor submit_time_after: ::Time
979
995
  attr_accessor submit_time_before: ::Time
@@ -1036,6 +1052,28 @@ module Aws::BedrockRuntime
1036
1052
  SENSITIVE: []
1037
1053
  end
1038
1054
 
1055
+ class OutputConfig
1056
+ attr_accessor text_format: Types::OutputFormat
1057
+ SENSITIVE: []
1058
+ end
1059
+
1060
+ class OutputFormat
1061
+ attr_accessor type: ("json_schema")
1062
+ attr_accessor structure: Types::OutputFormatStructure
1063
+ SENSITIVE: [:structure]
1064
+ end
1065
+
1066
+ class OutputFormatStructure
1067
+ attr_accessor json_schema: Types::JsonSchemaDefinition
1068
+ attr_accessor unknown: untyped
1069
+ SENSITIVE: []
1070
+
1071
+ class JsonSchema < OutputFormatStructure
1072
+ end
1073
+ class Unknown < OutputFormatStructure
1074
+ end
1075
+ end
1076
+
1039
1077
  class PayloadPart
1040
1078
  attr_accessor bytes: ::String
1041
1079
  attr_accessor event_type: untyped
@@ -1206,6 +1244,7 @@ module Aws::BedrockRuntime
1206
1244
  attr_accessor total_tokens: ::Integer
1207
1245
  attr_accessor cache_read_input_tokens: ::Integer
1208
1246
  attr_accessor cache_write_input_tokens: ::Integer
1247
+ attr_accessor cache_details: ::Array[Types::CacheDetail]
1209
1248
  SENSITIVE: []
1210
1249
  end
1211
1250
 
@@ -1319,6 +1358,7 @@ module Aws::BedrockRuntime
1319
1358
  attr_accessor name: ::String
1320
1359
  attr_accessor description: ::String
1321
1360
  attr_accessor input_schema: Types::ToolInputSchema
1361
+ attr_accessor strict: bool
1322
1362
  SENSITIVE: []
1323
1363
  end
1324
1364
 
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-bedrockruntime
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.71.0
4
+ version: 1.73.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services