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à.
# Gestione degli adattatori con la AWS CLI e SDKs
Rekognition ti consente di utilizzare molteplici funzionalità che sfruttano modelli di visione artificiale preaddestrati. Con questi modelli puoi svolgere attività come il rilevamento delle etichette e la moderazione dei contenuti. È inoltre possibile personalizzare questi determinati modelli utilizzando un adattatore.
Puoi utilizzare la creazione e la gestione dei progetti di Rekognition APIs (come and [CreateProjectVersion](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateProjectVersion.html)) per creare [CreateProject](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateProject.html)e addestrare adattatori. Le pagine seguenti descrivono come utilizzare le operazioni API per creare, addestrare e gestire gli adattatori, utilizzando la AWS console, l' AWS SDK scelto o la AWS CLI.
Dopo aver addestrato un adattatore, è possibile utilizzarlo per eseguire l'inferenza con le funzionalità supportate. Attualmente, gli adattatori sono supportati quando si utilizza la funzione di moderazione dei contenuti.
Quando addestrate un adattatore utilizzando un AWS SDK, dovete fornire le vostre etichette di base (annotazioni sulle immagini) sotto forma di file manifest. In alternativa, puoi utilizzare la Rekognition Console per creare e addestrare un adattatore.
**Nota**
Gli adattatori non possono essere copiati. È possibile copiare solo le versioni del progetto Rekognition Custom Labels.
**Topics**
+ [Stati dell'adattatore](#managing-adapters-project-versions-statuses)
+ [Creare un progetto](managing-adapters-create-project.md)
+ [Descrizione di progetti](managing-adapters-describe-projects.md)
+ [Eliminazione di un progetto](managing-adapters-delete-project.md)
+ [Creazione di una versione del progetto](managing-adapters-create-project-version.md)
+ [Descrivere una versione del progetto](managing-adapters-describe-project.md)
+ [Eliminazione di una versione di progetto](managing-adapters-delete-project-version.md)
## Stati dell'adattatore
L'adattatore di moderazione personalizzato (versioni del progetto) può avere uno dei seguenti stati:
+ TRAINING\$1IN\$1PROGRESS: l'adattatore è in corso di formazione sui file che hai fornito come documenti di formazione.
+ TRAINING\$1COMPLETED - L'adattatore ha completato con successo l'addestramento ed è pronto per consentirvi di esaminarne le prestazioni.
+ TRAINING\$1FAILED - L'adattatore non è riuscito a completare l'addestramento per qualche motivo. Consultate il file manifesto di output e il riepilogo del manifesto di output per informazioni sulla causa dell'errore.
+ ELIMINAZIONE - L'adattatore è in fase di eliminazione.
+ OBSOLETO: l'adattatore è stato addestrato su una versione precedente del modello base di Content Moderation. È in un periodo di prova e scadrà entro 60-90 giorni dal rilascio della nuova versione del modello base. Durante il periodo di prova, è comunque possibile utilizzare l'adattatore per l'inferenza con [DetectModerationLabels](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DetectModerationLabels.html)le nostre operazioni [StartMediaAnalysisJob](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartMediaAnalysisJob.html)API. Fai riferimento alla Custom Moderation Console per la data di scadenza degli adattatori.
+ SCADUTO: l'adattatore è stato addestrato su una versione precedente del modello base di moderazione dei contenuti e non può più essere utilizzato per ottenere risultati personalizzati con le operazioni o l'API. DetectModerationLabels StartMediaAnalysisJob Se in una richiesta di inferenza viene specificato un adattatore scaduto, verrà ignorato e la risposta verrà invece restituita dalla versione più recente del modello base di moderazione personalizzata.
# Creare un progetto
Con l'[CreateProject](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateProject.html)operazione è possibile creare un progetto che conterrà un adattatore per le operazioni di rilevamento delle etichette di Rekognition. Un progetto è un gruppo di risorse e, nel caso di operazioni di rilevamento di etichette come DetectModerationLabels, un progetto consente di memorizzare adattatori che è possibile utilizzare per personalizzare il modello Rekognition di base. Quando si richiama CreateProject, si fornisce il nome del progetto che si desidera creare all'argomento. ProjectName
Per creare un progetto con la AWS console:
+ Accedi alla Rekognition Console
+ Fai clic su **Moderazione personalizzata**
+ Scegliere **Crea progetto**
+ Seleziona **Crea un nuovo progetto** o **Aggiungi a un progetto esistente**
+ Aggiungi un **nome di progetto**
+ Aggiungi un **nome per l'adattatore**
+ Se lo desideri, aggiungi una descrizione
+ Scegli come importare le immagini di allenamento: file Manifest, dal bucket S3 o dal tuo computer
+ Scegli se vuoi dividere automaticamente i dati di allenamento o importare un file manifest
+ Seleziona se desideri o meno che il progetto si aggiorni automaticamente
+ Fare clic su **Crea progetto**
Per creare un progetto con AWS CLI e SDK:
1. Se non l'hai già fatto, installa e configura la AWS CLI e il. AWS SDKs Per ulteriori informazioni, consulta [Passaggio 2: configura AWS CLI e AWS SDKs](setup-awscli-sdk.md).
1. Usa il seguente codice per creare un progetto:
------
#### [ CLI ]
```
# Request
# Creating Content Moderation Project
aws rekognition create-project \
--project-name "project-name" \
--feature CONTENT_MODERATION \
--auto-update ENABLED
--profile profile-name
```
------
# Descrizione di progetti
Puoi utilizzare l'[DescribeProjects](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DescribeProjects.html)API per ottenere informazioni sui tuoi progetti, incluse informazioni su tutti gli adattatori associati a un progetto.
Per descrivere i progetti con AWS CLI e SDK:
1. Se non l'hai già fatto, installa e configura la AWS CLI e il. AWS SDKs Per ulteriori informazioni, consulta [Passaggio 2: configura AWS CLI e AWS SDKs](setup-awscli-sdk.md).
1. Utilizza il seguente codice per descrivere un progetto:
------
#### [ CLI ]
```
# Request
# Getting CONTENT_MODERATION project details
aws rekognition describe-projects \
--features CONTENT_MODERATION
--profile profile-name
```
------
# Eliminazione di un progetto
Puoi eliminare un progetto utilizzando la console Rekognition o chiamando l'API. [DeleteProject](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DeleteProject.html) Per eliminare un progetto, devi prima eliminare ogni adattatore associato. Un progetto o un modello eliminato non può essere ripristinato.
Per eliminare un progetto con la console: AWS
+ Accedi alla Rekognition Console.
+ Fai clic su **Moderazione personalizzata**.
+ Prima di eliminare il progetto stesso, devi eliminare ogni adattatore associato al progetto. Eliminate tutti gli adattatori associati al progetto selezionando l'adattatore e quindi selezionando **Elimina**.
+ Selezionate il progetto, quindi fate clic sul pulsante **Elimina**.
Per eliminare un progetto con AWS CLI e SDK:
1. Se non l'hai già fatto, installa e configura la AWS CLI e il. AWS SDKs Per ulteriori informazioni, consulta [Passaggio 2: configura AWS CLI e AWS SDKs](setup-awscli-sdk.md).
1. Utilizza il seguente codice per eliminare un progetto:
------
#### [ CLI ]
```
aws rekognition delete-project
--project-arn project_arn \
--profile profile-name
```
------
# Creazione di una versione del progetto
È possibile addestrare un adattatore per la distribuzione utilizzando l'[CreateProjectVersion](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateProjectVersion.html)operazione. CreateProjectVersion crea prima una nuova versione di un adattatore associato a un progetto e poi inizia ad addestrare l'adattatore. La risposta CreateProjectVersion è un Amazon Resource Name (ARN) per la versione del modello. Il completamento dell’addestramento richiede tempo. Puoi conoscere lo stato attuale DescribeProjectVersions chiamando. Quando si addestra un modello, Rekognition utilizza addestramento e i set di dati di test associati al progetto. È possibile creare un set di dati utilizzando la console. Per ulteriori informazioni, consulta la sezione sui set di dati.
Per creare una versione di progetto con la console Rekognition:
+ Accedi alla Rekognition Console AWS
+ Fai clic su Moderazione personalizzata
+ Scelta di un progetto.
+ Nella pagina dei dettagli del progetto, scegli **Crea adattatore**
+ Nella pagina «Crea un progetto», inserisci i dettagli richiesti per Dettagli del progetto, Immagini di formazione e Immagini di test, quindi seleziona **Crea progetto**.
+ Nella pagina «Assegna etichette alle immagini», aggiungi delle etichette alle immagini e, al termine, seleziona **Inizia la formazione**
Per creare una versione del progetto con AWS CLI e SDK:
1. Se non l'hai già fatto, installa e configura la AWS CLI e il. AWS SDKs Per ulteriori informazioni, consulta [Passaggio 2: configura AWS CLI e AWS SDKs](setup-awscli-sdk.md).
1. Usa il codice seguente per creare una versione del progetto:
------
#### [ CLI ]
```
# Request
aws rekognition create-project-version \
--project-arn project-arn \
--training-data '{Assets=[GroundTruthManifest={S3Object="amzn-s3-demo-source-bucket",Name="manifest.json"}]}' \
--output-config S3Bucket=amzn-s3-demo-destination-bucket,S3KeyPrefix=my-results \
--feature-config "ContentModeration={ConfidenceThreshold=70}"
--profile profile-name
```
------
# Descrivere una versione del progetto
È possibile elencare e descrivere gli adattatori associati a un progetto utilizzando l'[DescribeProjectVersions](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DescribeProjectVersions.html)operazione. È possibile specificare fino a 10 versioni del modello in ProjectVersionArns. Se non specifichi un valore, vengono restituite descrizioni per tutte le versioni del modello nel progetto.
Per descrivere una versione del progetto con AWS CLI e SDK:
1. Se non l'hai già fatto, installa e configura la AWS CLI e il. AWS SDKs Per ulteriori informazioni, consulta [Passaggio 2: configura AWS CLI e AWS SDKs](setup-awscli-sdk.md).
1. Usa il codice seguente per descrivere una versione del progetto:
------
#### [ CLI ]
```
aws rekognition describe-project-versions
--project-arn project_arn \
--version-names [versions]
```
------
# Eliminazione di una versione di progetto
È possibile eliminare un adattatore Rekognition associato a un progetto utilizzando l'operazione. [DeleteProjectVersion](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DeleteProjectVersion.html) Non puoi eliminare un adattatore se è in esecuzione o in fase di addestramento. Per verificare lo stato di un adattatore, richiamate l' DescribeProjectVersions operazione e controllate il campo Status da essa restituito. Per interrompere una chiamata all'adattatore in esecuzione StopProjectVersion. Se un modello è in fase di addestramento, attendi che finisca prima di eliminarlo. Prima di eliminare il progetto stesso, devi eliminare ogni adattatore associato al progetto.
Per eliminare una versione del progetto con la console Rekognition:
+ Accedi alla Rekognition Console
+ Fai clic su Moderazione personalizzata
+ Dalla scheda Progetti puoi vedere tutti i tuoi progetti e gli adattatori associati. Seleziona un adattatore, quindi seleziona **Elimina**.
Per eliminare una versione del progetto con AWS CLI e SDK:
1. Se non l'hai già fatto, installa e configura la AWS CLI e il. AWS SDKs Per ulteriori informazioni, consulta [Passaggio 2: configura AWS CLI e AWS SDKs](setup-awscli-sdk.md).
1. Usa il codice seguente per eliminare una versione del progetto:
------
#### [ CLI ]
```
# Request
aws rekognition delete-project-version
--project-version-arn model_arn \
--profile profile-name
```
------