Gerenciar uma força de trabalho privada (OIDC IdP)

Depois de criar uma força de trabalho privada usando seu provedor de identidade (IdP) do OpenID Connect (OIDC), você pode gerenciar seus operadores usando seu IdP. Por exemplo, você pode adicionar, remover e agrupar trabalhadores diretamente por meio do seu IdP.

Para adicionar trabalhadores a um trabalho de rotulagem do Amazon SageMaker Ground Truth (Ground Truth) ou à tarefa de revisão humana do Amazon Augmented AI (Amazon A2I), você cria equipes de trabalho usando de 1 a 10 grupos de IdP e atribui essa equipe de trabalho ao trabalho ou tarefa. Você atribui uma equipe de trabalho a um trabalho ou tarefa especificando essa equipe de trabalho ao criar um trabalho de rotulagem (Ground Truth) ou um fluxo de trabalho de revisão humana (Amazon A2I).

Você só pode atribuir uma equipe para cada trabalho de rotulagem ou fluxo de trabalho de análise humana. Você pode usar a mesma equipe para criar vários trabalhos de rotulagem ou tarefas de revisão humana. Você também pode criar várias equipes de trabalho para trabalhar em diferentes trabalhos de rotulagem ou tarefas de revisão humana.

Pré-requisitos

Para criar e gerenciar equipes de trabalho privadas usando seus grupos de IdP do OIDC, primeiro você deve criar uma força de trabalho usando a operação da API. SageMaker CreateWorkforce Para saber mais, consulte Criar uma força de trabalho privada (OIDC IdP).

Adicione equipes de trabalho

Você pode usar o SageMaker console para criar uma equipe de trabalho privada usando sua força de trabalho do OIDC IdP na página Labeling workforces em Ground Truth. Se você estiver criando um trabalho de rotulagem do Ground Truth, você também pode criar uma equipe de trabalho privada ao criar um trabalho de rotulagem.

nota

Você cria e gerencia equipes de trabalho para o Amazon A2I na área Ground Truth do SageMaker console.

Você também pode usar a SageMaker API e os SDKs específicos do idioma associados para criar uma equipe de trabalho privada.

Use os procedimentos a seguir para aprender a criar uma equipe de trabalho privada usando o SageMaker console e a API.

Para criar uma equipe de trabalho privada na página Labeling workforces (console)

1. Acesse a área Ground Truth do SageMaker console: https://console.aws.amazon.com/sagemaker/groundtruth.

2. Selecione Forças de trabalho de rotulagem.

3. Selecione Privado.

4. Na seção Equipes privadas, selecione Criar equipe privada.

5. Na seção Detalhes da equipe, insira o nome da equipe.

6. Na seção Adicionar trabalhadores, insira o nome de um único grupo de usuários. Todos os trabalhadores associados a esse grupo em seu IdP são adicionados a essa equipe de trabalho.

7. Para adicionar mais de um grupo de usuários, selecione Adicionar novo grupo de usuários e insira os nomes dos grupos de usuários que você deseja adicionar a essa equipe de trabalho. Insira um grupo de usuários por linha.

8. (Opcional) Para trabalhos de rotulagem do Ground Truth, se você fornecer um e-mail para os operadores em seu JWT, o Ground Truth notificará os trabalhadores quando uma nova tarefa de rotulagem estiver disponível se você selecionar um tópico SNS.

9. Selecione Criar equipe privada.

Como criar uma equipe de trabalho privada ao criar um trabalho de rotulagem Ground Truth (console)

1. Acesse a área Ground Truth do SageMaker console: https://console.aws.amazon.com/sagemaker/groundtruth.

2. Selecione Trabalhos de rotulagem.

3. Use as instruções em Criar um trabalho de rotulagem (console) para criar um trabalho de rotulagem. Pare quando chegar à seção Operadores na segunda página.

4. Selecione Privado para seu tipo de operador.

5. Insira um Nome de equie.

6. Na seção Adicionar trabalhadores, insira o nome de um único grupo de usuários em Grupos de usuários. Todos os trabalhadores associados a esse grupo em seu IdP são adicionados a essa equipe de trabalho.

   Importante

   Os nomes dos grupos que você especificar para grupos de usuários devem corresponder aos nomes dos grupos especificados no seu IdP do OIDC.

