Automated Reasoning checks in Amazon Bedrock Guardrails is capable of generating policy scenarios to validate policies. The GetAutomatedReasoningPolicyBuildWorkflowResultAssets API now adds POLICY SCENARIO asset type, allowing customers to retrieve scenarios generated by the build workflow.

Author: aws-sdk-dotnet-automation

generator/ServiceModels/bedrock/bedrock-2023-04-20.api.json

@@ -2356,7 +2356,8 @@
         "BUILD_LOG",
         "QUALITY_REPORT",
         "POLICY_DEFINITION",
-        "GENERATED_TEST_CASES"
+        "GENERATED_TEST_CASES",
+        "POLICY_SCENARIOS"
       ]
     },
     "AutomatedReasoningPolicyBuildResultAssets":{
@@ -2365,7 +2366,8 @@
         "policyDefinition":{"shape":"AutomatedReasoningPolicyDefinition"},
         "qualityReport":{"shape":"AutomatedReasoningPolicyDefinitionQualityReport"},
         "buildLog":{"shape":"AutomatedReasoningPolicyBuildLog"},
-        "generatedTestCases":{"shape":"AutomatedReasoningPolicyGeneratedTestCases"}
+        "generatedTestCases":{"shape":"AutomatedReasoningPolicyGeneratedTestCases"},
+        "policyScenarios":{"shape":"AutomatedReasoningPolicyScenarios"}
       },
       "union":true
     },
@@ -2858,14 +2860,14 @@
       "required":[
         "expression",
         "alternateExpression",
-        "ruleIds",
-        "expectedResult"
+        "expectedResult",
+        "ruleIds"
       ],
       "members":{
         "expression":{"shape":"AutomatedReasoningPolicyScenarioExpression"},
         "alternateExpression":{"shape":"AutomatedReasoningPolicyScenarioAlternateExpression"},
-        "ruleIds":{"shape":"AutomatedReasoningPolicyDefinitionRuleIdList"},
-        "expectedResult":{"shape":"AutomatedReasoningCheckResult"}
+        "expectedResult":{"shape":"AutomatedReasoningCheckResult"},
+        "ruleIds":{"shape":"AutomatedReasoningPolicyDefinitionRuleIdList"}
       }
     },
     "AutomatedReasoningPolicyScenarioAlternateExpression":{
@@ -2880,6 +2882,17 @@
       "min":0,
       "sensitive":true
     },
+    "AutomatedReasoningPolicyScenarioList":{
+      "type":"list",
+      "member":{"shape":"AutomatedReasoningPolicyScenario"}
+    },
+    "AutomatedReasoningPolicyScenarios":{
+      "type":"structure",
+      "required":["policyScenarios"],
+      "members":{
+        "policyScenarios":{"shape":"AutomatedReasoningPolicyScenarioList"}
+      }
+    },
     "AutomatedReasoningPolicySummaries":{
       "type":"list",
       "member":{"shape":"AutomatedReasoningPolicySummary"},

generator/ServiceModels/bedrock/bedrock-2023-04-20.docs.json

@@ -1099,6 +1099,7 @@
     "AutomatedReasoningPolicyScenario": {
       "base": "<p>Represents a test scenario used to validate an Automated Reasoning policy, including the test conditions and expected outcomes.</p>",
       "refs": {
+        "AutomatedReasoningPolicyScenarioList$member": null,
         "GetAutomatedReasoningPolicyNextScenarioResponse$scenario": "<p>The next test scenario to validate, including the test expression and expected results.</p>"
       }
     },
@@ -1115,6 +1116,18 @@
         "AutomatedReasoningPolicyUpdateFromScenarioFeedbackAnnotation$scenarioExpression": "<p>The logical expression that defines the test scenario that generated this feedback.</p>"
       }
     },
