Skip to content

Commit d06db0b

Browse files
author
AWS
committed
Amazon Bedrock Runtime Update: This release adds support for Automated Reasoning checks output models for the Amazon Bedrock Guardrails ApplyGuardrail API.
1 parent e8048ba commit d06db0b

File tree

2 files changed

+327
-0
lines changed

2 files changed

+327
-0
lines changed

‎.changes/next-release/feature-AmazonBedrockRuntime-0234baf.json

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
{
2+
"type": "feature",
3+
"category": "Amazon Bedrock Runtime",
4+
"contributor": "",
5+
"description": "This release adds support for Automated Reasoning checks output models for the Amazon Bedrock Guardrails ApplyGuardrail API."
6+
}

‎services/bedrockruntime/src/main/resources/codegen-resources/service-2.json

Lines changed: 321 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -421,6 +421,12 @@
421421
},
422422
"documentation":"<p>The Model automatically decides if a tool should be called or whether to generate text instead. For example, <code>{\"auto\" : {}}</code>.</p>"
423423
},
424+
"AutomatedReasoningRuleIdentifier":{
425+
"type":"string",
426+
"max":12,
427+
"min":0,
428+
"pattern":"[a-z0-9]{12}"
429+
},
424430
"BidirectionalInputPayloadPart":{
425431
"type":"structure",
426432
"members":{
@@ -1359,6 +1365,10 @@
13591365
"shape":"GuardrailContextualGroundingPolicyAssessment",
13601366
"documentation":"<p>The contextual grounding policy used for the guardrail assessment.</p>"
13611367
},
1368+
"automatedReasoningPolicy":{
1369+
"shape":"GuardrailAutomatedReasoningPolicyAssessment",
1370+
"documentation":"<p>The automated reasoning policy assessment results, including logical validation findings for the input content.</p>"
1371+
},
13621372
"invocationMetrics":{
13631373
"shape":"GuardrailInvocationMetrics",
13641374
"documentation":"<p>The invocation metrics for the guardrail assessment.</p>"
@@ -1380,6 +1390,309 @@
13801390
"key":{"shape":"String"},
13811391
"value":{"shape":"GuardrailAssessment"}
13821392
},
1393+
"GuardrailAutomatedReasoningDifferenceScenarioList":{
1394+
"type":"list",
1395+
"member":{"shape":"GuardrailAutomatedReasoningScenario"},
1396+
"max":2,
1397+
"min":0
1398+
},
1399+
"GuardrailAutomatedReasoningFinding":{
1400+
"type":"structure",
1401+
"members":{
1402+
"valid":{"shape":"GuardrailAutomatedReasoningValidFinding"},
1403+
"invalid":{"shape":"GuardrailAutomatedReasoningInvalidFinding"},
1404+
"satisfiable":{"shape":"GuardrailAutomatedReasoningSatisfiableFinding"},
1405+
"impossible":{"shape":"GuardrailAutomatedReasoningImpossibleFinding"},
1406+
"translationAmbiguous":{"shape":"GuardrailAutomatedReasoningTranslationAmbiguousFinding"},
1407+
"tooComplex":{"shape":"GuardrailAutomatedReasoningTooComplexFinding"},
1408+
"noTranslations":{"shape":"GuardrailAutomatedReasoningNoTranslationsFinding"}
1409+
},
1410+
"documentation":"<p>Represents a logical validation result from automated reasoning policy evaluation. The finding indicates whether claims in the input are logically valid, invalid, satisfiable, impossible, or have other logical issues.</p>",
1411+
"union":true
1412+
},
1413+
"GuardrailAutomatedReasoningFindingList":{
1414+
"type":"list",
1415+
"member":{"shape":"GuardrailAutomatedReasoningFinding"}
1416+
},
1417+
"GuardrailAutomatedReasoningImpossibleFinding":{
1418+
"type":"structure",
1419+
"members":{
1420+
"translation":{
1421+
"shape":"GuardrailAutomatedReasoningTranslation",
1422+
"documentation":"<p>The logical translation of the input that this finding evaluates.</p>"
1423+
},
1424+
"contradictingRules":{
1425+
"shape":"GuardrailAutomatedReasoningRuleList",
1426+
"documentation":"<p>The automated reasoning policy rules that contradict the claims and/or premises in the input.</p>"
1427+
},
1428+
"logicWarning":{
1429+
"shape":"GuardrailAutomatedReasoningLogicWarning",
1430+
"documentation":"<p>Indication of a logic issue with the translation without needing to consider the automated reasoning policy rules.</p>"
1431+
}
1432+
},
1433+
"documentation":"<p>Indicates that no valid claims can be made due to logical contradictions in the premises or rules.</p>"
1434+
},
1435+
"GuardrailAutomatedReasoningInputTextReference":{
1436+
"type":"structure",
1437+
"members":{
1438+
"text":{
1439+
"shape":"GuardrailAutomatedReasoningStatementNaturalLanguageContent",
1440+
"documentation":"<p>The specific text from the original input that this reference points to.</p>"
1441+
}
1442+
},
1443+
"documentation":"<p>References a portion of the original input text that corresponds to logical elements.</p>"
1444+
},
1445+
"GuardrailAutomatedReasoningInputTextReferenceList":{
1446+
"type":"list",
1447+
"member":{"shape":"GuardrailAutomatedReasoningInputTextReference"}
1448+
},
1449+
"GuardrailAutomatedReasoningInvalidFinding":{
1450+
"type":"structure",
1451+
"members":{
1452+
"translation":{
1453+
"shape":"GuardrailAutomatedReasoningTranslation",
1454+
"documentation":"<p>The logical translation of the input that this finding invalidates.</p>"
1455+
},
1456+
"contradictingRules":{
1457+
"shape":"GuardrailAutomatedReasoningRuleList",
1458+
"documentation":"<p>The automated reasoning policy rules that contradict the claims in the input.</p>"
1459+
},
1460+
"logicWarning":{
1461+
"shape":"GuardrailAutomatedReasoningLogicWarning",
1462+
"documentation":"<p>Indication of a logic issue with the translation without needing to consider the automated reasoning policy rules.</p>"
1463+
}
1464+
},
1465+
"documentation":"<p>Indicates that the claims are logically false and contradictory to the established rules or premises.</p>"
1466+
},
1467+
"GuardrailAutomatedReasoningLogicWarning":{
1468+
"type":"structure",
1469+
"members":{
1470+
"type":{
1471+
"shape":"GuardrailAutomatedReasoningLogicWarningType",
1472+
"documentation":"<p>The category of the detected logical issue, such as statements that are always true or always false.</p>"
1473+
},
1474+
"premises":{
1475+
"shape":"GuardrailAutomatedReasoningStatementList",
1476+
"documentation":"<p>The logical statements that serve as premises under which the claims are validated.</p>"
1477+
},
1478+
"claims":{
1479+
"shape":"GuardrailAutomatedReasoningStatementList",
1480+
"documentation":"<p>The logical statements that are validated while assuming the policy and premises.</p>"
1481+
}
1482+
},
1483+
"documentation":"<p>Identifies logical issues in the translated statements that exist independent of any policy rules, such as statements that are always true or always false.</p>"
1484+
},
1485+
"GuardrailAutomatedReasoningLogicWarningType":{
1486+
"type":"string",
1487+
"enum":[
1488+
"ALWAYS_FALSE",
1489+
"ALWAYS_TRUE"
1490+
]
1491+
},
1492+
"GuardrailAutomatedReasoningNoTranslationsFinding":{
1493+
"type":"structure",
1494+
"members":{
1495+
},
1496+
"documentation":"<p>Indicates that no relevant logical information could be extracted from the input for validation.</p>"
1497+
},
1498+
"GuardrailAutomatedReasoningPoliciesProcessed":{
1499+
"type":"integer",
1500+
"box":true
1501+
},
1502+
"GuardrailAutomatedReasoningPolicyAssessment":{
1503+
"type":"structure",
1504+
"members":{
1505+
"findings":{
1506+
"shape":"GuardrailAutomatedReasoningFindingList",
1507+
"documentation":"<p>List of logical validation results produced by evaluating the input content against automated reasoning policies.</p>"
1508+
}
1509+
},
1510+
"documentation":"<p>Contains the results of automated reasoning policy evaluation, including logical findings about the validity of claims made in the input content.</p>"
1511+
},
1512+
"GuardrailAutomatedReasoningPolicyUnitsProcessed":{
1513+
"type":"integer",
1514+
"box":true
1515+
},
1516+
"GuardrailAutomatedReasoningPolicyVersionArn":{
1517+
"type":"string",
1518+
"max":2048,
1519+
"min":0,
1520+
"pattern":"arn:aws(-[^:]+)?:bedrock:[a-z0-9-]{1,20}:[0-9]{12}:automated-reasoning-policy/[a-z0-9]{12}(:([1-9][0-9]{0,11}))?"
1521+
},
1522+
"GuardrailAutomatedReasoningRule":{
1523+
"type":"structure",
1524+
"members":{
1525+
"identifier":{
1526+
"shape":"AutomatedReasoningRuleIdentifier",
1527+
"documentation":"<p>The unique identifier of the automated reasoning rule.</p>"
1528+
},
1529+
"policyVersionArn":{
1530+
"shape":"GuardrailAutomatedReasoningPolicyVersionArn",
1531+
"documentation":"<p>The ARN of the automated reasoning policy version that contains this rule.</p>"
1532+
}
1533+
},
1534+
"documentation":"<p>References a specific automated reasoning policy rule that was applied during evaluation.</p>"
1535+
},
1536+
"GuardrailAutomatedReasoningRuleList":{
1537+
"type":"list",
1538+
"member":{"shape":"GuardrailAutomatedReasoningRule"}
1539+
},
1540+
"GuardrailAutomatedReasoningSatisfiableFinding":{
1541+
"type":"structure",
1542+
"members":{
1543+
"translation":{
1544+
"shape":"GuardrailAutomatedReasoningTranslation",
1545+
"documentation":"<p>The logical translation of the input that this finding evaluates.</p>"
1546+
},
1547+
"claimsTrueScenario":{
1548+
"shape":"GuardrailAutomatedReasoningScenario",
1549+
"documentation":"<p>An example scenario demonstrating how the claims could be logically true.</p>"
1550+
},
1551+
"claimsFalseScenario":{
1552+
"shape":"GuardrailAutomatedReasoningScenario",
1553+
"documentation":"<p>An example scenario demonstrating how the claims could be logically false.</p>"
1554+
},
1555+
"logicWarning":{
1556+
"shape":"GuardrailAutomatedReasoningLogicWarning",
1557+
"documentation":"<p>Indication of a logic issue with the translation without needing to consider the automated reasoning policy rules.</p>"
1558+
}
1559+
},
1560+
"documentation":"<p>Indicates that the claims could be either true or false depending on additional assumptions not provided in the input.</p>"
1561+
},
1562+
"GuardrailAutomatedReasoningScenario":{
1563+
"type":"structure",
1564+
"members":{
1565+
"statements":{
1566+
"shape":"GuardrailAutomatedReasoningStatementList",
1567+
"documentation":"<p>List of logical assignments and statements that define this scenario.</p>"
1568+
}
1569+
},
1570+
"documentation":"<p>Represents a logical scenario where claims can be evaluated as true or false, containing specific logical assignments.</p>"
1571+
},
1572+
"GuardrailAutomatedReasoningStatement":{
1573+
"type":"structure",
1574+
"members":{
1575+
"logic":{
1576+
"shape":"GuardrailAutomatedReasoningStatementLogicContent",
1577+
"documentation":"<p>The formal logical representation of the statement.</p>"
1578+
},
1579+
"naturalLanguage":{
1580+
"shape":"GuardrailAutomatedReasoningStatementNaturalLanguageContent",
1581+
"documentation":"<p>The natural language explanation of the logical statement.</p>"
1582+
}
1583+
},
1584+
"documentation":"<p>A logical statement that includes both formal logic representation and natural language explanation.</p>"
1585+
},
1586+
"GuardrailAutomatedReasoningStatementList":{
1587+
"type":"list",
1588+
"member":{"shape":"GuardrailAutomatedReasoningStatement"}
1589+
},
1590+
"GuardrailAutomatedReasoningStatementLogicContent":{
1591+
"type":"string",
1592+
"max":1000,
1593+
"min":0,
1594+
"sensitive":true
1595+
},
1596+
"GuardrailAutomatedReasoningStatementNaturalLanguageContent":{
1597+
"type":"string",
1598+
"max":1000,
1599+
"min":0,
1600+
"sensitive":true
1601+
},
1602+
"GuardrailAutomatedReasoningTooComplexFinding":{
1603+
"type":"structure",
1604+
"members":{
1605+
},
1606+
"documentation":"<p>Indicates that the input exceeds the processing capacity due to the volume or complexity of the logical information.</p>"
1607+
},
1608+
"GuardrailAutomatedReasoningTranslation":{
1609+
"type":"structure",
1610+
"members":{
1611+
"premises":{
1612+
"shape":"GuardrailAutomatedReasoningStatementList",
1613+
"documentation":"<p>The logical statements that serve as the foundation or assumptions for the claims.</p>"
1614+
},
1615+
"claims":{
1616+
"shape":"GuardrailAutomatedReasoningStatementList",
1617+
"documentation":"<p>The logical statements that are being validated against the premises and policy rules.</p>"
1618+
},
1619+
"untranslatedPremises":{
1620+
"shape":"GuardrailAutomatedReasoningInputTextReferenceList",
1621+
"documentation":"<p>References to portions of the original input text that correspond to the premises but could not be fully translated.</p>"
1622+
},
1623+
"untranslatedClaims":{
1624+
"shape":"GuardrailAutomatedReasoningInputTextReferenceList",
1625+
"documentation":"<p>References to portions of the original input text that correspond to the claims but could not be fully translated.</p>"
1626+
},
1627+
"confidence":{
1628+
"shape":"GuardrailAutomatedReasoningTranslationConfidence",
1629+
"documentation":"<p>A confidence score between 0 and 1 indicating how certain the system is about the logical translation.</p>"
1630+
}
1631+
},
1632+
"documentation":"<p>Contains the logical translation of natural language input into formal logical statements, including premises, claims, and confidence scores.</p>"
1633+
},
1634+
"GuardrailAutomatedReasoningTranslationAmbiguousFinding":{
1635+
"type":"structure",
1636+
"members":{
1637+
"options":{
1638+
"shape":"GuardrailAutomatedReasoningTranslationOptionList",
1639+
"documentation":"<p>Different logical interpretations that were detected during translation of the input.</p>"
1640+
},
1641+
"differenceScenarios":{
1642+
"shape":"GuardrailAutomatedReasoningDifferenceScenarioList",
1643+
"documentation":"<p>Scenarios showing how the different translation options differ in meaning.</p>"
1644+
}
1645+
},
1646+
"documentation":"<p>Indicates that the input has multiple valid logical interpretations, requiring additional context or clarification.</p>"
1647+
},
1648+
"GuardrailAutomatedReasoningTranslationConfidence":{
1649+
"type":"double",
1650+
"box":true,
1651+
"max":1,
1652+
"min":0
1653+
},
1654+
"GuardrailAutomatedReasoningTranslationList":{
1655+
"type":"list",
1656+
"member":{"shape":"GuardrailAutomatedReasoningTranslation"}
1657+
},
1658+
"GuardrailAutomatedReasoningTranslationOption":{
1659+
"type":"structure",
1660+
"members":{
1661+
"translations":{
1662+
"shape":"GuardrailAutomatedReasoningTranslationList",
1663+
"documentation":"<p>Example translations that provide this possible interpretation of the input.</p>"
1664+
}
1665+
},
1666+
"documentation":"<p>Represents one possible logical interpretation of ambiguous input content.</p>"
1667+
},
1668+
"GuardrailAutomatedReasoningTranslationOptionList":{
1669+
"type":"list",
1670+
"member":{"shape":"GuardrailAutomatedReasoningTranslationOption"},
1671+
"max":2,
1672+
"min":0
1673+
},
1674+
"GuardrailAutomatedReasoningValidFinding":{
1675+
"type":"structure",
1676+
"members":{
1677+
"translation":{
1678+
"shape":"GuardrailAutomatedReasoningTranslation",
1679+
"documentation":"<p>The logical translation of the input that this finding validates.</p>"
1680+
},
1681+
"claimsTrueScenario":{
1682+
"shape":"GuardrailAutomatedReasoningScenario",
1683+
"documentation":"<p>An example scenario demonstrating how the claims are logically true.</p>"
1684+
},
1685+
"supportingRules":{
1686+
"shape":"GuardrailAutomatedReasoningRuleList",
1687+
"documentation":"<p>The automated reasoning policy rules that support why this result is considered valid.</p>"
1688+
},
1689+
"logicWarning":{
1690+
"shape":"GuardrailAutomatedReasoningLogicWarning",
1691+
"documentation":"<p>Indication of a logic issue with the translation without needing to consider the automated reasoning policy rules.</p>"
1692+
}
1693+
},
1694+
"documentation":"<p>Indicates that the claims are definitively true and logically implied by the premises, with no possible alternative interpretations.</p>"
1695+
},
13831696
"GuardrailConfiguration":{
13841697
"type":"structure",
13851698
"required":[
@@ -2190,6 +2503,14 @@
21902503
"contentPolicyImageUnits":{
21912504
"shape":"GuardrailContentPolicyImageUnitsProcessed",
21922505
"documentation":"<p>The content policy image units processed by the guardrail.</p>"
2506+
},
2507+
"automatedReasoningPolicyUnits":{
2508+
"shape":"GuardrailAutomatedReasoningPolicyUnitsProcessed",
2509+
"documentation":"<p>The number of text units processed by the automated reasoning policy.</p>"
2510+
},
2511+
"automatedReasoningPolicies":{
2512+
"shape":"GuardrailAutomatedReasoningPoliciesProcessed",
2513+
"documentation":"<p>The number of automated reasoning policies that were processed during the guardrail evaluation.</p>"
21932514
}
21942515
},
21952516
"documentation":"<p>The details on the use of the guardrail.</p>"

0 commit comments

Comments
 (0)