aws-sdk-bedrockruntime 1.62.0 → 1.63.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1710612a0509a4726ba77860cf5876e3e20d75750787d6105693aa6544b8c631
-  data.tar.gz: a8332153ff0fa32f91667bdb2707f249d967bbc344f61cc19f6a8bb57020cc6f
+  metadata.gz: 1fe16e2649f933ef98cdc035603ca5f167ae32c71e88136a677aa824cd284e1c
+  data.tar.gz: '0289147ef1de7850c00b77fbe2fd98a739607bbb39223a3f0f134321cc691fa4'
 SHA512:
-  metadata.gz: a7c07dee2bd6b2d0cc350a4187a59b2852cf37e9171291b497a816f57e653dc4ee895c2c36877816442264f5a22932d21786b6d1b8d2fbf667e54dfa8ad42f6a
-  data.tar.gz: fc759fd66f13e3d54bcab377e9b2db830cb9d82d5b67148d461ac4bf5c897b570c307b36120aae90c8b254b727e20dd5cb61a75d34f313f42e010e5237598aaa
+  metadata.gz: 3c5cfdc5e1e81b0c6a5e2a6ada0bc3d497e1f5d0a63177eef3570f36cb641eaa700ceec9e8d043044f80f5cf2026ab6536b3a54ef66c5ea102ca0eaaa1d16836
+  data.tar.gz: 94521450d807e8516e97de7e68d0a62de0a622b8f929d1b9aa394ca59a2f11318fd01adc8e7d1379cba1fc00e208b8c4d0ec58c4c3370113deebd81a9a8a47f9

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.63.0 (2025-10-29)
+------------------
+
+* Feature - Add support for system tool and web citation response.
+
 1.62.0 (2025-10-28)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.62.0
+1.63.0

data/lib/aws-sdk-bedrockruntime/async_client.rb

@@ -621,7 +621,7 @@ module Aws::BedrockRuntime
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-bedrockruntime'
-      context[:gem_version] = '1.62.0'
+      context[:gem_version] = '1.63.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-bedrockruntime/client.rb

@@ -980,6 +980,7 @@ module Aws::BedrockRuntime
     #               name: "ToolName", # required
     #               input: { # required
     #               },
+    #               type: "server_tool_use", # accepts server_tool_use
     #             },
     #             tool_result: {
     #               tool_use_id: "ToolUseId", # required
@@ -1032,6 +1033,7 @@ module Aws::BedrockRuntime
     #                 },
     #               ],
     #               status: "success", # accepts success, error
+    #               type: "String",
     #             },
     #             guard_content: {
     #               text: {
@@ -1070,6 +1072,10 @@ module Aws::BedrockRuntime
     #                     },
     #                   ],
     #                   location: {
+    #                     web: {
+    #                       url: "String",
+    #                       domain: "String",
+    #                     },
     #                     document_char: {
     #                       document_index: 1,
     #                       start: 1,
@@ -1130,6 +1136,9 @@ module Aws::BedrockRuntime
     #               },
     #             },
     #           },
+    #           system_tool: {
+    #             name: "ToolName", # required
+    #           },
     #           cache_point: {
     #             type: "default", # required, accepts default
     #           },
@@ -1191,6 +1200,7 @@ module Aws::BedrockRuntime
     #   resp.output.message.content[0].video.source.s3_location.bucket_owner #=> String
     #   resp.output.message.content[0].tool_use.tool_use_id #=> String
     #   resp.output.message.content[0].tool_use.name #=> String
+    #   resp.output.message.content[0].tool_use.type #=> String, one of "server_tool_use"
     #   resp.output.message.content[0].tool_result.tool_use_id #=> String
     #   resp.output.message.content[0].tool_result.content #=> Array
     #   resp.output.message.content[0].tool_result.content[0].text #=> String
@@ -1213,6 +1223,7 @@ module Aws::BedrockRuntime
     #   resp.output.message.content[0].tool_result.content[0].video.source.s3_location.uri #=> String
     #   resp.output.message.content[0].tool_result.content[0].video.source.s3_location.bucket_owner #=> String
     #   resp.output.message.content[0].tool_result.status #=> String, one of "success", "error"
+    #   resp.output.message.content[0].tool_result.type #=> String
     #   resp.output.message.content[0].guard_content.text.text #=> String
     #   resp.output.message.content[0].guard_content.text.qualifiers #=> Array
     #   resp.output.message.content[0].guard_content.text.qualifiers[0] #=> String, one of "grounding_source", "query", "guard_content"
@@ -1228,6 +1239,8 @@ module Aws::BedrockRuntime
     #   resp.output.message.content[0].citations_content.citations[0].title #=> String
     #   resp.output.message.content[0].citations_content.citations[0].source_content #=> Array
     #   resp.output.message.content[0].citations_content.citations[0].source_content[0].text #=> String
+    #   resp.output.message.content[0].citations_content.citations[0].location.web.url #=> String
+    #   resp.output.message.content[0].citations_content.citations[0].location.web.domain #=> String
     #   resp.output.message.content[0].citations_content.citations[0].location.document_char.document_index #=> Integer
     #   resp.output.message.content[0].citations_content.citations[0].location.document_char.start #=> Integer
     #   resp.output.message.content[0].citations_content.citations[0].location.document_char.end #=> Integer
@@ -2002,6 +2015,7 @@ module Aws::BedrockRuntime
     #               name: "ToolName", # required
     #               input: { # required
     #               },
+    #               type: "server_tool_use", # accepts server_tool_use
     #             },
     #             tool_result: {
     #               tool_use_id: "ToolUseId", # required
@@ -2054,6 +2068,7 @@ module Aws::BedrockRuntime
     #                 },
     #               ],
     #               status: "success", # accepts success, error
