Distribuire un modello del flusso di lavoro di orchestrazione
Articolo
Dopo aver soddisfatto le prestazioni del modello, è possibile distribuirlo ed eseguirne una query per le stime dalle espressioni. La distribuzione di un modello rende disponibile per l'uso tramite l'API di stima.
Dopo aver esaminato le prestazioni del modello e aver deciso di usarlo nell'ambiente in uso, è necessario assegnarlo a una distribuzione per poterlo eseguire una query. 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 usarla 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.
Non sono necessarie configurazioni per le risposte alle domande personalizzate o le finalità non collegate.
I progetti LUIS devono essere pubblicati nello slot configurato durante la distribuzione dell'orchestrazione e le domande personalizzate devono essere pubblicate anche negli slot di produzione.
Selezionare Distribuisci per inviare 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
Creare una richiesta PUT usando l'URL, le intestazioni e il corpo JSON seguenti per iniziare a distribuire un modello di flusso di lavoro di orchestrazione.
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.
2023-04-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
{
"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 l'esito positivo. Nelle intestazioni della risposta estrarre il operation-location valore. Il formato sarà simile al seguente:
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. Questo è il location valore dell'intestazione ricevuto dall'API in risposta alla richiesta di distribuzione del modello.
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx
{API-VERSION}
Versione dell'API che si sta chiamando.
2023-04-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".
Dopo aver completato il test di un modello assegnato a una distribuzione, è possibile assegnarlo a un'altra distribuzione. Lo scambio delle distribuzioni prevede:
Prendere il modello assegnato alla prima distribuzione e assegnarlo alla seconda distribuzione.
prendendo il modello assegnato alla seconda distribuzione e assegnandolo alla prima distribuzione.
Può essere usato per scambiare le production distribuzioni e staging quando si vuole assegnare il modello a staging e assegnarlo a production.
Per eliminare una distribuzione da Language Studio, passare alla pagina Distribuisci 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 di language understanding per conversazioni.
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 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 sull'autenticazione 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, parte del 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, come parte del 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. Continuare a eseguire il polling di questo endpoint fino a quando il parametro di stato 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".
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.