Nozioni di base su Amazon Lookout for Vision - Amazon Lookout per Vision

Avviso di fine del supporto: il 31 ottobre 2025 AWS interromperà il supporto per Amazon Lookout for Vision. Dopo il 31 ottobre 2025, non potrai più accedere alla console Lookout for Vision o alle risorse Lookout for Vision. Per ulteriori informazioni, consulta questo post del blog.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Nozioni di base su Amazon Lookout for Vision

Prima di iniziare queste istruzioni introduttive, ti consigliamo di leggereInformazioni su Amazon Lookout for Vision.

Le istruzioni introduttive mostrano come utilizzare la creazione di un modello di segmentazione delle immagini di esempio. Se desideri creare un modello di classificazione delle immagini di esempio, vediset di dati di classificazione delle immagini.

Se desideri provare rapidamente un modello di esempio, forniamo immagini di allenamento di esempio e immagini di maschere. Forniamo anche uno script Python che crea un file manifest per la segmentazione delle immagini. Utilizzate il file manifest per creare un set di dati per il vostro progetto e non è necessario etichettare le immagini nel set di dati. Quando crei un modello con le tue immagini, devi etichettare le immagini nel set di dati. Per ulteriori informazioni, consulta Creare il tuo set di dati.

Le immagini che forniamo sono di cookie normali e anomali. Un cookie anomalo presenta una crepa nella forma del biscotto. Il modello che addestra con le immagini prevede una classificazione (normale o anomala) e trova l'area (maschera) delle crepe in un cookie anomalo, come mostrato nell'esempio seguente.

Chocolate chip cookie with a visible crack across its surface on a green background.

Fase 1: crea il file del manifesto e carica delle immagini

In questa procedura, cloni l'archivio della documentazione di Amazon Lookout for Vision sul tuo computer. Utilizzi quindi uno script Python (versione 3.7 o superiore) per creare un file manifest e caricare le immagini di training e le immagini delle maschere in una posizione Amazon S3 specificata. Utilizzate il file manifest per creare il vostro modello. Successivamente, utilizzi le immagini di prova nel repository locale per provare il tuo modello.

Per creare il file manifest e caricare immagini
  1. Configura Amazon Lookout for Vision seguendo le istruzioni in Configurazione di Amazon Lookout for Vision. Assicurati di installare l'AWSSDK per Python.

  2. Nella AWS regione in cui desideri utilizzare Lookout for Vision, crea un bucket S3.

  3. Nel bucket Amazon S3 crea una cartella denominata. getting-started

  4. Annotare l'URI Amazon S3 e il nome della risorsa Amazon (ARN) per la cartella. Li usi per configurare le autorizzazioni ed eseguire lo script.

  5. Assicurati che l'utente che chiama lo script disponga delle autorizzazioni per chiamare l's3:PutObjectoperazione. È possibile utilizzare la seguente policy. Per assegnare le autorizzazioni, vedere. Assegnare le autorizzazioni

    { "Version": "2012-10-17", "Statement": [{ "Sid": "Statement1", "Effect": "Allow", "Action": [ "s3:PutObject" ], "Resource": [ "arn:aws:s3::: ARN for S3 folder in step 4/*" ] }] }
  6. Assicurati di avere un profilo locale denominato lookoutvision-access e che l'utente del profilo disponga delle autorizzazioni del passaggio precedente. Per ulteriori informazioni, consulta Utilizzo di un profilo su un computer locale.

  7. Scarica il file zip, getting-started.zip. Il file zip contiene il set di dati introduttivo e lo script di configurazione.

  8. Decomprimi il file getting-started.zip.

  9. Al prompt dei comandi procedere come segue:

    1. Accedere alla cartella getting-started.

    2. Esegui il comando seguente per creare un file manifest e caricare le immagini di allenamento e le maschere di immagini nel percorso Amazon S3 indicato nel passaggio 4.

      python getting_started.py S3-URI-from-step-4
    3. Al termine dello script, annota il percorso del train.manifest file che lo script visualizza dopoCreate dataset using manifest file:. Il percorso dovrebbe essere simile as3://path to getting started folder/manifests/train.manifest.

Fase 2: creazione del modello

In questa procedura, crei un progetto e un set di dati utilizzando le immagini e il file manifest che hai precedentemente caricato nel tuo bucket Amazon S3. Quindi si crea il modello e si visualizzano i risultati della valutazione dell'addestramento dei modelli.

