Implantar um modelo e extrair entidades do texto usando a API de runtime

Depois que você 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

Um projeto criado com sucesso com uma conta de Armazenamento do Azure configurada.
Dados de texto carregados em sua conta de armazenamento.
Dados rotulados e um modelo treinado com sucesso
Revise os detalhes da avaliação do modelo para determinar o desempenho dele.

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. Atribuir o modelo a uma implantação disponibiliza-o para uso por meio da API de previsão. Recomendamos que você crie uma instância denominada produção para atribuir o melhor modelo que você criou até agora e usá-lo 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.

Microsoft Foundry
APIs REST

Para obter informações sobre como implantar seu modelo personalizado na Foundry, consulteImplantar seu modelo ajustado .

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

{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 é para a versão mais recente lançada. Para obter mais informações, consulteo ciclo de vida do modelo.	`2022-05-01`

headers

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 atribuído à sua 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 que o trabalho foi enviado corretamente. Nos cabeçalhos de resposta, extraia o operation-location valor formatado da seguinte forma:

{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 recebeu na etapa anterior ou substituir os valores do espaço reservado por 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. Ele está no valor do `location` cabeçalho que você recebeu na etapa anterior.	`xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx`
`{API-VERSION}`	A versão da API que você está chamando. O valor referenciado é para a versão mais recente lançada. Para obter mais informações, consulteo ciclo de vida do modelo.	`2022-05-01`

headers

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ê obtém a resposta a seguir. 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"
}

Trocar implantações

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

Fundição
APIs REST

Para substituir um modelo implantado, você pode trocar o modelo implantado por um modelo diferente na mesma região:

Selecione o nome do modelo em Nome e selecione Implantar modelo.
Selecione Modelo de Swap.

A redistribuição leva vários minutos para ser concluída. Enquanto isso, o modelo implantado continua disponível para uso com a API de Tradutor até que esse processo seja concluído.

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-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 é para a versão mais recente do modelo lançada.	`2022-05-01`

headers

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.

Se você não precisar mais do projeto, poderá excluí-lo da Foundry.

Navegue até a página inicial do Foundry. Inicie o processo de autenticação entrando, a menos que você já tenha concluído essa etapa e sua sessão esteja ativa.
Selecione o projeto que você deseja excluir do Keep building with Foundry
Selecione Centro de gerenciamento.
Selecione Excluir projeto.

Para excluir o hub junto com todos os seus projetos:

Navegue até a guia Visão Geral na seção Hub .
À direita, selecione Excluir hub.
O link abre o portal do Azure para você excluir o hub.

Crie uma solicitaçãoDELETE usando a URL, os cabeçalhos e o corpo JSON a seguir para excluir uma implantação.

URL de 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 é para a versão mais recente lançada. Para obter mais informações, consulteo ciclo de vida do modelo.	`2022-05-01`

headers

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 sua solicitação de API, você receberá uma 202 resposta indicando êxito, o que significa que sua implantação é 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.

Fundição
APIs REST

Para obter mais informações sobre como implantar seu modelo personalizado, consulteImplantar seu modelo ajustado

A atribuição de recursos de implantação requer a 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, saiba mais na documentaçã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-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`

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

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

URL de 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. Está no valor do 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`

headers

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ê obtém a resposta a seguir. 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

Para cancelar a atribuição ou remover um recurso de implantação de um projeto, você também deve excluir todas as implantações associadas à região desse recurso.

Fundição
APIs REST

Se você não precisar mais do projeto, poderá excluí-lo da Foundry.

Navegue até a página inicial do Foundry. Inicie o processo de autenticação entrando, a menos que você já tenha concluído essa etapa e sua sessão esteja ativa.
Selecione o projeto que você deseja excluir do Keep building with Foundry
Selecione Centro de gerenciamento.
Selecione Excluir projeto.

Para excluir o hub junto com todos os seus projetos:

Navegue até a guia Visão Geral na seção Hub .
À direita, selecione Excluir hub.
O link abre o portal do Azure para você excluir o hub.

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-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`

headers

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/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1/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 do espaço reservado pelos seus.

URL de 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. Está no valor do 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`

headers

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ê 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

Depois que você tiver uma implantação, poderá usá-la para extrair entidades do texto.

Comentários

Esta página foi útil?

Last updated on 2025-11-18

Compartilhar via

Implantar um modelo e extrair entidades do texto usando a API de runtime

Pré-requisitos

Implantar modelo

Trocar implantações

Excluir implantação

Atribuir recursos de implantação

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

Próximas etapas

Comentários

Recursos adicionais