Como criar um projeto personalizado de Análise de Texto para Saúde

Use este artigo para saber como configurar os requisitos para começar com a análise de texto personalizada para integridade e criar um projeto.

Pré-requisitos

Antes de começar a usar a análise de texto personalizada para integridade, você precisa:

• Uma assinatura do Azure - Crie uma gratuitamente.

Criar um recurso de idioma

Antes de começar a usar a análise de texto personalizada para integridade, você precisará de um recurso da Linguagem de IA do Azure. É recomendável criar seu recurso de idioma e conectar uma conta de armazenamento a ele no portal do Azure. Criar um recurso no portal do Azure permite criar uma conta de armazenamento do Azure ao mesmo tempo, com todas as permissões necessárias pré-configuradas. Você também pode ler mais no artigo para saber como usar um recurso pré-existente e configurá-lo para trabalhar com análise de texto personalizada para integridade.

Você também precisará de uma conta de armazenamento do Azure onde carregará seus .txt documentos que serão usados para treinar um modelo para extrair entidades.

Nota

• Você precisa ter uma função de proprietário atribuída no grupo de recursos para criar um recurso de idioma.
• Se você conectar uma conta de armazenamento pré-existente, deverá ter uma função de proprietário atribuída a ela.

Criar recurso de idioma e conectar conta de armazenamento

Você pode criar um recurso das seguintes maneiras:

• O portal do Azure
• Estúdio de Idiomas
• PowerShell

Nota

Você não deve mover a conta de armazenamento para um grupo de recursos ou assinatura diferente depois que ela estiver vinculada ao recurso Idioma.

Criar um novo recurso a partir do portal do Azure

1. Vá para o portal do Azure para criar um novo recurso de linguagem de IA do Azure.

2. Na janela apresentada, selecione este serviço a partir das funcionalidades personalizadas. Selecione Continuar para criar seu recurso na parte inferior da tela.

   

3. Crie um recurso de idioma com os seguintes detalhes.

   Nome	Descrição
   Subscrição	A sua subscrição do Azure.
   Grupo de recursos	Um grupo de recursos que conterá seu recurso. Você pode usar um existente ou criar um novo.
   País/Região	A região do seu recurso Idioma. Por exemplo, "West US 2".
   Nome	Um nome para o seu recurso.
   Escalão de preço	A camada de preço para seu recurso de idioma. Você pode usar a camada Gratuito (F0) para experimentar o serviço.

   Nota

   Se você receber uma mensagem dizendo "sua conta de login não é proprietária do grupo de recursos da conta de armazenamento selecionada", sua conta precisará ter uma função de proprietário atribuída no grupo de recursos antes de poder criar um recurso de idioma. Entre em contato com o proprietário da assinatura do Azure para obter assistência.

4. Na seção deste serviço, selecione uma conta de armazenamento existente ou selecione Nova conta de armazenamento. Esses valores são para ajudá-lo a começar, e não necessariamente os valores da conta de armazenamento que você desejará usar em ambientes de produção. Para evitar latência durante a criação do projeto, conecte-se a contas de armazenamento na mesma região do recurso Idioma.

   Valor da conta de armazenamento	Valor recomendado
   Nome da conta de armazenamento	Qualquer nome
   Storage account type	LRS padrão

5. Certifique-se de que o Aviso de IA Responsável está verificado. Selecione Rever + criar na parte inferior da página e, em seguida, selecione Criar.

Criar um novo recurso de idioma a partir do Language Studio

Se for a primeira vez que inicia sessão, verá uma janela no Language Studio que lhe permitirá escolher um recurso de Idioma existente ou criar um novo. Também pode criar um recurso clicando no ícone de definições no canto superior direito, selecionando Recursos e, em seguida, clicando em Criar um novo recurso.

Crie um recurso de idioma com os seguintes detalhes.

Detalhe da instância	Valor obrigatório
Subscrição do Azure	a subscrição do Azure
Grupo de recursos do Azure	Seu grupo de recursos do Azure
Nome do recurso do Azure	Seu nome de recurso do Azure
Location	A região
Escalão de preço	A camada de preço do seu recurso de idioma.

Importante

• Certifique-se de habilitar a Identidade Gerenciada ao criar um recurso de Idioma.
• Leia e confirme o aviso de IA responsável

