将人工循环激活条件 JSON 架构与 Amazon Rekognition 结合使用 - Amazon SageMaker
ModerationLabelConfidenceCheck 输入采样输入示例
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 Amazon Web Services 服务入门。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

将人工循环激活条件 JSON 架构与 Amazon Rekognition 结合使用

与 Amazon A2I 一起使用时，Amazon Rekognition 将与结合使用的 Amazon RekognDetectModerationLabels操作支持以下输入：ConditionType参数：

  • ModerationLabelConfidenceCheck— 使用此条件类型可在一个或多个指定标签的推理置信度低时创建人工循环。

  • Sampling— 使用此条件指定发送进行人工审核的所有推理的百分比。使用此条件来执行以下操作：

    • 通过对模型的所有推理随机抽样并将指定的百分比发送进行人工审核，对 ML 模型进行审计。

    • 使用 ModerationLabelConfidenceCheck 条件随机抽样满足 ModerationLabelConfidenceCheck 中指定的条件的一定百分比的推理以启动人工循环，并仅发送指定的百分比进行人工审核。

注意

如果你将同样的请求发送到DetectModerationLabels多次，结果Sampling不会因为该输入的推断而改变。例如，如果你做了DetectModerationLabels请求一次，然后Sampling不会启动人类循环，随后请求DetectModerationLabels使用相同的配置不要启动人类循环。

在创建流程定义时，如果您使用中提供的默认工作人员任务模板人工审核工作流在 Amazon SageMaker 控制台的部分，当工作人员打开任务时，按照这些激活条件发送的供人员审阅的推论将包含在工作人员 UI 中。如果您使用自定义工作人员任务模板，则需要包含 <task.input.selectedAiServiceResponse.blocks> 自定义 HTML 元素来访问这些推理。有关使用此 HTML 元素的自定义模板示例，请参阅 Amazon Rekognition 的自定义模板示例。

ModerationLabelConfidenceCheck 输入

对于 ModerationLabelConfidenceCheck ConditionType，支持以下 ConditionParameters：

  • ModerationLabelName— 一个的确切（区分大小写）名称ModerationLabelAmazon Rekognition 检测到DetectModerationLabelsoperation. 您可以指定包罗万象的特殊值 (*) 来表示任何审核标签。

  • ConfidenceEquals

  • ConfidenceLessThan

  • ConfidenceLessThanEquals

  • ConfidenceGreaterThan

  • ConfidenceGreaterThanEquals

当您使用ModerationLabelConfidenceCheck ConditionType中，亚马逊 A2I 为您在中指定的标签发送标签推理ModerationLabelName供人类评论。

采样输入

Sampling ConditionType 现在支持 RandomSamplingPercentage ConditionParameters。RandomSamplingPercentage 参数的输入应是 0.01 到 100 之间的实数。此数字表示符合人工审核条件并将发送进行人工审核的推理百分比。如果您在不使用任何其他条件的情况下使用 Sampling 条件，则此数字表示单个 DetectModerationLabel 请求生成的所有推理中，发送供人工审核的百分比。

示例

示例 1：使用ModerationLabelConfidenceCheck使用And操作者

以下示例为HumanLoopActivationConditions在满足以下一个或多个条件时，条件启动人工循环：

  • Amazon Rekognition 检测到Graphic Male Nudity置信度介于 90 到 99 之间的审核标签。

  • Amazon Rekognition 检测到Graphic Female Nudity有信度介于 80 到 99 之间的审核标签。

请注意使用Or和And为此逻辑建模的逻辑运算符。

虽然在这两个条件中只有一个Or运营商需要评估才能true为了创建人类循环，亚马逊 Augmented AI 会评估所有条件。人工审核者需要审查评估到的所有条件的审核标签true.

{
     "Conditions": [{
         "Or": [{
                 "And": [{
                         "ConditionType": "ModerationLabelConfidenceCheck",
                         "ConditionParameters": {
                             "ModerationLabelName": "Graphic Male Nudity",
                             "ConfidenceLessThanEquals": 99
                         }
                     },
                     {
                         "ConditionType": "ModerationLabelConfidenceCheck",
                         "ConditionParameters": {
                             "ModerationLabelName": "Graphic Male Nudity",
                             "ConfidenceGreaterThanEquals": 90
                         }
                     }
                 ]
             },
             {
                 "And": [{
                         "ConditionType": "ModerationLabelConfidenceCheck",
                         "ConditionParameters": {
                             "ModerationLabelName": "Graphic Female Nudity",
                             "ConfidenceLessThanEquals": 99
                         }
                     },
                     {
                         "ConditionType": "ModerationLabelConfidenceCheck",
                         "ConditionParameters": {
                             "ModerationLabelName": "Graphic Female Nudity",
                             "ConfidenceGreaterThanEquals": 80
                         }
                     }
                 ]
             }
         ]
     }]
}