+    #               type: "String",
     #             },
     #             guard_content: {
     #               text: {
@@ -2092,6 +2107,10 @@ module Aws::BedrockRuntime
     #                     },
     #                   ],
     #                   location: {
+    #                     web: {
+    #                       url: "String",
+    #                       domain: "String",
+    #                     },
     #                     document_char: {
     #                       document_index: 1,
     #                       start: 1,
@@ -2152,6 +2171,9 @@ module Aws::BedrockRuntime
     #               },
     #             },
     #           },
+    #           system_tool: {
+    #             name: "ToolName", # required
+    #           },
     #           cache_point: {
     #             type: "default", # required, accepts default
     #           },
@@ -2201,17 +2223,25 @@ module Aws::BedrockRuntime
     #   # For :content_block_start event available at #on_content_block_start_event callback and response eventstream enumerator:
     #   event.start.tool_use.tool_use_id #=> String
     #   event.start.tool_use.name #=> String
+    #   event.start.tool_use.type #=> String, one of "server_tool_use"
+    #   event.start.tool_result.tool_use_id #=> String
+    #   event.start.tool_result.type #=> String
+    #   event.start.tool_result.status #=> String, one of "success", "error"
     #   event.content_block_index #=> Integer
     #
     #   # For :content_block_delta event available at #on_content_block_delta_event callback and response eventstream enumerator:
     #   event.delta.text #=> String
     #   event.delta.tool_use.input #=> String
+    #   event.delta.tool_result #=> Array
+    #   event.delta.tool_result[0].text #=> String
     #   event.delta.reasoning_content.text #=> String
     #   event.delta.reasoning_content.redacted_content #=> String
     #   event.delta.reasoning_content.signature #=> String
     #   event.delta.citation.title #=> String
     #   event.delta.citation.source_content #=> Array
     #   event.delta.citation.source_content[0].text #=> String
+    #   event.delta.citation.location.web.url #=> String
+    #   event.delta.citation.location.web.domain #=> String
     #   event.delta.citation.location.document_char.document_index #=> Integer
     #   event.delta.citation.location.document_char.start #=> Integer
     #   event.delta.citation.location.document_char.end #=> Integer
@@ -2726,6 +2756,7 @@ module Aws::BedrockRuntime
     #                   name: "ToolName", # required
     #                   input: { # required
     #                   },
+    #                   type: "server_tool_use", # accepts server_tool_use
     #                 },
     #                 tool_result: {
     #                   tool_use_id: "ToolUseId", # required
@@ -2778,6 +2809,7 @@ module Aws::BedrockRuntime
     #                     },
     #                   ],
     #                   status: "success", # accepts success, error
+    #                   type: "String",
     #                 },
     #                 guard_content: {
     #                   text: {
@@ -2816,6 +2848,10 @@ module Aws::BedrockRuntime
     #                         },
     #                       ],
     #                       location: {
+    #                         web: {
+    #                           url: "String",
+    #                           domain: "String",
+    #                         },
     #                         document_char: {
     #                           document_index: 1,
     #                           start: 1,
@@ -3574,7 +3610,7 @@ module Aws::BedrockRuntime
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-bedrockruntime'
-      context[:gem_version] = '1.62.0'
+      context[:gem_version] = '1.63.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-bedrockruntime/client_api.rb

@@ -285,6 +285,7 @@ module Aws::BedrockRuntime
     String = Shapes::StringShape.new(name: 'String')
     SystemContentBlock = Shapes::UnionShape.new(name: 'SystemContentBlock')
     SystemContentBlocks = Shapes::ListShape.new(name: 'SystemContentBlocks')
+    SystemTool = Shapes::StructureShape.new(name: 'SystemTool')
     Tag = Shapes::StructureShape.new(name: 'Tag')
     TagKey = Shapes::StringShape.new(name: 'TagKey')
     TagList = Shapes::ListShape.new(name: 'TagList')
@@ -306,6 +307,9 @@ module Aws::BedrockRuntime
     ToolInputSchema = Shapes::UnionShape.new(name: 'ToolInputSchema')
     ToolName = Shapes::StringShape.new(name: 'ToolName')
     ToolResultBlock = Shapes::StructureShape.new(name: 'ToolResultBlock')
+    ToolResultBlockDelta = Shapes::UnionShape.new(name: 'ToolResultBlockDelta')
+    ToolResultBlockStart = Shapes::StructureShape.new(name: 'ToolResultBlockStart')
+    ToolResultBlocksDelta = Shapes::ListShape.new(name: 'ToolResultBlocksDelta')
     ToolResultContentBlock = Shapes::UnionShape.new(name: 'ToolResultContentBlock')
     ToolResultContentBlocks = Shapes::ListShape.new(name: 'ToolResultContentBlocks')
     ToolResultStatus = Shapes::StringShape.new(name: 'ToolResultStatus')
@@ -314,12 +318,14 @@ module Aws::BedrockRuntime
     ToolUseBlockDelta = Shapes::StructureShape.new(name: 'ToolUseBlockDelta')
     ToolUseBlockStart = Shapes::StructureShape.new(name: 'ToolUseBlockStart')
     ToolUseId = Shapes::StringShape.new(name: 'ToolUseId')
+    ToolUseType = Shapes::StringShape.new(name: 'ToolUseType')
     Trace = Shapes::StringShape.new(name: 'Trace')
     ValidationException = Shapes::StructureShape.new(name: 'ValidationException')
     VideoBlock = Shapes::StructureShape.new(name: 'VideoBlock')
     VideoFormat = Shapes::StringShape.new(name: 'VideoFormat')
     VideoSource = Shapes::UnionShape.new(name: 'VideoSource')
     VideoSourceBytesBlob = Shapes::BlobShape.new(name: 'VideoSourceBytesBlob')