Para usar esse serviço, você precisará criar uma conta de armazenamento do Azure se ainda não tiver uma.

Criar um novo recurso de idioma usando o PowerShell

Você pode criar um novo recurso e uma conta de armazenamento usando os seguintes arquivos de modelo e parâmetros da CLI, que são hospedados no GitHub.

Edite os seguintes valores no arquivo de parâmetros:

Nome do parâmetro	Descrição do valor
name	Nome do recurso linguístico
location	Região na qual seu recurso está hospedado.
sku	A camada de preço do seu recurso.
storageResourceName	Nome da sua conta de armazenamento
storageLocation	Região em que sua conta de armazenamento está hospedada.
storageSkuType	SKU da sua conta de armazenamento.
storageResourceGroupName	Grupo de recursos da sua conta de armazenamento

Use o seguinte comando do PowerShell para implantar o modelo ARM (Azure Resource Manager) com os arquivos editados.

New-AzResourceGroupDeployment -Name ExampleDeployment -ResourceGroupName ExampleResourceGroup `
  -TemplateFile <path-to-arm-template> `
  -TemplateParameterFile <path-to-parameters-file>

Consulte a documentação do modelo ARM para obter informações sobre como implantar modelos e arquivos de parâmetros.

Nota

• O processo de conexão de uma conta de armazenamento ao seu recurso de idioma é irreversível, não pode ser desconectado mais tarde.
• Você só pode conectar seu recurso de idioma a uma conta de armazenamento.

Usando um recurso de idioma pré-existente

Você pode usar um recurso de idioma existente para começar a usar o NER personalizado, desde que esse recurso atenda aos requisitos abaixo:

Requisito	Description
Regiões	Verifique se o recurso existente está provisionado em uma das regiões suportadas. Caso contrário, você precisará criar um novo recurso em uma dessas regiões.
Escalão de preço	O nível de preço do seu recurso.
Identidade gerida	Verifique se a configuração de identidade gerenciada do recurso está habilitada. Caso contrário, leia a próxima seção.

Para usar a análise de texto personalizada para integridade, você precisará criar uma conta de armazenamento do Azure se ainda não tiver uma.

Habilite o gerenciamento de identidades para seu recurso

Portal do Azure

Seu recurso de idioma deve ter gerenciamento de identidade. Para habilitá-lo usando o portal do Azure:

1. Ir para o seu recurso linguístico
2. No menu à esquerda, na seção Gerenciamento de Recursos, selecione Identidade
3. Na guia Sistema atribuído, certifique-se de definir Status como Ativado

Estúdio de Idiomas

Seu recurso de idioma deve ter gerenciamento de identidade, para habilitá-lo usando o Language Studio:

1. Selecione o ícone de configurações no canto superior direito da tela
2. Selecionar Recursos
3. Marque a caixa de seleção Identidade Gerenciada para seu recurso de Linguagem do Azure AI.

Habilite a análise de texto personalizada para integridade

Certifique-se de habilitar a classificação de texto personalizada / Reconhecimento de entidade nomeada personalizada / Análise de texto personalizada para o recurso de integridade do portal do Azure.

1. Vá para seu recurso de idioma no portal do Azure.
2. No menu do lado esquerdo, na seção Gerenciamento de Recursos, selecione Recursos
3. Habilite o recurso Classificação de texto personalizada / Reconhecimento de entidade nomeada personalizada / Análise de texto personalizada
4. Conecte sua conta de armazenamento
5. Selecione Aplicar

Importante

• Verifique se o recurso de idioma tem a função de contribuidor de dados de blob de armazenamento atribuída na conta de armazenamento que você está conectando.

Adicionar funções necessárias

Use as etapas a seguir para definir as funções necessárias para sua conta de armazenamento e recurso de idioma.

Funções para seu recurso de linguagem de IA do Azure

1. Vá para sua conta de armazenamento ou recurso de idioma no portal do Azure.

2. Selecione Controle de acesso (IAM) no menu de navegação à esquerda.

3. Selecione Adicionar para Adicionar Atribuições de Função e escolha a função apropriada para sua conta.

   Você deve ter a função de proprietário ou colaborador atribuída em seu recurso de idioma.