示例 2：使用ModerationLabelConfidenceCheck具有全部捕获值 (*)

在以下示例中，如果检测到置信度大于或等于 75 的任何审核标签，则会启动人工循环。人工审核者需要审核置信度得分大于或等于 75 的所有审核标签。

{
    "Conditions": [
        {
            "ConditionType": "ModerationLabelConfidenceCheck",
            "ConditionParameters": {
                "ModerationLabelName": "*",
                "ConfidenceGreaterThanEquals": 75
            }
        }
    ]
}

示例 3：使用采样

在下面的示例中，5% 的 Amazon Rekognition 推理来自DetectModerationLabels请求将发送给工作人员。使用 SageMaker 控制台中提供的默认工作人员任务模板时，Amazon Rekognition 返回的所有审核标签都将发送给工作人员以供审核。

{
  "Conditions": [
    {
      "ConditionType": "Sampling",
      "ConditionParameters": {
        "RandomSamplingPercentage": 5
      }
    }
  ]
}

示例 4：使用采样和ModerationLabelConfidenceCheck使用And操作者

在这个例子中，有 5％ 的 Amazon Rekognition 推断Graphic Male Nudity将置信度大于 50 的审核标签发送给工作人员进行审核。使用 SageMaker 控制台中提供的默认工作人员任务模板时，只有Graphic Male Nudity标签将发送给工作人员以进行审查。

{
  "Conditions": [
    {
      "And": [
        {
          "ConditionType": "Sampling",
          "ConditionParameters": {
            "RandomSamplingPercentage": 5
          }
        },
        {
          "ConditionType": "ModerationLabelConfidenceCheck",
          "ConditionParameters": {
            "ModerationLabelName": "Graphic Male Nudity",
            "ConfidenceGreaterThan": 50
          }
        }
      ]
    }
  ]
}

示例 5：使用采样和ModerationLabelConfidenceCheck使用And操作者

使用此示例可以配置人工审核工作流，始终将指定标签的低置信度推理发送进行人工审核，并按指定比率抽样标签的高置信度推理。

在以下示例中，通过以下方式之一启动人工审核：

  • 对于 Graphic Male Nudity 审核标签的推理，在置信度分数小于 60 时将始终发送供人工审核。仅将 Graphic Male Nudity 标签发送给工作人员以进行审查。

  • 所有推论中的 5％Graphic Male Nudity将置信度分数大于 90 的审核标签发送给工人工审核。仅将 Graphic Male Nudity 标签发送给工作人员以进行审查。

{
  "Conditions": [
    {
      "Or": [
        {
          "ConditionType": "ModerationLabelConfidenceCheck",
          "ConditionParameters": {
            "ModerationLabelName": "Graphic Male Nudity",
            "ConfidenceLessThan": 60
          }
        },
        {
            "And": [
                {
                    "ConditionType": "Sampling",
                    "ConditionParameters": {
                        "RandomSamplingPercentage": 5
                    }
                },
                {
                    "ConditionType": "ModerationLabelConfidenceCheck",
                    "ConditionParameters": {
                        "ModerationLabelName": "Graphic Male Nudity",
                        "ConfidenceGreaterThan": 90
                    }
                }
            ]
        }
      ]
    }
  ]
}

示例 6：使用采样和ModerationLabelConfidenceCheck使用Or操作者

在以下示例中，如果 Amazon Rekognition 推理响应包含 “图形男性裸体” 标签且推理置信度大于 50，则会创建人工循环。此外，所有其他推理中有 5% 的推理启动了人工循环。

{
  "Conditions": [
    {
      "Or": [
        {
          "ConditionType": "Sampling",
          "ConditionParameters": {
            "RandomSamplingPercentage": 5
          }
        },
        {
          "ConditionType": "ModerationLabelConfidenceCheck",
          "ConditionParameters": {
            "ModerationLabelName": "Graphic Male Nudity",
            "ConfidenceGreaterThan": 50
          }
        }
      ]
    }
  ]
}