Docs
Torna alla versione inglese della documentazione

Integrazione di watsonx.governance come servizio su AWS con Amazon SageMaker

Ultimo aggiornamento: 23 set 2024
Integrazione di watsonx.governance come servizio su AWS con Amazon SageMaker

Puoi integrarewatsonx.governance come servizio attivoAWS con AmazonSageMaker per portare le capacità di governance, rischio e conformità diwatsonx.governance alla tua AmazonSageMaker Modelli.

Prima di iniziare

Devi avere i seguenti servizi:

  • Un'istanza diwatsonx.governance
  • Un'istanza di AmazonSageMaker

Configura i seguenti servizi suAWS :

  • CloudTrail: Amazzonia SageMaker gli eventi vengono pubblicati su CloudTrail.
  • Servizio Simple Queue (SQS): utilizza questo servizio per impostare una coda per il tuo AmazonSageMaker Modelli. Per ulteriori informazioni, vedere Configurazione di Amazon SQS
  • EventBridge: Utilizza questo servizio per definire le regole che estraggono Amazon SageMaker la scheda modello viene modificata in una coda FIFO Simple Queue Service (SQS).

Assicurarsi che ilCloudTrail EEventBridge i servizi sono in funzione.

InAWS , impostare una chiave di accesso a lungo termine per l'integrazione conwatsonx.governance . Le tue credenziali devono avere i seguenti accessi:

  • Accesso programmatico al servizio Simple Queue (SQS)
  • Accesso programmatico all'AmazzoniaSageMaker API
  • Autorizzazioni per aggiornare le schede modello in AmazonSageMaker

Per ulteriori informazioni, vedereAWS credenziali di sicurezza .

Nella console di governance, assicurati che il tuo account utente disponga di All/SOX/Administration/SageMaker autorizzazione dell'applicazione.

ImpostareAWS servizi per l'integrazione

Effettuare le operazioni riportate di seguito:

  1. Configura una coda SQS per la tua AmazonSageMaker Modelli.
  2. Crea un'AmazzoniaEventBridge regola e aggiungi la coda SQS come destinazione per la regola.

Configurazione di una coda SQS

L'integrazione utilizza una coda SQS per ricevere notifiche per eventuali modifiche alle schede modello.

Per impostare una coda SQS, procedi come segue:

  1. DalAWS console, selezionare il servizio Code semplice.
  2. Clic Crea coda .
  3. Digitare un nome per la coda, quindi inserire le seguenti informazioni:
    • Tipo : FIFO
    • Timeout della visibilità : 30 secondi
    • Periodo di conservazione dei messaggi : 4 giorni
    • Dimensione massima del messaggio : 256KB
    • Ritardo nella consegna : 0
    • Ricevi il tempo di attesa del messaggio : 0
  4. Sotto Impostazioni della coda FIFO , abilitare le seguenti opzioni:
    • Deduplicazione basata sui contenuti
    • Coda FIFO ad alta produttività

La coda SQS è definita. Quindi, imposta unEventBridge regola.

Impostazione di unEventBridge regola

Per impostare unEventBridge regola e aggiungi la coda SQS come destinazione, procedi come segue:

  1. DalAWS console, seleziona AmazonEventBridge servizio.
  2. Clic Crea regola .
  3. Digitare un nome per la regola, quindi fare clic su Prossimo .
  4. Per l'origine dell'evento, fare clic su Altro .
  5. Per il metodo di creazione, fare clic su Modello personalizzato (editor JSON) , quindi inserisci il seguente JSON per il pattern evento:
    {
   "detail": {
      "eventName": ["CreateModelCard", "UpdateModelCard", "DeleteModelCard"],
      "eventSource": ["sagemaker.amazonaws.com"]
  },
   "detail-type": ["AWS API Call via CloudTrail"],
   "source": ["aws.sagemaker"]
}
  6. Fare clic su Avanti.
  7. Imposta la destinazione sulla coda SQS che hai creato.
  8. Clic Prossimo nelle pagine rimanenti, quindi fare clic su Crea regola .

Ora hai unEventBridge regola con la tua coda SQS come destinazione della regola.

Costituzione di un'entità aziendale madre