4. Em Atribuir acesso a, selecione Usuário, grupo ou entidade de serviço

5. Selecionar membros

6. Selecione seu nome de usuário. Você pode pesquisar nomes de usuário no campo Selecionar . Repita isso para todas as funções.

7. Repita estas etapas para todas as contas de usuário que precisam acessar esse recurso.

Funções para sua conta de armazenamento

1. Aceda à página da sua conta de armazenamento no portal do Azure.
2. Selecione Controle de acesso (IAM) no menu de navegação à esquerda.
3. Selecione Adicionar para Adicionar Atribuições de Função e escolha a função de contribuidor de dados de blob de armazenamento na conta de armazenamento.
4. Em Atribuir acesso a, selecione Identidade gerenciada.
5. Selecionar membros
6. Selecione sua assinatura e Idioma como a identidade gerenciada. Você pode pesquisar nomes de usuário no campo Selecionar .

Importante

Se você tiver uma rede virtual ou ponto de extremidade privado, certifique-se de selecionar Permitir serviços do Azure na lista de serviços confiáveis para acessar essa conta de armazenamento no portal do Azure.

Ativar CORS para sua conta de armazenamento

Certifique-se de permitir métodos (GET, PUT, DELETE) ao habilitar o CORS (Cross-Origin Resource Sharing). Defina o campo origens permitidas como https://language.cognitive.azure.com. Permita todos os cabeçalhos adicionando * aos valores de cabeçalho permitidos e defina a idade máxima como 500.

Criar um projeto personalizado de Análise de Texto para integridade

Depois que o contêiner de recursos e armazenamento estiver configurado, crie um novo projeto de análise de texto personalizado para integridade. Um projeto é uma área de trabalho para construir seus modelos de IA personalizados com base em seus dados. Seu projeto só pode ser acessado por você e outras pessoas que têm acesso ao recurso do Azure que está sendo usado. Se você tiver rotulado dados, poderá usá-los para começar importando um projeto.

Estúdio de Idiomas

1. Entre no Language Studio. Será exibida uma janela para permitir que você selecione sua assinatura e recurso de idioma. Selecione o recurso de idioma que você criou na etapa acima.

2. Na seção Extrair informações do Language Studio, selecione Análise de texto personalizada para integridade.

3. Selecione Criar novo projeto no menu superior da página de projetos. Criar um projeto permite rotular dados, treinar, avaliar, melhorar e implantar seus modelos.

   

4. Insira as informações do projeto, incluindo um nome, uma descrição e o idioma dos arquivos em seu projeto. Se você estiver usando o conjunto de dados de exemplo, selecione Inglês. Não é possível alterar o nome do seu projeto mais tarde. Selecione Seguinte

   Gorjeta

   Seu conjunto de dados não precisa estar totalmente no mesmo idioma. Você pode ter vários documentos, cada um com diferentes idiomas suportados. Se o conjunto de dados contiver documentos de idiomas diferentes ou se você esperar texto de idiomas diferentes durante o tempo de execução, selecione a opção habilitar conjunto de dados multilíngue ao inserir as informações básicas para seu projeto. Esta opção pode ser ativada posteriormente na página Configurações do projeto.

5. Depois de selecionar Criar novo projeto, uma janela será exibida para permitir que você conecte sua conta de armazenamento. Se você já tiver conectado uma conta de armazenamento, verá o armazenamento contabilizado conectado. Caso contrário, escolha sua conta de armazenamento na lista suspensa exibida e selecione Conectar conta de armazenamento, isso definirá as funções necessárias para sua conta de armazenamento. Esta etapa possivelmente retornará um erro se você não estiver atribuído como proprietário na conta de armazenamento.

   Nota

   • Você só precisa fazer essa etapa uma vez para cada novo recurso usado.
   • Esse processo é irreversível, se você conectar uma conta de armazenamento ao seu recurso de idioma, não poderá desconectá-la mais tarde.
   • Você só pode conectar seu recurso de idioma a uma conta de armazenamento.

   

6. Selecione o contêiner onde você carregou seu conjunto de dados.