+    WebLocation = Shapes::StructureShape.new(name: 'WebLocation')
 
     AccessDeniedException.add_member(:message, Shapes::ShapeRef.new(shape: NonBlankString, location_name: "message"))
     AccessDeniedException.struct_class = Types::AccessDeniedException
@@ -389,10 +395,12 @@ module Aws::BedrockRuntime
 
     CitationGeneratedContentList.member = Shapes::ShapeRef.new(shape: CitationGeneratedContent)
 
+    CitationLocation.add_member(:web, Shapes::ShapeRef.new(shape: WebLocation, location_name: "web"))
     CitationLocation.add_member(:document_char, Shapes::ShapeRef.new(shape: DocumentCharLocation, location_name: "documentChar"))
     CitationLocation.add_member(:document_page, Shapes::ShapeRef.new(shape: DocumentPageLocation, location_name: "documentPage"))
     CitationLocation.add_member(:document_chunk, Shapes::ShapeRef.new(shape: DocumentChunkLocation, location_name: "documentChunk"))
     CitationLocation.add_member(:unknown, Shapes::ShapeRef.new(shape: nil, location_name: 'unknown'))
+    CitationLocation.add_member_subclass(:web, Types::CitationLocation::Web)
     CitationLocation.add_member_subclass(:document_char, Types::CitationLocation::DocumentChar)
     CitationLocation.add_member_subclass(:document_page, Types::CitationLocation::DocumentPage)
     CitationLocation.add_member_subclass(:document_chunk, Types::CitationLocation::DocumentChunk)
@@ -455,11 +463,13 @@ module Aws::BedrockRuntime
 
     ContentBlockDelta.add_member(:text, Shapes::ShapeRef.new(shape: String, location_name: "text"))
     ContentBlockDelta.add_member(:tool_use, Shapes::ShapeRef.new(shape: ToolUseBlockDelta, location_name: "toolUse"))
+    ContentBlockDelta.add_member(:tool_result, Shapes::ShapeRef.new(shape: ToolResultBlocksDelta, location_name: "toolResult"))
     ContentBlockDelta.add_member(:reasoning_content, Shapes::ShapeRef.new(shape: ReasoningContentBlockDelta, location_name: "reasoningContent"))
     ContentBlockDelta.add_member(:citation, Shapes::ShapeRef.new(shape: CitationsDelta, location_name: "citation"))
     ContentBlockDelta.add_member(:unknown, Shapes::ShapeRef.new(shape: nil, location_name: 'unknown'))
     ContentBlockDelta.add_member_subclass(:text, Types::ContentBlockDelta::Text)
     ContentBlockDelta.add_member_subclass(:tool_use, Types::ContentBlockDelta::ToolUse)
+    ContentBlockDelta.add_member_subclass(:tool_result, Types::ContentBlockDelta::ToolResult)
     ContentBlockDelta.add_member_subclass(:reasoning_content, Types::ContentBlockDelta::ReasoningContent)
     ContentBlockDelta.add_member_subclass(:citation, Types::ContentBlockDelta::Citation)
     ContentBlockDelta.add_member_subclass(:unknown, Types::ContentBlockDelta::Unknown)
@@ -470,8 +480,10 @@ module Aws::BedrockRuntime
     ContentBlockDeltaEvent.struct_class = Types::ContentBlockDeltaEvent
 
     ContentBlockStart.add_member(:tool_use, Shapes::ShapeRef.new(shape: ToolUseBlockStart, location_name: "toolUse"))
+    ContentBlockStart.add_member(:tool_result, Shapes::ShapeRef.new(shape: ToolResultBlockStart, location_name: "toolResult"))
     ContentBlockStart.add_member(:unknown, Shapes::ShapeRef.new(shape: nil, location_name: 'unknown'))
     ContentBlockStart.add_member_subclass(:tool_use, Types::ContentBlockStart::ToolUse)
+    ContentBlockStart.add_member_subclass(:tool_result, Types::ContentBlockStart::ToolResult)
     ContentBlockStart.add_member_subclass(:unknown, Types::ContentBlockStart::Unknown)
     ContentBlockStart.struct_class = Types::ContentBlockStart
 
@@ -1149,6 +1161,9 @@ module Aws::BedrockRuntime
 
     SystemContentBlocks.member = Shapes::ShapeRef.new(shape: SystemContentBlock)
 
+    SystemTool.add_member(:name, Shapes::ShapeRef.new(shape: ToolName, required: true, location_name: "name"))
+    SystemTool.struct_class = Types::SystemTool
+
     Tag.add_member(:key, Shapes::ShapeRef.new(shape: TagKey, required: true, location_name: "key"))
     Tag.add_member(:value, Shapes::ShapeRef.new(shape: TagValue, required: true, location_name: "value"))
     Tag.struct_class = Types::Tag
@@ -1166,9 +1181,11 @@ module Aws::BedrockRuntime
     TokenUsage.struct_class = Types::TokenUsage
 
     Tool.add_member(:tool_spec, Shapes::ShapeRef.new(shape: ToolSpecification, location_name: "toolSpec"))
+    Tool.add_member(:system_tool, Shapes::ShapeRef.new(shape: SystemTool, location_name: "systemTool"))
     Tool.add_member(:cache_point, Shapes::ShapeRef.new(shape: CachePointBlock, location_name: "cachePoint"))
     Tool.add_member(:unknown, Shapes::ShapeRef.new(shape: nil, location_name: 'unknown'))
     Tool.add_member_subclass(:tool_spec, Types::Tool::ToolSpec)
+    Tool.add_member_subclass(:system_tool, Types::Tool::SystemTool)
     Tool.add_member_subclass(:cache_point, Types::Tool::CachePoint)
     Tool.add_member_subclass(:unknown, Types::Tool::Unknown)
     Tool.struct_class = Types::Tool
