Gestione di una forza lavoro privata (IdP OIDC)

Dopo aver creato una forza lavoro privata utilizzando il tuo Identity Provider (IdP) OpenID Connect (OIDC), puoi gestire i tuoi worker utilizzando il tuo IdP. Ad esempio, puoi aggiungere, rimuovere e raggruppare i worker direttamente tramite il tuo IdP.

Per aggiungere lavoratori a un lavoro di etichettatura di Amazon SageMaker Ground Truth (Ground Truth) o a un'attività di revisione umana di Amazon Augmented AI (Amazon A2I), crei team di lavoro utilizzando 1-10 gruppi IdP e assegnando quel team di lavoro al lavoro o all'attività. Assegni un team di lavoro a un processo o un'attività specificando quel team di lavoro quando crei un processo di etichettatura (Ground Truth) o un flusso di lavoro di revisione umana (Amazon A2I).

Puoi assegnare un solo team a ciascun processo di etichettatura o flusso di lavoro di revisione umana. Puoi utilizzare lo stesso team per creare più processi di etichettatura o attività di revisione umana. Puoi anche creare più team di lavoro per lavorare su diversi processi di etichettatura o attività di revisione umana.

Prerequisiti

Per creare e gestire team di lavoro privati utilizzando i tuoi gruppi IdP OIDC, devi innanzitutto creare una forza lavoro utilizzando l'operazione API. SageMaker CreateWorkforce Per ulteriori informazioni, consulta Creazione di una forza lavoro privata (IdP OIDC).

Aggiungere team di lavoro

Puoi utilizzare la SageMaker console per creare un team di lavoro privato utilizzando la tua forza lavoro IdP OIDC nella pagina Labeling workforce in Ground Truth. Se stai creando un processo di etichettatura Ground Truth, puoi anche creare un team di lavoro privato durante la creazione di un processo di etichettatura.

Nota

Puoi creare e gestire team di lavoro per Amazon A2I nell'area Ground Truth della SageMaker console.

Puoi anche utilizzare l' SageMaker API e gli SDK associati specifici per la lingua per creare un team di lavoro privato.

Utilizza le seguenti procedure per imparare a creare un team di lavoro privato utilizzando la console e l' SageMakerAPI.

Per creare un team di lavoro privato nella pagina Forze lavoro di etichettatura (console)

1. Vai all'area Ground Truth della SageMaker console: https://console.aws.amazon.com/sagemaker/groundtruth.

2. Seleziona Etichettatura delle forze lavoro.

3. Seleziona Privato.

4. Nella sezione Team privati, seleziona Crea team privato.

5. Nella sezione Dettagli del team, inserisci il Nome del team.

6. Nella sezione Aggiungi worker, inserisci il nome di un singolo gruppo di utenti. Tutti i worker associati a questo gruppo nel tuo IdP vengono aggiunti a questo team di lavoro.

7. Per aggiungere più di un gruppo di utenti, seleziona Aggiungi nuovo gruppo di utenti e inserisci i nomi dei gruppi di utenti che desideri aggiungere a questo team di lavoro. Specifica un gruppo di utenti per riga.

8. (Facoltativo) Per i processi di etichettatura Ground Truth, se fornisci un'e-mail per i worker del vostro JWT, Ground Truth avviserà i worker quando è disponibile una nuova attività di etichettatura se selezioni un argomento SNS.

9. Scegli Crea team privato.

Per creare un team di lavoro privato durante la creazione di un processo di etichettatura Ground (console)

1. Vai all'area Ground Truth della SageMaker console: https://console.aws.amazon.com/sagemaker/groundtruth.

2. Seleziona Processi di etichettatura.

3. Usa le istruzioni riportate in Creazione di un processo di etichettatura (console) per creare un processo di etichettatura. Fermati quando arrivi alla sezione worker nella seconda pagina.

4. Seleziona Privato per il tipo di worker.

5. Immetti un Nome del team.

6. Nella sezione Aggiungi worker, inserisci il nome di un singolo gruppo di utenti in Gruppi di utenti. Tutti i worker associati a questo gruppo nel tuo IdP vengono aggiunti a questo team di lavoro.

   Importante

   I nomi dei gruppi specificati per i Gruppi di utenti devono corrispondere ai nomi dei gruppi specificati nel tuo IdP OIDC.

7. Per aggiungere più di un gruppo di utenti, seleziona Aggiungi nuovo gruppo di utenti e inserisci i nomi dei gruppi di utenti che desideri aggiungere a questo team di lavoro. Specifica un gruppo di utenti per riga.

