Quickstart: Criar um recurso de Serviços Cognitivos utilizando o Azure CLI

  • Artigo
  • 8 minutos para ler

Utilize este quickstart para criar um recurso de Serviços Cognitivos utilizando comandos Azure Command-Line Interface (CLI). Depois de criar o recurso, utilize as teclas e o ponto final gerados para autenticar as suas aplicações.

Azure Cognitive Services é um serviço baseado na nuvem com APIs REST, e SDKs de biblioteca de clientes disponíveis para ajudar os desenvolvedores a construir inteligência cognitiva em aplicações sem ter inteligência artificial direta (IA) ou habilidades ou conhecimentos de ciência de dados. O Azure Cognitive Services permite que os desenvolvedores adicionem facilmente funcionalidades cognitivas nas suas aplicações com soluções cognitivas que podem ver, ouvir, falar, entender e até começar a raciocinar.

Tipos de recursos de Serviços Cognitivos

Você pode aceder aos Serviços Cognitivos Azure através de dois recursos diferentes: um recurso multi-serviço, ou um único serviço.

  • Recurso multi-serviço:
    • Aceda a vários Serviços Cognitivos Azure com uma única chave e ponto final.
    • Consolida a faturação dos serviços que utiliza.
  • Recurso de serviço único:
    • Aceda a um único Serviço Cognitivo Azure com uma chave e ponto final únicos para cada serviço criado.
    • Utilize o nível gratuito para experimentar o serviço.

Pré-requisitos

  • Uma subscrição válida do Azure - Crie uma gratuitamente.
  • O Azure CLI
  • Uma função de Contribuidor dos Serviços Cognitivos tem de estar atribuída à conta do Azure para poder aceitar os termos da IA responsável e criar um recurso. Para obter esta função atribuída à sua conta, siga os passos na documentação das funções atribuir ou contacte o seu administrador.
  • Tem de criar os seus primeiros recursos Face, Language ou Computer Vision a partir do portal Azure para rever e reconhecer os termos e condições. Pode fazê-lo aqui: Rosto, serviço de idioma, Visão de Computador. Depois disso, pode criar recursos subsequentes utilizando qualquer ferramenta de implantação (SDK, CLI ou ARM, etc) sob a mesma assinatura Azure.

Instale o Azure CLI e inscreva-se

Instale o Azure CLI. Para iniciar sessão na instalação local do CLI, execute o comando de login az :

az login

Também pode utilizar o botão verde Try It para executar estes comandos no seu navegador.

Criar um novo grupo de recursos Azure Cognitive Services

Antes de criar um recurso de Serviços Cognitivos, deve ter um grupo de recursos Azure para conter o recurso. Quando cria um novo recurso, pode criar um novo grupo de recursos ou utilizar um existente. Este artigo mostra como criar um novo grupo de recursos.

Escolha a localização do seu grupo de recursos

Para criar um recurso, você precisará de uma das localizações Azure disponíveis para a sua subscrição. Pode recuperar uma lista de locais disponíveis com o comando de localizações da lista de conta AZ . A maioria dos Serviços Cognitivos pode ser acedida a partir de vários locais. Escolha o mais próximo de si, ou veja quais os locais disponíveis para o serviço.

Importante

  • Lembre-se da sua localização Azure, como vai precisar quando ligar para os Serviços Cognitivos Azure.
  • A disponibilidade de alguns Serviços Cognitivos pode variar por região. Para mais informações, consulte os produtos Azure por região.
az account list-locations \
    --query "[].{Region:name}" \
    --out table

Depois de ter a sua localização Azure, crie um novo grupo de recursos no CLI Azure utilizando o comando de criação do grupo AZ .

No exemplo abaixo, substitua a localização westus2 Azure por uma das localizações Azure disponíveis para a sua subscrição.

az group create \
    --name cognitive-services-resource-group \
    --location westus2

Criar um recurso dos Serviços Cognitivos

Escolha um nível de serviço cognitivo e preços

Ao criar um novo recurso, terá de conhecer o "tipo" de serviço que pretende utilizar, juntamente com o nível de preços (ou sku) que pretende. Usará esta e outras informações como parâmetros ao criar o recurso.

Você pode aceder aos Serviços Cognitivos Azure através de dois recursos diferentes: um recurso multi-serviço, ou um único serviço.

  • Recurso multi-serviço:
    • Aceda a vários Serviços Cognitivos Azure com uma única chave e ponto final.
    • Consolida a faturação dos serviços que utiliza.
  • Recurso de serviço único:
    • Aceda a um único Serviço Cognitivo Azure com uma chave e ponto final únicos para cada serviço criado.
    • Utilize o nível gratuito para experimentar o serviço.

Consulte a lista de SKUs e informações sobre preços abaixo.

Multi-serviço

Serviço Tipo
Vários serviços. Para mais informações, consulte a página de preços . CognitiveServices

Visão

Serviço Tipo
Imagem Digitalizada ComputerVision
Visão Personalizada - Previsão CustomVision.Prediction
Visão Personalizada - Formação CustomVision.Training
Rostos Face
Reconhecedor de Formato FormRecognizer