@@ -1198,8 +1215,22 @@ module Aws::BedrockRuntime
     ToolResultBlock.add_member(:tool_use_id, Shapes::ShapeRef.new(shape: ToolUseId, required: true, location_name: "toolUseId"))
     ToolResultBlock.add_member(:content, Shapes::ShapeRef.new(shape: ToolResultContentBlocks, required: true, location_name: "content"))
     ToolResultBlock.add_member(:status, Shapes::ShapeRef.new(shape: ToolResultStatus, location_name: "status"))
+    ToolResultBlock.add_member(:type, Shapes::ShapeRef.new(shape: String, location_name: "type"))
     ToolResultBlock.struct_class = Types::ToolResultBlock
 
+    ToolResultBlockDelta.add_member(:text, Shapes::ShapeRef.new(shape: String, location_name: "text"))
+    ToolResultBlockDelta.add_member(:unknown, Shapes::ShapeRef.new(shape: nil, location_name: 'unknown'))
+    ToolResultBlockDelta.add_member_subclass(:text, Types::ToolResultBlockDelta::Text)
+    ToolResultBlockDelta.add_member_subclass(:unknown, Types::ToolResultBlockDelta::Unknown)
+    ToolResultBlockDelta.struct_class = Types::ToolResultBlockDelta
+
+    ToolResultBlockStart.add_member(:tool_use_id, Shapes::ShapeRef.new(shape: ToolUseId, required: true, location_name: "toolUseId"))
+    ToolResultBlockStart.add_member(:type, Shapes::ShapeRef.new(shape: String, location_name: "type"))
+    ToolResultBlockStart.add_member(:status, Shapes::ShapeRef.new(shape: ToolResultStatus, location_name: "status"))
+    ToolResultBlockStart.struct_class = Types::ToolResultBlockStart
+
+    ToolResultBlocksDelta.member = Shapes::ShapeRef.new(shape: ToolResultBlockDelta)
+
     ToolResultContentBlock.add_member(:json, Shapes::ShapeRef.new(shape: Document, location_name: "json"))
     ToolResultContentBlock.add_member(:text, Shapes::ShapeRef.new(shape: String, location_name: "text"))
     ToolResultContentBlock.add_member(:image, Shapes::ShapeRef.new(shape: ImageBlock, location_name: "image"))
@@ -1224,6 +1255,7 @@ module Aws::BedrockRuntime
     ToolUseBlock.add_member(:tool_use_id, Shapes::ShapeRef.new(shape: ToolUseId, required: true, location_name: "toolUseId"))
     ToolUseBlock.add_member(:name, Shapes::ShapeRef.new(shape: ToolName, required: true, location_name: "name"))
     ToolUseBlock.add_member(:input, Shapes::ShapeRef.new(shape: Document, required: true, location_name: "input"))
+    ToolUseBlock.add_member(:type, Shapes::ShapeRef.new(shape: ToolUseType, location_name: "type"))
     ToolUseBlock.struct_class = Types::ToolUseBlock
 
     ToolUseBlockDelta.add_member(:input, Shapes::ShapeRef.new(shape: String, required: true, location_name: "input"))
@@ -1231,6 +1263,7 @@ module Aws::BedrockRuntime
 
     ToolUseBlockStart.add_member(:tool_use_id, Shapes::ShapeRef.new(shape: ToolUseId, required: true, location_name: "toolUseId"))
     ToolUseBlockStart.add_member(:name, Shapes::ShapeRef.new(shape: ToolName, required: true, location_name: "name"))
+    ToolUseBlockStart.add_member(:type, Shapes::ShapeRef.new(shape: ToolUseType, location_name: "type"))
     ToolUseBlockStart.struct_class = Types::ToolUseBlockStart
 
     ValidationException.add_member(:message, Shapes::ShapeRef.new(shape: NonBlankString, location_name: "message"))
@@ -1248,6 +1281,10 @@ module Aws::BedrockRuntime
     VideoSource.add_member_subclass(:unknown, Types::VideoSource::Unknown)
     VideoSource.struct_class = Types::VideoSource
 
+    WebLocation.add_member(:url, Shapes::ShapeRef.new(shape: String, location_name: "url"))
+    WebLocation.add_member(:domain, Shapes::ShapeRef.new(shape: String, location_name: "domain"))
+    WebLocation.struct_class = Types::WebLocation
+
 
     # @api private
     API = Seahorse::Model::Api.new.tap do |api|

data/lib/aws-sdk-bedrockruntime/types.rb

@@ -30,7 +30,12 @@ module Aws::BedrockRuntime
     end
 
     # The model must request at least one tool (no text is generated). For
-    # example, `{"any" : {}}`.
+    # example, `{"any" : {}}`. For more information, see [Call a tool with
+    # the Converse API][1] in the Amazon Bedrock User Guide.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/tool-use.html
     #
     # @api private
     #
@@ -217,7 +222,13 @@ module Aws::BedrockRuntime
     end
 
     # The Model automatically decides if a tool should be called or whether
-    # to generate text instead. For example, `{"auto" : {}}`.
+    # to generate text instead. For example, `{"auto" : {}}`. For more
+    # information, see [Call a tool with the Converse API][1] in the Amazon
+    # Bedrock User Guide
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/tool-use.html
     #
     # @api private
     #
@@ -336,6 +347,10 @@ module Aws::BedrockRuntime
     #
     # @note CitationLocation is a union - when returned from an API call exactly one value will be set and the returned type will be a subclass of CitationLocation corresponding to the set member.
     #
+    # @!attribute [rw] web
+    #   The web URL that was cited for this reference.
+    #   @return [Types::WebLocation]
+    #
     # @!attribute [rw] document_char
     #   The character-level location within the document where the cited
     #   content is found.