7. Se você já tiver rotulado dados, certifique-se de que eles seguem o formato suportado e selecione Sim, meus arquivos já estão rotulados e eu formatei o arquivo de rótulos JSON e selecione o arquivo de rótulos no menu suspenso. Selecione Seguinte. Se você estiver usando o conjunto de dados do Guia de início rápido, não há necessidade de revisar a formatação do arquivo de rótulos JSON.

8. Revise os dados inseridos e selecione Criar projeto.

APIs REST

Para começar a criar um modelo personalizado de Análise de Texto para integridade, você precisa criar um projeto. Criar um projeto permitirá que você rotule dados, treine, avalie, melhore e implante seus modelos.

Nota

O nome do projeto diferencia maiúsculas de minúsculas para todas as operações.

Crie uma solicitação PATCH usando a seguinte URL, cabeçalhos e corpo JSON para criar seu projeto.

URL do Pedido

Use a seguinte URL para criar um projeto. Substitua os valores de espaço reservado abaixo pelos seus próprios valores.

{Endpoint}/language/authoring/analyze-text/projects/{projectName}?api-version={API-VERSION}

Marcador de Posição	valor	Exemplo
{ENDPOINT}	O ponto de extremidade para autenticar 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 última versão lançada. Consulte Ciclo de vida do modelo para saber mais sobre outras versões de API disponíveis.	2022-05-01

Cabeçalhos

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

Key	valor
Ocp-Apim-Subscription-Key	A chave para o seu recurso. Usado para autenticar suas solicitações de API.

Corpo

Use o JSON a seguir em sua solicitação. Substitua os valores de espaço reservado abaixo pelos seus próprios valores.

{
  "projectName": "{PROJECT-NAME}",
  "language": "{LANGUAGE-CODE}",
  "projectKind": "CustomHealthcare",
  "description": "Project description",
  "multilingual": "True",
  "storageInputContainerName": "{CONTAINER-NAME}"
}

