Implementar um modelo

Quando estiver satisfeito com o desempenho do seu modelo, ele estará pronto para ser implantado e interrogue-o para obter previsões de declarações. A implantação de um modelo o torna disponível para uso por meio da API de previsão.

Pré-requisitos

• Um projeto criado
• Enunciados rotulados e modelo treinado com sucesso
• Revisei o desempenho do modelo para determinar como o seu modelo está a funcionar.

Para obter mais informações, consulteCiclo de vida de desenvolvimento do projeto.

Implementar o modelo

Depois de rever o desempenho do modelo e decidir que pode ser usado no seu ambiente, precisa de o atribuir a uma implementação para poder consultá-lo. A atribuição do modelo a uma implantação o torna disponível para uso por meio da API de previsão. Recomendamos criar uma implantação nomeada production à qual atribua o melhor modelo que tenha construído até agora e utilizá-lo no 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á-la. Você pode ter um máximo de 10 implantações em seu projeto.

Enviar tarefa de implantação

Crie uma solicitação PUT usando a seguinte URL, cabeçalhos e corpo JSON para começar a implantar um modelo de compreensão de linguagem conversacional.

URL do Pedido

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/deployments/{DEPLOYMENT-NAME}?api-version={API-VERSION}

Cabeçalhos

Use o cabeçalho a seguir para autenticar sua solicitação.

Corpo do Pedido

{
  "trainedModelLabel": "{MODEL-NAME}",
}

Depois de enviar o seu pedido de API, recebe uma 202 resposta a indicar sucesso. Nos cabeçalhos de resposta, extraia o valor operation-location formatado da seguinte forma:

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/deployments/{DEPLOYMENT-NAME}/jobs/{JOB-ID}?api-version={API-VERSION}

Você pode usar essa URL para obter o status do trabalho de implantação.

Obter o estado da tarefa de implementação

Quando se envia uma solicitação de implantação bem-sucedida, a URL completa da solicitação para verificar o estado da tarefa (incluindo o seu ponto de extremidade, o nome do projeto e o ID da tarefa) está contida no cabeçalho da operation-location resposta.

Use a seguinte solicitação GET para obter o status do seu trabalho de implantação. Substitua os valores de substituição por seus próprios valores.

URL do Pedido

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/deployments/{DEPLOYMENT-NAME}/jobs/{JOB-ID}?api-version={API-VERSION}

Cabeçalhos

Use o cabeçalho a seguir para autenticar sua solicitação.

Organismo de resposta

Depois de enviar a solicitação, você receberá a seguinte resposta. Continue a interrogar este ponto de extremidade até que o parâmetro de status mude para "concluído".

{
    "jobId":"{JOB-ID}",
    "createdDateTime":"{CREATED-TIME}",
    "lastUpdatedDateTime":"{UPDATED-TIME}",
    "expirationDateTime":"{EXPIRATION-TIME}",
    "status":"running"
}

Troca de implementações

Depois de concluir o teste de um modelo atribuído a uma implantação, convém atribuí-lo a outra implantação. A troca de implantações envolve:

• Tomar o modelo atribuído à primeira implantação e atribuí-lo à segunda implantação.
• pegar o modelo atribuído à segunda implantação e atribuí-lo à primeira implantação.

Por exemplo, pode trocar as suas production e staging quando quiser pegar no modelo atribuído a staging e atribuí-lo a production.

Crie uma solicitação POST usando a seguinte URL, cabeçalhos e corpo JSON para iniciar uma tarefa de troca de implementações.

URL do Pedido

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/deployments/:swap?api-version={API-VERSION}

Cabeçalhos

Use o cabeçalho a seguir para autenticar sua solicitação.

Corpo do Pedido

{
  "firstDeploymentName": "{FIRST-DEPLOYMENT-NAME}",
  "secondDeploymentName": "{SECOND-DEPLOYMENT-NAME}"
}

Depois de enviar o seu pedido de API, recebe uma 202 resposta a indicar sucesso.

Excluir implantação

Crie uma solicitação DELETE usando a seguinte URL, cabeçalhos e corpo JSON para excluir uma implantação de compreensão de linguagem conversacional.

