aws-sdk-qconnect 1.57.0 → 1.58.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 656b0a127f77c3907d376c5e68e2cf36eebd907c67534c68f98027f3e7bbd11e
-  data.tar.gz: 0c9901a5457af9569e407bea9bd69b067664e90d02751b96316504189e7140c9
+  metadata.gz: c09da3de5b23fbd947ecfe3a326eb9047cb9b903d7fed8228c88304c022c1867
+  data.tar.gz: eb6b33cd9fa5af50da5eb7f69b7bf2113598b9eebd818f47e90dd1250ab5b980
 SHA512:
-  metadata.gz: 2b188059ed947752d3e0584f219891f280a1fd20a982b26e9751c9dbbf49043abc43674fe6156707cd489c6e771adc9969d569adad1477663195bc809f9af851
-  data.tar.gz: 2f7f635174f741e21cec70de33fe5595aab49135b7f88bd68af36f15d40776e6b99eca80c509a5c625efb793f938d8f3ed9f1ffc988f21a8f8d1de58ef17c32b
+  metadata.gz: 7b6ece3c562d507e349ffafa5844bcd8a9f2c4920b1ae48e5a499721531c9acaf8bcdd1515f5cb3baedb13ee9aea4ec4676710eca4618cb16c38cc8ed2dc5f3d
+  data.tar.gz: 59638d109f20bf0a86ec88ed07c672ed7a067f977607d9ce6811df894e4ea23616257cfe5c7dda8744f2a0b0d36a48da8c963887cceb1e53c765f6b2d3b4220b

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.58.0 (2026-05-22)
+------------------
+
+* Feature - Added guardrail assessment results to inference spans in the ListSpans API. You can now see which AI Guardrail policies were evaluated, whether content was blocked or masked, and per-policy details for each Bedrock Converse call
+
 1.57.0 (2026-05-21)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.57.0
+1.58.0

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

@@ -6317,6 +6317,15 @@ module Aws::QConnect
     #   resp.spans[0].attributes.prompt_name #=> String
     #   resp.spans[0].attributes.prompt_version #=> Integer
     #   resp.spans[0].attributes.time_to_first_token_ms #=> Integer
+    #   resp.spans[0].attributes.guardrail_assessments #=> Array
+    #   resp.spans[0].attributes.guardrail_assessments[0].guardrail_id #=> String
+    #   resp.spans[0].attributes.guardrail_assessments[0].guardrail_name #=> String
+    #   resp.spans[0].attributes.guardrail_assessments[0].source #=> String, one of "INPUT", "OUTPUT"
+    #   resp.spans[0].attributes.guardrail_assessments[0].action #=> String, one of "NONE", "BLOCKED", "MASKED"
+    #   resp.spans[0].attributes.guardrail_assessments[0].policies #=> Array
+    #   resp.spans[0].attributes.guardrail_assessments[0].policies[0].policy_type #=> String, one of "CONTENT_FILTER", "TOPIC", "WORD", "SENSITIVE_INFORMATION_PII", "SENSITIVE_INFORMATION_REGEX", "CONTEXTUAL_GROUNDING"
+    #   resp.spans[0].attributes.guardrail_assessments[0].policies[0].action #=> String, one of "NONE", "BLOCKED", "MASKED"
+    #   resp.spans[0].attributes.guardrail_assessments[0].policies[0].details #=> String
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/qconnect-2020-10-19/ListSpans AWS API Documentation
@@ -9527,7 +9536,7 @@ module Aws::QConnect
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-qconnect'
-      context[:gem_version] = '1.57.0'
+      context[:gem_version] = '1.58.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -265,6 +265,7 @@ module Aws::QConnect
     GroupingCriteria = Shapes::StringShape.new(name: 'GroupingCriteria')
     GroupingValue = Shapes::StringShape.new(name: 'GroupingValue')
     GroupingValues = Shapes::ListShape.new(name: 'GroupingValues')