@@ -355,6 +370,7 @@ module Aws::BedrockRuntime
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/CitationLocation AWS API Documentation
     #
     class CitationLocation < Struct.new(
+      :web,
       :document_char,
       :document_page,
       :document_chunk,
@@ -363,6 +379,7 @@ module Aws::BedrockRuntime
       include Aws::Structure
       include Aws::Structure::Union
 
+      class Web < CitationLocation; end
       class DocumentChar < CitationLocation; end
       class DocumentPage < CitationLocation; end
       class DocumentChunk < CitationLocation; end
@@ -416,10 +433,10 @@ module Aws::BedrockRuntime
     # source documents.
     #
     # @!attribute [rw] enabled
-    #   Specifies whether document citations should be included in the
-    #   model's response. When set to true, the model can generate
-    #   citations that reference the source documents used to inform the
-    #   response.
+    #   Specifies whether citations from the selected document should be
+    #   used in the model's response. When set to true, the model can
+    #   generate citations that reference the source documents used to
+    #   inform the response.
     #   @return [Boolean]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/CitationsConfig AWS API Documentation
@@ -604,6 +621,10 @@ module Aws::BedrockRuntime
     #   Information about a tool that the model is requesting to use.
     #   @return [Types::ToolUseBlockDelta]
     #
+    # @!attribute [rw] tool_result
+    #   An incremental update that contains the results from a tool call.
+    #   @return [Array<Types::ToolResultBlockDelta>]
+    #
     # @!attribute [rw] reasoning_content
     #   Contains content regarding the reasoning that is carried out by the
     #   model. Reasoning refers to a Chain of Thought (CoT) that the model
@@ -620,6 +641,7 @@ module Aws::BedrockRuntime
     class ContentBlockDelta < Struct.new(
       :text,
       :tool_use,
+      :tool_result,
       :reasoning_content,
       :citation,
       :unknown)
@@ -629,6 +651,7 @@ module Aws::BedrockRuntime
 
       class Text < ContentBlockDelta; end
       class ToolUse < ContentBlockDelta; end
+      class ToolResult < ContentBlockDelta; end
       class ReasoningContent < ContentBlockDelta; end
       class Citation < ContentBlockDelta; end
       class Unknown < ContentBlockDelta; end
@@ -662,16 +685,22 @@ module Aws::BedrockRuntime
     #   Information about a tool that the model is requesting to use.
     #   @return [Types::ToolUseBlockStart]
     #
+    # @!attribute [rw] tool_result
+    #   The
+    #   @return [Types::ToolResultBlockStart]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/ContentBlockStart AWS API Documentation
     #
     class ContentBlockStart < Struct.new(
       :tool_use,
+      :tool_result,
       :unknown)
       SENSITIVE = []
       include Aws::Structure
       include Aws::Structure::Union
 
       class ToolUse < ContentBlockStart; end
+      class ToolResult < ContentBlockStart; end
       class Unknown < ContentBlockStart; end
     end
 
@@ -1144,8 +1173,7 @@ module Aws::BedrockRuntime
       include Aws::Structure
     end
 
-    # The trace object in a response from [ConverseStream][1]. Currently,
-    # you can only trace guardrails.
+    # The trace object in a response from [ConverseStream][1].
     #
     #
     #
@@ -1194,8 +1222,7 @@ module Aws::BedrockRuntime
       include Aws::Structure
     end
 
-    # The trace object in a response from [Converse][1]. Currently, you can
-    # only trace guardrails.
+    # The trace object in a response from [Converse][1].
     #
     #
     #
@@ -2263,7 +2290,12 @@ module Aws::BedrockRuntime
     end
 
     # A text block that contains text that you want to assess with a
-    # guardrail. For more information, see GuardrailConverseContentBlock.
+    # guardrail. For more information, see
+    # [GuardrailConverseContentBlock][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_GuardrailConverseContentBlock.html
     #
     # @!attribute [rw] text
     #   The text that you want to guard.
@@ -2527,7 +2559,7 @@ module Aws::BedrockRuntime
       include Aws::Structure
     end
 
-    # The assessment for aPersonally Identifiable Information (PII) policy.
+    # The assessment for a Personally Identifiable Information (PII) policy.
     #
     # @!attribute [rw] pii_entities
     #   The PII entities in the assessment.
@@ -2547,7 +2579,11 @@ module Aws::BedrockRuntime
     end
 
     # Configuration information for a guardrail that you use with the
-    # ConverseStream action.
+    # [ConverseStream][1] action.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_ConverseStream.html
     #
     # @!attribute [rw] guardrail_identifier
     #   The identifier for the guardrail.
@@ -2663,7 +2699,11 @@ module Aws::BedrockRuntime
     end
 
     # A Top level guardrail trace object. For more information, see
-    # ConverseTrace.
+    # [ConverseTrace][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_ConverseTrace.html
     #
     # @!attribute [rw] model_output
     #   The output from the model.
@@ -3707,12 +3747,17 @@ module Aws::BedrockRuntime
     end
 
     # The model must request a specific tool. For example, `{"tool" :
-    # {"name" : "Your tool name"}}`.
+    # {"name" : "Your tool name"}}`. For more information, see [Call a tool
+    # with the Converse API][1] in the Amazon Bedrock User Guide
     #
     # <note markdown="1"> This field is only supported by Anthropic Claude 3 models.
     #
     #  </note>
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/tool-use.html
+    #
     # @!attribute [rw] name
     #   The name of the tool that the model must request.
     #   @return [String]
@@ -3773,7 +3818,12 @@ module Aws::BedrockRuntime
       include Aws::Structure
     end
 
-    # A system content block.
+    # Contains configurations for instructions to provide the model for how
+    # to handle input. To learn more, see [Using the Converse API][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/conversation-inference-call.html
     #
     # @note SystemContentBlock is a union - when making an API calls you must set exactly one of the members.
     #
@@ -3815,6 +3865,21 @@ module Aws::BedrockRuntime
       class Unknown < SystemContentBlock; end
     end
 
+    # Specifies a system-defined tool for the model to use. *System-defined
+    # tools* are tools that are created and provided by the model provider.
+    #
+    # @!attribute [rw] name
+    #   The name of the system-defined tool that you want to call.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/SystemTool AWS API Documentation
+    #
+    class SystemTool < Struct.new(
+      :name)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # A tag.
     #
     # @!attribute [rw] key
@@ -3889,8 +3954,8 @@ module Aws::BedrockRuntime
     end
 
     # Information about a tool that you can use with the Converse API. For
-    # more information, see [Tool use (function calling)][1] in the Amazon
-    # Bedrock User Guide.
+    # more information, see [Call a tool with the Converse API][1] in the
+    # Amazon Bedrock User Guide.
     #
     #
     #
@@ -3902,6 +3967,10 @@ module Aws::BedrockRuntime
     #   The specfication for the tool.
     #   @return [Types::ToolSpecification]
     #
+    # @!attribute [rw] system_tool
+    #   Specifies the system-defined tool that you want use.
+    #   @return [Types::SystemTool]
+    #
     # @!attribute [rw] cache_point
     #   CachePoint to include in the tool configuration.
     #   @return [Types::CachePointBlock]
@@ -3910,6 +3979,7 @@ module Aws::BedrockRuntime
     #
     class Tool < Struct.new(
       :tool_spec,
+      :system_tool,
       :cache_point,
       :unknown)
       SENSITIVE = []
@@ -3917,13 +3987,18 @@ module Aws::BedrockRuntime
       include Aws::Structure::Union
 
       class ToolSpec < Tool; end
+      class SystemTool < Tool; end
       class CachePoint < Tool; end
       class Unknown < Tool; end
     end
 
     # Determines which tools the model should request in a call to
-    # `Converse` or `ConverseStream`. `ToolChoice` is only supported by
-    # Anthropic Claude 3 models and by Mistral AI Mistral Large.
+    # `Converse` or `ConverseStream`. For more information, see [Call a tool
+    # with the Converse API][1] in the Amazon Bedrock User Guide.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/tool-use.html
     #
     # @note ToolChoice is a union - when making an API calls you must set exactly one of the members.
     #
@@ -3938,7 +4013,7 @@ module Aws::BedrockRuntime
     #
     # @!attribute [rw] tool
     #   The Model must request the specified tool. Only supported by
-    #   Anthropic Claude 3 models.
+    #   Anthropic Claude 3 and Amazon Nova models.
     #   @return [Types::SpecificToolChoice]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/ToolChoice AWS API Documentation
@@ -3984,6 +4059,12 @@ module Aws::BedrockRuntime
     end
 
     # The schema for the tool. The top level schema type must be `object`.
+    # For more information, see [Call a tool with the Converse API][1] in
+    # the Amazon Bedrock User Guide.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/tool-use.html
     #
     # @note ToolInputSchema is a union - when making an API calls you must set exactly one of the members.
     #
@@ -4010,7 +4091,12 @@ module Aws::BedrockRuntime
     end
 
     # A tool result block that contains the results for a tool request that
-    # the model previously made.
+    # the model previously made. For more information, see [Call a tool with
+    # the Converse API][1] in the Amazon Bedrock User Guide.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/tool-use.html
     #
     # @!attribute [rw] tool_use_id
     #   The ID of the tool request that this is the result for.
@@ -4023,22 +4109,86 @@ module Aws::BedrockRuntime
     # @!attribute [rw] status
     #   The status for the tool result content block.
     #
-    #   <note markdown="1"> This field is only supported Anthropic Claude 3 models.
+    #   <note markdown="1"> This field is only supported by Amazon Nova and Anthropic Claude 3
+    #   and 4 models.
     #
     #    </note>
     #   @return [String]
     #
+    # @!attribute [rw] type
+    #   The type for the tool result content block.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/ToolResultBlock AWS API Documentation
     #
     class ToolResultBlock < Struct.new(
       :tool_use_id,
       :content,
+      :status,
+      :type)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Contains incremental updates to tool results information during
+    # streaming responses. This allows clients to build up tool results data
+    # progressively as the response is generated.
+    #
+    # @note ToolResultBlockDelta is a union - when returned from an API call exactly one value will be set and the returned type will be a subclass of ToolResultBlockDelta corresponding to the set member.
+    #
+    # @!attribute [rw] text
+    #   The reasoning the model used to return the output.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/ToolResultBlockDelta AWS API Documentation
+    #
+    class ToolResultBlockDelta < Struct.new(
+      :text,
+      :unknown)
+      SENSITIVE = []
+      include Aws::Structure
+      include Aws::Structure::Union
+
+      class Text < ToolResultBlockDelta; end
+      class Unknown < ToolResultBlockDelta; end
+    end
+
+    # The start of a tool result block. For more information, see [Call a
+    # tool with the Converse API][1] in the Amazon Bedrock User Guide.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/tool-use.html
+    #
+    # @!attribute [rw] tool_use_id
+    #   The ID of the tool that was used to generate this tool result block.
+    #   @return [String]
+    #
+    # @!attribute [rw] type
+    #   The type for the tool that was used to generate this tool result
+    #   block.
+    #   @return [String]
+    #
+    # @!attribute [rw] status
+    #   The status of the tool result block.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/ToolResultBlockStart AWS API Documentation
+    #
+    class ToolResultBlockStart < Struct.new(
+      :tool_use_id,
+      :type,
       :status)
       SENSITIVE = []
       include Aws::Structure
     end
 
-    # The tool result content block.
+    # The tool result content block. For more information, see [Call a tool
+    # with the Converse API][1] in the Amazon Bedrock User Guide.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/tool-use.html
     #
     # @note ToolResultContentBlock is a union - when making an API calls you must set exactly one of the members.
     #
@@ -4055,7 +4205,8 @@ module Aws::BedrockRuntime
     # @!attribute [rw] image
     #   A tool result that is an image.
     #
-    #   <note markdown="1"> This field is only supported by Anthropic Claude 3 models.
+    #   <note markdown="1"> This field is only supported by Amazon Nova and Anthropic Claude 3
+    #   and 4 models.
     #
     #    </note>
     #   @return [Types::ImageBlock]
@@ -4089,7 +4240,12 @@ module Aws::BedrockRuntime
       class Unknown < ToolResultContentBlock; end
     end
 
-    # The specification for the tool.
+    # The specification for the tool. For more information, see [Call a tool
+    # with the Converse API][1] in the Amazon Bedrock User Guide.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/tool-use.html
     #
     # @!attribute [rw] name
     #   The name for the tool.
@@ -4115,7 +4271,12 @@ module Aws::BedrockRuntime
 
     # A tool use content block. Contains information about a tool that the
     # model is requesting be run., The model uses the result from the tool
-    # to generate a response.
+    # to generate a response. For more information, see [Call a tool with
+    # the Converse API][1] in the Amazon Bedrock User Guide.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/tool-use.html
     #
     # @!attribute [rw] tool_use_id
     #   The ID for the tool request.
@@ -4129,12 +4290,17 @@ module Aws::BedrockRuntime
     #   The input to pass to the tool.
     #   @return [Hash,Array,String,Numeric,Boolean]
     #
+    # @!attribute [rw] type
+    #   The type for the tool request.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/ToolUseBlock AWS API Documentation
     #
     class ToolUseBlock < Struct.new(
       :tool_use_id,
       :name,
-      :input)
+      :input,
+      :type)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -4153,7 +4319,12 @@ module Aws::BedrockRuntime
       include Aws::Structure
     end
 
