Início Rápido: Criar um recurso dos Serviços Cognitivos com a CLI do Azure

  • Artigo

Utilize este início rápido para criar um recurso dos Serviços Cognitivos com comandos da Interface de Command-Line (CLI) do Azure . Depois de criar o recurso, utilize as chaves e o ponto final gerados para autenticar as suas aplicações.

Os Serviços Cognitivos do Azure são serviços de inteligência artificial (IA) baseados na cloud que ajudam os programadores a criar inteligência cognitiva em aplicações sem terem conhecimentos ou competências de IA ou ciência de dados diretas. Estão disponíveis através de APIs REST e SDKs de biblioteca de cliente em linguagens de desenvolvimento populares. Os Serviços Cognitivos do Azure permitem aos programadores adicionar facilmente funcionalidades cognitivas às suas aplicações com soluções cognitivas que podem ver, ouvir, falar e analisar.

Tipos de recursos dos Serviços Cognitivos

Pode aceder aos Serviços Cognitivos do Azure através de dois recursos diferentes: um recurso multiserviço ou um serviço único.

  • Recurso multi-serviço:
    • Aceda a vários Serviços Cognitivos do 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 do Azure com uma chave e um ponto final exclusivos para cada serviço criado.
    • Utilize o escalão gratuito para experimentar o serviço.

Pré-requisitos

  • Uma subscrição válida do Azure – crie uma gratuitamente.
  • CLI do Azure
  • 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 atribuir esta função à sua conta, siga os passos na documentação Atribuir funções ou contacte o administrador.
  • Tem de criar os seus primeiros recursos Face, Idioma ou Imagem Digitalizada a partir do portal do Azure para rever e reconhecer os termos e condições. Pode fazê-lo aqui: Face, Serviço de idiomas, Imagem Digitalizada. Depois disso, pode criar recursos subsequentes com qualquer ferramenta de implementação (SDK, CLI ou modelo arm, etc.) na mesma subscrição do Azure.

Instalar a CLI do Azure e iniciar sessão

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

az login

Também pode utilizar o botão verde Experimentar para executar estes comandos no browser.

Criar um novo grupo de recursos dos Serviços Cognitivos do Azure

Antes de criar um recurso dos Serviços Cognitivos, tem de ter um grupo de recursos do 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.

Escolher a localização do grupo de recursos

Para criar um recurso, precisará de uma das localizações do Azure disponíveis para a sua subscrição. Pode obter uma lista de localizações disponíveis com o comando az account list-locations . A maioria dos Serviços Cognitivos pode ser acedida a partir de várias localizações. Escolha o mais próximo de si ou veja que localizações estão disponíveis para o serviço.

Importante

  • Lembre-se da sua localização do Azure, pois irá precisar dela ao chamar os recursos dos Serviços Cognitivos do Azure.
  • A disponibilidade de alguns Serviços Cognitivos pode variar consoante a região. Para obter mais informações, veja Produtos do Azure por região.
az account list-locations --query "[].{Region:name}" --out table

Depois de ter a localização do Azure, crie um novo grupo de recursos na CLI do Azure com o comando az group create . No exemplo abaixo, substitua a localização westus2 do Azure por uma das localizações do 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

Escolher um serviço e um escalão de preço

Quando criar um novo recurso, terá de saber o tipo de serviço que pretende utilizar, juntamente com o escalão de preço (ou SKU) que pretende. Irá utilizar esta e outras informações como parâmetros quando criar o recurso.

Pode aceder aos Serviços Cognitivos do Azure através de dois recursos diferentes: um recurso multiserviço ou um serviço único.

  • Recurso multi-serviço:
    • Aceda a vários Serviços Cognitivos do 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 do Azure com uma chave e um ponto final exclusivos para cada serviço criado.
    • Utilize o escalão gratuito para experimentar o serviço.

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

Multi-serviço

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

Visão

Serviço Tipo
Imagem Digitalizada ComputerVision
Visão Personalizada - Prediçã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 idioma TextAnalytics
Tradução de Texto TextTranslation

Decisão

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

Azure OpenAI

Serviço Tipo
Azure OpenAI OpenAI

Escalões de preço e faturação