+    GuardrailAction = Shapes::StringShape.new(name: 'GuardrailAction')
     GuardrailContentFilterConfig = Shapes::StructureShape.new(name: 'GuardrailContentFilterConfig')
     GuardrailContentFilterType = Shapes::StringShape.new(name: 'GuardrailContentFilterType')
     GuardrailContentFiltersConfig = Shapes::ListShape.new(name: 'GuardrailContentFiltersConfig')
@@ -279,12 +280,16 @@ module Aws::QConnect
     GuardrailPiiEntitiesConfig = Shapes::ListShape.new(name: 'GuardrailPiiEntitiesConfig')
     GuardrailPiiEntityConfig = Shapes::StructureShape.new(name: 'GuardrailPiiEntityConfig')
     GuardrailPiiEntityType = Shapes::StringShape.new(name: 'GuardrailPiiEntityType')
+    GuardrailPolicyResult = Shapes::StructureShape.new(name: 'GuardrailPolicyResult')
+    GuardrailPolicyResultList = Shapes::ListShape.new(name: 'GuardrailPolicyResultList')
+    GuardrailPolicyType = Shapes::StringShape.new(name: 'GuardrailPolicyType')
     GuardrailRegexConfig = Shapes::StructureShape.new(name: 'GuardrailRegexConfig')
     GuardrailRegexDescription = Shapes::StringShape.new(name: 'GuardrailRegexDescription')
     GuardrailRegexName = Shapes::StringShape.new(name: 'GuardrailRegexName')
     GuardrailRegexPattern = Shapes::StringShape.new(name: 'GuardrailRegexPattern')
     GuardrailRegexesConfig = Shapes::ListShape.new(name: 'GuardrailRegexesConfig')
     GuardrailSensitiveInformationAction = Shapes::StringShape.new(name: 'GuardrailSensitiveInformationAction')
+    GuardrailSource = Shapes::StringShape.new(name: 'GuardrailSource')
     GuardrailTopicConfig = Shapes::StructureShape.new(name: 'GuardrailTopicConfig')
     GuardrailTopicDefinition = Shapes::StringShape.new(name: 'GuardrailTopicDefinition')
     GuardrailTopicExample = Shapes::StringShape.new(name: 'GuardrailTopicExample')
@@ -563,6 +568,8 @@ module Aws::QConnect
     SpanCitation = Shapes::StructureShape.new(name: 'SpanCitation')
     SpanCitationList = Shapes::ListShape.new(name: 'SpanCitationList')
     SpanFinishReasonList = Shapes::ListShape.new(name: 'SpanFinishReasonList')
+    SpanGuardrailAssessment = Shapes::StructureShape.new(name: 'SpanGuardrailAssessment')
+    SpanGuardrailAssessmentList = Shapes::ListShape.new(name: 'SpanGuardrailAssessmentList')
     SpanList = Shapes::ListShape.new(name: 'SpanList')
     SpanMessage = Shapes::StructureShape.new(name: 'SpanMessage')
     SpanMessageList = Shapes::ListShape.new(name: 'SpanMessageList')
@@ -1820,6 +1827,13 @@ module Aws::QConnect
     GuardrailPiiEntityConfig.add_member(:action, Shapes::ShapeRef.new(shape: GuardrailSensitiveInformationAction, required: true, location_name: "action"))
     GuardrailPiiEntityConfig.struct_class = Types::GuardrailPiiEntityConfig
 
+    GuardrailPolicyResult.add_member(:policy_type, Shapes::ShapeRef.new(shape: GuardrailPolicyType, required: true, location_name: "policyType"))
+    GuardrailPolicyResult.add_member(:action, Shapes::ShapeRef.new(shape: GuardrailAction, required: true, location_name: "action"))
+    GuardrailPolicyResult.add_member(:details, Shapes::ShapeRef.new(shape: NonEmptyString, location_name: "details"))
+    GuardrailPolicyResult.struct_class = Types::GuardrailPolicyResult
+
+    GuardrailPolicyResultList.member = Shapes::ShapeRef.new(shape: GuardrailPolicyResult)
+
     GuardrailRegexConfig.add_member(:name, Shapes::ShapeRef.new(shape: GuardrailRegexName, required: true, location_name: "name"))
     GuardrailRegexConfig.add_member(:description, Shapes::ShapeRef.new(shape: GuardrailRegexDescription, location_name: "description"))
     GuardrailRegexConfig.add_member(:pattern, Shapes::ShapeRef.new(shape: GuardrailRegexPattern, required: true, location_name: "pattern"))