8. Completa tutte le fasi rimanenti per creare il tuo processo di etichettatura.

Il team privato che crei viene utilizzato per questo lavoro di etichettatura ed è elencato nella sezione Etichettatura della forza lavoro della console. SageMaker

Per creare un team di lavoro privato utilizzando l'API SageMaker

È possibile creare un team di lavoro privato utilizzando l'operazione SageMaker APICreateWorkteam.

Quando usi questa operazione, elenca nel parametro tutti i gruppi di utenti che desideri includere nel team di lavoro nel parametro OidcMemberDefinition Groups.

Importante

I nomi dei gruppi specificati per Groups devono corrispondere ai nomi dei gruppi specificati nel tuo IdP OIDC.

Ad esempio, se i nomi dei gruppi di utenti sono group1, group2 e group3 nel tuo IdP IDC, configura OidcMemberDefinition come segue:

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

Inoltre, è necessario assegnare un nome al team di lavoro utilizzando il parametro WorkteamName.

Aggiungere o rimuovere gruppi IdP dai team di lavoro

Dopo aver creato un team di lavoro, puoi utilizzare l' SageMaker API per gestirlo. Utilizza l'operazione UpdateWorkteam per aggiornare i gruppi di utenti IdP inclusi in quel team di lavoro.

• Utilizza il parametro WorkteamName per identificare il team di lavoro che intendi aggiornare.

• Quando usi questa operazione, elenca nel parametro tutti i gruppi di utenti che desideri includere nel team di lavoro nel parametro OidcMemberDefinition Groups. Se un gruppo di utenti è associato a un team di lavoro e non lo includi in questo elenco, quel gruppo di utenti non è più associato a questo team di lavoro.

Eliminare un team di lavoro

Puoi eliminare un team di lavoro utilizzando la SageMaker console e l' SageMaker API.

Per eliminare un team di lavoro privato nella SageMaker console

1. Vai all'area Ground Truth della SageMaker console: https://console.aws.amazon.com/sagemaker/groundtruth.

2. Seleziona Etichettatura delle forze lavoro.

3. Seleziona Privato.

4. Nella sezione Team privati, scegli il team di lavoro che desideri eliminare.

5. Seleziona Elimina.

Per eliminare un team di lavoro privato (API)

È possibile eliminare un team di lavoro privato utilizzando l'operazione SageMaker APIDeleteWorkteam.

Gestire i singoli worker

Quando crei una forza lavoro utilizzando il tuo IdP OIDC, non puoi usare Ground Truth o Amazon A2I per gestire singoli worker.

• Per aggiungere un worker a un team di lavoro, aggiungi quel worker a un gruppo associato a quel team di lavoro.

• Per rimuovere un worker da un team di lavoro, rimuovi quel worker da tutti i gruppi di utenti associati a quel team di lavoro.

Aggiornare, eliminare e descrivere la tua forza lavoro

Puoi aggiornare, eliminare e descrivere la tua forza lavoro IdP OIDC utilizzando l'API. SageMaker Di seguito è riportato un elenco di operazioni API utilizzabili per gestire la forza lavoro. Per ulteriori dettagli, incluso come individuare il nome della forza lavoro, consulta Gestisci la forza lavoro privata utilizzando l'API Amazon SageMaker .

• UpdateWorkforce: potresti voler aggiornare una forza lavoro creata utilizzando il tuo IdP OIDC per specificare un endpoint di autorizzazione, un endpoint token o un emittente diverso. Puoi aggiornare qualsiasi parametro trovato in OidcConfig utilizzando questa operazione.

  Puoi aggiornare la configurazione IdP di OIDC solo quando non ci sono team di lavoro associati alla tua forza lavoro. Per informazioni su come eliminare i team di lavoro, consulta Eliminare un team di lavoro.

• DeleteWorkforce: usa questa operazione per eliminare la tua forza lavoro privata. Se hai dei team di lavoro associati alla tua forza lavoro, devi eliminarli prima di eliminare la tua forza lavoro. Per ulteriori informazioni, consulta Eliminare un team di lavoro.

• DescribeWorkforce: usa questa operazione per elencare le informazioni private sulla forza lavoro, tra cui il nome della forza lavoro, nome della risorsa Amazon (ARN) e, se applicabile, gli intervalli di indirizzi IP consentiti (CIDR).