Quando você estiver satisfeito com o desempenho do modelo, ele estará pronto para ser implantado e consultado para previsões usando enunciados. A implantação de um modelo o torna disponível para uso por meio da API de previsão.
Depois de examinar o desempenho do modelo e decidir que ele é adequado para ser usado em seu ambiente, você precisará atribuí-lo a uma implantação para consultá-lo. Atribuir o modelo a uma implantação disponibiliza-o para uso por meio da API de previsão. É recomendável criar uma implantação chamada production à qual você atribui o melhor modelo criado até agora e utiliza-o em seu sistema. Você pode criar outra implantação chamada staging à qual você pode atribuir o modelo em que está trabalhando no momento para poder testá-lo. Você pode ter no máximo dez implantações em seu projeto.
Selecione Adicionar implantação para iniciar o assistente Adicionar implantação.
Selecione Criar um novo nome de implantação para criar uma implantação e atribuir um modelo treinado na lista suspensa abaixo. Caso contrário, você pode selecionar Substituir um nome de implantação existente para substituir efetivamente o modelo usado por uma implantação existente.
Observação
A substituição de uma implantação existente não exige alterações na chamada à API de Previsão, mas os resultados obtidos serão baseados no modelo recém-atribuído.
Selecione um modelo treinado na lista suspensa Modelo.
Selecione Implantar para iniciar a implantação.
Depois que a implantação for realizada com sucesso, uma data de validade será exibida. A expiração da implantação consiste no momento em que o modelo implantado não estará disponível para ser usado para previsão, o que normalmente acontece 12 meses após a expiração de uma configuração de treinamento.
Enviar trabalho de implantação
Crie uma solicitação PUT usando a URL, os cabeçalhos e o corpo JSON a seguir para começar a implantar um modelo de compreensão da linguagem coloquial.
Use o cabeçalho a seguir para autenticar sua solicitação.
Chave
Valor
Ocp-Apim-Subscription-Key
A chave para o recurso. Usado para autenticação de suas solicitações de API.
Corpo da solicitação
{
"trainedModelLabel": "{MODEL-NAME}",
}
Chave
Espaço reservado
Valor
Exemplo
trainedModelLabel
{MODEL-NAME}
O nome do modelo que será atribuído à implantação. Você só pode atribuir modelos treinados com sucesso. Esse valor diferencia maiúsculas de minúsculas.
myModel
Depois de enviar sua solicitação de API, você receberá uma 202 resposta indicando êxito. Nos cabeçalhos de resposta, extraia o valor operation-location. A formatação ficará da seguinte maneira:
Use essa URL para obter o status do trabalho de implantação.
Obter status do trabalho de implantação
Ao enviar uma solicitação de implantação bem-sucedida, a URL completa da solicitação para verificar o status do trabalho (incluindo seu ponto de extremidade, nome do projeto e ID do trabalho) está contida no cabeçalho operation-location da resposta.
Use a solicitação GET a seguir para obter o status do trabalho de implantação. Substitua os valores do espaço reservado pelos seus.
Use o cabeçalho a seguir para autenticar sua solicitação.
Chave
Valor
Ocp-Apim-Subscription-Key
A chave para o recurso. Usado para autenticação de suas solicitações de API.
Corpo da resposta
Depois de enviar a solicitação, você receberá a seguinte resposta. Continue sondando esse ponto de extremidade até que o parâmetro de status mude para "bem-sucedido".
Depois de terminar de testar um modelo atribuído a uma implantação, você poderá atribuí-lo a outra implantação. A troca de implantações envolve:
Pegar o modelo atribuído à primeira implantação e atribui-lo à segunda implantação.
pegar o modelo atribuído à segunda implantação e atribui-lo à primeira implantação.
Isso poderá ser usado para trocar as implantações production e staging quando você quiser pegar o modelo atribuído a staging e atribuí-lo a production.
Para excluir uma implantação de dentro do Language Studio, acesse a página Implantar modelo. Selecione a implantação que você deseja excluir e clique em Excluir implantação no menu superior.
Crie uma solicitação EXCLUIR usando a URL, os cabeçalhos e o corpo JSON a seguir para excluir um projeto de compreensão da linguagem coloquial.
Vá para a página Implantando um modelo no Language Studio.
Selecione a guia Regiões.
Clique em Adicionar recurso de implantação.
Selecione um recurso de Linguagem em outra região.
Agora você está pronto para implantar seu projeto nas regiões em que atribuiu recursos.
Atribuir recursos de implantação programaticamente requer autenticação do Microsoft Entra**. O Microsoft Entra ID é usado para confirmar que você tem acesso aos recursos que está interessado em atribuir ao seu projeto para implantação em várias regiões. Para usar programaticamente a autenticação do Mirosoft Entra ao fazer chamadas à API REST, consulte a documentação de autenticação dos serviços de IA do Azure.
Atribuir recurso
Envie uma solicitação POST usando a URL, os cabeçalhos e o corpo JSON a seguir para atribuir recursos de implantação.
URL da solicitação
Use a URL a seguir ao criar sua solicitação de API. Substitua os valores dos espaços reservados abaixo pelos seus próprios valores.
O subdomínio personalizado do recurso que você deseja atribuir. Encontrado na portal do Azure na guia Chaves e Ponto de Extremidade do recurso, parte do campo Ponto de Extremidade na URL https://<your-custom-subdomain>.cognitiveservices.azure.com/
contosoresource
region
{REGION-CODE}
Um código de região que especifica a região do recurso que você deseja atribuir. Encontrado no portal do Azure na guia Chaves e Ponto de Extremidade do recurso, como parte do campo Localização/Região.
eastus
Obter o status da atribuição do recurso
Use a solicitação GET a seguir para obter o status do trabalho de atribuição do recurso de implantação. Substitua os valores dos espaços reservados abaixo pelos seus próprios valores.
O nome do seu projeto. Esse valor diferencia maiúsculas de minúsculas.
myProject
{JOB-ID}
A ID do trabalho para obter o status de atribuição de implantação. Encontre-a no valor de cabeçalho operation-location que você recebeu da API em resposta à solicitação de atribuição de recurso de implantação.
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx
{API-VERSION}
A versão da API que você está chamando.
2022-10-01-preview
Cabeçalhos
Use o cabeçalho a seguir para autenticar sua solicitação.
Chave
Valor
Ocp-Apim-Subscription-Key
A chave para o recurso. Usado para autenticação de suas solicitações de API.
Corpo da resposta
Depois de enviar a solicitação, você receberá a seguinte resposta. Continue sondando esse ponto de extremidade até que o parâmetro de status mude para "bem-sucedido".
Ao cancelar a atribuição ou a remoção de um recurso de implantação de um projeto, você também excluirá todas as implantações que foram realizadas na região desse recurso.
Para cancelar a atribuição de recursos de implantação ou removê-los de outras regiões usando o Language Studio:
Vá para a guia Regiões na página Implantar um modelo.
Selecione o recurso cuja atribuição você deseja cancelar.
Selecione o botão Remover atribuição.
Na janela exibida, digite o nome do recurso que você deseja remover.
Cancelar a atribuição do recurso
Envie uma solicitação POST usando a URL, os cabeçalhos e o corpo JSON a seguir para cancelar a atribuição dos recursos de implantação ou removê-los do seu projeto.
URL da solicitação
Use a URL a seguir ao criar sua solicitação de API. Substitua os valores dos espaços reservados abaixo pelos seus próprios valores.
O caminho completo da ID do recurso cuja atribuição você deseja cancelar. Encontrado na portal do Azure na guia Propriedades do recurso, como o campo ID do Recurso.
Obter o status do cancelamento da atribuição do recurso
Use a solicitação GET a seguir para obter o status do trabalho de cancelamento da atribuição do recurso de implantação. Substitua os valores dos espaços reservados abaixo pelos seus próprios valores.
O nome do seu projeto. Esse valor diferencia maiúsculas de minúsculas.
myProject
{JOB-ID}
A ID do trabalho para obter o status de atribuição de implantação. Encontre-a no valor de cabeçalho operation-location que você recebeu da API em resposta à solicitação de cancelamento de atribuição de recurso de implantação.
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx
{API-VERSION}
A versão da API que você está chamando.
2022-10-01-preview
Cabeçalhos
Use o cabeçalho a seguir para autenticar sua solicitação.
Chave
Valor
Ocp-Apim-Subscription-Key
A chave para o recurso. Usado para autenticação de suas solicitações de API.
Corpo da resposta
Depois de enviar a solicitação, você receberá a seguinte resposta. Continue sondando esse ponto de extremidade até que o parâmetro de status mude para "bem-sucedido".
