管理私有人力 (OIDC IdP) - Amazon SageMaker
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

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

管理私有人力 (OIDC IdP)

使用 创建私有人力后OpenID Connect (OIDC) 身份提供商 (IdP),您可以使用 IdP 管理工作人员。例如,您可以直接通过 IdP 添加、删除和分组工作人员。

要将工作人员添加到 Amazon SageMaker Ground Truth (Ground Truth) 标记作业或 Amazon Augmented AI (Amazon A2I) 人工审核任务,您可以使用 1-10 IdP 组创建工作团队,并将该工作团队分配给作业或任务。您可以通过在创建标记作业 (Ground Truth) 或人工审核工作流 Amazon A2I() 时指定工作团队来为该工作或任务分配工作团队。

您只能为每个标记作业或人工审核工作流程分配一个团队。您可以使用同一个团队创建多个标记作业或人工审核任务。您还可以创建多个工作团队来处理不同的标记作业或人工审核任务。

Prerequisites

要使用 OIDC IdP 组创建和管理私有工作团队,您必须先使用 SageMaker API CreateWorkforce 操作 创建人力。要了解更多信息,请参阅“创建私有人力 (OIDC IdP)”。

添加工作团队

您可以使用 SageMaker 控制台在 Labeling workforces (标记人力) 页面上的 OIDC IdP Ground Truth 人力创建私有工作团队。如果您要创建Ground Truth标记作业,也可以在创建标记作业时创建私有工作团队。

注意

您可以在 Amazon A2I 控制台的 Ground Truth SageMaker 区域中为 创建和管理工作团队。

您还可以使用 SageMaker API 和关联的特定于语言SDKs来创建私有工作团队。

使用以下过程了解如何使用 SageMaker 控制台和 API 创建私有工作团队。

在 Labeling workforces (标记人力) 页面上创建私有工作团队(控制台)

  1. 转到 Ground Truth 控制台SageMaker的区域https://console.aws.amazon.com/sagemaker/groundtruth

  2. 选择 Labeling workforces (标记人力)。

  3. 选择 Private (私有)。

  4. Private teams (私有团队) 部分中,选择 Create private team (创建私有团队)。

  5. Team details (团队详细信息) 部分中,输入 Team name (团队名称)。

  6. Add workers (添加工作人员) 部分中,输入单个用户组的名称。IdP 中与此组关联的所有工作人员都将添加到此工作团队。

  7. 要添加多个用户组,请选择 Add new user group (添加新用户组),然后输入要添加到此工作团队的用户组的名称。每行输入一个用户组。

  8. (可选)对于Ground Truth标记作业,如果您为 JWT 中的工作人员提供电子邮件,则 会在新的标记任务可用时(如果您选择 SNS 主题Ground Truth)通知工作人员。

  9. 选择 Create private team (创建私有团队)。

在创建Ground Truth标记作业时创建私有工作团队(控制台)

  1. 转到 Ground Truth 控制台SageMaker的区域https://console.aws.amazon.com/sagemaker/groundtruth

  2. 选择 Labeling jobs (标记作业)。

  3. 按照中的说明创建标记作业(控制台)创建标记作业。当您转到第二页上的 Workers (工作人员) 部分时停止。

  4. 为工作人员类型选择 Private (私有)。

  5. 输入 Team name (团队名称)。

  6. Add workers (添加工作人员) 部分中,在 User groups (用户组) 下输入单个用户组的名称。IdP 中与此组关联的所有工作人员都将添加到此工作团队。

    重要

    您为 User groups (用户组) 指定的组名称必须与 OIDC IdP 中指定的组名称匹配。

  7. 要添加多个用户组,请选择 Add new user group (添加新用户组),然后输入要添加到此工作团队的用户组的名称。每行输入一个用户组。

  8. 完成所有剩余步骤以创建标记作业。

您创建的私有团队将用于此标记作业,并列在 控制台的 Labeling workforcesSageMaker (标记人力) 部分中。

使用 SageMaker API 创建私有工作团队

您可以使用 SageMaker API 操作 创建私有工作团队CreateWorkteam

当您使用此操作时,请在OidcMemberDefinition参数 中列出您希望包含在工作团队中的所有用户组Groups

重要

您为 指定的组名称Groups必须与 OIDC IdP 中指定的组名称匹配。

例如,如果您的 OIDC IdP group1 中的用户组名称为 group2group3和 ,请按OidcMemberDefinition以下方式配置 :

"OidcMemberDefinition": { "Groups": ["group1", "group2", "group3"] }

此外,您必须使用 WorkteamName 参数为工作团队指定一个名称。

在工作团队中添加或删除 IdP 组

创建工作团队后,您可以使用 SageMaker API 管理该工作团队。使用 UpdateWorkteam 操作更新该工作团队中包含的 IdP 用户组。

  • 使用 WorkteamName 参数标识要更新的工作团队。

  • 当您使用此操作时,请在OidcMemberDefinition参数 中列出您希望包含在工作团队中的所有用户组Groups。如果某个用户组与工作团队关联,而您没有将它包含在此列表中,则该用户组将不再与此工作团队关联。

删除工作团队

您可以使用 SageMaker 控制台和 SageMaker API 删除工作团队。

在 SageMaker 控制台中删除私有工作团队

  1. 转到 Ground Truth 控制台SageMaker的区域https://console.aws.amazon.com/sagemaker/groundtruth

  2. 选择 Labeling workforces (标记人力)。

  3. 选择 Private (私有)。

  4. Private teams (私有团队) 部分中,选择要删除的工作团队。

  5. 选择 Delete (删除)。

删除私有工作团队 (API)

您可以使用 SageMaker API 操作 删除私有工作团队DeleteWorkteam

管理单个工作人员

当您使用自己的 OIDC IdP 创建人力时,不能使用 Ground Truth 或 Amazon A2I 来管理单个工作人员。

  • 要向工作团队添加工作人员,请将该工作人员添加到与该工作团队关联的组。

  • 要从工作团队中删除一个工作人员,请从与该工作团队关联的所有用户组中删除该工作人员。

更新、删除和描述人力

您可以使用 SageMaker API 更新、删除和描述 OIDC IdP 人力。以下是可用于管理人力的 API 操作的列表。有关其他详细信息(包括如何查找人力名称),请参阅使用 Amazon SageMaker API 管理私有人力

  • UpdateWorkforce – 您可能需要更新使用您自己的 OIDC IdP 创建的人力,以指定不同的授权终端节点、令牌终端节点或发布者。您可以使用OidcConfig此操作更新在 中找到的任何参数。

    您只能在没有与人力关联的工作团队时更新 OIDC IdP 配置。要了解如何删除工作团队,请参阅删除工作团队

  • DeleteWorkforce – 使用此操作可删除您的私有人力。如果您有与您的人力关联的任何工作团队,则必须删除这些工作团队,然后再删除您的人力。有关更多信息,请参阅删除工作团队

  • DescribeWorkforce – 使用此操作可列出私有人力信息,包括人力名称、Amazon 资源名称 (ARN) 和允许的 IP 地址范围 (CIDRs如果适用)。