@@ -2926,6 +2940,7 @@ module Aws::QConnect
     SpanAttributes.add_member(:prompt_name, Shapes::ShapeRef.new(shape: Name, location_name: "promptName"))
     SpanAttributes.add_member(:prompt_version, Shapes::ShapeRef.new(shape: Integer, location_name: "promptVersion"))
     SpanAttributes.add_member(:time_to_first_token_ms, Shapes::ShapeRef.new(shape: Integer, location_name: "timeToFirstTokenMs"))
+    SpanAttributes.add_member(:guardrail_assessments, Shapes::ShapeRef.new(shape: SpanGuardrailAssessmentList, location_name: "guardrailAssessments"))
     SpanAttributes.struct_class = Types::SpanAttributes
 
     SpanCitation.add_member(:content_id, Shapes::ShapeRef.new(shape: Uuid, location_name: "contentId"))
@@ -2938,6 +2953,15 @@ module Aws::QConnect
 
     SpanFinishReasonList.member = Shapes::ShapeRef.new(shape: NonEmptyString)
 
+    SpanGuardrailAssessment.add_member(:guardrail_id, Shapes::ShapeRef.new(shape: NonEmptyString, required: true, location_name: "guardrailId"))
+    SpanGuardrailAssessment.add_member(:guardrail_name, Shapes::ShapeRef.new(shape: NonEmptyString, required: true, location_name: "guardrailName"))
+    SpanGuardrailAssessment.add_member(:source, Shapes::ShapeRef.new(shape: GuardrailSource, required: true, location_name: "source"))
+    SpanGuardrailAssessment.add_member(:action, Shapes::ShapeRef.new(shape: GuardrailAction, required: true, location_name: "action"))
+    SpanGuardrailAssessment.add_member(:policies, Shapes::ShapeRef.new(shape: GuardrailPolicyResultList, location_name: "policies"))
+    SpanGuardrailAssessment.struct_class = Types::SpanGuardrailAssessment
+
+    SpanGuardrailAssessmentList.member = Shapes::ShapeRef.new(shape: SpanGuardrailAssessment)
+
     SpanList.member = Shapes::ShapeRef.new(shape: Span)
 
     SpanMessage.add_member(:message_id, Shapes::ShapeRef.new(shape: Uuid, required: true, location_name: "messageId"))

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

@@ -5744,6 +5744,31 @@ module Aws::QConnect
       include Aws::Structure
     end
 
+    # Per-policy guardrail assessment result. Captures which policy
+    # triggered, its outcome, and a policy-specific detail string.
+    #
+    # @!attribute [rw] policy_type
+    #   The type of guardrail policy that was evaluated.
+    #   @return [String]
+    #
+    # @!attribute [rw] action
+    #   Outcome of this specific policy.
+    #   @return [String]
+    #
+    # @!attribute [rw] details
+    #   Policy-specific detail.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/qconnect-2020-10-19/GuardrailPolicyResult AWS API Documentation
+    #
+    class GuardrailPolicyResult < Struct.new(
+      :policy_type,
+      :action,
+      :details)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # The regular expression to configure for the AI Guardrail.
     #
     # @!attribute [rw] name
@@ -10940,6 +10965,11 @@ module Aws::QConnect
     #   Bedrock was invoked to when the first token was returned
     #   @return [Integer]
     #
