Implantar um modelo

Depois de estar contente com o desempenho do modelo, ele estará pronto para ser implantado, e você poderá realizar consultas ao modelo para obter previsões a partir de expressõ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 um modelo treinado com sucesso
• Examine o desempenho do modelo para determinar como o seu modelo está se saindo.

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

Implantar modelo

Depois de examinar o desempenho do modelo e decidir que ele pode ser usado em seu ambiente, você precisará 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 nomeada production à qual você atribui o melhor modelo criado até agora e usá-lo 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.

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.

URL de Solicitação

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

headers

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

Corpo da solicitação

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

Depois de enviar sua solicitação de API, você receberá uma 202 resposta indicando êxito. Nos cabeçalhos de resposta, extraia o operation-location valor formatado da seguinte forma:

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

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.

URL de Solicitação

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

headers

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

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"
}

Trocar implantações

Depois de terminar de testar um modelo atribuído a uma implantação, convém 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.

Por exemplo, você pode trocar suas implantações production e staging quando quiser pegar o modelo atribuído a staging e atribuí-lo a production.

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 de Solicitação

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

headers

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

Corpo da solicitação

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

Depois de enviar sua solicitação de API, você receberá uma 202 resposta indicando êxito.

Excluir implantação

Crie uma solicitação DELETE usando a URL, os cabeçalhos e o corpo JSON a seguir para excluir uma implantação de compreensão da linguagem coloquial.

URL de Solicitação

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

headers

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

Depois de enviar sua solicitação de API, você receberá uma 202 resposta indicando êxito, o que significa que sua implantação é excluída.

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.

Atribuir recursos de implantação programaticamente requer autenticação do Microsoft Entra**. A ID do Microsoft Entra é usada para confirmar que você tem acesso aos recursos que está interessado em atribuir ao seu projeto para implantação de várias regiões. Para usar programaticamente a autenticação do Microsoft Entra ao fazer chamadas à API REST, consulte a documentação de autenticação do Foundry Tools.

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 de Solicitação

Use a URL a seguir ao criar sua solicitação de API. Substitua os valores do espaço reservado pelos seus.

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

headers

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}"
    }
  ]
}

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 do espaço reservado pelos seus.

URL de Solicitação

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

headers

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

Corpo da resposta

Depois de enviar a solicitação, você obtém a resposta a seguir. 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"
}

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 exclui todas as implantações implantadas na região do recurso.

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 de Solicitação

Use a URL a seguir ao criar sua solicitação de API. Substitua os valores do espaço reservado pelos seus.

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

headers

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

Corpo

Use o JSON de exemplo a seguir como seu corpo.

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

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 do espaço reservado pelos seus.

URL de Solicitação

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

headers

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

Corpo da resposta

Depois de enviar a solicitação, você obtém a resposta a seguir. 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

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