Gerenciar uma força de trabalho privada (OIDC IdP) - Amazon SageMaker AI
Pré-requisitosAdicione equipes de trabalhoAdicionar ou remover grupos de IdP das equipes de trabalhoExcluir uma equipe de trabalhoGerencie trabalhadores individuaisAtualize, exclua e descreva sua força de trabalho

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 a uma tarefa de análise 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 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 CreateWorkforce da API do SageMaker. Para saber mais, consulte Criar uma força de trabalho privada (OIDC IdP).

Adicione equipes de trabalho

Você pode usar o console do SageMaker AI para criar uma equipe de trabalho privada usando sua força de trabalho do IdP OIDC na página Forças de trabalho de rotulagem 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 console do SageMaker AI.

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

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

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

  1. Acesse a área Ground Truth do console do SageMaker AI: 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 console do SageMaker AI: 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 rotulagem e está listada na seção Forças de trabalho de rotulagem do console do SageMaker AI.

Como criar uma equipe de trabalho privada usando a API do SageMaker

Como criar uma equipe de trabalho privada usando a API operação de API CreateWorkteam do SageMaker.

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 API SageMaker 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 console do SageMaker AI e a API do SageMaker.

Como excluir uma equipe de trabalho privada no console do SageMaker AI

  1. Acesse a área Ground Truth do console do SageMaker AI: 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 DeleteWorkteam.

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 do 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 Gerenciamento da força de trabalho privada usando a API do 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).