Como criar um projeto de análise de sentimento personalizado
Use este artigo para saber como configurar os requisitos para começar com Análise de sentimento personalizada e criar um projeto.
Pré-requisitos
Antes de começar a usar a Análise de sentimento personalizada, você precisará:
- Uma assinatura do Azure - Crie uma gratuitamente.
Criar um recurso de idioma
Antes de começar a usar a Análise de sentimento personalizada, você precisará de um recurso de Linguagem 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 sentimento personalizada.
Você também precisa de uma conta de armazenamento do Azure onde carregará seus .txt
documentos que serão usados para treinar um modelo para classificar texto.
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
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
Vá para o portal do Azure para criar um novo recurso de linguagem de IA do Azure.
Na janela apresentada, selecione este serviço a partir das funcionalidades personalizadas. Selecione Continuar para criar seu recurso na parte inferior da tela.
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.
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 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
Requisito | Description |
---|---|
Regiões | Se você não tiver um recurso, precisará criar um novo em uma região suportada. |
Escalão de preço | nível de preço para o 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 esse serviço, você precisará criar uma conta de armazenamento do Azure se ainda não tiver uma.
Habilite o gerenciamento de identidades para seu recurso
Seu recurso de idioma deve ter gerenciamento de identidade, para habilitá-lo usando o portal do Azure:
- Ir para o seu recurso linguístico
- No menu à esquerda, na seção Gerenciamento de Recursos, selecione Identidade
- Na guia Sistema atribuído, certifique-se de definir Status como Ativado
Habilite o recurso personalizado para seu recurso
Certifique-se de habilitar o recurso personalizado deste serviço no portal do Azure.
- Vá para o seu recurso de idioma no portal do Azure
- No menu do lado esquerdo, na seção Gerenciamento de Recursos, selecione Recursos
- Ativar o recurso personalizado deste serviço
- Conecte sua conta de armazenamento
- 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.
Definir funções para sua conta de armazenamento e recurso de idioma do Azure AI
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
Vá para sua conta de armazenamento ou recurso de idioma no portal do Azure.
Selecione Controle de acesso (IAM) no menu de navegação à esquerda.
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.
Em Atribuir acesso a, selecione Usuário, grupo ou entidade de serviço
Selecionar membros
Selecione seu nome de usuário. Você pode pesquisar nomes de usuário no campo Selecionar . Repita isso para todas as funções.
Repita estas etapas para todas as contas de usuário que precisam acessar esse recurso.
Funções para sua conta de armazenamento
- Aceda à página da sua conta de armazenamento no portal do Azure.
- Selecione Controle de acesso (IAM) no menu de navegação à esquerda.
- 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.
- Em Atribuir acesso a, selecione Identidade gerenciada.
- Selecionar membros
- 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 de análise de sentimento personalizado
Depois que o contêiner de recursos e armazenamento estiver configurado, crie um novo projeto de análise de sentimento personalizado. 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 dados rotulados, poderá importá-los para começar.
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.
Selecione o recurso que você deseja usar no Language Studio.
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.
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.
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.
Selecione o contêiner onde você carregou seu conjunto de dados.
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.
Revise os dados inseridos e selecione Criar projeto.
Importar um projeto de análise de sentimento personalizado
Entre no Language Studio. Será exibida uma janela para permitir que você selecione sua assinatura e recurso de idioma. Selecione o seu recurso Idioma.
Selecione o recurso que deseja usar.
Selecione Criar novo projeto no menu superior da página de projetos. Criar um projeto permitirá que você rotule dados, treine, avalie, melhore e implante seus modelos.
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.
Insira as informações do projeto, incluindo um nome, uma descrição e o idioma dos documentos 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.
Selecione o contêiner onde você carregou seu conjunto de dados.
Selecione Sim, meus documentos já estão rotulados e eu formatei o arquivo de etiquetas JSON e selecione o arquivo de etiquetas no menu suspenso abaixo para importar seu arquivo de etiquetas JSON.
Selecione Seguinte.
Revise os dados inseridos e selecione Criar projeto.
Obter detalhes do projeto
Vá para a página de configurações do projeto no Language Studio.
Você pode ver os detalhes do projeto.
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.
Você também pode exibir a conta de armazenamento conectada e o contêiner ao seu recurso de idioma.
Você também pode recuperar sua chave primária de recurso nesta página.
Excluir projeto
Quando você não precisar mais do seu projeto, poderá excluí-lo usando o Language Studio. Selecione a funcionalidade que está a utilizar na parte superior e, em seguida, selecione o projeto que pretende eliminar. Selecione Excluir no menu superior para excluir o projeto.