+    "AutomatedReasoningPolicyScenarioList": {
+      "base": null,
+      "refs": {
+        "AutomatedReasoningPolicyScenarios$policyScenarios": "<p>Represents a collection of generated policy scenarios.</p>"
+      }
+    },
+    "AutomatedReasoningPolicyScenarios": {
+      "base": "<p>Contains a comprehensive entity encompassing all the scenarios generated by the build workflow, which can be used to validate an Automated Reasoning policy.</p>",
+      "refs": {
+        "AutomatedReasoningPolicyBuildResultAssets$policyScenarios": "<p>An entity encompassing all the policy scenarios generated by the build workflow, which can be used to validate an Automated Reasoning policy. </p>"
+      }
+    },
     "AutomatedReasoningPolicySummaries": {
       "base": null,
       "refs": {

generator/ServiceModels/bedrock/bedrock-2023-04-20.normal.json

@@ -2754,7 +2754,8 @@
         "BUILD_LOG",
         "QUALITY_REPORT",
         "POLICY_DEFINITION",
-        "GENERATED_TEST_CASES"
+        "GENERATED_TEST_CASES",
+        "POLICY_SCENARIOS"
       ]
     },
     "AutomatedReasoningPolicyBuildResultAssets":{
@@ -2775,6 +2776,10 @@
         "generatedTestCases":{
           "shape":"AutomatedReasoningPolicyGeneratedTestCases",
           "documentation":"<p>A comprehensive test suite generated by the build workflow, providing validation capabilities for automated reasoning policies.</p>"
+        },
+        "policyScenarios":{
+          "shape":"AutomatedReasoningPolicyScenarios",
+          "documentation":"<p>An entity encompassing all the policy scenarios generated by the build workflow, which can be used to validate an Automated Reasoning policy. </p>"
         }
       },
       "documentation":"<p>Contains the various assets generated during a policy build workflow, including logs, quality reports, test cases, and the final policy definition.</p>",
@@ -3510,8 +3515,8 @@
       "required":[
         "expression",
         "alternateExpression",
-        "ruleIds",
-        "expectedResult"
+        "expectedResult",
+        "ruleIds"
       ],
       "members":{
         "expression":{
@@ -3522,13 +3527,13 @@
           "shape":"AutomatedReasoningPolicyScenarioAlternateExpression",
           "documentation":"<p>An alternative way to express the same test scenario, used for validation and comparison purposes.</p>"
         },
-        "ruleIds":{
-          "shape":"AutomatedReasoningPolicyDefinitionRuleIdList",
-          "documentation":"<p>The list of rule identifiers that are expected to be triggered or evaluated by this test scenario.</p>"
-        },
         "expectedResult":{
           "shape":"AutomatedReasoningCheckResult",
           "documentation":"<p>The expected outcome when this scenario is evaluated against the policy (e.g., PASS, FAIL, VIOLATION).</p>"
+        },
+        "ruleIds":{
+          "shape":"AutomatedReasoningPolicyDefinitionRuleIdList",
+          "documentation":"<p>The list of rule identifiers that are expected to be triggered or evaluated by this test scenario.</p>"
         }
       },
       "documentation":"<p>Represents a test scenario used to validate an Automated Reasoning policy, including the test conditions and expected outcomes.</p>"
@@ -3545,6 +3550,21 @@
       "min":0,
       "sensitive":true
     },
+    "AutomatedReasoningPolicyScenarioList":{
+      "type":"list",
+      "member":{"shape":"AutomatedReasoningPolicyScenario"}
+    },
+    "AutomatedReasoningPolicyScenarios":{
+      "type":"structure",
+      "required":["policyScenarios"],
+      "members":{
+        "policyScenarios":{
+          "shape":"AutomatedReasoningPolicyScenarioList",
+          "documentation":"<p>Represents a collection of generated policy scenarios.</p>"
+        }
+      },
+      "documentation":"<p>Contains a comprehensive entity encompassing all the scenarios generated by the build workflow, which can be used to validate an Automated Reasoning policy.</p>"
+    },
     "AutomatedReasoningPolicySummaries":{
       "type":"list",
       "member":{"shape":"AutomatedReasoningPolicySummary"},

sdk/src/Services/Bedrock/Generated/Model/AutomatedReasoningPolicyBuildResultAssets.cs

@@ -38,6 +38,7 @@ public partial class AutomatedReasoningPolicyBuildResultAssets
         private AutomatedReasoningPolicyBuildLog _buildLog;
         private AutomatedReasoningPolicyGeneratedTestCases _generatedTestCases;
         private AutomatedReasoningPolicyDefinition _policyDefinition;
+        private AutomatedReasoningPolicyScenarios _policyScenarios;
         private AutomatedReasoningPolicyDefinitionQualityReport _qualityReport;
 
         /// <summary>
@@ -97,6 +98,25 @@ internal bool IsSetPolicyDefinition()
             return this._policyDefinition != null;
         }
 