Voz

Serviço Tipo
Serviços de Voz SpeechServices

Linguagem

Serviço Tipo
LUIS LUIS
Criador de FAQ QnAMaker
Serviço de idiomas TextAnalytics
Tradução de Texto TextTranslation

Decisão

Serviço Tipo
Detetor de Anomalias AnomalyDetector
Content Moderator ContentModerator
Personalizador Personalizer

Níveis de preços e faturação

Os níveis de preços (e o valor que recebe faturado) baseiam-se no número de transações que envia usando as suas informações de autenticação. Cada nível de preços especifica:

  • número máximo de transações permitidas por segundo (TPS).
  • funcionalidades de serviço ativadas dentro do nível de preços.
  • custo para um número pré-refinado de transações. Ir acima deste número irá causar uma taxa extra, conforme especificado nos detalhes de preços do seu serviço.

Nota

Muitos dos Serviços Cognitivos têm um nível gratuito que pode usar para experimentar o serviço. Para utilizar o nível livre, utilize F0 como SKU para o seu recurso.

Pode encontrar uma lista de "tipos" disponíveis do Serviço Cognitivo com o comando de tipos de listas de tipos de conta az cognitiveservices :

az cognitiveservices account list-kinds

Adicione um novo recurso ao seu grupo de recursos

Para criar e subscrever um novo recurso de Serviços Cognitivos, use a conta az cognitiveservices criar comando. Este comando adiciona um novo recurso faturado ao grupo de recursos criado anteriormente. Ao criar o seu novo recurso, terá de conhecer o "tipo" de serviço que pretende utilizar, juntamente com o seu nível de preços (ou sku) e uma localização Azure:

Pode criar um recurso F0 (gratuito) para detetor de anomalias, nomeado anomaly-detector-resource com o comando abaixo.

az cognitiveservices account create \
    --name anomaly-detector-resource \
    --resource-group cognitive-services-resource-group \
    --kind AnomalyDetector \
    --sku F0 \
    --location westus2 \
    --yes

Dica

Se a sua subscrição não permitir criar um recurso de Serviço Cognitivo, poderá ter de ativar essa capacidade do fornecedor de recursos Azure com o portal Azure, o comando PowerShell ou um comando CLI Azure. Se não for o proprietário da subscrição, peça ao Proprietário da Assinatura ou a alguém com um papel de administrador que complete o registo por si ou peça os privilégios /registo/ação concedidos à sua conta.

Obtenha as chaves do seu recurso

Para iniciar sessão na instalação local do Command-Line Interface (CLI), utilize o comando de login az .

az login

Use o comando da lista de chaves de conta az cognitiveservices para obter as chaves do seu recurso de Serviço Cognitivo.

    az cognitiveservices account keys list \
    --name anomaly-detector-resource \
    --resource-group cognitive-services-resource-group

Configure uma variável ambiental para a autenticação

As aplicações precisam de autenticar o acesso aos Serviços Cognitivos que utilizam. Para autenticar, recomendamos a criação de uma variável ambiental para armazenar as chaves para os seus Recursos Azure.

Depois de ter a sua chave, escreva-a para uma nova variável de ambiente na máquina local que executa a aplicação. Para definir a variável de ambiente, abra uma janela da consola e siga as instruções relevantes para o seu sistema operativo. Substitua your-key por uma das teclas do seu recurso.

setx COGNITIVE_SERVICE_KEY "your-key"

Depois de adicionar a variável de ambiente, poderá ter de reiniciar todos os programas em execução que irão precisar de ler a variável de ambiente, incluindo a janela da consola. Por exemplo, se estiver a utilizar o Visual Studio como seu editor, reinicie o Visual Studio antes de executar o exemplo.

Níveis de preços e faturação

Os níveis de preços (e o valor que recebe faturado) baseiam-se no número de transações que envia usando as suas informações de autenticação. Cada nível de preços especifica:

  • número máximo de transações permitidas por segundo (TPS).
  • funcionalidades de serviço ativadas dentro do nível de preços.
  • O custo de um número predefinido de transações. Ir acima deste valor irá causar uma taxa extra, conforme especificado nos detalhes de preços do seu serviço.

Obtenha o uso atual da quota para o seu recurso

Utilize o comando de utilização da lista de serviços cognitivos az para obter o uso do seu recurso De Serviço Cognitivo.

az cognitiveservices account list-usage \
    --name anomaly-detector-resource \
    --resource-group cognitive-services-resource-group \
    --subscription subscription-name

Limpar os recursos

Se quiser limpar e remover um recurso de Serviços Cognitivos, pode eliminá-lo ou ao grupo de recursos. A eliminação do grupo de recursos também elimina quaisquer outros recursos contidos no grupo.

Para remover o grupo de recursos e os seus recursos associados, utilize o comando de eliminação do grupo AZ.

az group delete --name cognitive-services-resource-group

Se precisar de recuperar um recurso eliminado, consulte recuperar os recursos dos Serviços Cognitivos eliminados.

Ver também