Poiché crei il set di dati dal file manifest introduttivo, non è necessario etichettare le immagini del set di dati. Quando crei un set di dati con le tue immagini, devi etichettare le immagini. Per ulteriori informazioni, consulta Immagini etichettate.

Importante

Ti viene addebitato il costo di un addestramento di successo di un modello.

Per creare un modello
  1. Apri la console Amazon Lookout for Vision all'indirizzo https://console.aws.amazon.com/lookoutvision/.

  2. Assicurati di essere nella stessa AWS regione in cui hai creato il bucket Amazon S3. Fase 1: crea il file del manifesto e carica delle immagini Per modificare la Regione, scegliere il nome della Regione attualmente visualizzata nella barra di navigazione. Quindi seleziona la Regione alla quale desideri passare.

  3. Scegliere Inizia.

    Amazon Lookout for Vision service description and Get started button highlighted.
  4. Nella sezione Progetti, scegli Crea progetto.

    Dashboard overview with empty statistics and a "Create project" button highlighted.
  5. Nella pagina Crea progetto procedere come segue:

    1. In Nome progetto, inseriscigetting-started.

    2. Seleziona Create project (Crea progetto).

    Project creation interface for anomaly detection model with project name input field.
  6. Nella pagina del progetto, nella sezione Come funziona, scegli Crea set di dati.

    Getting-started info page showing steps to prepare dataset and train model.
  7. Nella pagina Crea set di dati procedere come segue:

    1. Scegli Crea un singolo set di dati.

    2. Nella sezione Configurazione della sorgente dell'immagine, scegli Importa immagini etichettate da SageMaker Ground Truth.

    3. Per la posizione del file.manifest, inserisci la posizione Amazon S3 del file manifest che hai annotato nel passaggio 6.c. di. Fase 1: crea il file del manifesto e carica delle immagini La posizione di Amazon S3 dovrebbe essere simile a s3://path to getting started folder/manifests/train.manifest

    4. Scegli Crea set di dati.

    Dataset configuration options with single dataset creation selected and image import methods.
  8. Nella pagina dei dettagli del progetto, nella sezione Immagini, visualizza le immagini del set di dati. È possibile visualizzare le informazioni sulla classificazione e sulla segmentazione delle immagini (etichette di maschere e anomalie) per ogni immagine del set di dati. Puoi anche cercare immagini, filtrare le immagini in base allo stato dell'etichettatura (etichettate/senza etichetta) o filtrare le immagini in base alle etichette di anomalia ad esse assegnate.

    Image labeling interface showing three chocolate chip cookies with cracks, labeled as anomalies.
  9. Nella pagina dei dettagli del progetto, scegli Modello ferroviario.

    Getting-started page with instructions to prepare datasets and a Train model button.
  10. Nella pagina dei dettagli del modello di treno, scegli Modello di treno.

  11. Nella sezione Vuoi addestrare il tuo modello? finestra di dialogo scegliere Modello di treno.

  12. Nella pagina Modelli del progetto, puoi vedere che la formazione è iniziata. Controlla lo stato corrente visualizzando la colonna Stato per la versione del modello. L'addestramento del modello richiede almeno 30 minuti. L'allenamento è terminato con successo quando lo stato cambia in Allenamento completato.

  13. Al termine dell'allenamento, scegli il modello Modello 1 nella pagina Modelli.

    Models page showing one model named Model 1 with Training complete status.
  14. Nella pagina dei dettagli del modello, visualizza i risultati della valutazione nella scheda Metriche delle prestazioni. Esistono metriche per quanto segue:

    • Metriche complessive delle prestazioni del modello (precisione, richiamo e punteggio F1) per le previsioni di classificazione effettuate dal modello.

      Model performance metrics showing 100% precision, recall, and F1 score for 20 test images.
    • Metriche delle prestazioni per le etichette delle anomalie presenti nelle immagini del test (IoU medio, punteggio F1)

      Table showing performance metrics for "cracked" label with 10 test images, 86.1% F1 score, and 74.53% Average IoU.
    • Previsioni per le immagini di test (classificazione, maschere di segmentazione ed etichette di anomalie)

      Three chocolate chip cookies on dark surfaces, two with green anomalies labeled as "cracked".

    Poiché l'allenamento modello non è deterministico, i risultati della valutazione potrebbero differire dai risultati mostrati in questa pagina. Per ulteriori informazioni, consulta Come migliorare il modello Amazon Lookout for Vision.