URL do Pedido

{ENDPOINT}/language/authoring/analyze-conversations/projects/{projectName}/deployments/{deploymentName}?api-version={API-VERSION}

Cabeçalhos

Use o cabeçalho a seguir para autenticar sua solicitação.

Depois de enviar o seu pedido de API, recebe uma 202 resposta a indicar sucesso, o que significa que a sua implementação é eliminada.

Atribuir recursos de implantação

Você pode implantar seu projeto em várias regiões atribuindo diferentes recursos de idioma que existem em regiões diferentes.

A atribuição de recursos de implantação programaticamente requer autenticação do Microsoft Entra**. O Microsoft Entra ID é usado para confirmar que tem acesso aos recursos que pretende atribuir ao seu projeto para implementação multi-região. Para usar programáticamente a autenticação Microsoft Entra ao fazer chamadas REST API, consulte a documentação de autenticação do Foundry Tools.

Atribuir recurso

Envie uma solicitação POST usando a seguinte URL, cabeçalhos e corpo JSON para atribuir recursos de implantação.

URL do Pedido

Use a seguinte URL ao criar sua solicitação de API. Substitua os valores de substituição por seus próprios valores.

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/resources/:assign?api-version={API-VERSION}

Cabeçalhos

Use autenticação do Microsoft Entra para autenticar esta API.

Corpo

Use o exemplo JSON seguinte como o seu conteúdo.

{
  "resourcesMetadata": [
    {
      "azureResourceId": "{AZURE-RESOURCE-ID}",
      "customDomain": "{CUSTOM-DOMAIN}",
      "region": "{REGION-CODE}"
    }
  ]
}

Obter o status do recurso atribuído

Use a seguinte solicitação GET para obter o estado da sua tarefa de atribuição de recursos de implementação. Substitua os valores de substituição por seus próprios valores.

URL do Pedido

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/resources/assign/jobs/{JOB-ID}?api-version={API-VERSION}

Cabeçalhos

Use o cabeçalho a seguir para autenticar sua solicitação.

Organismo de resposta

Depois de enviar o pedido, recebe a seguinte resposta. Continue a interrogar este ponto de extremidade até que o parâmetro de status mude para "concluído".

{
    "jobId":"{JOB-ID}",
    "createdDateTime":"{CREATED-TIME}",
    "lastUpdatedDateTime":"{UPDATED-TIME}",
    "expirationDateTime":"{EXPIRATION-TIME}",
    "status":"running"
}

Cancelar a atribuição de recursos de implantação

Ao desatribuir ou remover um recurso de implementação de um projeto, também se apagam todas as implementações que são implementadas na região do recurso.

Cancelar atribuição de recurso

Envie uma solicitação POST usando a seguinte URL, cabeçalhos e corpo JSON para cancelar a atribuição ou remover recursos de implantação do seu projeto.

URL do Pedido

Use a seguinte URL ao criar sua solicitação de API. Substitua os valores de substituição por seus próprios valores.

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/resources/:unassign?api-version={API-VERSION}

Cabeçalhos

Use o cabeçalho a seguir para autenticar sua solicitação.

Corpo

Use o exemplo JSON seguinte como o seu conteúdo.

{
  "assignedResourceIds": [
    "{AZURE-RESOURCE-ID}"
  ]
}

Obter o status de recurso não atribuído

Use o seguinte pedido GET para obter o estado da sua tarefa de liberação de recursos de implantação. Substitua os valores de substituição por seus próprios valores.

URL do Pedido

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/resources/unassign/jobs/{JOB-ID}?api-version={API-VERSION}

Cabeçalhos

Use o cabeçalho a seguir para autenticar sua solicitação.

Organismo de resposta

Depois de enviar o pedido, recebe a seguinte resposta. Continue a interrogar este ponto de extremidade até que o parâmetro de status mude para "concluído".

{
    "jobId":"{JOB-ID}",
    "createdDateTime":"{CREATED-TIME}",
    "lastUpdatedDateTime":"{UPDATED-TIME}",
    "expirationDateTime":"{EXPIRATION-TIME}",
    "status":"running"
}

Próximos passos

• Use a API de previsão para consultar seu modelo