+        /// <summary>
+        /// Gets and sets the property PolicyScenarios. 
+        /// <para>
+        /// An entity encompassing all the policy scenarios generated by the build workflow, which
+        /// can be used to validate an Automated Reasoning policy. 
+        /// </para>
+        /// </summary>
+        public AutomatedReasoningPolicyScenarios PolicyScenarios
+        {
+            get { return this._policyScenarios; }
+            set { this._policyScenarios = value; }
+        }
+
+        // Check to see if PolicyScenarios property is set
+        internal bool IsSetPolicyScenarios()
+        {
+            return this._policyScenarios != null;
+        }
+
         /// <summary>
         /// Gets and sets the property QualityReport. 
         /// <para>

sdk/src/Services/Bedrock/Generated/Model/AutomatedReasoningPolicyScenarios.cs

@@ -0,0 +1,60 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * 
+ * Licensed under the Apache License, Version 2.0 (the "License").
+ * You may not use this file except in compliance with the License.
+ * A copy of the License is located at
+ * 
+ *  http://aws.amazon.com/apache2.0
+ * 
+ * or in the "license" file accompanying this file. This file is distributed
+ * on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
+ * express or implied. See the License for the specific language governing
+ * permissions and limitations under the License.
+ */
+
+/*
+ * Do not modify this file. This file is generated from the bedrock-2023-04-20.normal.json service model.
+ */
+using System;
+using System.Collections.Generic;
+using System.Xml.Serialization;
+using System.Text;
+using System.IO;
+using System.Net;
+
+using Amazon.Runtime;
+using Amazon.Runtime.Internal;
+
+#pragma warning disable CS0612,CS0618,CS1570
+namespace Amazon.Bedrock.Model
+{
+    /// <summary>
+    /// Contains a comprehensive entity encompassing all the scenarios generated by the build
+    /// workflow, which can be used to validate an Automated Reasoning policy.
+    /// </summary>
+    public partial class AutomatedReasoningPolicyScenarios
+    {
+        private List<AutomatedReasoningPolicyScenario> _policyScenarios = AWSConfigs.InitializeCollections ? new List<AutomatedReasoningPolicyScenario>() : null;
+
+        /// <summary>
+        /// Gets and sets the property PolicyScenarios. 
+        /// <para>
+        /// Represents a collection of generated policy scenarios.
+        /// </para>
+        /// </summary>
+        [AWSProperty(Required=true)]
+        public List<AutomatedReasoningPolicyScenario> PolicyScenarios
+        {
+            get { return this._policyScenarios; }
+            set { this._policyScenarios = value; }
+        }
+
+        // Check to see if PolicyScenarios property is set
+        internal bool IsSetPolicyScenarios()
+        {
+            return this._policyScenarios != null && (this._policyScenarios.Count > 0 || !AWSConfigs.InitializeCollections); 
+        }
+
+    }
+}

sdk/src/Services/Bedrock/Generated/Model/Internal/MarshallTransformations/AutomatedReasoningPolicyBuildResultAssetsUnmarshaller.cs

@@ -84,6 +84,12 @@ public AutomatedReasoningPolicyBuildResultAssets Unmarshall(JsonUnmarshallerCont
                     unmarshalledObject.PolicyDefinition = unmarshaller.Unmarshall(context);
                     continue;
                 }