Fase 3: avvio del modello

In questo passaggio, iniziate a ospitare il modello in modo che sia pronto per analizzare le immagini. Per ulteriori informazioni, consulta Esecuzione del modello Amazon Lookout for Vision addestrato.

Nota

Ti viene addebitato per il tempo di funzionamento del modello. Fai entrare il tuo modelloFase 5: Arresta il modello.

Per avviare il modello.
  1. Nella pagina dei dettagli del modello, scegli Usa modello, quindi scegli Integrate API to the cloud.

    Model 1 page with "Use model" button and dropdown option "Integrate API to the cloud".
  2. Nella sezione AWS CLIcomandi, copia il start-model AWS CLI comando.

    AWS CLI command to start a Lookout for Vision model with project and version details.
  3. Assicurati che AWS CLI sia configurato per funzionare nella stessa AWS regione in cui utilizzi la console Amazon Lookout for Vision. Per modificare la AWS regione AWS CLI utilizzata, vedereInstalla gli SDK AWS.

  4. Al prompt dei comandi, avviate il modello immettendo il start-model comando. Se utilizzi il lookoutvision profilo per ottenere le credenziali, aggiungi il --profile lookoutvision-access parametro. Ad esempio:

    aws lookoutvision start-model \ --project-name getting-started \ --model-version 1 \ --min-inference-units 1 \ --profile lookoutvision-access

    Se la chiamata ha esito positivo, viene visualizzato il seguente output:

    { "Status": "STARTING_HOSTING" }
  5. Nella console scegliere Modelli nel riquadro di navigazione.

    AWSLookout for Vision console showing CLI commands to start model and detect anomalies.
  6. Attendere che lo stato del modello (Modello 1) nella colonna Stato venga visualizzato Hosted. Se hai già addestrato un modello nel progetto, attendi il completamento della versione più recente del modello.

    Model 1 with Hosted status, 100% precision and recall, created on September 21st, 2022.

Fase 4: Analisi di un'immagine

In questa fase verrà analizzata un'immagine con il modello. Forniamo immagini di esempio che puoi utilizzare nella test-images cartella Guida introduttiva dell'archivio della documentazione di Lookout for Vision sul tuo computer. Per ulteriori informazioni, consulta Rilevamento di anomalie in un'immagine.

