Implantar um modelo e classificar texto usando a API de runtime
Artigo
Quando estiver satisfeito com o desempenho do modelo, ele estará pronto para ser implantado e usado para classificar texto. 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 pode ser usado em seu ambiente, você precisa atribuí-lo a uma implantação para poder 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 um novo trabalho de implantação.
Selecione Criar implantação para criar uma implantação e atribuir um modelo treinado na lista suspensa abaixo. Você também pode Substituir uma implantação existente selecionando essa opção e escolhendo o modelo treinado que deseja atribuir na lista suspensa abaixo.
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 Implantar para iniciar o trabalho de 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
Envie uma solicitaçãoPUT usando a URL, os cabeçalhos e o corpo JSON a seguir para enviar o trabalho 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
{DEPLOYMENT-NAME}
O nome da sua implantação. Esse valor diferencia maiúsculas de minúsculas.
staging
{API-VERSION}
A versão da API que você está chamando. O valor referenciado aqui é para a versão mais recente lançada. Saiba mais sobre as outras versões de API disponíveis
2022-05-01
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 solicitação
Use o JSON a seguir no corpo da solicitação. Use o nome do modelo atribuído à implantaçã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 a solicitação à API, você receberá uma resposta 202 indicando que o trabalho foi enviado corretamente. Nos cabeçalhos de resposta, extraia o valor operation-location. A formatação ficará da seguinte maneira:
A {JOB-ID} é usada para identificar a solicitação, pois essa operação é assíncrona. Você pode usar essa URL para obter o status de implantação.
Obter status do trabalho de implantação
Use a solicitação GET a seguir para consultar o status do trabalho de implantação. Você pode usar a URL que obteve na etapa anterior ou substituir os valores de espaço reservado abaixo pelos seus próprios valores.
O nome do seu projeto. Esse valor diferencia maiúsculas de minúsculas.
myProject
{DEPLOYMENT-NAME}
O nome da sua implantação. Esse valor diferencia maiúsculas de minúsculas.
staging
{JOB-ID}
A ID para localização do status de treinamento do modelo. Isso está no valor de cabeçalho location que você obteve na etapa anterior.
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx
{API-VERSION}
A versão da API que você está chamando. O valor referenciado aqui é para a versão mais recente lançada. Saiba mais sobre as outras versões de API disponíveis
2022-05-01
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". Você deve obter um código 200 para indicar o sucesso da solicitação.
Você pode trocar implantações depois de testar um modelo atribuído a uma implantação caso deseje atribuí-lo a outra. A troca de implantações envolve usar o modelo atribuído à primeira implantação atribuindo-o à segunda implantação. Em seguida, use o modelo atribuído à segunda implantação e atribua-o à primeira implantação. Isso poderá ser usado para trocar suas implantações production e staging quando você quiser usar 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 um modelo. Selecione a implantação que você deseja excluir e clique em Excluir implantação no menu superior.
Crie uma solicitaçãoDELETE usando a URL, os cabeçalhos e o corpo JSON a seguir para excluir uma implantação.
O nome do seu projeto. Esse valor diferencia maiúsculas de minúsculas.
myProject
{DEPLOYMENT-NAME}
O nome a ser usado para a implantação. Esse valor diferencia maiúsculas de minúsculas.
prod
{API-VERSION}
A versão da API que você está chamando. O valor referenciado aqui é para a versão mais recente lançada. Saiba mais sobre as outras versões de API disponíveis
2022-05-01
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.
Depois de enviar a solicitação da API, você receberá uma resposta 202 indicando êxito, o que significa que a implantação foi excluída. Uma chamada bem-sucedida resulta em um cabeçalho Operation-Location usado para verificar o status do trabalho.
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.
A atribuição de recursos de implantação requer a 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 Microsoft Entra ao fazer chamadas à API REST, consulte a documentaçã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, como o 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, no 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 status mude para succeeded.
Ao cancelar a atribuição de um recurso de implantação ou removê-lo 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".
