Distribuire un modello di analisi testuale personalizzata per la salute
Articolo
Quando si è soddisfatti delle prestazioni del modello, è pronto per essere distribuito e usato per riconoscere le entità nel testo. La distribuzione di un modello consente di renderlo disponibile per l'uso tramite l'API di stima.
Prerequisiti
Un progetto creato correttamente con un account di archiviazione di Azure configurato.
Dati di testo caricati nell'account di archiviazione.
Dopo aver esaminato le prestazioni del modello e aver stabilito che è adatto al proprio ambiente, è necessario assegnarlo a una distribuzione. L'assegnazione di un modello a una distribuzione consente di renderlo disponibile per l'uso tramite l'API di previsione. È preferibile creare una distribuzione denominata produzione a cui assegnare il modello migliore generato finora e usarlo nel proprio sistema. È possibile creare un'altra distribuzione denominata staging a cui è possibile assegnare il modello in uso per poterlo testare. È possibile avere fino a 10 distribuzioni in un progetto.
Selezionare Distribuzione di un modello nel 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 dall'elenco a discesa seguente. È possibile anche sovrascrivere una distribuzione esistente selezionando questa opzione e scegliendo il modello sottoposto a training da assegnare dall'elenco a discesa seguente.
Nota
La sovrascrittura di una distribuzione esistente non richiede modifiche alla chiamata dell'API di stima, ma i risultati ottenuti saranno basati sul modello appena assegnato.
Fare clic su Distribuisci per avviare il processo di distribuzione.
Al termine della distribuzione verrà visualizzata una data di scadenza. La scadenza della distribuzione indica quando il modello non potrà essere usato per la stima, ossia generalmente 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.
Il nome del progetto. Per questo valore viene applicata la distinzione tra maiuscole e minuscole.
myProject
{DEPLOYMENT-NAME}
Il nome della distribuzione. Per questo valore viene applicata la distinzione tra maiuscole e minuscole.
staging
{API-VERSION}
La versione dell'API che viene richiamata. Il valore a cui si fa riferimento qui è 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
La chiave della risorsa. È usata per l’autenticazione delle richieste API.
Corpo della richiesta
Usare il 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 il cui training è stato eseguito correttamente. Per questo valore viene applicata la distinzione tra maiuscole e minuscole.
myModel
Dopo aver inviato la richiesta API, si riceverà una risposta 202 che indica che il processo è stato inviato correttamente. Nelle intestazioni della risposta estrarre il valore operation-location. 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 dello stato del processo di distribuzione. È possibile usare l'URL ricevuto dal passaggio precedente oppure sostituire i valori segnaposto seguenti con i propri valori.
Il nome del progetto. Per questo valore viene applicata la distinzione tra maiuscole e minuscole.
myProject
{DEPLOYMENT-NAME}
Il nome della distribuzione. Per questo valore viene applicata la distinzione tra maiuscole e minuscole.
staging
{JOB-ID}
L’ID per individuare lo stato del training del modello. Si trova nel valore dell'intestazione location ricevuto nel passaggio precedente.
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx
{API-VERSION}
La versione dell'API che viene richiamata. Il valore a cui si fa riferimento qui è 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
La chiave della risorsa. È usata per l’autenticazione delle richieste API.
Testo della risposta
Quando si invia la richiesta, si riceverà la richiesta seguente. Continuare il polling di questo endpoint fino a quando il parametro dello stato diventa "succeeded". Si ottiene un codice 200 indicante l'esito positivo della richiesta.
Dopo aver completato il test di un modello assegnato a una distribuzione e averlo assegnato a un'altra distribuzione, è possibile scambiare le due distribuzioni. Nello scambio delle distribuzioni si prende il modello assegnato alla prima distribuzione e lo si assegna alla seconda distribuzione. Si prende quindi il modello assegnato alla seconda distribuzione e lo si assegna alla prima distribuzione. È possibile usare questo processo per scambiare le distribuzioni di produzione e staging ogni volta che si vuole prendere il modello assegnato all'ambiente di staging e assegnarlo all'ambiente di produzione.
Per eliminare una distribuzione da Language Studio, accedere alla pagina Distribuzione di un modello. Selezionare la distribuzione da eliminare e scegliere Elimina distribuzione nel 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}
Il nome della distribuzione. Per questo valore viene applicata la distinzione tra maiuscole e minuscole.
prod
{API-VERSION}
La versione dell'API che si sta chiamando. Il valore a cui si fa riferimento qui è 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
La chiave della risorsa. È usata per l’autenticazione delle richieste API.
Dopo aver inviato la richiesta API, si riceverà una risposta 202 con l'esito positivo indicante che la distribuzione è stata eliminata. Risultati di una chiamata con esito positivo con un'intestazione Operation-Location usata per controllare lo stato del processo.
Andare 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.
A questo punto, è possibile distribuire il progetto nelle aree in cui sono state assegnate le risorse.
L'assegnazione delle risorse di distribuzione a livello di codice richiede l'autenticazione di Microsoft Entra. Microsoft Entra ID viene usato per accertarsi di disporre dell’accesso alle risorse da assegnare al progetto per la distribuzione in più aree. Per usare l'autenticazione di Microsoft Entra a livello di codice quando si effettuano chiamate dell'API REST, vedere altre informazioni dalla documentazione di Servizi di Azure AI.
Assegnare una risorsa
Inviare una richiesta POST usando l'URL, le intestazioni e il corpo JSON seguenti per assegnare risorse di distribuzione.
Richiesta URL
Usare l'URL seguente durante la creazione della richiesta API. Sostituire i valori segnaposto seguenti con i propri valori.
Il sottodominio personalizzato della risorsa da assegnare. Disponibile nel portale di Azure nella scheda Chiavi ed endpoint per la risorsa, come campo Endpoint nell'URL https://<your-custom-subdomain>.cognitiveservices.azure.com/
contosoresource
region
{REGION-CODE}
Un codice area che specifica l'area della risorsa da assegnare. Disponibile nel portale di Azure nella scheda Chiavi ed endpoint per la risorsa, nel campo Posizione/Area.
eastus
Ottenere lo stato di assegnazione di una risorsa
Usare la richiesta GET seguente per ottenere lo stato del processo di assegnazione di una 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}
L’ID processo per ottenere lo stato di assegnazione della distribuzione. È incluso nel valore dell'intestazione operation-location ricevuto dall'API in risposta alla richiesta di assegnazione della risorsa di distribuzione.
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx
{API-VERSION}
La versione dell'API che viene richiamata.
2022-10-01-preview
Intestazioni
Usare l'intestazione seguente per autenticare la richiesta.
Chiave
valore
Ocp-Apim-Subscription-Key
La chiave della risorsa. È usata per l’autenticazione delle richieste API.
Testo della risposta
Dopo aver inviato la richiesta, si otterrà la risposta seguente. Continuare il polling di questo endpoint fino a quando il parametro status dello stato diventa succeeded.
Annullare l'assegnazione di risorse di distribuzione
Quando si annulla l'assegnazione o si rimuove una risorsa di distribuzione da un progetto, verranno eliminate anche tutte le distribuzioni distribuite nell'area di tale risorsa.
Per annullare l’assegnazione o rimuovere risorse di distribuzione in altre usando Studio di linguaggio:
Accedere alla scheda Aree nella pagina Distribuisci un modello.
Selezionare la risorsa di cui annullare l'assegnazione.
Selezionare il pulsante Rimuovi assegnazione.
Nella finestra che viene visualizzata, digitare il nome della risorsa da rimuovere.
Annullare l'assegnazione di una risorsa
Inviare una richiesta POST usando l'URL, le intestazioni e il corpo JSON seguenti per annullare l’assegnazione o rimuovere risorse di distribuzione da un progetto.
Richiesta URL
Usare l'URL seguente durante la creazione della richiesta API. Sostituire i valori segnaposto seguenti con i propri valori.
Il percorso dell’ID risorsa completo di cui annullare l’assegnazione. Disponibile nel portale di Azure nella scheda Proprietà per la risorsa come campo ID risorsa.
Ottenere lo stato di annullamento dell’assegnazione di una risorsa
Usare la richiesta GET seguente per ottenere lo stato del processo di annullamento dell’assegnazione di una 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}
L’ID processo per ottenere lo stato di assegnazione della distribuzione. È incluso nel valore dell'intestazione operation-location ricevuto dall'API in risposta alla richiesta di annullamento dell’assegnazione di una risorsa di distribuzione.
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx
{API-VERSION}
La versione dell'API che viene richiamata.
2022-10-01-preview
Intestazioni
Usare l'intestazione seguente per autenticare la richiesta.
Chiave
valore
Ocp-Apim-Subscription-Key
La chiave della risorsa. È usata per l’autenticazione delle richieste API.
Testo della risposta
Dopo aver inviato la richiesta, si otterrà la risposta seguente. Continuare il polling di questo endpoint fino a quando il parametro dello stato diventa "succeeded".