Per analizzare un'immagine
  1. Nella pagina Modelli, scegli il modello Modello 1.

    Models table showing Model 1 with Hosted status, creation date, and 100% precision and recall.
  2. Nella pagina dei dettagli del modello, scegli Usa modello, quindi scegli Integrate API to the cloud.

    Model 1 page with "Use model" button and dropdown option "Integrate API to the cloud".
  3. Nella sezione AWS CLIcomandi, copia il detect-anomalies AWS CLI comando.

    AWS CLI command for detect-anomalies with parameters for project, model version, and image file.
  4. Al prompt dei comandi, analizza un'immagine anomala inserendo il detect-anomalies comando del passaggio precedente. Per il --body parametro, specifica un'immagine anomala dalla test-images cartella introduttiva sul tuo computer. Se utilizzi il lookoutvision profilo per ottenere le credenziali, aggiungi il --profile lookoutvision-access parametro. Ad esempio:

    aws lookoutvision detect-anomalies \ --project-name getting-started \ --model-version 1 \ --content-type image/jpeg \ --body /path/to/test-images/test-anomaly-1.jpg \ --profile lookoutvision-access

    L'output visualizzato dovrebbe essere simile al seguente:

    { "DetectAnomalyResult": { "Source": { "Type": "direct" }, "IsAnomalous": true, "Confidence": 0.983975887298584, "Anomalies": [ { "Name": "background", "PixelAnomaly": { "TotalPercentageArea": 0.9818974137306213, "Color": "#FFFFFF" } }, { "Name": "cracked", "PixelAnomaly": { "TotalPercentageArea": 0.018102575093507767, "Color": "#23A436" } } ], "AnomalyMask": "iVBORw0KGgoAAAANSUhEUgAAAkAAAAMACA......" } }
  5. Nell'output, tenere presente quanto segue:

    • IsAnomalousè un valore booleano per la classificazione prevista. truese l'immagine è anomala, altrimenti. false

    • Confidenceè un valore variabile che rappresenta la fiducia di Amazon Lookout for Vision nella previsione. 0 è il livello di confidenza più basso, 1 è l'affidabilità massima.

    • Anomaliesè un elenco di anomalie rilevate nell'immagine. Nameè l'etichetta dell'anomalia. PixelAnomalyinclude l'area percentuale totale dell'anomalia (TotalPercentageArea) e un colore (Color) per l'etichetta dell'anomalia. L'elenco include anche un'anomalia di «sfondo» che copre l'area al di fuori delle anomalie rilevate nell'immagine.

    • AnomalyMaskè un'immagine di maschera che mostra la posizione delle anomalie sull'immagine analizzata.

    È possibile utilizzare le informazioni nella risposta per visualizzare una combinazione dell'immagine analizzata e maschera delle anomalie, come illustrato nell'esempio seguente. Per il codice di esempio, consulta Visualizzazione delle informazioni di classificazione e segmentazione.

    Chocolate chip cookie with green segmentation highlighting cracked areas, labeled as anomalous.
  6. Al prompt dei comandi, analizza un'immagine normale dalla test-images cartella introduttiva. Se utilizzi il lookoutvision profilo per ottenere le credenziali, aggiungi il --profile lookoutvision-access parametro. Ad esempio:

    aws lookoutvision detect-anomalies \ --project-name getting-started \ --model-version 1 \ --content-type image/jpeg \ --body /path/to/test-images/test-normal-1.jpg \ --profile lookoutvision-access

    L'output visualizzato dovrebbe essere simile al seguente:

    { "DetectAnomalyResult": { "Source": { "Type": "direct" }, "IsAnomalous": false, "Confidence": 0.9916400909423828, "Anomalies": [ { "Name": "background", "PixelAnomaly": { "TotalPercentageArea": 1.0, "Color": "#FFFFFF" } } ], "AnomalyMask": "iVBORw0KGgoAAAANSUhEUgAAAkAAAA....." } }
  7. Nell'output, nota che il false valore di IsAnomalous classifica l'immagine come priva di anomalie. ConfidenceUtilizzalo per determinare la tua fiducia nella classificazione. Inoltre, l'Anomaliesarray ha solo l'etichetta dell'backgroundanomalia.

Fase 5: Arresta il modello

In questa fase verrà interrotto l'hosting del modello. Ti viene addebitato il periodo di funzionamento del tuo modello. Se non utilizzi il modello, è necessario interromperlo. È possibile riavviare il modello quando è di nuovo necessario. Per ulteriori informazioni, consulta Avvio del modello Amazon Lookout for Vision.

Per fermare il modello.
  1. Nel riquadro di navigazione scegliere Modelli.

    AWSLookout for Vision console showing CLI commands to start model and detect anomalies.
  2. Nella pagina Modelli, scegli il modello Modello 1.

    Models table showing Model 1 with Hosted status, creation date, and 100% precision and recall.
  3. Nella pagina dei dettagli del modello, scegli Usa modello, quindi scegli Integrate API to the cloud.

    Model 1 page with "Use model" button and dropdown option "Integrate API to the cloud".
  4. Nella sezione AWS CLIcomandi, copia il stop-model AWS CLI comando.

    Copy button icon next to AWS CLI command for stopping a Lookout for Vision model.
  5. Al prompt dei comandi, arrestate il modello immettendo il stop-model AWS CLI comando del passaggio precedente. Se utilizzi il lookoutvision profilo per ottenere le credenziali, aggiungi il --profile lookoutvision-access parametro. Ad esempio:

    aws lookoutvision stop-model \ --project-name getting-started \ --model-version 1 \ --profile lookoutvision-access

    Se la chiamata ha esito positivo, viene visualizzato il seguente output:

    { "Status": "STOPPING_HOSTING" }
  6. Torna alla console, scegli Modelli nella pagina di navigazione a sinistra.

  7. Il modello si è fermato quando lo stato del modello nella colonna Stato è Allenamento completato.

Fasi successive

Quando sei pronto a creare un modello con le tue immagini, inizia seguendo le istruzioni inCreare il tuo progetto. Le istruzioni includono i passaggi per creare un modello con la console Amazon Lookout for Vision e con l'AWSSDK.

Se vuoi provare altri set di dati di esempio, vediCodice e set di dati di esempio.