7. Para adicionar mais de um grupo de usuários, selecione Adicionar novo grupo de usuários e insira os nomes dos grupos de usuários que você deseja adicionar a essa equipe de trabalho. Insira um grupo de usuários por linha.

8. Conclua todas as etapas restantes para criar seu trabalho de rotulagem.

A equipe privada que você cria é usada para esse trabalho de etiquetagem e está listada na seção Rotulagem de forças de trabalho do SageMaker console.

Para criar uma equipe de trabalho privada usando a SageMaker API

Você pode criar uma equipe de trabalho privada usando a operação SageMaker da APICreateWorkteam.

Ao usar essa operação, liste todos os grupos de usuários que você deseja incluir na equipe de trabalho no OidcMemberDefinition parâmetro Groups.

Importante

Os nomes dos grupos que você especificar para Groups devem corresponder aos nomes dos grupos especificados no seu IdP do OIDC.

Por exemplo, se os nomes dos seus grupos de usuários forem group1, group2 e group3 no seu IdP do OIDC, configure OidcMemberDefinition da seguinte forma:

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

Além disso, você deve dar um nome à equipe de trabalho usando o parâmetro WorkteamName.

Adicionar ou remover grupos de IdP das equipes de trabalho

Depois de criar uma equipe de trabalho, você pode usar a SageMaker API para gerenciar essa equipe de trabalho. Use a operação UpdateWorkteam para atualizar os grupos de usuários do IdP incluídos nessa equipe de trabalho.

• Use o parâmetro WorkteamName para identificar a equipe de trabalho que você deseja atualizar.

• Ao usar essa operação, liste todos os grupos de usuários que você deseja incluir na equipe de trabalho no parâmetroOidcMemberDefinition Groups. Se um grupo de usuários estiver associado a uma equipe de trabalho e você não o incluir nessa lista, esse grupo de usuários não estará mais associado a essa equipe de trabalho.

Excluir uma equipe de trabalho

Você pode excluir uma equipe de trabalho usando o SageMaker console e a SageMaker API.

Para excluir uma equipe de trabalho privada no SageMaker console

1. Acesse a área Ground Truth do SageMaker console: https://console.aws.amazon.com/sagemaker/groundtruth.

2. Selecione Forças de trabalho de rotulagem.

3. Selecione Privado.

4. Na seção Equipes privadas, selecione a equipe à qual você deseja excluir.

5. Selecione Excluir.

Para excluir uma equipe de trabalho privada (API)

Você pode excluir uma equipe de trabalho privada usando a operação SageMaker da APIDeleteWorkteam.

Gerencie trabalhadores individuais

Quando você cria uma força de trabalho usando seu próprio OIDC IdP, você não pode usar o Ground Truth ou o Amazon A2I para gerenciar trabalhadores individuais.

• Para adicionar um trabalhador a uma equipe de trabalho, adicione-o a um grupo associado a essa equipe de trabalho.

• Para remover um trabalhador de uma equipe de trabalho, remova-o de todos os grupos de usuários associados a essa equipe de trabalho.

Atualize, exclua e descreva sua força de trabalho

Você pode atualizar, excluir e descrever sua força de trabalho do OIDC IdP usando a API. SageMaker A seguir, uma lista de operações de API que podem ser usadas para gerenciar sua força de trabalho. Para obter detalhes adicionais, incluindo como você pode localizar o nome da sua força de trabalho, consulte Gerencie a força de trabalho privada usando a API da Amazon SageMaker .

• UpdateWorkforce – Talvez você queira atualizar uma força de trabalho criada usando seu próprio IdP do OIDC para especificar um endpoint de autorização, endpoint do token ou emissor diferente. Você pode atualizar qualquer parâmetro encontrado no OidcConfig usando essa operação.

  Você só pode atualizar sua configuração de IdP do OIDC quando não houver equipes de trabalho associadas à sua força de trabalho. Para saber como excluir equipes de trabalho, consulte Excluir uma equipe de trabalho.

• DeleteWorkforce – Use essa operação para excluir sua força de trabalho privada. Se você tiver alguma equipe de trabalho associada à sua força de trabalho, exclua essas equipes de trabalho antes de excluir sua força de trabalho. Para ter mais informações, consulte Excluir uma equipe de trabalho.

• DescribeWorkforce – Use essa operação para listar informações da força de trabalho privada, incluindo nome da força de trabalho, nome de recurso da Amazon (ARN) e, se aplicável, intervalos de endereços IP permitidos (CIDRs).