Eseguire il training del modello di riconoscimento delle entità denominato personalizzato
Articolo
Il training è il processo in cui il modello apprende dai dati etichettati. Al termine del training, sarà possibile visualizzare le prestazioni del modello per determinare se è necessario migliorare il modello.
Per eseguire il training di un modello, avviare un processo di training e creare un modello solo i processi completati correttamente. I processi di training scadono dopo sette giorni, il che significa che non sarà possibile recuperare i dettagli del processo dopo questa volta. Se il processo di training è stato completato correttamente e un modello è stato creato, il modello non sarà interessato. È possibile avere un solo processo di training in esecuzione alla volta e non è possibile avviare altri processi nello stesso progetto.
I tempi di training possono essere ovunque da pochi minuti quando si gestiscono pochi documenti, fino a diverse ore a seconda delle dimensioni del set di dati e della complessità dello schema.
Prerequisiti
Progetto creato correttamente con un account di archiviazione BLOB di Azure configurato
Dati di testo caricati nell'account di archiviazione.
Prima di avviare il processo di training, i documenti etichettati nel progetto sono suddivisi in un set di training e in un set di test. Ognuno di essi serve una funzione diversa.
Il set di training viene usato nel training del modello, questo è il set da cui il modello apprende le entità etichettate e gli intervalli di testo da estrarre come entità.
Il set di test è un set cieco che non viene introdotto nel modello durante il training, ma solo durante la valutazione.
Al termine del training del modello, il modello viene usato per eseguire stime dai documenti nei test e in base a queste metriche di valutazione delle stime vengono calcolate.
È consigliabile assicurarsi che tutte le entità siano adeguatamente rappresentate sia nel set di training che nel set di test.
Il NER personalizzato supporta due metodi per la suddivisione dei dati:
Suddividere automaticamente il set di test dai dati di training: il sistema suddividerà i dati etichettati tra i set di training e test, in base alle percentuali scelte. La divisione percentuale consigliata è il 80% per il training e il 20% per i test.
Nota
Se si sceglie l'opzione Divisione automatica del set di test dai dati di training , solo i dati assegnati al set di training verranno suddivisi in base alle percentuali fornite.
Usare una suddivisione manuale dei dati di training e test: questo metodo consente agli utenti di definire quali documenti etichettati devono appartenere a quale set. Questo passaggio è abilitato solo se sono stati aggiunti documenti al set di test durante l'etichettatura dei dati.
Selezionare Processi di training dal menu a sinistra.
Selezionare Avvia un processo di training dal menu superiore.
Selezionare Esegui il training di un nuovo modello e digita il nome del modello nella casella di testo. È anche possibile sovrascrivere un modello esistente selezionando questa opzione e scegliendo il modello da sovrascrivere dal menu a discesa. Sovrascrivere un modello sottoposto a training è irreversibile, ma non influisce sui modelli distribuiti finché non si distribuisce il nuovo modello.
Selezionare il metodo di divisione dei dati. È possibile scegliere Suddivisione automatica del set di test dai dati di training in cui il sistema suddividerà i dati etichettati tra i set di training e test, in base alle percentuali specificate. In alternativa, è possibile usare una suddivisione manuale dei dati di training e test, questa opzione è abilitata solo se sono stati aggiunti documenti al set di test durante l'etichettatura dei dati. Vedere Come eseguire il training di un modello per informazioni sulla suddivisione dei dati.
Selezionare il pulsante Esegui training .
Se si seleziona l'ID processo di training dall'elenco, verrà visualizzato un riquadro laterale in cui è possibile controllare lo stato del training, lo stato del processo e altri dettagli per questo processo.
Nota
Solo i processi di training completati genereranno modelli.
Il training può richiedere tempo tra un paio di minuti e diverse ore in base alle dimensioni dei dati etichettati.
È possibile eseguire un solo processo di training alla volta. Non è possibile avviare altri processi di training nello stesso progetto fino al completamento del processo in esecuzione.
Avviare il processo di formazione
Inviare una richiesta POST usando l'URL, le intestazioni e il corpo JSON seguenti per inviare un processo di training. Sostituire i valori segnaposto seguenti con i propri valori.
Nome del progetto. Per questo valore viene applicata la distinzione tra maiuscole e minuscole.
myProject
{API-VERSION}
Versione dell'API che si sta chiamando. Il valore a cui viene fatto riferimento è per la versione più recente rilasciata. Per altre informazioni sulle altre versioni dell'API disponibili, vedere Ciclo di vita del modello .
2022-05-01
Intestazioni
Usare l'intestazione seguente per autenticare la richiesta.
Chiave
Valore
Ocp-Apim-Subscription-Key
Chiave della risorsa. Usato per autenticare le richieste API.
Testo della richiesta
Usare il codice JSON seguente nel corpo della richiesta. Il modello verrà assegnato al termine del {MODEL-NAME} training. Solo i processi di formazione con esito positivo produrranno modelli.
Percentuale dei dati contrassegnati da includere nel set di training. Il valore consigliato è 80.
80
testingSplitPercentage
20
Percentuale dei dati contrassegnati da includere nel set di test. Il valore consigliato è 20.
20
Nota
L'oggetto trainingSplitPercentage e testingSplitPercentage sono necessari solo se Kind è impostato su percentage e la somma di entrambe le percentuali deve essere uguale a 100.
Dopo aver inviato la richiesta API, si riceverà una 202 risposta che indica che il processo è stato inviato correttamente. Nelle intestazioni di risposta estrarre il location valore. Verrà formattato come segue:
{JOB-ID} viene usato per identificare la richiesta, poiché questa operazione è asincrona. È possibile usare questo URL per ottenere lo stato di training.
Ottenere lo stato del processo di training
Il training potrebbe richiedere tempo a seconda delle dimensioni dei dati di training e della complessità dello schema. È possibile usare la richiesta seguente per mantenere il polling dello stato del processo di training fino al completamento del processo di training.
Usare la richiesta GET seguente per ottenere lo stato dell'avanzamento del training del modello. Sostituire i valori segnaposto seguenti con i propri valori.
Nome del progetto. Per questo valore viene applicata la distinzione tra maiuscole e minuscole.
myProject
{JOB-ID}
ID per individuare lo stato di training del modello. Questo valore è nel valore dell'intestazione location ricevuto nel passaggio precedente.
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx
{API-VERSION}
Versione dell'API che si sta chiamando. Il valore a cui viene fatto riferimento è per la versione più recente rilasciata. Per altre informazioni sulle altre versioni dell'API disponibili, vedere Ciclo di vita del modello .
2022-05-01
Intestazioni
Usare l'intestazione seguente per autenticare la richiesta.
Chiave
Valore
Ocp-Apim-Subscription-Key
Chiave della risorsa. Usato per autenticare le richieste API.
Corpo della risposta
Dopo aver inviato la richiesta, si otterrà la risposta seguente.
Per annullare un processo di training da Language Studio, passare alla pagina Processi di training . Selezionare il processo di training da annullare e selezionare Annulla dal menu in alto.
Creare una richiesta POST usando l'URL, le intestazioni e il corpo JSON seguenti per annullare un processo di training.
URL richiesta
Usare l'URL seguente durante la creazione della richiesta API. Sostituire i valori segnaposto seguenti con i propri valori.
Nome del progetto. Per questo valore viene applicata la distinzione tra maiuscole e minuscole.
EmailApp
{JOB-ID}
Questo valore è l'ID processo di training.
XXXXX-XXXXX-XXXX-XX
{API-VERSION}
Versione dell'API che si sta chiamando. Il valore a cui viene fatto riferimento è per la versione del modello rilasciata più recente.
2022-05-01
Intestazioni
Usare l'intestazione seguente per autenticare la richiesta.
Chiave
Valore
Ocp-Apim-Subscription-Key
Chiave della risorsa. Usato per autenticare le richieste API.
Dopo aver inviato la richiesta API, si riceverà una risposta 202 con un'intestazione Operation-Location usata per controllare lo stato del processo.
Passaggi successivi
Al termine del training, sarà possibile visualizzare le prestazioni del modello per migliorare facoltativamente il modello se necessario. Dopo aver soddisfatto il modello, è possibile distribuirlo, rendendolo disponibile per l'estrazione di entità dal testo.