+    # @!attribute [rw] guardrail_assessments
+    #   Guardrail assessments for the inference span. Absent on other span
+    #   types and when no AI Guardrail is attached to the AI Agent.
+    #   @return [Array<Types::SpanGuardrailAssessment>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/qconnect-2020-10-19/SpanAttributes AWS API Documentation
     #
     class SpanAttributes < Struct.new(
@@ -10977,7 +11007,8 @@ module Aws::QConnect
       :prompt_type,
       :prompt_name,
       :prompt_version,
-      :time_to_first_token_ms)
+      :time_to_first_token_ms,
+      :guardrail_assessments)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -11012,6 +11043,42 @@ module Aws::QConnect
       include Aws::Structure
     end
 
+    # Result of a single guardrail assessment, covering either the input
+    # (customer/user message) or the output (LLM response) of a Bedrock
+    # Converse call.
+    #
+    # @!attribute [rw] guardrail_id
+    #   Unique AI Guardrail identifier.
+    #   @return [String]
+    #
+    # @!attribute [rw] guardrail_name
+    #   Customer-defined display name of the AI Guardrail resource.
+    #   @return [String]
+    #
+    # @!attribute [rw] source
+    #   Content source the guardrail was evaluated against.
+    #   @return [String]
+    #
+    # @!attribute [rw] action
+    #   Outcome of the guardrail assessment.
+    #   @return [String]
+    #
+    # @!attribute [rw] policies
+    #   Per-policy assessment results. Absent or empty when action is NONE.
+    #   @return [Array<Types::GuardrailPolicyResult>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/qconnect-2020-10-19/SpanGuardrailAssessment AWS API Documentation
+    #
+    class SpanGuardrailAssessment < Struct.new(
+      :guardrail_id,
+      :guardrail_name,
+      :source,
+      :action,
+      :policies)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # A message in the conversation history with participant role and
     # content values
     #

data/lib/aws-sdk-qconnect.rb

@@ -55,7 +55,7 @@ module Aws::QConnect
   autoload :EndpointProvider, 'aws-sdk-qconnect/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-qconnect/endpoints'
 
-  GEM_VERSION = '1.57.0'
+  GEM_VERSION = '1.58.0'
 
 end
 

data/sig/types.rbs

@@ -1484,6 +1484,13 @@ module Aws::QConnect
       SENSITIVE: [:type, :action]
     end
 
+    class GuardrailPolicyResult
+      attr_accessor policy_type: ("CONTENT_FILTER" | "TOPIC" | "WORD" | "SENSITIVE_INFORMATION_PII" | "SENSITIVE_INFORMATION_REGEX" | "CONTEXTUAL_GROUNDING")
+      attr_accessor action: ("NONE" | "BLOCKED" | "MASKED")
+      attr_accessor details: ::String
+      SENSITIVE: []
+    end
+
     class GuardrailRegexConfig
       attr_accessor name: ::String
       attr_accessor description: ::String
@@ -2881,6 +2888,7 @@ module Aws::QConnect
       attr_accessor prompt_name: ::String
       attr_accessor prompt_version: ::Integer
       attr_accessor time_to_first_token_ms: ::Integer
+      attr_accessor guardrail_assessments: ::Array[Types::SpanGuardrailAssessment]
       SENSITIVE: []
     end
 
@@ -2892,6 +2900,15 @@ module Aws::QConnect
       SENSITIVE: [:title]
     end
 
+    class SpanGuardrailAssessment
+      attr_accessor guardrail_id: ::String
+      attr_accessor guardrail_name: ::String
+      attr_accessor source: ("INPUT" | "OUTPUT")
+      attr_accessor action: ("NONE" | "BLOCKED" | "MASKED")
+      attr_accessor policies: ::Array[Types::GuardrailPolicyResult]
+      SENSITIVE: []
+    end
+
     class SpanMessage
       attr_accessor message_id: ::String
       attr_accessor participant: ("CUSTOMER" | "AGENT" | "BOT")

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-qconnect
 version: !ruby/object:Gem::Version
-  version: 1.57.0
+  version: 1.58.0
 platform: ruby
 authors:
 - Amazon Web Services