-    # The start of a tool use block.
+    # The start of a tool use block. For more information, see [Call a tool
+    # with the Converse API][1] in the Amazon Bedrock User Guide.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/tool-use.html
     #
     # @!attribute [rw] tool_use_id
     #   The ID for the tool request.
@@ -4163,11 +4334,16 @@ module Aws::BedrockRuntime
     #   The name of the tool that the model is requesting to use.
     #   @return [String]
     #
+    # @!attribute [rw] type
+    #   The type for the tool request.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/ToolUseBlockStart AWS API Documentation
     #
     class ToolUseBlockStart < Struct.new(
       :tool_use_id,
-      :name)
+      :name,
+      :type)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -4248,6 +4424,26 @@ module Aws::BedrockRuntime
       class Unknown < VideoSource; end
     end
 
+    # Provides the URL and domain information for the website that was cited
+    # when performing a web search.
+    #
+    # @!attribute [rw] url
+    #   The URL that was cited when performing a web search.
+    #   @return [String]
+    #
+    # @!attribute [rw] domain
+    #   The domain that was cited when performing a web search.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/WebLocation AWS API Documentation
+    #
+    class WebLocation < Struct.new(
+      :url,
+      :domain)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # The messages output stream
     #
     # EventStream is an Enumerator of Events.