+                if (context.TestExpression("policyScenarios", targetDepth))
+                {
+                    var unmarshaller = AutomatedReasoningPolicyScenariosUnmarshaller.Instance;
+                    unmarshalledObject.PolicyScenarios = unmarshaller.Unmarshall(context);
+                    continue;
+                }
                 if (context.TestExpression("qualityReport", targetDepth))
                 {
                     var unmarshaller = AutomatedReasoningPolicyDefinitionQualityReportUnmarshaller.Instance;

sdk/src/Services/Bedrock/Generated/Model/Internal/MarshallTransformations/AutomatedReasoningPolicyScenariosUnmarshaller.cs

@@ -0,0 +1,93 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * 
+ * Licensed under the Apache License, Version 2.0 (the "License").
+ * You may not use this file except in compliance with the License.
+ * A copy of the License is located at
+ * 
+ *  http://aws.amazon.com/apache2.0
+ * 
+ * or in the "license" file accompanying this file. This file is distributed
+ * on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
+ * express or implied. See the License for the specific language governing
+ * permissions and limitations under the License.
+ */
+
+/*
+ * Do not modify this file. This file is generated from the bedrock-2023-04-20.normal.json service model.
+ */
+using System;
+using System.Collections.Generic;
+using System.Globalization;
+using System.IO;
+using System.Net;
+using System.Text;
+using System.Xml.Serialization;
+
+using Amazon.Bedrock.Model;
+using Amazon.Runtime;
+using Amazon.Runtime.Internal;
+using Amazon.Runtime.Internal.Transform;
+using Amazon.Runtime.Internal.Util;
+using ThirdParty.Json.LitJson;
+
+#pragma warning disable CS0612,CS0618
+namespace Amazon.Bedrock.Model.Internal.MarshallTransformations
+{
+    /// <summary>
+    /// Response Unmarshaller for AutomatedReasoningPolicyScenarios Object
+    /// </summary>  
+    public class AutomatedReasoningPolicyScenariosUnmarshaller : IUnmarshaller<AutomatedReasoningPolicyScenarios, XmlUnmarshallerContext>, IUnmarshaller<AutomatedReasoningPolicyScenarios, JsonUnmarshallerContext>
+    {
+        /// <summary>
+        /// Unmarshaller the response from the service to the response class.
+        /// </summary>  
+        /// <param name="context"></param>
+        /// <returns></returns>
+        AutomatedReasoningPolicyScenarios IUnmarshaller<AutomatedReasoningPolicyScenarios, XmlUnmarshallerContext>.Unmarshall(XmlUnmarshallerContext context)
+        {
+            throw new NotImplementedException();
+        }
+
+        /// <summary>
+        /// Unmarshaller the response from the service to the response class.
+        /// </summary>  
+        /// <param name="context"></param>
+        /// <returns>The unmarshalled object</returns>
+        public AutomatedReasoningPolicyScenarios Unmarshall(JsonUnmarshallerContext context)
+        {
+            AutomatedReasoningPolicyScenarios unmarshalledObject = new AutomatedReasoningPolicyScenarios();
+            if (context.IsEmptyResponse)
+                return null;
+            context.Read();
+            if (context.CurrentTokenType == JsonToken.Null) 
+                return null;
+
+            int targetDepth = context.CurrentDepth;
+            while (context.ReadAtDepth(targetDepth))
+            {
+                if (context.TestExpression("policyScenarios", targetDepth))
+                {
+                    var unmarshaller = new ListUnmarshaller<AutomatedReasoningPolicyScenario, AutomatedReasoningPolicyScenarioUnmarshaller>(AutomatedReasoningPolicyScenarioUnmarshaller.Instance);
+                    unmarshalledObject.PolicyScenarios = unmarshaller.Unmarshall(context);
+                    continue;
+                }
+            }
+            return unmarshalledObject;
+        }
+
+
+        private static AutomatedReasoningPolicyScenariosUnmarshaller _instance = new AutomatedReasoningPolicyScenariosUnmarshaller();        
+
+        /// <summary>
+        /// Gets the singleton.
+        /// </summary>  
+        public static AutomatedReasoningPolicyScenariosUnmarshaller Instance
+        {
+            get
+            {
+                return _instance;
+            }
+        }
+    }
+}

sdk/src/Services/Bedrock/Generated/ServiceEnumerations.cs

@@ -533,6 +533,10 @@ public class AutomatedReasoningPolicyBuildResultAssetType : ConstantClass
         /// </summary>
         public static readonly AutomatedReasoningPolicyBuildResultAssetType POLICY_DEFINITION = new AutomatedReasoningPolicyBuildResultAssetType("POLICY_DEFINITION");
         /// <summary>
+        /// Constant POLICY_SCENARIOS for AutomatedReasoningPolicyBuildResultAssetType
+        /// </summary>
+        public static readonly AutomatedReasoningPolicyBuildResultAssetType POLICY_SCENARIOS = new AutomatedReasoningPolicyBuildResultAssetType("POLICY_SCENARIOS");
+        /// <summary>
         /// Constant QUALITY_REPORT for AutomatedReasoningPolicyBuildResultAssetType
         /// </summary>
         public static readonly AutomatedReasoningPolicyBuildResultAssetType QUALITY_REPORT = new AutomatedReasoningPolicyBuildResultAssetType("QUALITY_REPORT");