Chave	Marcador de Posição	valor	Exemplo
projectName	{PROJECT-NAME}	O nome do seu projeto. Esse valor diferencia maiúsculas de minúsculas.	myProject
idioma	{LANGUAGE-CODE}	Uma cadeia de caracteres especificando o código de idioma para os documentos usados em seu projeto. Se o seu projeto for multilingue, escolha o código linguístico da maioria dos documentos. Consulte o suporte a idiomas para saber mais sobre os códigos de idioma suportados.	en-us
projectKind	CustomHealthcare	O seu tipo de projeto.	CustomHealthcare
multilingue	true	Um valor booleano que permite que você tenha documentos em vários idiomas em seu conjunto de dados e, quando seu modelo é implantado, você pode consultar o modelo em qualquer idioma suportado (não necessariamente aqueles incluídos em seus documentos de treinamento). Consulte o suporte linguístico para saber mais sobre o suporte multilingue.	true
storageInputContainerName	{CONTAINER-NAME	O nome do contêiner de armazenamento do Azure onde você carregou seus documentos.	myContainer

Essa solicitação retornará uma resposta 201, o que significa que o projeto foi criado.

Esta solicitação retornará um erro se:

• O recurso selecionado não tem permissão adequada para a conta de armazenamento.

Importar projeto

Se você já tiver rotulado dados, poderá usá-los para começar a usar o serviço. Certifique-se de que os dados rotulados seguem os formatos de dados aceitos.

Estúdio de Idiomas

1. Entre no Language Studio. Será exibida uma janela para permitir que você selecione sua assinatura e recurso de idioma. Selecione o seu recurso Idioma.

2. Na seção Extrair informações do Language Studio, selecione Análise de texto personalizada para integridade.

3. Selecione Criar novo projeto no menu superior da página de projetos. Criar um projeto permitirá que você marque dados, treine, avalie, melhore e implante seus modelos.

4. Depois de selecionar Criar novo projeto, uma tela será exibida para permitir que você conecte sua conta de armazenamento. Se não conseguir encontrar a sua conta de armazenamento, certifique-se de que criou um recurso utilizando os passos recomendados. Se já tiver ligado uma conta de armazenamento ao seu recurso Idioma, verá a sua conta de armazenamento ligada.

   Nota

   • Você só precisa fazer essa etapa uma vez para cada novo recurso de idioma usado.
   • Esse processo é irreversível, se você conectar uma conta de armazenamento ao seu recurso de idioma, não poderá desconectá-la mais tarde.
   • Você só pode conectar seu recurso de idioma a uma conta de armazenamento.

   

5. Insira as informações do projeto, incluindo um nome, uma descrição e o idioma dos arquivos em seu projeto. Você não poderá alterar o nome do seu projeto mais tarde. Selecione Seguinte.

   Gorjeta

   Seu conjunto de dados não precisa estar totalmente no mesmo idioma. Você pode ter vários documentos, cada um com diferentes idiomas suportados. Se o conjunto de dados contiver documentos de idiomas diferentes ou se você esperar texto de idiomas diferentes durante o tempo de execução, selecione a opção habilitar conjunto de dados multilíngue ao inserir as informações básicas para seu projeto. Esta opção pode ser ativada posteriormente na página Configurações do projeto.

6. Selecione o contêiner onde você carregou seu conjunto de dados.

7. Selecione Sim, meus arquivos já estão rotulados e eu formatei o arquivo de rótulos JSON e selecione o arquivo de rótulos no menu suspenso abaixo para importar seu arquivo de rótulos JSON. Certifique-se de que segue o formato suportado.

8. Selecione Seguinte.

9. Revise os dados inseridos e selecione Criar projeto.

APIs REST

Envie uma solicitação POST usando a seguinte URL, cabeçalhos e corpo JSON para importar seu arquivo de etiquetas. Certifique-se de que o ficheiro de etiquetas segue o formato aceite.

Se já existir um projeto com o mesmo nome, os dados desse projeto serão substituídos.

{Endpoint}/language/authoring/analyze-text/projects/{projectName}/:import?api-version={API-VERSION}

Marcador de Posição	valor	Exemplo
{ENDPOINT}	O ponto de extremidade para autenticar 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 última versão lançada. Consulte Ciclo de vida do modelo para saber mais sobre outras versões de API disponíveis.	2022-05-01

Cabeçalhos

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

Key	valor
Ocp-Apim-Subscription-Key	A chave para o seu recurso. Usado para autenticar suas solicitações de API.

Corpo

Use o JSON a seguir em sua solicitação. Substitua os valores de espaço reservado abaixo pelos seus próprios valores.

{
	"projectFileVersion": "{API-VERSION}",
	"stringIndexType": "Utf16CodeUnit",
	"metadata": {
		"projectName": "{PROJECT-NAME}",
		"projectKind": "CustomHealthcare",
		"description": "Trying out custom Text Analytics for health",
		"language": "{LANGUAGE-CODE}",
		"multilingual": true,
		"storageInputContainerName": "{CONTAINER-NAME}",
		"settings": {}
	},
	"assets": {
		"projectKind": "CustomHealthcare",
		"entities": [
			{
				"category": "Entity1",
				"compositionSetting": "{COMPOSITION-SETTING}",
				"list": {
					"sublists": [
						{
							"listKey": "One",
							"synonyms": [
								{
									"language": "en",
									"values": [
										"EntityNumberOne",
										"FirstEntity"
									]
								}
							]
						}
					]
				}
			},
			{
				"category": "Entity2"
			},
			{
				"category": "MedicationName",
				"list": {
					"sublists": [
						{
							"listKey": "research drugs",
							"synonyms": [
								{
									"language": "en",
									"values": [
										"rdrug a",
										"rdrug b"
									]
								}
							]

						}
					]
				}
				"prebuilts": "MedicationName"
			}
		],
		"documents": [
			{
				"location": "{DOCUMENT-NAME}",
				"language": "{LANGUAGE-CODE}",
				"dataset": "{DATASET}",
				"entities": [
					{
						"regionOffset": 0,
						"regionLength": 500,
						"labels": [
							{
								"category": "Entity1",
								"offset": 25,
								"length": 10
							},
							{
								"category": "Entity2",
								"offset": 120,
								"length": 8
							}
						]
					}
				]
			},
			{
				"location": "{DOCUMENT-NAME}",
				"language": "{LANGUAGE-CODE}",
				"dataset": "{DATASET}",
				"entities": [
					{
						"regionOffset": 0,
						"regionLength": 100,
						"labels": [
							{
								"category": "Entity2",
								"offset": 20,
								"length": 5
							}
						]
					}
				]
			}
		]
	}
}

Chave	Marcador de Posição	valor	Exemplo
multilingual	true	Um valor booleano que permite que você tenha documentos em vários idiomas em seu conjunto de dados e, quando seu modelo é implantado, você pode consultar o modelo em qualquer idioma suportado (não necessariamente incluído em seus documentos de treinamento). Consulte o suporte linguístico para saber mais sobre o suporte multilingue.	true
projectName	{PROJECT-NAME}	Nome do projeto	myproject
storageInputContainerName	{CONTAINER-NAME}	Nome do contentor	mycontainer
entities		Matriz contendo todos os tipos de entidade que você tem no projeto. Estes são os tipos de entidade que serão extraídos dos seus documentos.
category		O nome do tipo de entidade, que pode ser definido pelo usuário para novas definições de entidade ou predefinido para entidades pré-criadas.
compositionSetting	{COMPOSITION-SETTING}	Regra que define como gerenciar vários componentes em sua entidade. As opções são combineComponents ou separateComponents.	combineComponents
list		Matriz que contém todas as sublistas que você tem no projeto para uma entidade específica. As listas podem ser adicionadas a entidades pré-criadas ou a novas entidades com componentes aprendidos.
sublists	[]	Matriz contendo sublistas. Cada sublista é uma chave e seus valores associados.	[]
listKey	One	Um valor normalizado para a lista de sinônimos a serem mapeados de volta na previsão.	One
synonyms	[]	Matriz contendo todos os sinónimos	sinónimo
language	{LANGUAGE-CODE}	Uma cadeia de caracteres que especifica o código de idioma para o sinônimo em sua sublista. Se o seu projeto for multilingue e pretender apoiar a sua lista de sinónimos para todas as línguas do projeto, tem de adicionar explicitamente os seus sinónimos a cada língua. Consulte Suporte a idiomas para obter mais informações sobre códigos de idiomas suportados.	en
values	"EntityNumberone", "FirstEntity"	Uma lista de cadeias de caracteres separadas por vírgulas que serão correspondidas exatamente para extração e mapeada para a chave de lista.	"EntityNumberone", "FirstEntity"
prebuilts	MedicationName	O nome do componente pré-construído que preenche a entidade pré-construída. As entidades pré-criadas são carregadas automaticamente em seu projeto por padrão, mas você pode estendê-las com componentes de lista em seu arquivo de etiquetas.	MedicationName
documents		Matriz contendo todos os documentos em seu projeto e lista das entidades rotuladas dentro de cada documento.	[]
location	{DOCUMENT-NAME}	A localização dos documentos no recipiente de armazenamento. Como todos os documentos estão na raiz do contêiner, este deve ser o nome do documento.	doc1.txt
dataset	{DATASET}	O conjunto de testes para o qual este arquivo irá quando dividido antes do treinamento. Os valores possíveis para este campo são Train e Test.	Train
regionOffset		A posição de caracteres inclusivos do início do texto.	0
regionLength		O comprimento da caixa delimitadora em termos de caracteres UTF16. A formação considera apenas os dados desta região.	500
category		O tipo de entidade associada à extensão de texto especificada.	Entity1
offset		A posição inicial do texto da entidade.	25
length		O comprimento da entidade em termos de caracteres UTF16.	20
language	{LANGUAGE-CODE}	Uma cadeia de caracteres especificando o código de idioma para o documento usado em seu projeto. Se o seu projeto for multilingue, escolha o código linguístico da maioria dos documentos. Consulte Suporte a idiomas para obter mais informações sobre códigos de idiomas suportados.	en

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. Será formatado da seguinte forma:

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

{JOB-ID} é utilizado para identificar o seu pedido, uma vez que esta operação é assíncrona. Você usará essa URL para obter o status do trabalho de importação.

Possíveis cenários de erro para esta solicitação:

• O recurso selecionado não tem permissões adequadas para a conta de armazenamento.
• O storageInputContainerName especificado não existe.
• Código de idioma inválido é usado, ou se o tipo de código de idioma não é string.
• multilingual value é uma cadeia de caracteres e não um booleano.

Obter detalhes do projeto

Estúdio de Idiomas

1. Vá para a página de configurações do projeto no Language Studio.

2. Você pode ver os detalhes do projeto.

3. Nesta página, você pode atualizar a descrição do projeto e ativar/desabilitar o conjunto de dados multilíngue nas configurações do projeto.

4. Você também pode exibir a conta de armazenamento conectada e o contêiner ao seu recurso de idioma.

5. Você também pode recuperar sua chave de recurso primária nesta página.

   

APIs REST

Use a seguinte solicitação GET para obter os detalhes do seu projeto. Substitua os valores de espaço reservado abaixo pelos seus próprios valores.

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

Marcador de Posição	valor	Exemplo
{ENDPOINT}	O ponto de extremidade para autenticar 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. Consulte Ciclo de vida do modelo para saber mais sobre outras versões de API disponíveis.	2022-05-01

Cabeçalhos

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

Key	valor
Ocp-Apim-Subscription-Key	A chave para o seu recurso. Usado para autenticar suas solicitações de API.

Corpo da resposta

    {
        "createdDateTime": "2021-10-19T23:24:41.572Z",
        "lastModifiedDateTime": "2021-10-19T23:24:41.572Z",
        "lastTrainedDateTime": "2021-10-19T23:24:41.572Z",
        "lastDeployedDateTime": "2021-10-19T23:24:41.572Z",
        "projectKind": "CustomHealthcare",
        "storageInputContainerName": "{CONTAINER-NAME}",
        "projectName": "{PROJECT-NAME}",
        "multilingual": false,
        "description": "Project description",
        "language": "{LANGUAGE-CODE}"
    }

Value	Marcador de Posição	Descrição	Exemplo
projectKind	CustomHealthcare	O seu tipo de projeto.	CustomHealthcare
storageInputContainerName	{CONTAINER-NAME}	O nome do contêiner de armazenamento do Azure onde você carregou seus documentos.	myContainer
projectName	{PROJECT-NAME}	O nome do seu projeto. Esse valor diferencia maiúsculas de minúsculas.	myProject
multilingual	true	Um valor booleano que permite que você tenha documentos em vários idiomas em seu conjunto de dados e, quando seu modelo é implantado, você pode consultar o modelo em qualquer idioma suportado (não necessariamente aqueles incluídos em seus documentos de treinamento). Para obter mais informações sobre suporte multilíngue, consulte Suporte a idiomas.	true
language	{LANGUAGE-CODE}	Uma cadeia de caracteres especificando o código de idioma para os documentos usados em seu projeto. Se o seu projeto for multilingue, escolha o código linguístico da maioria dos documentos.	en

Depois de enviar sua solicitação de API, você receberá uma resposta indicando o sucesso e o 200 corpo da resposta JSON com os detalhes do seu projeto.

Excluir projeto

Estúdio de Idiomas

Quando você não precisar mais do seu projeto, poderá excluí-lo usando o Language Studio.

1. Selecione o recurso Serviço de idioma que você está usando na parte superior da página, s
2. Selecione o projeto que deseja excluir
3. Selecione Eliminar no menu superior.

APIs REST

Quando você não precisar mais do seu projeto, poderá excluí-lo com a seguinte solicitação DELETE . Substitua os valores de espaço reservado por seus próprios valores.

{Endpoint}/language/authoring/analyze-text/projects/{projectName}?api-version={API-VERSION}

Marcador de Posição	valor	Exemplo
{ENDPOINT}	O ponto de extremidade para autenticar 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 última versão lançada. Consulte Ciclo de vida do modelo para saber mais sobre outras versões de API disponíveis.	2022-05-01

Cabeçalhos

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

Key	valor
Ocp-Apim-Subscription-Key	A chave para o seu recurso. Usado para autenticar suas solicitações de API.

Depois de enviar sua solicitação de API, você receberá uma 202 resposta indicando sucesso, o que significa que seu projeto foi excluído. Uma chamada bem-sucedida resulta com um cabeçalho Operation-Location usado para verificar o status do trabalho.

Próximos passos

• Você deve ter uma ideia do esquema de projeto que usará para rotular seus dados.

• Depois de definir seu esquema, você pode começar a rotular seus dados, que serão usados para treinamento de modelos, avaliação e, finalmente, fazer previsões.