Quando estiver satisfeito com o desempenho do modelo, ele estará pronto para ser implantado e usado para reconhecer entidades no texto. A implantação de um modelo o torna disponível para uso por meio da API de previsão.
Pré-requisitos
Confira o ciclo de vida de desenvolvimento de projetos para obter mais informações.
Implantar modelo
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. 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 produção à qual você atribui o melhor modelo criado até agora e utiliza-o em seu sistema. Você pode criar outra implantação chamada preparo à 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.
Para implantar o modelo por meio do Language Studio:
Selecione Implantar um modelo no menu à esquerda.
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 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
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.
{Endpoint}/language/authoring/analyze-text/projects/{projectName}/deployments/{deploymentName}?api-version={API-VERSION}
| Espaço reservado |
Valor |
Exemplo |
{ENDPOINT} |
O ponto de extremidade para autenticação de sua solicitação de API. |
https://<your-custom-subdomain>.cognitiveservices.azure.com |
{PROJECT-NAME} |
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. Consulte o Ciclo de vida do modelo para saber mais sobre outras versões de API disponíveis. |
2022-05-01 |
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:
{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/deployments/{DEPLOYMENT-NAME}/jobs/{JOB-ID}?api-version={API-VERSION}
{JOB-ID} é usado para identificar sua 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.
{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/deployments/{DEPLOYMENT-NAME}/jobs/{JOB-ID}?api-version={API-VERSION}
| Espaço reservado |
Valor |
Exemplo |
{ENDPOINT} |
O ponto de extremidade para autenticação de sua solicitação de API. |
https://<your-custom-subdomain>.cognitiveservices.azure.com |
{PROJECT-NAME} |
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. Consulte o Ciclo de vida do modelo para saber mais sobre outras versões de API disponíveis. |
2022-05-01 |
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.
{
"jobId":"{JOB-ID}",
"createdDateTime":"{CREATED-TIME}",
"lastUpdatedDateTime":"{UPDATED-TIME}",
"expirationDateTime":"{EXPIRATION-TIME}",
"status":"running"
}
Permutar implantações
Depois de você terminar de testar um modelo atribuído a uma implantação e se quiser atribuir esse modelo a outra implantação, você poderá trocar essas duas implantações. 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. Você poderá usar esse processo para trocar suas implantações de produção e preparo quando quiser usar o modelo atribuído à preparo e atribuí-lo à produção.
Para trocar implantações de dentro do Language Studio:
Na página Implantar um modelo, selecione as duas implantações que você deseja trocar e selecione Trocar implantações no menu superior.
Na janela que aparece, selecione os nomes das implantações que você deseja trocar.
Crie uma solicitaçãoPOST usando a URL, os cabeçalhos e o corpo JSON a seguir para iniciar um trabalho de troca de implantações.
URL da solicitação
{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/deployments/:swap?api-version={API-VERSION}
| Espaço reservado |
Valor |
Exemplo |
{ENDPOINT} |
O ponto de extremidade para autenticação de sua solicitação de API. |
https://<your-custom-subdomain>.cognitiveservices.azure.com |
{PROJECT-NAME} |
O nome do seu projeto. Esse valor diferencia maiúsculas de minúsculas. |
myProject |
{API-VERSION} |
A versão da API que você está chamando. O valor referenciado aqui é para a versão de modelo mais recente lançada. |
2022-05-01 |
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
{
"firstDeploymentName": "{FIRST-DEPLOYMENT-NAME}",
"secondDeploymentName": "{SECOND-DEPLOYMENT-NAME}"
}
| Chave |
Espaço reservado |
Valor |
Exemplo |
| firstDeploymentName |
{FIRST-DEPLOYMENT-NAME} |
O nome da sua primeira implantação. Esse valor diferencia maiúsculas de minúsculas. |
production |
| secondDeploymentName |
{SECOND-DEPLOYMENT-NAME} |
O nome da sua segunda implantação. Esse valor diferencia maiúsculas de minúsculas. |
staging |
Depois de enviar sua solicitação de API, você receberá uma 202 resposta indicando êxito.
Excluir implantação
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.
URL da solicitação
{Endpoint}/language/authoring/analyze-text/projects/{PROJECT-NAME}/deployments/{deploymentName}?api-version={API-VERSION}
| Espaço reservado |
Valor |
Exemplo |
{ENDPOINT} |
O ponto de extremidade para autenticação de sua solicitação de API. |
https://<your-custom-subdomain>.cognitiveservices.azure.com |
{PROJECT-NAME} |
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. Consulte o Ciclo de vida do modelo para saber mais sobre outras versões de API disponíveis. |
2022-05-01 |
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.
Atribuir recursos de implantação
Você pode implantar seu projeto em várias regiões atribuindo diferentes recursos de linguagem existentes em regiões diferentes.
Para atribuir recursos de implantação em outras regiões no Language Studio:
- Certifique-se de ter atribuído a si mesmo a função de Proprietário de Linguagem dos Serviços Cognitivos para o recurso usado para criar o projeto.
- 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.
{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/resources/:assign?api-version={API-VERSION}
| Espaço reservado |
Valor |
Exemplo |
{ENDPOINT} |
O ponto de extremidade para autenticação de sua solicitação de API. |
https://<your-custom-subdomain>.cognitiveservices.azure.com |
{PROJECT-NAME} |
O nome do seu projeto. Esse valor diferencia maiúsculas de minúsculas. |
myProject |
{API-VERSION} |
A versão da API que você está chamando. |
2022-10-01-preview |
Use autenticação do Microsoft Entra para autenticar essa API.
Corpo
Use o JSON de exemplo a seguir como seu corpo.
{
"resourcesMetadata": [
{
"azureResourceId": "{AZURE-RESOURCE-ID}",
"customDomain": "{CUSTOM-DOMAIN}",
"region": "{REGION-CODE}"
}
]
}
| Chave |
Espaço reservado |
Valor |
Exemplo |
azureResourceId |
{AZURE-RESOURCE-ID} |
O caminho completo da ID do recurso que você deseja atribuir. Encontrado no portal do Azure, na guia Propriedades do recurso, no campo ID do Recurso. |
/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/ContosoResourceGroup/providers/Microsoft.CognitiveServices/accounts/ContosoResource |
customDomain |
{CUSTOM-DOMAIN} |
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.
URL da solicitação
{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/resources/assign/jobs/{JOB-ID}?api-version={API-VERSION}
| Espaço reservado |
Valor |
Exemplo |
{ENDPOINT} |
O ponto de extremidade para autenticação de sua solicitação de API. |
https://<your-custom-subdomain>.cognitiveservices.azure.com |
{PROJECT-NAME} |
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 |
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.
{
"jobId":"{JOB-ID}",
"createdDateTime":"{CREATED-TIME}",
"lastUpdatedDateTime":"{UPDATED-TIME}",
"expirationDateTime":"{EXPIRATION-TIME}",
"status":"running"
}
Cancelar a atribuição de recursos de implantação
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.
{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/resources/:unassign?api-version={API-VERSION}
| Espaço reservado |
Valor |
Exemplo |
{ENDPOINT} |
O ponto de extremidade para autenticação de sua solicitação de API. |
https://<your-custom-subdomain>.cognitiveservices.azure.com |
{PROJECT-NAME} |
O nome do seu projeto. Esse valor diferencia maiúsculas de minúsculas. |
myProject |
{API-VERSION} |
A versão da API que você está chamando. |
2022-10-01-preview |
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
Use o JSON de exemplo a seguir como seu corpo.
{
"assignedResourceIds": [
"{AZURE-RESOURCE-ID}"
]
}
| Chave |
Espaço reservado |
Valor |
Exemplo |
assignedResourceIds |
{AZURE-RESOURCE-ID} |
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. |
/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/ContosoResourceGroup/providers/Microsoft.CognitiveServices/accounts/ContosoResource |
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.
URL da solicitação
{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/resources/unassign/jobs/{JOB-ID}?api-version={API-VERSION}
| Espaço reservado |
Valor |
Exemplo |
{ENDPOINT} |
O ponto de extremidade para autenticação de sua solicitação de API. |
https://<your-custom-subdomain>.cognitiveservices.azure.com |
{PROJECT-NAME} |
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 |
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".
{
"jobId":"{JOB-ID}",
"createdDateTime":"{CREATED-TIME}",
"lastUpdatedDateTime":"{UPDATED-TIME}",
"expirationDateTime":"{EXPIRATION-TIME}",
"status":"running"
}
Próximas etapas
Depois que você tiver uma implantação, poderá usá-la para extrair entidades do texto.
