Distribuire un modello ed estrarre entità dal testo usando l'API di runtime
Articolo
Dopo aver soddisfatto le prestazioni del modello, è pronto per essere distribuito e usato per riconoscere le entità nel testo. La distribuzione di un modello rende disponibile per l'uso tramite l'API di stima.
Prerequisiti
Progetto creato correttamente con un account di archiviazione di Azure configurato.
Dopo aver esaminato le prestazioni del modello e aver deciso che può essere usato nell'ambiente, è necessario assegnarlo a una distribuzione. L'assegnazione del modello a una distribuzione lo rende disponibile per l'uso tramite l'API di stima. È consigliabile creare una distribuzione denominata production a cui assegnare il modello migliore creato finora e usarlo nel sistema. È possibile creare un'altra distribuzione denominata staging a cui è possibile assegnare il modello su cui si sta lavorando per poterlo testare. È possibile avere un massimo di 10 distribuzioni nel progetto.
Selezionare Deploying a model (Distribuzione di un modello ) dal menu a sinistra.
Selezionare Aggiungi distribuzione per avviare un nuovo processo di distribuzione.
Selezionare Crea nuova distribuzione per creare una nuova distribuzione e assegnare un modello sottoposto a training nell'elenco a discesa seguente. È anche possibile sovrascrivere una distribuzione esistente selezionando questa opzione e selezionando il modello sottoposto a training che si vuole assegnare al modello dall'elenco a discesa seguente.
Nota
La sovrascrittura di una distribuzione esistente non richiede modifiche alla chiamata api di stima, ma i risultati ottenuti saranno basati sul modello appena assegnato.
Selezionare Distribuisci per avviare il processo di distribuzione.
Al termine della distribuzione, accanto verrà visualizzata una data di scadenza. La scadenza della distribuzione è quando il modello distribuito non sarà disponibile per la stima, che in genere si verifica dodici mesi dopo la scadenza di una configurazione di training.
Inviare un processo di distribuzione
Inviare una richiesta PUT usando l'URL, le intestazioni e il corpo JSON seguenti per inviare un processo di distribuzione. Sostituire i valori segnaposto seguenti con i propri valori.
Nome del progetto. Per questo valore viene applicata la distinzione tra maiuscole e minuscole.
myProject
{DEPLOYMENT-NAME}
Nome della distribuzione. Per questo valore viene applicata la distinzione tra maiuscole e minuscole.
staging
{API-VERSION}
Versione dell'API che si sta chiamando. Il valore a cui viene fatto riferimento è relativo alla 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 l'autenticazione delle richieste API.
Corpo della richiesta
Usare il codice JSON seguente nel corpo della richiesta. Usare il nome del modello da assegnare alla distribuzione.
{
"trainedModelLabel": "{MODEL-NAME}"
}
Chiave
Segnaposto
Valore
Esempio
trainedModelLabel
{MODEL-NAME}
Nome del modello che verrà assegnato alla distribuzione. È possibile assegnare solo modelli sottoposti a training correttamente. Per questo valore viene applicata la distinzione tra maiuscole e minuscole.
myModel
Dopo aver inviato la richiesta API, si riceverà una 202 risposta che indica che il processo è stato inviato correttamente. Nelle intestazioni della risposta estrarre il operation-location valore. Il formato sarà simile al seguente:
{JOB-ID} viene usato per identificare la richiesta, poiché questa operazione è asincrona. È possibile usare questo URL per ottenere lo stato della distribuzione.
Ottenere lo stato del processo di distribuzione
Usare la richiesta GET seguente per eseguire una query sullo stato del processo di distribuzione. È possibile usare l'URL ricevuto dal passaggio precedente oppure sostituire i valori segnaposto seguenti con i propri valori.
Nome del progetto. Per questo valore viene applicata la distinzione tra maiuscole e minuscole.
myProject
{DEPLOYMENT-NAME}
Nome della distribuzione. Per questo valore viene applicata la distinzione tra maiuscole e minuscole.
staging
{JOB-ID}
ID per individuare lo stato di training del modello. Si trova 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 è relativo alla 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 l'autenticazione delle richieste API.
Testo della risposta
Dopo aver inviato la richiesta, si otterrà la risposta seguente. Continuare a eseguire il polling di questo endpoint fino a quando il parametro di stato non viene modificato in "succeeded". Si dovrebbe ottenere un 200 codice per indicare l'esito positivo della richiesta.
Dopo aver completato il test di un modello assegnato a una distribuzione e si vuole assegnare questo modello a un'altra distribuzione, è possibile scambiare queste due distribuzioni. Lo scambio delle distribuzioni comporta l'assegnazione del modello alla prima distribuzione e l'assegnazione alla seconda distribuzione. Prendere quindi il modello assegnato alla seconda distribuzione e assegnarlo alla prima distribuzione. È possibile usare questo processo per scambiare le distribuzioni di produzione e staging quando si vuole assegnare il modello alla gestione temporanea e assegnarlo all'ambiente di produzione.
Per eliminare una distribuzione da Language Studio, passare alla pagina Distribuzione di un modello . Selezionare la distribuzione da eliminare e selezionare Elimina distribuzione dal menu in alto.
Creare una richiesta DELETE usando l'URL, le intestazioni e il corpo JSON seguenti per eliminare una distribuzione.
Nome del progetto. Per questo valore viene applicata la distinzione tra maiuscole e minuscole.
myProject
{DEPLOYMENT-NAME}
Nome della distribuzione. Per questo valore viene applicata la distinzione tra maiuscole e minuscole.
prod
{API-VERSION}
Versione dell'API che si sta chiamando. Il valore a cui viene fatto riferimento è relativo alla 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 l'autenticazione delle richieste API.
Dopo aver inviato la richiesta API, si riceverà una 202 risposta che indica l'esito positivo, ovvero la distribuzione è stata eliminata. Risultati di una chiamata con esito positivo con un'intestazione Operation-Location usata per controllare lo stato del processo.
Per assegnare risorse di distribuzione in altre aree in Language Studio:
Assicurarsi di aver assegnato se stessi come proprietario del linguaggio di Servizi cognitivi alla risorsa usata per creare il progetto.
Passare alla pagina Distribuzione di un modello in Language Studio.
Selezionare la scheda Aree .
Selezionare Aggiungi risorsa di distribuzione.
Selezionare una risorsa lingua in un'altra area.
È ora possibile distribuire il progetto nelle aree in cui sono state assegnate le risorse.
L'assegnazione di risorse di distribuzione a livello di codice richiede l'autenticazione di Microsoft Entra. Microsoft Entra ID viene usato per confermare di avere accesso alle risorse che si desidera assegnare al progetto per la distribuzione in più aree. Per usare l'autenticazione Di Microsoft Entra a livello di codice quando si effettuano chiamate API REST, vedere la documentazione dei servizi di intelligenza artificiale di Azure.
Assegnare una risorsa
Inviare una richiesta POST usando l'URL, le intestazioni e il corpo JSON seguenti per assegnare le risorse di distribuzione.
Richiesta URL
Usare l'URL seguente durante la creazione della richiesta API. Sostituire i valori segnaposto seguenti con i propri valori.
Sottodominio personalizzato della risorsa da assegnare. Trovato nella portale di Azure nella scheda Chiavi ed endpoint per la risorsa, come campo Endpoint nell'URLhttps://<your-custom-subdomain>.cognitiveservices.azure.com/
contosoresource
region
{REGION-CODE}
Codice di area che specifica l'area della risorsa da assegnare. Trovato nella portale di Azure nella scheda Chiavi ed endpoint per la risorsa, nel campo Località/Area.
eastus
Ottenere lo stato di assegnazione della risorsa
Usare la richiesta GET seguente per ottenere lo stato del processo di assegnazione della risorsa di distribuzione. 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 processo per ottenere lo stato di distribuzione assegnato. Si tratta del operation-location valore dell'intestazione ricevuto dall'API in risposta alla richiesta di assegnazione della risorsa di distribuzione.
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx
{API-VERSION}
Versione dell'API che si sta chiamando.
2022-10-01-preview
Intestazioni
Usare l'intestazione seguente per autenticare la richiesta.
Chiave
Valore
Ocp-Apim-Subscription-Key
Chiave della risorsa. Usato per l'autenticazione delle richieste API.
Testo della risposta
Dopo aver inviato la richiesta, si otterrà la risposta seguente. Mantenere il polling di questo endpoint fino a quando il status parametro non viene modificato in succeeded.
Annullare l'assegnazione delle risorse di distribuzione
Quando si annulla l'assegnazione o la rimozione di una risorsa di distribuzione da un progetto, verranno eliminate anche tutte le distribuzioni distribuite nell'area della risorsa.
Percorso ID risorsa completo che si desidera annullare l'assegnazione. Trovato nella portale di Azure nella scheda Proprietà per la risorsa come campo ID risorsa.
Ottenere lo stato di annullare l'assegnazione della risorsa
Usare la richiesta GET seguente per ottenere lo stato del processo di annullare l'assegnazione delle risorse di distribuzione. 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 processo per ottenere lo stato di distribuzione assegnato. Si tratta del operation-location valore dell'intestazione ricevuto dall'API in risposta alla richiesta di risorsa di distribuzione non assegnata.
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx
{API-VERSION}
Versione dell'API che si sta chiamando.
2022-10-01-preview
Intestazioni
Usare l'intestazione seguente per autenticare la richiesta.
Chiave
Valore
Ocp-Apim-Subscription-Key
Chiave della risorsa. Usato per l'autenticazione delle richieste API.
Testo della risposta
Dopo aver inviato la richiesta, si otterrà la risposta seguente. Continuare a eseguire il polling di questo endpoint fino a quando il parametro di stato non viene modificato in "succeeded".