Decidi quale entità aziendale desideri utilizzare come entità aziendale madre per il tuo AmazonSageMaker Modelli. Per impostazione predefinita, l'entità aziendale madre di AmazonSageMaker i modelli sono Biblioteca/MRG .

Se desideri utilizzare un'entità aziendale diversa, creala prima di configurare l'integrazione con AmazonSageMaker . Per visualizzare un elenco di entità aziendali, fare clic suMenu principale > Organizzazione > Entità commerciali . Per creare un'entità aziendale, è necessario disporre di autorizzazioni amministrative.

Ad esempio, se desideri conservare il tuo Amazon SageMaker modelli sotto Libreria/MRG/SageMaker, vai al Biblioteca/MRG entità aziendale, fare clic su Nuova entità commerciale. Nel Nome tipo di campoSageMaker , nel Tipo campo, seleziona Biblioteca . Completa i campi richiesti, quindi salva.

Configurazione dell'integrazione

Per configurare l'integrazione, sono necessarie le seguenti informazioni:

  • L'ID dell'account AWS.
  • L'ID della chiave di accesso e l'ID segreto impostati per l'integrazione.
  • L'URL del servizio Amazon SQS impostato per l'integrazione.

Autorizzazione richiesta: è necessario il All/SOX/Administration/SageMaker autorizzazione dell'applicazione nella console di governance.

Per configurare l'integrazione, procedere come segue:

  1. Accedi alla console di governance come amministratore.

  2. Fare clic su Menu ammin. > Integrazioni > Amazon SageMaker.

  3. Sotto Configurazione generale , procedi come segue:

    1. Seleziona l'entità aziendale madre per il tuoSageMaker Modelli. In genere, i modelli vengono archiviati sotto il file Biblioteca/MRG entità.
    2. Seleziona un utente predefinito. I modelli a cui non è assegnato un proprietario o che hanno un proprietario che non esiste nella console di governance vengono assegnati a questo utente predefinito.

  4. In AWS credenziali dell'account, inserire le credenziali dell'account AWS e la regione.

    Per il Regione utilizzous-east-1 .

  5. In URL della scheda modello SQS , inserisci l'URL della coda SQS che hai configurato.

  6. Clic Testare la connessione , quindi fare clic su Salva .

  7. Fare clic sull'interruttore per abilitare l'integrazione. Viene avviato il processo di sincronizzazione automatica. Quando crei modelli in Amazon SageMaker, le informazioni vengono sincronizzate con la console di governance. Per vedere l'avanzamento, fare clic Altro > Processi in background .

Mancia: Se disponi di modelli esistenti su Amazon SageMaker, clic Sincronizza le informazioni sul modello esistente. ILSageMaker sincronizzazioni la tabella mostra l'avanzamento della sincronizzazione manuale.

La tua Amazzonia SageMaker i modelli sono ora disponibili nella console Governance.

Il flusso di lavoro tipico per i nuovi casi d'uso è:

  • Un utente aziendale crea un caso d'uso e completa la valutazione del rischio e la valutazione dell'applicabilità.
  • Lo sviluppatore del modello viene informato che il caso d'uso è pronto per lo sviluppo.
  • Lo sviluppatore del modello crea una scheda modello in AmazonSageMaker .
  • Le informazioni sulla scheda modello vengono sincronizzate da Amazon SageMaker alla console di governance.
  • L'utente aziendale collega il modello al caso d'uso.

Sincronizzazione dati

Il processo di sincronizzazione ascolta le seguenti azioni:

  • UpdateModelCard: una scheda modello viene modificata o aggiornata in AmazonSageMaker .
  • DeleteModelCard: una scheda modello viene eliminata in AmazonSageMaker .
  • CreateModelCard: Una scheda modello viene creata in AmazonSageMaker .

Potresti non vedere immediatamente le modifiche nella console di governance.

  • Il processo di sincronizzazione viene eseguito una volta al minuto.
  • Il processo di sincronizzazione viene interrotto quando la modalità amministratore di sistema è abilitata. La sincronizzazione riprende quando la modalità amministratore di sistema è disabilitata.
  • Il processo di sincronizzazione viene sospeso quando è in esecuzione una sincronizzazione manuale. La sincronizzazione riprende al termine del processo manuale.