Os escalões de preço (e o montante que é faturado) baseiam-se no número de transações que envia com as suas informações de autenticação. Cada escalão de preço especifica o seguinte:

  • número máximo de transações permitidas por segundo (TPS).
  • funcionalidades de serviço ativadas no escalão de preço.
  • custo de um número predefinido de transações. Ultrapassar este número causará um custo adicional, conforme especificado nos detalhes de preços do seu serviço.

Nota

Muitos dos Serviços Cognitivos têm um escalão gratuito que pode utilizar para experimentar o serviço. Para utilizar o escalão gratuito, utilize F0 como SKU para o recurso.

Pode encontrar uma lista de "tipos" do Serviço Cognitivo disponíveis com o comando az cognitiveservices account list-kinds :

az cognitiveservices account list-kinds

Adicionar um novo recurso ao grupo de recursos

Para criar e subscrever um novo recurso dos Serviços Cognitivos, utilize o comando az cognitiveservices account create . Este comando adiciona um novo recurso faturável ao grupo de recursos que criou anteriormente. Quando criar o seu novo recurso, terá de saber o "tipo" de serviço que pretende utilizar, juntamente com o respetivo escalão de preço (ou SKU) e uma localização do Azure:

Pode criar um recurso F0 (gratuito) para Detetor de Anomalias, com o nome 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 lhe permitir criar um recurso do Serviço Cognitivo, poderá ter de ativar o privilégio desse fornecedor de recursos do Azure com o portal do Azure, o comando do PowerShell ou um comando da CLI do Azure. Se não for o proprietário da subscrição, peça ao Proprietário da Subscrição ou a alguém com uma função de administrador para concluir o registo por si ou peça que os privilégios /register/action sejam concedidos à sua conta.

Obter as chaves do recurso

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

az login

Utilize o comando az cognitiveservices account keys list para obter as chaves do recurso do Serviço Cognitivo.

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

Configurar uma variável de ambiente para autenticação

A sua aplicação tem de ser autenticada para aceder aos recursos dos Serviços Cognitivos. Para produção, utilize uma forma segura de armazenar e aceder às suas credenciais. Por exemplo, depois de ter uma chave para o recurso, escreva-a numa nova variável de ambiente no computador local que executa a aplicação.

Dica

Não inclua a chave diretamente no seu código e nunca a publique publicamente. Veja o artigo de segurança dos Serviços Cognitivos para obter mais opções de autenticação, como o Azure Key Vault.

Para definir a variável de ambiente para a chave de recurso, abra uma janela da consola e siga as instruções para o seu sistema operativo e ambiente de desenvolvimento. Para definir a variável de COGNITIVE_SERVICE_KEY ambiente, substitua your-key por uma das chaves do recurso.

setx COGNITIVE_SERVICE_KEY your-key

Nota

Se apenas precisar de aceder à variável de ambiente na consola de execução atual, pode definir a variável de ambiente com set em vez de setx.

Depois de adicionar a variável de ambiente, poderá ter de reiniciar quaisquer consolas em execução ou outros programas que precisem de ler a variável de ambiente. Por exemplo, se estiver a utilizar o Visual Studio como editor, reinicie o Visual Studio antes de executar o exemplo.

Para definir a variável de ambiente para a região de recursos de Voz, siga os mesmos passos. Defina COGNITIVE_SERVICE_REGION para a região do recurso. Por exemplo, westus.

Escalões de preço e faturação

Os escalões de preço (e o montante que é faturado) baseiam-se no número de transações que envia com as suas informações de autenticação. Cada escalão de preço especifica o seguinte:

  • número máximo de transações permitidas por segundo (TPS).
  • funcionalidades de serviço ativadas no escalão de preço.
  • O custo de um número predefinido de transações. Ultrapassar este montante causará um custo adicional, conforme especificado nos detalhes de preços do seu serviço.

Obter a utilização de quota atual para o recurso

Utilize o comando az cognitiveservices account list-usage para obter a utilização do recurso do 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 dos Serviços Cognitivos, pode eliminá-lo ou ao grupo de recursos. Eliminar o grupo de recursos também elimina quaisquer outros recursos contidos no grupo.

Para remover o grupo de recursos e os respetivos recursos associados, utilize o comando az group delete.

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

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

Ver também