data/lib/aws-sdk-bedrockruntime.rb

@@ -57,7 +57,7 @@ module Aws::BedrockRuntime
   autoload :AsyncClient, 'aws-sdk-bedrockruntime/async_client'
   autoload :EventStreams, 'aws-sdk-bedrockruntime/event_streams'
 
-  GEM_VERSION = '1.62.0'
+  GEM_VERSION = '1.63.0'
 
 end
 

data/sig/client.rbs

@@ -177,7 +177,8 @@ module Aws
                                 tool_use_id: ::String,
                                 name: ::String,
                                 input: {
-                                }
+                                },
+                                type: ("server_tool_use")?
                               }?,
                               tool_result: {
                                 tool_use_id: ::String,
@@ -229,7 +230,8 @@ module Aws
                                     }?
                                   },
                                 ],
-                                status: ("success" | "error")?
+                                status: ("success" | "error")?,
+                                type: ::String?
                               }?,
                               guard_content: {
                                 text: {
@@ -268,6 +270,10 @@ module Aws
                                       },
                                     ]?,
                                     location: {
+                                      web: {
+                                        url: ::String?,
+                                        domain: ::String?
+                                      }?,
                                       document_char: {
                                         document_index: ::Integer?,
                                         start: ::Integer?,
@@ -328,6 +334,9 @@ module Aws
                                 }?
                               }
                             }?,
+                            system_tool: {
+                              name: ::String
+                            }?,
                             cache_point: {
                               type: ("default")
                             }?
@@ -419,7 +428,8 @@ module Aws
                                        tool_use_id: ::String,
                                        name: ::String,
                                        input: {
-                                       }
+                                       },
+                                       type: ("server_tool_use")?
                                      }?,
                                      tool_result: {
                                        tool_use_id: ::String,
@@ -471,7 +481,8 @@ module Aws
                                            }?
                                          },
                                        ],
-                                       status: ("success" | "error")?
+                                       status: ("success" | "error")?,
+                                       type: ::String?
                                      }?,
                                      guard_content: {
                                        text: {
@@ -510,6 +521,10 @@ module Aws
                                              },
                                            ]?,
                                            location: {
+                                             web: {
+                                               url: ::String?,
+                                               domain: ::String?
+                                             }?,
                                              document_char: {
                                                document_index: ::Integer?,
                                                start: ::Integer?,
@@ -570,6 +585,9 @@ module Aws
                                        }?
                                      }
                                    }?,
