Distribuire un modello del flusso di lavoro di orchestrazione
Articolo
Quando le prestazioni del modello sono soddisfacenti, il modello è pronto per la distribuzione e le query per le stime dalle espressioni. La distribuzione di un modello consente di renderlo disponibile per l'uso tramite l'API di stima.
Dopo aver esaminato le prestazioni del modello e aver deciso che è adatto all’uso nel proprio ambiente, è necessario assegnarlo a una distribuzione per l’esecuzione delle query. L’assegnazione di un modello a una distribuzione consente di renderlo disponibile all'uso tramite l'API di stima. È preferibile creare una distribuzione denominata production 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 previsione, ma i risultati ottenuti saranno basati sul modello appena assegnato.
Non sono necessarie configurazioni per la funzionalità personalizzata di risposta alla domanda o le finalità non collegate.
I progetti LUIS devono essere pubblicati nello slot configurato durante la distribuzione dell'orchestrazione e devono essere pubblicate anche le KB di risposta alle domande personalizzate 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 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
Creare una richiesta PUT usando l'URL, le intestazioni e il corpo JSON seguenti per iniziare a distribuire un modello del flusso di lavoro di orchestrazione.
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
{
"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 indicante l'esito positivo. Nelle intestazioni della risposta, estrarre il valore operation-location. 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}
L'ID per individuare lo stato del training del modello. È incluso nel valore dell'intestazione location ricevuto dall'API in risposta alla richiesta di distribuzione del modello.
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".
Dopo aver completato il test di un modello assegnato a una distribuzione, è possibile assegnarlo a un'altra distribuzione. Lo scambio delle distribuzioni prevede:
Acquisizione del modello assegnato alla prima distribuzione e assegnazione di tale modello alla seconda distribuzione.
Acquisizione del modello assegnato alla seconda distribuzione e assegnazione di tale modello alla prima distribuzione.
Può essere usato per lo scambio di distribuzioni production e staging quando si desidera acquisire il modello assegnato a staging e assegnarlo a production.
Per eliminare una distribuzione da Language Studio, accedere alla pagina Distribuisci modello. Selezionare la distribuzione da eliminare e scegliere Elimina distribuzione nel menu in alto.
Creare una richiesta ELIMINA usando l'URL, le intestazioni e il corpo JSON seguenti per eliminare una distribuzione di comprensione del linguaggio di conversazione.
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 programmatica delle risorse di distribuzione 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 programmaticamente quando si effettuano chiamate API REST, vedere la documentazione relativa all'autenticazione 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 percorso ID risorsa completo da assegnare. Disponibile nel portale di Azure nella scheda Proprietà per la risorsa, all'interno del campo ID risorsa.
Il sottodominio personalizzato della risorsa da assegnare. Disponibile nel portale di Azure nella scheda Chiavi ed endpoint per la risorsa, come parte del 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, come parte del 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. Mantenere il polling di questo endpoint fino a quando il parametro 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".