Informazioni sincronizzate dalla console di governance ad Amazon SageMaker

La tabella seguente mostra i campi sincronizzati dalla console di governance ad Amazon SageMaker.

Ad esempio, quando aggiorni il Proprietario del modello su un oggetto modello nella console di governance, il campo Proprietario del modello sulla scheda del modello in Amazon SageMaker è aggiornato.

Tabella 2. Campi sincronizzati dalla console di governance ad Amazon SageMaker
Console di governance SageMaker campo
Modello MRG: Proprietario del modello: Proprietario del modello (model_owner )
Modello MRG:Stato* Stato della scheda modello (model_approval_status )
MRG-AIFacts-ModelUseCase:Purpose Scopo del modello (purpose_of_model )
MRG-AIFacts-ModelUseCase:Risk Livello Valutazione del rischio (risk_rating )
(Caso d'uso) Campi di sistema:Descrizione Problema aziendale > Descrizione (business_problem )
MRG-ModelUseCase:Owner Stakeholder aziendale (business_stakeholders )

*Solo per la sincronizzazione iniziale, MRG-Model:Status viene sincronizzato da Amazon SageMaker alla console di governance. Per le sincronizzazioni successive, lo stato viene sincronizzato dalla console di governance ad Amazon SageMaker.

Informazioni sincronizzate da Amazon SageMaker alla console di governance

La tabella seguente mostra i campi sincronizzati da Amazon SageMaker alla console di governance.

Ad esempio, quando aggiorni il campo Creatore modello su una scheda modello in Amazon SageMaker, il campo Sviluppatore modello sull'oggetto modello viene aggiornato nella console di governance.

Tabella 3. Campi sincronizzati da Amazon SageMaker alla console di governance
SageMaker Console di governance
creatore_modello MRG-Model:Model Developer Se l'utente non esiste nella console di governance, Model Developer è impostato sull'utente predefinito specificato al momento della configurazione dell'integrazione.
tipo_algoritmo Modello MRG-AIFacts: algoritmo
model_id Modello MRG-AIFacts: ID risorsa esterna
modello_artefatto MRG-AIFacts-Model:URL risorsa esterna: le risorse esterne vengono sincronizzate solo se il nome della cartella della risorsa includeModelArtifacts .
model_name MRG-AIFacts-Model: nome del modello esterno
versione_modello Modello MRG:Versione del modello
Metriche di formazione (training_metrics e user_provided_training_metrics) Metrica, valore metrico
Parametri Hyper (hyper_parameters e user_provided_hyper_parameters) Modello MRG-AIFacts: iperparametri (appiattito da un array a una stringa).

Metriche di formazione e metriche di formazione fornite dall'utente

Le metriche di formazione e le metriche di formazione fornite dall'utente sono mappate agli oggetti Metrica e Valore metrica nella console Governance.

Gli oggetti Metrica e Valore metrica vengono creati nella console di governance se non esistono. Gli oggetti metrici vengono creati come figli dell'oggetto Modello. Gli oggetti Metric Value vengono creati come figli dell'oggetto Metric.

Per i parametri di formazione e i parametri di formazione forniti dagli utenti, i seguenti campi nella console di governance vengono aggiornati con le informazioni di Amazon SageMaker:

  • Metric.Description: Il nome della metrica in AmazonSageMaker
  • Metric.Title: Il nome della metrica
  • Metric.Status: Imposta su Attivo per le metriche esistenti. Imposta su Inattivo per i parametri eliminati in AmazonSageMaker .
  • MetricoValue.Description: Il nome della metrica.
  • MetricoValue.MRG-MetricVal Valore: il valore della metrica
  • MetricoValue.MRG-Metric-Shared:Collection Stato: impostato su Raccolto.

Sincronizzazione bidirezionale

La descrizione della scheda modello (model_description ) campo in Amazon SageMaker e il campo Descrizione sull'oggetto Modello (Model.System Fields:Description ) nella console Governance sono sincronizzati in entrambe le direzioni.

Argomento padre: Watsonx.governance come servizio su AWS