+                                   system_tool: {
+                                     name: ::String
+                                   }?,
                                    cache_point: {
                                      type: ("default")
                                    }?
@@ -667,7 +685,8 @@ module Aws
                                         tool_use_id: ::String,
                                         name: ::String,
                                         input: {
-                                        }
+                                        },
+                                        type: ("server_tool_use")?
                                       }?,
                                       tool_result: {
                                         tool_use_id: ::String,
@@ -719,7 +738,8 @@ module Aws
                                             }?
                                           },
                                         ],
-                                        status: ("success" | "error")?
+                                        status: ("success" | "error")?,
+                                        type: ::String?
                                       }?,
                                       guard_content: {
                                         text: {
@@ -758,6 +778,10 @@ module Aws
                                               },
                                             ]?,
                                             location: {
+                                              web: {
+                                                url: ::String?,
+                                                domain: ::String?
+                                              }?,
                                               document_char: {
                                                 document_index: ::Integer?,
                                                 start: ::Integer?,

data/sig/types.rbs

@@ -105,12 +105,15 @@ module Aws::BedrockRuntime
     end
 
     class CitationLocation
+      attr_accessor web: Types::WebLocation
       attr_accessor document_char: Types::DocumentCharLocation
       attr_accessor document_page: Types::DocumentPageLocation
       attr_accessor document_chunk: Types::DocumentChunkLocation
       attr_accessor unknown: untyped
       SENSITIVE: []
 
+      class Web < CitationLocation
+      end
       class DocumentChar < CitationLocation
       end
       class DocumentPage < CitationLocation
@@ -201,6 +204,7 @@ module Aws::BedrockRuntime
     class ContentBlockDelta
       attr_accessor text: ::String
       attr_accessor tool_use: Types::ToolUseBlockDelta
+      attr_accessor tool_result: ::Array[Types::ToolResultBlockDelta]
       attr_accessor reasoning_content: Types::ReasoningContentBlockDelta
       attr_accessor citation: Types::CitationsDelta
       attr_accessor unknown: untyped
@@ -210,6 +214,8 @@ module Aws::BedrockRuntime
       end
       class ToolUse < ContentBlockDelta
       end
+      class ToolResult < ContentBlockDelta
+      end
       class ReasoningContent < ContentBlockDelta
       end
       class Citation < ContentBlockDelta
@@ -227,11 +233,14 @@ module Aws::BedrockRuntime
 
     class ContentBlockStart
       attr_accessor tool_use: Types::ToolUseBlockStart
+      attr_accessor tool_result: Types::ToolResultBlockStart
       attr_accessor unknown: untyped
       SENSITIVE: []
 
       class ToolUse < ContentBlockStart
       end
+      class ToolResult < ContentBlockStart
+      end
       class Unknown < ContentBlockStart
       end
     end
@@ -1074,6 +1083,11 @@ module Aws::BedrockRuntime
       end
     end
 
+    class SystemTool
+      attr_accessor name: ::String
+      SENSITIVE: []
+    end
+
     class Tag
       attr_accessor key: ::String
       attr_accessor value: ::String
@@ -1097,12 +1111,15 @@ module Aws::BedrockRuntime
 
     class Tool
       attr_accessor tool_spec: Types::ToolSpecification
+      attr_accessor system_tool: Types::SystemTool
       attr_accessor cache_point: Types::CachePointBlock
       attr_accessor unknown: untyped
       SENSITIVE: []
 
       class ToolSpec < Tool
       end
+      class SystemTool < Tool
+      end
       class CachePoint < Tool
       end
       class Unknown < Tool
@@ -1147,6 +1164,25 @@ module Aws::BedrockRuntime
       attr_accessor tool_use_id: ::String
       attr_accessor content: ::Array[Types::ToolResultContentBlock]
       attr_accessor status: ("success" | "error")
+      attr_accessor type: ::String
+      SENSITIVE: []
+    end
+
+    class ToolResultBlockDelta
+      attr_accessor text: ::String
+      attr_accessor unknown: untyped
+      SENSITIVE: []
+
+      class Text < ToolResultBlockDelta
+      end
+      class Unknown < ToolResultBlockDelta
+      end
+    end
+
+    class ToolResultBlockStart
+      attr_accessor tool_use_id: ::String
+      attr_accessor type: ::String
+      attr_accessor status: ("success" | "error")
       SENSITIVE: []
     end
 
@@ -1184,6 +1220,7 @@ module Aws::BedrockRuntime
       attr_accessor tool_use_id: ::String
       attr_accessor name: ::String
       attr_accessor input: untyped
+      attr_accessor type: ("server_tool_use")
       SENSITIVE: []
     end
 
@@ -1195,6 +1232,7 @@ module Aws::BedrockRuntime
     class ToolUseBlockStart
       attr_accessor tool_use_id: ::String
       attr_accessor name: ::String
+      attr_accessor type: ("server_tool_use")
       SENSITIVE: []
     end
 
@@ -1224,6 +1262,12 @@ module Aws::BedrockRuntime
       end
     end
 
+    class WebLocation
+      attr_accessor url: ::String
+      attr_accessor domain: ::String
+      SENSITIVE: []
+    end
+
     class ConverseStreamOutput < Enumerator[untyped, untyped]
       def event_types: () -> [:message_start, :content_block_start, :content_block_delta, :content_block_stop, :message_stop, :metadata, :internal_server_exception, :model_stream_error_exception, :validation_exception, :throttling_exception, :service_unavailable_exception]
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-bedrockruntime
 version: !ruby/object:Gem::Version
-  version: 1.62.0
+  version: 1.63.0
 platform: ruby
 authors:
 - Amazon Web Services