Guia de início rápido: criar um recurso multisserviço para serviços de IA do Azure

  • Artigo

Saiba como criar e gerenciar um recurso multisserviço para serviços de IA do Azure. Um recurso multisserviço permite que você acesse vários serviços de IA do Azure com uma única chave e ponto de extremidade. Também consolida a faturação dos serviços que utiliza.

Você pode acessar os serviços de IA do Azure por meio de dois recursos diferentes: um recurso multisserviço ou um recurso de serviço único.

  • Recurso multisserviço:
    • Acesse vários serviços de IA do Azure com uma única chave e ponto de extremidade.
    • Consolida a faturação dos serviços que utiliza.
  • Recurso de serviço único:
    • Acesse um único serviço de IA do Azure com uma chave e um ponto de extremidade exclusivos para cada serviço criado.
    • A maioria dos serviços de IA do Azure oferece uma camada gratuita para experimentá-lo.

Os serviços de IA do Azure são recursos do Azure que você cria em sua assinatura do Azure. Depois de criar um recurso, você pode usar as chaves e o ponto de extremidade gerados para autenticar seus aplicativos.

Serviços suportados com um recurso multisserviço

O recurso multisserviço permite o acesso aos seguintes serviços de IA do Azure com uma única chave e ponto de extremidade. Use estes links para encontrar artigos de início rápido, exemplos e muito mais para começar a usar seu recurso.

Serviço Description
Ícone do Moderador de ConteúdoModerador de conteúdo (desativado) Detete conteúdo potencialmente ofensivo ou indesejável.
Ícone Visão PersonalizadaVisão Personalizada Personalize o reconhecimento de imagens para o seu negócio.
Ícone do Document IntelligenceInteligência Documental Transforme documentos em soluções inteligentes orientadas por dados.
Ícone de rostoFace Detete e identifique pessoas e emoções em imagens.
Ícone de idiomaIdioma Crie aplicativos com recursos de compreensão de linguagem natural líderes do setor.
Ícone de vozVoz Conversão de fala em texto, de texto em fala, tradução e reconhecimento de oradores.
Ícone do tradutorTranslator Use a tecnologia de tradução baseada em IA para traduzir mais de 100 idiomas e dialetos em uso, em risco e ameaçados de extinção.
Ícone VisãoVisão Analise conteúdo em imagens e vídeos.

Pré-requisitos

  • Uma assinatura válida do Azure - Crie uma gratuitamente.
  • Sua conta do Azure deve ter uma Cognitive Services Contributor função atribuída para que você concorde com os termos de IA responsável e crie um recurso. Para atribuir essa função à sua conta, siga as etapas na documentação Atribuir funções ou entre em contato com o administrador.

Criar um novo recurso multisserviço

O recurso multisserviço está listado em Azure AI services>Azure AI services multi-service account no portal. Para criar um recurso multisserviço, siga estas instruções:

  1. Selecione este link para criar um recurso multisserviço: https://portal.azure.com/#create/Microsoft.CognitiveServicesAllInOne

  2. Na página Criar, forneça as seguintes informações:

    Detalhes do projeto Description
    Subscrição Selecione uma das suas subscrições do Azure disponíveis.
    Grupo de recursos O grupo de recursos do Azure que conterá seu recurso de serviços de IA do Azure. Você pode criar um novo grupo ou adicioná-lo a um grupo pré-existente.
    Região O local da sua instância de serviço de IA do Azure. Locais diferentes podem introduzir latência, mas não têm impacto na disponibilidade de tempo de execução do seu recurso.
    Nome Um nome descritivo para seu recurso de serviços de IA do Azure. Por exemplo, MyCognitiveServicesResource.
    Escalão de preço O custo da sua conta de serviços de IA do Azure depende das opções que escolher e da sua utilização. Para obter mais informações, consulte os detalhes de preços da API.

    Tela de criação de recursos multisserviço

  3. Configure outras definições para o seu recurso conforme necessário, leia e aceite as condições (conforme aplicável) e, em seguida, selecione Rever + criar.

Gorjeta

Se sua assinatura não permitir que você crie um recurso de serviços de IA do Azure, talvez seja necessário habilitar o privilégio desse provedor de recursos do Azure usando 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 a função de administrador para concluir o registo por si ou peça que sejam concedidos à conta os privilégios de /registo/ação.

Obtenha as chaves para o seu recurso

  1. Depois que o recurso for implantado com êxito, selecione Próximas etapas>Ir para o recurso.

    Ecrã Obter chaves de recursos

  2. No painel de início rápido que se abre, você pode acessar o ponto de extremidade do recurso e gerenciar chaves.

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

Seu aplicativo deve ser autenticado para acessar os recursos de serviços de IA do Azure. Para definir a variável de ambiente para sua chave de recurso, abra uma janela do console e siga as instruções para seu sistema operacional e ambiente de desenvolvimento. Para definir a COGNITIVE_SERVICE_KEY variável de ambiente, substitua your-key por uma das chaves do seu recurso.

Para produção, use uma maneira segura de armazenar e acessar suas credenciais, como um cofre secreto protegido por senha. Para teste, gravar em uma variável de ambiente é uma prática padrão, mas lembre-se de que as variáveis de ambiente são armazenadas em texto não criptografado na máquina local.

Gorjeta

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

O PowerShell inclui uma solução extensível, o Gerenciamento Secreto, para armazenar cadeias de caracteres seguras em plataformas como o Repositório Secreto ou o Azure KeyVault.

Para configurar um repositório secreto para hospedar cadeias de caracteres seguras, consulte o artigo Introdução ao uso do armazenamento secreto. Em seguida, use os exemplos a seguir para armazenar suas chaves de api.

Set-Secret -Name COGNITIVE_SERVICE_KEY -value your-key

Para ambientes de teste, você pode usar a sintaxe do PowerShell para definir uma variável de $Env: ambiente apenas para a sessão atual ou o setx comando para reter a variável entre sessões. Lembre-se de que esses valores são armazenados em texto não criptografado nas chaves do Registro do Windows.

$Env:COGNITIVE_SERVICE_KEY = your-key

setx COGNITIVE_SERVICE_KEY your-key

Depois de adicionar a variável de ambiente usando setxo , talvez seja necessário reiniciar todos os consoles em execução ou outros programas que precisarão ler a variável de ambiente. Por exemplo, se você estiver usando o Visual Studio como editor, reinicie o Visual Studio antes de executar o exemplo.

Para definir a variável de ambiente para sua região de recurso de fala, siga as mesmas etapas. Defina COGNITIVE_SERVICE_REGION para a região do seu recurso. Por exemplo, westus.

Clean up resources (Limpar recursos)

Se quiser limpar e remover uma assinatura de serviços do Azure AI, você pode excluir o recurso ou grupo de recursos. A exclusão do grupo de recursos também exclui quaisquer outros recursos contidos no grupo.

  1. No portal do Azure, expanda o menu no lado esquerdo para abrir o menu de serviços e escolha Grupos de Recursos, para apresentar a lista dos seus grupos de recursos.
  2. Localize o grupo de recursos que contém o recurso a ser excluído.
  3. Se quiser excluir todo o grupo de recursos, selecione o nome do grupo de recursos. Na página seguinte, selecione Excluir grupo de recursos e confirme.
  4. Se você quiser excluir apenas o recurso de serviços de IA do Azure, selecione o grupo de recursos para ver todos os recursos dentro dele. Na página seguinte, selecione o recurso que deseja excluir, selecione o menu de reticências dessa linha e selecione Excluir.

Use este início rápido para criar um recurso de serviços de IA do Azure usando comandos da CLI (Interface de Linha de Comando) do Azure. Depois de criar o recurso, use as chaves e o ponto de extremidade gerados para autenticar seus aplicativos.

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

Pré-requisitos

  • Uma assinatura válida do Azure - Crie uma gratuitamente.
  • A CLI do Azure
  • Sua conta do Azure deve ter uma Cognitive Services Contributor função atribuída para que você concorde com os termos de IA responsável e crie um recurso. Para atribuir essa função à sua conta, siga as etapas na documentação Atribuir funções ou entre em contato com o administrador.
  • Se estiver a planear utilizar a Análise Espacial na Visão de IA do Azure ou a Análise de Texto para Saúde na Linguagem de IA do Azure, tem de criar os seus primeiros recursos de Visão ou Linguagem a partir do portal do Azure para poder rever e reconhecer os termos e condições. Pode fazê-lo aqui: Azure AI Language, Azure AI Vision. Depois disso, você pode criar recursos subsequentes usando qualquer ferramenta de implantação (por exemplo, SDK, CLI ou modelo ARM) sob a mesma assinatura do Azure.

Instalar a CLI do Azure e entrar

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

az login

Você também pode usar o botão verde Try It para executar esses comandos em seu navegador.

Criar um novo grupo de recursos de serviços de IA do Azure

Antes de criar um recurso de serviços de IA do Azure, você deve ter um grupo de recursos do Azure para conter o recurso. Ao criar um novo recurso, você pode criar um novo grupo de recursos ou usar 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 um dos locais do Azure disponíveis para sua assinatura. Você pode recuperar uma lista de locais disponíveis com o comando az account list-locations . A maioria dos serviços de IA do Azure pode ser acessada de vários locais. Escolha o mais próximo de você ou veja quais locais estão disponíveis para o serviço.

Importante

  • Lembre-se de seu local do Azure, pois você precisará dele ao chamar os recursos de serviços de IA do Azure.
  • A disponibilidade de alguns serviços de IA do Azure pode variar de acordo com a região. Para obter mais informações, consulte Produtos do Azure por região.
az account list-locations --query "[].{Region:name}" --out table

Depois de ter seu local do Azure, crie um novo grupo de recursos na CLI do Azure usando o comando az group create . No exemplo abaixo, substitua o local westus2 do Azure por um dos locais do Azure disponíveis para sua assinatura.

az group create --name ai-services-resource-group --location westus2

Criar um recurso de serviços de IA do Azure

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

Ao criar um novo recurso, você precisará saber o tipo de serviço que deseja usar, juntamente com a camada de preço (ou SKU) desejada. Você usará essas e outras informações como parâmetros ao criar o recurso.

As tabelas a seguir fornecem informações sobre produtos e preços para serviços de IA do Azure.

Multi-serviço

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

Visão

Serviço Variante
Visão ComputerVision
Visão Personalizada - Previsão CustomVision.Prediction
Visão Personalizada - Formação CustomVision.Training
Face Face
Inteligência Documental FormRecognizer

Voz

Serviço Variante
Voz SpeechServices

Linguagem

Serviço Variante
Compreensão de Idiomas (LUIS) LUIS
Criador de FAQ QnAMaker
Linguagem TextAnalytics
Tradução de Texto TextTranslation

Decisão

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

Azure OpenAI

Serviço Variante
Azure OpenAI OpenAI

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

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

  • Número máximo de transações permitidas por segundo (TPS).
  • Recursos de serviço habilitados dentro do nível de preço.
  • Custo para um número predefinido de transações. Ultrapassar este número implicará um custo adicional, conforme especificado nos detalhes do preço do seu serviço.

Nota

Muitos dos serviços de IA do Azure têm uma camada gratuita que você pode usar para experimentar o serviço. Para usar o nível gratuito, use F0 como o nível de preço para seu recurso.

Você pode encontrar uma lista de "tipos" de serviços de IA do Azure disponíveis com o comando az cognitiveservices account list-types :

az cognitiveservices account list-kinds

Adicionar um novo recurso ao seu grupo de recursos

Para criar e assinar um novo recurso de serviços de IA do Azure, use o comando az cognitiveservices account create . Este comando adiciona um novo recurso faturável ao grupo de recursos criado anteriormente. Ao criar seu novo recurso, você precisará saber o "tipo" de serviço que deseja usar, juntamente com sua camada de preço (ou SKU) e um local do Azure:

Você pode criar um recurso multisserviço Standard S0 nomeado multi-service-resource com o comando abaixo.

az cognitiveservices account create --name multi-service-resource --resource-group ai-services-resource-group  --kind CognitiveServices --sku F0 --location westus2 --yes

Gorjeta

Se sua assinatura não permitir que você crie um recurso de serviços de IA do Azure, talvez seja necessário habilitar o privilégio desse provedor de recursos do Azure usando 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 a função de administrador para concluir o registo por si ou peça que sejam concedidos à conta os privilégios de /registo/ação.

Obtenha as chaves para o seu recurso

Para fazer login na instalação local da interface de linha de comando (CLI), use o comando az login .

az login

Use o comando az cognitiveservices account keys list para obter as chaves para o seu recurso.

az cognitiveservices account keys list  --name multi-service-resource --resource-group ai-services-resource-group

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

Seu aplicativo deve ser autenticado para acessar os recursos de serviços de IA do Azure. Para definir a variável de ambiente para sua chave de recurso, abra uma janela do console e siga as instruções para seu sistema operacional e ambiente de desenvolvimento. Para definir a COGNITIVE_SERVICE_KEY variável de ambiente, substitua your-key por uma das chaves do seu recurso.

Para produção, use uma maneira segura de armazenar e acessar suas credenciais, como um cofre secreto protegido por senha. Para teste, gravar em uma variável de ambiente é uma prática padrão, mas lembre-se de que as variáveis de ambiente são armazenadas em texto não criptografado na máquina local.

Gorjeta

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

O PowerShell inclui uma solução extensível, o Gerenciamento Secreto, para armazenar cadeias de caracteres seguras em plataformas como o Repositório Secreto ou o Azure KeyVault.

Para configurar um repositório secreto para hospedar cadeias de caracteres seguras, consulte o artigo Introdução ao uso do armazenamento secreto. Em seguida, use os exemplos a seguir para armazenar suas chaves de api.

Set-Secret -Name COGNITIVE_SERVICE_KEY -value your-key

Para ambientes de teste, você pode usar a sintaxe do PowerShell para definir uma variável de $Env: ambiente apenas para a sessão atual ou o setx comando para reter a variável entre sessões. Lembre-se de que esses valores são armazenados em texto não criptografado nas chaves do Registro do Windows.

$Env:COGNITIVE_SERVICE_KEY = your-key

setx COGNITIVE_SERVICE_KEY your-key

Depois de adicionar a variável de ambiente usando setxo , talvez seja necessário reiniciar todos os consoles em execução ou outros programas que precisarão ler a variável de ambiente. Por exemplo, se você estiver usando o Visual Studio como editor, reinicie o Visual Studio antes de executar o exemplo.

Para definir a variável de ambiente para sua região de recurso de fala, siga as mesmas etapas. Defina COGNITIVE_SERVICE_REGION para a região do seu recurso. Por exemplo, westus.

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

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

  • número máximo de transações permitidas por segundo (TPS).
  • Recursos de serviço habilitados dentro do nível de preço.
  • O custo de um número predefinido de transações. Ultrapassar este valor implicará um encargo adicional, conforme especificado nos detalhes do preço do seu serviço.

Obter o uso atual da cota para seu recurso

Use o comando az cognitiveservices account list-usage para obter o uso do seu recurso.

az cognitiveservices account list-usage --name multi-service-resource --resource-group ai-services-resource-group --subscription subscription-name

Clean up resources (Limpar recursos)

Se quiser limpar e remover um recurso de serviços de IA do Azure, você pode excluí-lo ou o grupo de recursos. A exclusão do grupo de recursos também exclui quaisquer outros recursos contidos no grupo.

Para remover o grupo de recursos e seus recursos associados, use o comando az group delete.

az group delete --name ai-services-resource-group

Use este início rápido para criar um recurso de serviços de IA do Azure usando comandos do Azure PowerShell . Depois de criar o recurso, use as chaves e o ponto de extremidade gerados para autenticar seus aplicativos.

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

Pré-requisitos

  • Uma assinatura válida do Azure - Crie uma gratuitamente.
  • Azure PowerShell
  • Sua conta do Azure deve ter uma Cognitive Services Contributor função atribuída para que você concorde com os termos de IA responsável e crie um recurso. Para atribuir essa função à sua conta, siga as etapas na documentação Atribuir funções ou entre em contato com o administrador.
  • Se estiver a planear utilizar a Análise Espacial na Visão de IA do Azure ou a Análise de Texto para Saúde na Linguagem de IA do Azure, tem de criar os seus primeiros recursos de Visão ou Linguagem a partir do portal do Azure para poder rever e reconhecer os termos e condições. Pode fazê-lo aqui: Azure AI Language, Azure AI Vision. Depois disso, você pode criar recursos subsequentes usando qualquer ferramenta de implantação (por exemplo, SDK, CLI ou modelo ARM) sob a mesma assinatura do Azure.

Instalar o Azure PowerShell e entrar

Instale o Azure PowerShell. Para entrar, execute o comando Connect-AzAccount :

Connect-AzAccount

Você também pode usar o botão verde Try It para executar esses comandos em seu navegador.

Criar um novo grupo de recursos de serviços de IA do Azure

Antes de criar um recurso de serviços de IA do Azure, você deve ter um grupo de recursos do Azure para conter o recurso. Ao criar um novo recurso, você pode criar um novo grupo de recursos ou usar 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 um dos locais do Azure disponíveis para sua assinatura. Você pode recuperar uma lista de locais disponíveis com o comando Get-AzLocation . A maioria dos serviços de IA do Azure pode ser acessada de vários locais. Escolha o mais próximo de você ou veja quais locais estão disponíveis para o serviço.

Importante

  • Lembre-se de seu local do Azure, pois você precisará dele ao chamar os recursos de serviços de IA do Azure.
  • A disponibilidade de alguns serviços de IA do Azure pode variar de acordo com a região. Para obter mais informações, consulte Produtos do Azure por região.
Get-AzLocation | Select-Object -Property Location, DisplayName

Depois de ter seu local do Azure, crie um novo grupo de recursos no Azure PowerShell usando o comando New-AzResourceGroup . No exemplo abaixo, substitua o local westus2 do Azure por um dos locais do Azure disponíveis para sua assinatura.

New-AzResourceGroup -Name ai-services-resource-group -Location westus2

Criar um recurso de serviços de IA do Azure

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

Ao criar um novo recurso, você precisará saber o tipo de serviço que deseja usar, juntamente com a camada de preço (ou SKU) desejada. Você usará essas e outras informações como parâmetros ao criar o recurso.

As tabelas a seguir fornecem informações sobre produtos e preços para serviços de IA do Azure.

Multi-serviço

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

Visão

Serviço Variante
Visão ComputerVision
Visão Personalizada - Previsão CustomVision.Prediction
Visão Personalizada - Formação CustomVision.Training
Face Face
Inteligência Documental FormRecognizer

Voz

Serviço Variante
Voz SpeechServices

Linguagem

Serviço Variante
Compreensão de Idiomas (LUIS) LUIS
Criador de FAQ QnAMaker
Linguagem TextAnalytics
Tradução de Texto TextTranslation

Decisão

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

Azure OpenAI

Serviço Variante
Azure OpenAI OpenAI

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

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

  • Número máximo de transações permitidas por segundo (TPS).
  • Recursos de serviço habilitados dentro do nível de preço.
  • Custo para um número predefinido de transações. Ultrapassar este número implicará um custo adicional, conforme especificado nos detalhes do preço do seu serviço.

Nota

Muitos dos serviços de IA do Azure têm uma camada gratuita que você pode usar para experimentar o serviço. Para usar o nível gratuito, use F0 como o nível de preço para seu recurso.

Você pode encontrar uma lista de "tipos" de serviços de IA do Azure disponíveis com o comando Get-AzCognitiveServicesAccountType :

Get-AzCognitiveServicesAccountType

Adicionar um novo recurso ao seu grupo de recursos

Para criar e assinar um novo recurso de serviços de IA do Azure, use o comando New-AzCognitiveServicesAccount . Este comando adiciona um novo recurso faturável ao grupo de recursos criado anteriormente. Ao criar seu novo recurso, você precisará saber o "tipo" de serviço que deseja usar, juntamente com sua camada de preço (ou SKU) e um local do Azure:

Você pode criar um recurso multisserviço Standard S0 nomeado multi-service-resource com o comando abaixo.

New-AzCognitiveServicesAccount -ResourceGroupName ai-services-resource-group -Name multi-service-resource -Type CognitiveServices -SkuName F0 -Location westus2

Gorjeta

Se sua assinatura não permitir que você crie um recurso de serviços de IA do Azure, talvez seja necessário habilitar o privilégio desse provedor de recursos do Azure usando o portal do Azure, um comando do Azure 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 a função de administrador para concluir o registo por si ou peça que sejam concedidos à conta os privilégios de /registo/ação.

Obtenha as chaves para o seu recurso

Use o comando Get-AzCognitiveServicesAccountKey para obter as chaves para seu recurso.

Get-AzCognitiveServicesAccountKey -Name multi-service-resource -ResourceGroupName ai-services-resource-group

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

Seu aplicativo deve ser autenticado para acessar os recursos de serviços de IA do Azure. Para definir a variável de ambiente para sua chave de recurso, abra uma janela do console e siga as instruções para seu sistema operacional e ambiente de desenvolvimento. Para definir a COGNITIVE_SERVICE_KEY variável de ambiente, substitua your-key por uma das chaves do seu recurso.

Para produção, use uma maneira segura de armazenar e acessar suas credenciais, como um cofre secreto protegido por senha. Para teste, gravar em uma variável de ambiente é uma prática padrão, mas lembre-se de que as variáveis de ambiente são armazenadas em texto não criptografado na máquina local.

Gorjeta

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

O PowerShell inclui uma solução extensível, o Gerenciamento Secreto, para armazenar cadeias de caracteres seguras em plataformas como o Repositório Secreto ou o Azure KeyVault.

Para configurar um repositório secreto para hospedar cadeias de caracteres seguras, consulte o artigo Introdução ao uso do armazenamento secreto. Em seguida, use os exemplos a seguir para armazenar suas chaves de api.

Set-Secret -Name COGNITIVE_SERVICE_KEY -value your-key

Para ambientes de teste, você pode usar a sintaxe do PowerShell para definir uma variável de $Env: ambiente apenas para a sessão atual ou o setx comando para reter a variável entre sessões. Lembre-se de que esses valores são armazenados em texto não criptografado nas chaves do Registro do Windows.

$Env:COGNITIVE_SERVICE_KEY = your-key

setx COGNITIVE_SERVICE_KEY your-key

Depois de adicionar a variável de ambiente usando setxo , talvez seja necessário reiniciar todos os consoles em execução ou outros programas que precisarão ler a variável de ambiente. Por exemplo, se você estiver usando o Visual Studio como editor, reinicie o Visual Studio antes de executar o exemplo.

Para definir a variável de ambiente para sua região de recurso de fala, siga as mesmas etapas. Defina COGNITIVE_SERVICE_REGION para a região do seu recurso. Por exemplo, westus.

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

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

  • número máximo de transações permitidas por segundo (TPS).
  • Recursos de serviço habilitados dentro do nível de preço.
  • O custo de um número predefinido de transações. Ultrapassar este valor implicará um encargo adicional, conforme especificado nos detalhes do preço do seu serviço.

Obter o uso atual da cota para seu recurso

Use o comando Get-AzCognitiveServicesAccountUsage para obter o uso do seu recurso.

Get-AzCognitiveServicesAccountUsage -ResourceGroupName ai-services-resource-group -Name multi-service-resource

Clean up resources (Limpar recursos)

Se quiser limpar e remover um recurso de serviços de IA do Azure, você pode excluí-lo ou o grupo de recursos. A exclusão do grupo de recursos também exclui quaisquer outros recursos contidos no grupo.

Para remover o grupo de recursos e seus recursos associados, use o comando Remove-AzResourceGroup .

Remove-AzResourceGroup -Name ai-services-resource-group

Documentação | de referência Pacote de código-fonte | da biblioteca (NuGet)Amostras |

Pré-requisitos do C#

  • Uma assinatura válida do Azure - Crie uma gratuitamente.
  • A versão atual do .NET Core.
  • Sua conta do Azure deve ter uma Cognitive Services Contributor função atribuída para que você concorde com os termos de IA responsável e crie um recurso. Para atribuir essa função à sua conta, siga as etapas na documentação Atribuir funções ou entre em contato com o administrador.
  • Se estiver a planear utilizar a Análise Espacial na Visão de IA do Azure ou a Análise de Texto para Saúde na Linguagem de IA do Azure, tem de criar os seus primeiros recursos de Visão ou Linguagem a partir do portal do Azure para poder rever e reconhecer os termos e condições. Pode fazê-lo aqui: Azure AI Language, Azure AI Vision. Depois disso, você pode criar recursos subsequentes usando qualquer ferramenta de implantação (por exemplo, SDK, CLI ou modelo ARM) sob a mesma assinatura do Azure.

Criar uma entidade de serviço do Azure

Para que seu aplicativo interaja com sua conta do Azure, você precisa de uma entidade de serviço do Azure para gerenciar permissões. Siga as instruções em Criar uma entidade de serviço do Azure.

Ao criar uma entidade de serviço, você verá que ela tem um valor secreto, uma ID e uma ID de aplicativo. Salve o ID e o segredo do aplicativo em um local temporário para etapas posteriores.

Criar um grupo de recursos

Antes de criar um recurso de serviços de IA do Azure, sua conta deve ter um grupo de recursos do Azure para conter o recurso. Se você ainda não tiver um grupo de recursos, crie um no portal do Azure antes de continuar.

Criar um novo aplicativo C#

Crie um novo aplicativo .NET Core. Em uma janela de console (como cmd, PowerShell ou Bash), use o dotnet new comando para criar um novo aplicativo de console com o nome azure-management-quickstart. Este comando cria um projeto C# "Hello World" simples com um único arquivo de origem: program.cs.

dotnet new console -n azure-management-quickstart

Altere seu diretório para a pasta do aplicativo recém-criada. Você pode criar o aplicativo com:

dotnet build

A saída da compilação não deve conter avisos ou erros.

...
Build succeeded.
 0 Warning(s)
 0 Error(s)
...

Instalar a biblioteca de cliente

No diretório do aplicativo, instale a biblioteca de cliente do Azure Management para .NET com o seguinte comando:

dotnet add package Azure.ResourceManager.CognitiveServices
dotnet add package Microsoft.Azure.Management.Fluent
dotnet add package Microsoft.Azure.Management.ResourceManager.Fluent

Se você estiver usando o IDE do Visual Studio, a biblioteca de cliente estará disponível como um pacote NuGet para download.

Importar bibliotecas

Abra program.cs e adicione as seguintes using instruções à parte superior do arquivo:

using System;
using Microsoft.Azure.Management.Fluent;
using Microsoft.Azure.Management.ResourceManager.Fluent;
using Microsoft.Azure.Management.ResourceManager.Fluent.Authentication;
using Microsoft.Azure.Management.CognitiveServices;
using Microsoft.Azure.Management.CognitiveServices.Models;

Autenticar o cliente

Adicione os campos a seguir à raiz do program.cs e preencha seus valores, usando a entidade de serviço que você criou e as informações da sua conta do Azure.

const string  service_principal_application_id = "PASTE_YOUR_SERVICE_PRINCIPAL_APPLICATION_ID_HERE";
const string  service_principal_secret = "PASTE_YOUR_SERVICE_PRINCIPAL_SECRET_HERE";

/* The ID of your Azure subscription. You can find this in the Azure Dashboard under Home > Subscriptions. */
const string  subscription_id = "PASTE_YOUR_SUBSCRIPTION_ID_HERE";

/* The Active Directory tenant ID. You can find this in the Azure Dashboard under Home > Azure Active Directory. */
const string  tenant_id = "PASTE_YOUR_TENANT_ID_HERE";

/* The name of the Azure resource group in which you want to create the resource.
You can find resource groups in the Azure Dashboard under Home > Resource groups. */
const string  resource_group_name = "PASTE_YOUR_RESOURCE_GROUP_NAME_HERE";

/* The name of the custom subdomain to use when you create the resource. This is optional.
For example, if you create a Bing Search v7 resource with the custom subdomain name 'my-search-resource',
your resource would have the endpoint https://my-search-resource.cognitiveservices.azure.com/.
Note not all Cognitive Services allow custom subdomain names. */
const string subdomain_name = "PASTE_YOUR_SUBDOMAIN_NAME_HERE";

Em seguida, em seu método Main, use esses valores para construir um objeto CognitiveServicesManagementClient. Este objeto é necessário para todas as suas operações de gerenciamento do Azure.

var service_principal_credentials = new ServicePrincipalLoginInformation ();
service_principal_credentials.ClientId = service_principal_application_id;
service_principal_credentials.ClientSecret = service_principal_secret;

var credentials = SdkContext.AzureCredentialsFactory.FromServicePrincipal(service_principal_application_id, service_principal_secret, tenant_id, AzureEnvironment.AzureGlobalCloud);
var client = new CognitiveServicesManagementClient(credentials);
client.SubscriptionId = subscription_id;

Métodos de gestão de chamadas

Adicione o código a seguir ao seu método Main para listar recursos disponíveis, criar um recurso de exemplo, listar seus recursos de propriedade e, em seguida, excluir o recurso de exemplo. Você definirá esses métodos nas próximas etapas.

    // Uncomment to list all available resource kinds, SKUs, and locations for your Azure account:
    //list_available_kinds_skus_locations(client);

    // Create a resource with kind TextTranslation, F0 (free tier), location global.
    create_resource(client, "test_resource", "TextTranslation", "F0", "Global");

    // List all resources for your Azure account and resource group:
    list_resources(client);

    // Delete the resource.
    delete_resource(client, "test_resource");

    Console.WriteLine("Press any key to exit.");
    Console.ReadKey();

Criar um recurso de serviços de IA do Azure (C#)

Para criar e assinar um novo recurso de serviços de IA do Azure, use o método Create . Esse método adiciona um novo recurso faturável ao grupo de recursos que você passa. Ao criar seu novo recurso, você precisará saber o "tipo" de serviço que deseja usar, juntamente com sua camada de preço (ou SKU) e um local do Azure. O método a seguir usa tudo isso como argumentos e cria um recurso.

static void create_resource(CognitiveServicesManagementClient client, string resource_name, string kind, string account_tier, string location)
{
    Console.WriteLine("Creating resource: " + resource_name + "...");
    /* NOTE If you do not want to use a custom subdomain name, remove the customSubDomainName
    property from CognitiveServicesAccountProperties. */
    CognitiveServicesAccount parameters = 
        new CognitiveServicesAccount(null, null, kind, location, resource_name, new CognitiveServicesAccountProperties(customSubDomainName : subdomain_name), new Sku(account_tier));
    var result = client.Accounts.Create(resource_group_name, resource_name, parameters);
    Console.WriteLine("Resource created.");
    Console.WriteLine("ID: " + result.Id);
    Console.WriteLine("Kind: " + result.Kind);
    Console.WriteLine();
}

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

Ao criar um novo recurso, você precisará saber o "tipo" de serviço que deseja usar, juntamente com a camada de preço (ou SKU) desejada. Você usará essas e outras informações como parâmetros ao criar o recurso. Você pode encontrar uma lista de "tipos" de serviços de IA do Azure disponíveis chamando o seguinte método em seu script:

static void list_available_kinds_skus_locations(CognitiveServicesManagementClient client)
{

    Console.WriteLine("Available SKUs:");
    var result = client.ResourceSkus.List();
    Console.WriteLine("Kind\tSKU Name\tSKU Tier\tLocations");
    foreach (var x in result) {
        var locations = "";
        foreach (var region in x.Locations)
        {
            locations += region;
        }
        Console.WriteLine(x.Kind + "\t" + x.Name + "\t" + x.Tier + "\t" + locations);
    };
}

As tabelas a seguir fornecem informações sobre produtos e preços para serviços de IA do Azure.

Multi-serviço

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

Visão

Serviço Variante
Visão ComputerVision
Visão Personalizada - Previsão CustomVision.Prediction
Visão Personalizada - Formação CustomVision.Training
Face Face
Inteligência Documental FormRecognizer

Voz

Serviço Variante
Voz SpeechServices

Linguagem

Serviço Variante
Compreensão de Idiomas (LUIS) LUIS
Criador de FAQ QnAMaker
Linguagem TextAnalytics
Tradução de Texto TextTranslation

Decisão

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

Azure OpenAI

Serviço Variante
Azure OpenAI OpenAI

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

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

  • Número máximo de transações permitidas por segundo (TPS).
  • Recursos de serviço habilitados dentro do nível de preço.
  • Custo para um número predefinido de transações. Ultrapassar este número implicará um custo adicional, conforme especificado nos detalhes do preço do seu serviço.

Nota

Muitos dos serviços de IA do Azure têm uma camada gratuita que você pode usar para experimentar o serviço. Para usar o nível gratuito, use F0 como o nível de preço para seu recurso.

Ver os seus recursos

Para exibir todos os recursos em sua conta do Azure (em todos os grupos de recursos), use o seguinte método:

static void list_resources(CognitiveServicesManagementClient client)
{
    Console.WriteLine("Resources in resource group: " + resource_group_name);
    var result = client.Accounts.ListByResourceGroup(resource_group_name);
    foreach (var x in result)
    {
        Console.WriteLine("ID: " + x.Id);
        Console.WriteLine("Name: " + x.Name);
        Console.WriteLine("Type: " + x.Type);
        Console.WriteLine("Kind: " + x.Kind);
        Console.WriteLine();
    }
}

Eliminar um recurso

O método a seguir exclui o recurso especificado do grupo de recursos determinado.

static void delete_resource(CognitiveServicesManagementClient client, string resource_name)
{
    Console.WriteLine("Deleting resource: " + resource_name + "...");
    client.Accounts.Delete (resource_group_name, resource_name);

    Console.WriteLine("Resource deleted.");
    Console.WriteLine();
}

Executar a aplicação

Execute o aplicativo a partir do diretório do aplicativo com o dotnet run comando.

dotnet run

Documentação | de referência Pacote de código-fonte | da biblioteca (Maven)

Pré-requisitos Java

  • Uma assinatura válida do Azure - Crie uma gratuitamente.
  • A versão atual do Java Development Kit (JDK)
  • A ferramenta de compilação Gradle ou outro gerenciador de dependência.
  • Sua conta do Azure deve ter uma Cognitive Services Contributor função atribuída para que você concorde com os termos de IA responsável e crie um recurso. Para atribuir essa função à sua conta, siga as etapas na documentação Atribuir funções ou entre em contato com o administrador.
  • Se estiver a planear utilizar a Análise Espacial na Visão de IA do Azure ou a Análise de Texto para Saúde na Linguagem de IA do Azure, tem de criar os seus primeiros recursos de Visão ou Linguagem a partir do portal do Azure para poder rever e reconhecer os termos e condições. Pode fazê-lo aqui: Azure AI Language, Azure AI Vision. Depois disso, você pode criar recursos subsequentes usando qualquer ferramenta de implantação (por exemplo, SDK, CLI ou modelo ARM) sob a mesma assinatura do Azure.

Criar uma entidade de serviço do Azure

Para que seu aplicativo interaja com sua conta do Azure, você precisa de uma entidade de serviço do Azure para gerenciar permissões. Siga as instruções em Criar uma entidade de serviço do Azure.

Ao criar uma entidade de serviço, você verá que ela tem um valor secreto, uma ID e uma ID de aplicativo. Salve o ID e o segredo do aplicativo em um local temporário para etapas posteriores.

Criar um grupo de recursos

Antes de criar um recurso de serviços de IA do Azure, sua conta deve ter um grupo de recursos do Azure para conter o recurso. Se você ainda não tiver um grupo de recursos, crie um no portal do Azure antes de continuar.

Criar uma nova aplicação Java

Numa janela de consola (como cmd, PowerShell ou Bash), crie um novo diretório para a sua aplicação e navegue para a mesma.

mkdir myapp && cd myapp

Execute o comando a gradle init partir do seu diretório de trabalho. Este comando criará arquivos de compilação essenciais para o Gradle, incluindo build.gradle.kts que é usado em tempo de execução para criar e configurar seu aplicativo.

gradle init --type basic

Quando solicitado a escolher uma DSL, selecione Kotlin.

No diretório de trabalho, execute o seguinte comando:

mkdir -p src/main/java

Instalar a biblioteca de cliente

Este guia de início rápido usa o gerenciador de dependência do Gradle. Você pode encontrar a biblioteca do cliente e informações para outros gerenciadores de dependência no Maven Central Repository.

No arquivo build.gradle.kts do seu projeto, inclua a biblioteca do cliente como uma implementation instrução, juntamente com os plug-ins e configurações necessários.

plugins {
    java
    application
}
application {
    mainClass.set("FormRecognizer")
}
repositories {
    mavenCentral()
}
dependencies {
    implementation(group = "com.microsoft.azure", name = "azure-mgmt-cognitiveservices", version = "1.10.0-beta")
}

Importar bibliotecas

Navegue até a nova pasta src/main/java e crie um arquivo chamado Management.java. Abra-o em seu editor ou IDE preferido e adicione as seguintes import instruções:

import com.azure.core.management.*;
import com.azure.core.management.profile.*;
import com.azure.identity.*;
import com.azure.resourcemanager.cognitiveservices.*;
import com.azure.resourcemanager.cognitiveservices.implementation.*;
import com.azure.resourcemanager.cognitiveservices.models.*;

import java.io.*;
import java.lang.Object.*;
import java.util.*;
import java.net.*;

Autenticar o cliente

Adicione uma classe em Management.java e, em seguida, adicione os seguintes campos e seus valores dentro dela. Preencha seus valores, usando a entidade de serviço que você criou e suas outras informações de conta do Azure.

/*
Be sure to use the service pricipal application ID, not simply the ID. 
*/

private static String applicationId = "PASTE_YOUR_SERVICE_PRINCIPAL_APPLICATION_ID_HERE";
private static String applicationSecret = "PASTE_YOUR_SERVICE_PRINCIPAL_SECRET_HERE";

/* The ID of your Azure subscription. You can find this in the Azure Dashboard under Home > Subscriptions. */
private static String subscriptionId = "PASTE_YOUR_SUBSCRIPTION_ID_HERE";

/* The Active Directory tenant ID. You can find this in the Azure Dashboard under Home > Azure Active Directory. */
private static String tenantId = "PASTE_YOUR_TENANT_ID_HERE";

/* The name of the Azure resource group in which you want to create the resource.
You can find resource groups in the Azure Dashboard under Home > Resource groups. */
private static String resourceGroupName = "PASTE_YOUR_RESOURCE_GROUP_NAME_HERE";

/* The name of the custom subdomain to use when you create the resource. This is optional.
For example, if you create a Bing Search v7 resource with the custom subdomain name 'my-search-resource',
your resource would have the endpoint https://my-search-resource.cognitiveservices.azure.com/.
Note not all Cognitive Services allow custom subdomain names. */
private static String subDomainName = "PASTE_YOUR_SUBDOMAIN_NAME_HERE";

Em seguida, em seu método principal, use esses valores para construir um objeto CognitiveServicesManager. Este objeto é necessário para todas as suas operações de gerenciamento do Azure.

/* For more information see:
https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md
*/

ClientSecretCredential credential = new ClientSecretCredentialBuilder()
    .clientId(applicationId)
    .clientSecret(applicationSecret)
    .tenantId(tenantId)
    .build();
AzureProfile profile = new AzureProfile(tenantId, subscriptionId, AzureEnvironment.AZURE);

CognitiveServicesManager client = CognitiveServicesManager.authenticate(credential, profile);

Métodos de gestão de chamadas

Adicione o código a seguir ao seu método Main para listar recursos disponíveis, criar um recurso de exemplo, listar seus recursos de propriedade e, em seguida, excluir o recurso de exemplo. Você definirá esses métodos nas próximas etapas.

String resourceName = "test_resource";
String resourceKind = "TextTranslation";
String resourceSku = "F0";
Region resourceRegion = Region.US_WEST;

// Uncomment to list all available resource kinds, SKUs, and locations for your Azure account.
// list_available_kinds_skus_locations (client);

// Create a resource with kind Text Translation, SKU F0 (free tier), location US West.
String resourceId = create_resource (client, resourceName, resourceGroupName, resourceKind, resourceSku, resourceRegion);

// Uncomment this to list all resources for your Azure account.
// list_resources (client, resourceGroupName);

// Delete the resource.
delete_resource (client, resourceId);

/* NOTE: When you delete a resource, it is only soft-deleted. You must also purge it. Otherwise, if you try to create another
resource with the same name or custom subdomain, you will receive an error stating that such a resource already exists. */
purge_resource (client, resourceName, resourceGroupName, resourceRegion);

Criar um recurso de serviços de IA do Azure (Java)

Para criar e assinar um novo recurso de serviços de IA do Azure, use o método create . Esse método adiciona um novo recurso faturável ao grupo de recursos que você passa. Ao criar seu novo recurso, você precisará saber o "tipo" de serviço que deseja usar, juntamente com sua camada de preço (ou SKU) e um local do Azure. O método a seguir usa tudo isso como argumentos e cria um recurso.

public static String create_resource (CognitiveServicesManager client, String resourceName, String resourceGroupName, String resourceKind, String resourceSku, Region resourceRegion) {
    System.out.println ("Creating resource: " + resourceName + "...");

    /* NOTE: If you do not want to use a custom subdomain name, remove the withCustomSubDomainName
    setter from the AccountProperties object. */
    Account result = client.accounts().define(resourceName)
        .withExistingResourceGroup(resourceGroupName)
        // Note: Do not call withRegion() first, as it does not exist on the Blank interface returned by define().
        .withRegion(resourceRegion)
        .withKind(resourceKind)
        .withSku(new Sku().withName(resourceSku))
        .withProperties(new AccountProperties().withCustomSubDomainName(subDomainName))
        .create();

    System.out.println ("Resource created.");
    System.out.println ("ID: " + result.id());
    System.out.println ("Provisioning state: " + result.properties().provisioningState().toString());
    System.out.println ();

    return result.id();
}

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

Ao criar um novo recurso, você precisará saber o "tipo" de serviço que deseja usar, juntamente com a camada de preço (ou SKU) desejada. Você usará essas e outras informações como parâmetros ao criar o recurso. Você pode encontrar uma lista de "tipos" de serviços de IA do Azure disponíveis chamando o seguinte método:

public static void list_available_kinds_skus_locations (CognitiveServicesManager client) {
    System.out.println ("Available SKUs:");
    System.out.println("Kind\tSKU Name\tSKU Tier\tLocations");
    ResourceSkus skus = client.resourceSkus();
    for (ResourceSku sku : skus.list()) {
        String locations = String.join (",", sku.locations());
        System.out.println (sku.kind() + "\t" + sku.name() + "\t" + sku.tier() + "\t" + locations);
    }
}

As tabelas a seguir fornecem informações sobre produtos e preços para serviços de IA do Azure.

Multi-serviço

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

Visão

Serviço Variante
Visão ComputerVision
Visão Personalizada - Previsão CustomVision.Prediction
Visão Personalizada - Formação CustomVision.Training
Face Face
Inteligência Documental FormRecognizer

Voz

Serviço Variante
Voz SpeechServices

Linguagem

Serviço Variante
Compreensão de Idiomas (LUIS) LUIS
Criador de FAQ QnAMaker
Linguagem TextAnalytics
Tradução de Texto TextTranslation

Decisão

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

Azure OpenAI

Serviço Variante
Azure OpenAI OpenAI

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

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

  • Número máximo de transações permitidas por segundo (TPS).
  • Recursos de serviço habilitados dentro do nível de preço.
  • Custo para um número predefinido de transações. Ultrapassar este número implicará um custo adicional, conforme especificado nos detalhes do preço do seu serviço.

Nota

Muitos dos serviços de IA do Azure têm uma camada gratuita que você pode usar para experimentar o serviço. Para usar o nível gratuito, use F0 como o nível de preço para seu recurso.

Ver os seus recursos

Para exibir todos os recursos em sua conta do Azure (em todos os grupos de recursos), use o seguinte método:

public static void list_resources (CognitiveServicesManager client, String resourceGroupName) {
    System.out.println ("Resources in resource group: " + resourceGroupName);
    // Note Azure resources are also sometimes referred to as accounts.
    Accounts accounts = client.accounts();
    for (Account account : accounts.listByResourceGroup(resourceGroupName)) {
        System.out.println ("ID: " + account.id());
        System.out.println ("Kind: " + account.kind ());
        System.out.println ("SKU Name: " + account.sku().name());
        System.out.println ("Custom subdomain name: " + account.properties().customSubDomainName());
        System.out.println ();
    }
}

Eliminar um recurso

O método a seguir exclui o recurso especificado do grupo de recursos determinado.

public static void delete_resource (CognitiveServicesManager client, String resourceId) {
    System.out.println ("Deleting resource: " + resourceId + "...");
    client.accounts().deleteById (resourceId);
    System.out.println ("Resource deleted.");
    System.out.println ();
}

Documentação | de referência Pacote de código-fonte | da biblioteca (npm)Exemplos |

Pré-requisitos JavaScript

  • Uma assinatura válida do Azure - Crie uma gratuitamente.
  • A versão atual do Node.js
  • Sua conta do Azure deve ter uma Cognitive Services Contributor função atribuída para que você concorde com os termos de IA responsável e crie um recurso. Para atribuir essa função à sua conta, siga as etapas na documentação Atribuir funções ou entre em contato com o administrador.
  • Se estiver a planear utilizar a Análise Espacial na Visão de IA do Azure ou a Análise de Texto para Saúde na Linguagem de IA do Azure, tem de criar os seus primeiros recursos de Visão ou Linguagem a partir do portal do Azure para poder rever e reconhecer os termos e condições. Pode fazê-lo aqui: Azure AI Language, Azure AI Vision. Depois disso, você pode criar recursos subsequentes usando qualquer ferramenta de implantação (por exemplo, SDK, CLI ou modelo ARM) sob a mesma assinatura do Azure.

Criar uma entidade de serviço do Azure

Para que seu aplicativo interaja com sua conta do Azure, você precisa de uma entidade de serviço do Azure para gerenciar permissões. Siga as instruções em Criar uma entidade de serviço do Azure.

Ao criar uma entidade de serviço, você verá que ela tem um valor secreto, uma ID e uma ID de aplicativo. Salve o ID e o segredo do aplicativo em um local temporário para etapas posteriores.

Criar um grupo de recursos

Antes de criar um recurso de serviços de IA do Azure, sua conta deve ter um grupo de recursos do Azure para conter o recurso. Se você ainda não tiver um grupo de recursos, crie um no portal do Azure antes de continuar.

Criar uma nova aplicação Node.js

Numa janela de consola (como cmd, PowerShell ou Bash), crie um novo diretório para a sua aplicação e navegue para a mesma.

mkdir myapp && cd myapp

Execute o comando init para criar uma aplicação de nó com um ficheiro package.json.

 init

Crie um arquivo chamado index.js antes de continuar.

Instalar a biblioteca de cliente

Instale os seguintes pacotes npm:

npm install @azure/arm-cognitiveservices
npm install @azure/identity

O ficheiro package.json da sua aplicação será atualizado com as dependências.

Importar bibliotecas

Abra o script index.js e importe as seguintes bibliotecas.

"use strict";

/* To run this sample, install the following modules.
 * npm install @azure/arm-cognitiveservices @azure/identity
 */
var Arm = require("@azure/arm-cognitiveservices");
var Identity = require("@azure/identity");

Autenticar o cliente

Adicione os seguintes campos à raiz do seu script e preencha seus valores, usando a entidade de serviço que você criou e as informações da sua conta do Azure.

const service_principal_application_id =
  "PASTE_YOUR_SERVICE_PRINCIPAL_APPLICATION_ID_HERE";
const service_principal_secret = "PASTE_YOUR_SERVICE_PRINCIPAL_SECRET_HERE";

/* The ID of your Azure subscription. You can find this in the Azure Dashboard under Home > Subscriptions. */
const subscription_id = "PASTE_YOUR_SUBSCRIPTION_ID_HERE";

/* The Active Directory tenant ID. You can find this in the Azure Dashboard under Home > Azure Active Directory. */
const tenant_id = "PASTE_YOUR_TENANT_ID_HERE";

/* The name of the Azure resource group in which you want to create the resource.
You can find resource groups in the Azure Dashboard under Home > Resource groups. */
const resource_group_name = "PASTE_YOUR_RESOURCE_GROUP_NAME_HERE";

/* The name of the custom subdomain to use when you create the resource. This is optional.
For example, if you create a Bing Search v7 resource with the custom subdomain name 'my-search-resource',
your resource would have the endpoint https://my-search-resource.cognitiveservices.azure.com/.
Note not all Cognitive Services allow custom subdomain names.
*/
const subdomain_name = "PASTE_YOUR_SUBDOMAIN_NAME_HERE";

Em seguida, adicione a seguinte quickstart função para lidar com o trabalho principal do seu programa. O primeiro bloco de código constrói um objeto CognitiveServicesManagementClient usando as variáveis de credencial inseridas acima. Este objeto é necessário para todas as suas operações de gerenciamento do Azure.

async function quickstart() {
  /* For more information see:
https://www.npmjs.com/package/@azure/arm-cognitiveservices/v/6.0.0
https://github.com/Azure/azure-sdk-for-js/blob/main/sdk/identity/identity/samples/AzureIdentityExamples.md#authenticating-a-service-principal-with-a-client-secret
*/
  const credentials = new Identity.ClientSecretCredential(
    tenant_id,
    service_principal_application_id,
    service_principal_secret
  );
  const client = new Arm.CognitiveServicesManagementClient(
    credentials,
    subscription_id
  );
  // Note Azure resources are also sometimes referred to as accounts.
  const accounts_client = client.accounts;
  const resource_skus_client = client.resourceSkus;
  const deleted_accounts_client = client.deletedAccounts;

Funções de gestão de chamadas

Adicione o código a seguir ao final da função quickstart para listar os recursos disponíveis, criar um recurso de exemplo, listar seus recursos de propriedade e, em seguida, excluir o recurso de exemplo. Você definirá essas funções nas próximas etapas.

Criar um recurso de serviços de IA do Azure (Node.js)

Para criar e assinar um novo recurso de serviços de IA do Azure, use a função Criar . Esta função adiciona um novo recurso faturável ao grupo de recursos que você passa. Ao criar seu novo recurso, você precisará saber o "tipo" de serviço que deseja usar, juntamente com sua camada de preço (ou SKU) e um local do Azure. A função a seguir usa todos esses argumentos e cria um recurso.

async function create_resource(
  client,
  resource_name,
  resource_kind,
  resource_sku,
  resource_region
) {
  console.log("Creating resource: " + resource_name + "...");
  /* NOTE If you do not want to use a custom subdomain name, remove the customSubDomainName
property from the properties object. */
  var parameters = {
    sku: { name: resource_sku },
    kind: resource_kind,
    location: resource_region,
    properties: { customSubDomainName: subdomain_name },
  };
  return client
    .beginCreateAndWait(resource_group_name, resource_name, parameters)
    .then((result) => {
      console.log("Resource created.");
      console.log();
      console.log("ID: " + result.id);
      console.log("Kind: " + result.kind);
      console.log();
    })
    .catch((err) => {
      console.log(err);
    });
}

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

Ao criar um novo recurso, você precisará saber o "tipo" de serviço que deseja usar, juntamente com a camada de preço (ou SKU) desejada. Você usará essas e outras informações como parâmetros ao criar o recurso. A função a seguir lista os "tipos" de serviços de IA do Azure disponíveis.

async function list_available_kinds_skus_locations(client) {
  console.log("Available SKUs:");
  var result = client.list();
  console.log("Kind\tSKU Name\tSKU Tier\tLocations");
  for await (let item of result) {
    var locations = item.locations.join(",");
    console.log(item.kind + "\t" + item.name + "\t" + item.tier + "\t" + locations);
  }
}

As tabelas a seguir fornecem informações sobre produtos e preços para serviços de IA do Azure.

Multi-serviço

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

Visão

Serviço Variante
Visão ComputerVision
Visão Personalizada - Previsão CustomVision.Prediction
Visão Personalizada - Formação CustomVision.Training
Face Face
Inteligência Documental FormRecognizer

Voz

Serviço Variante
Voz SpeechServices

Linguagem

Serviço Variante
Compreensão de Idiomas (LUIS) LUIS
Criador de FAQ QnAMaker
Linguagem TextAnalytics
Tradução de Texto TextTranslation

Decisão

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

Azure OpenAI

Serviço Variante
Azure OpenAI OpenAI

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

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

  • Número máximo de transações permitidas por segundo (TPS).
  • Recursos de serviço habilitados dentro do nível de preço.
  • Custo para um número predefinido de transações. Ultrapassar este número implicará um custo adicional, conforme especificado nos detalhes do preço do seu serviço.

Nota

Muitos dos serviços de IA do Azure têm uma camada gratuita que você pode usar para experimentar o serviço. Para usar o nível gratuito, use F0 como o nível de preço para seu recurso.

Ver os seus recursos

Para exibir todos os recursos em sua conta do Azure (em todos os grupos de recursos), use a seguinte função:

async function list_resources(client) {
  console.log("Resources in resource group: " + resource_group_name);
  var result = client.listByResourceGroup(resource_group_name);
  for await (let item of result) {
    console.log(item);
    console.log();
  }
}

Eliminar um recurso

A função a seguir exclui o recurso especificado do grupo de recursos determinado.

async function delete_resource(client, resource_name) {
  console.log("Deleting resource: " + resource_name + "...");
  await client.beginDeleteAndWait(resource_group_name, resource_name);
  console.log("Resource deleted.");
  console.log();
}

Executar a aplicação

Adicione o seguinte código à parte inferior do script para chamar sua função principal quickstart com tratamento de erros.

try {
  quickstart();
} catch (error) {
  console.log(error);
}

Em seguida, na janela do console, execute o aplicativo com o node comando.

node index.js

Documentação | de referência Pacote de código-fonte | da biblioteca (PyPi)Amostras |

Pré-requisitos do Python

  • Uma assinatura válida do Azure - Crie uma gratuitamente.
  • Python 3.x
  • Sua conta do Azure deve ter uma Cognitive Services Contributor função atribuída para que você concorde com os termos de IA responsável e crie um recurso. Para atribuir essa função à sua conta, siga as etapas na documentação Atribuir funções ou entre em contato com o administrador.
  • Se estiver a planear utilizar a Análise Espacial na Visão de IA do Azure ou a Análise de Texto para Saúde na Linguagem de IA do Azure, tem de criar os seus primeiros recursos de Visão ou Linguagem a partir do portal do Azure para poder rever e reconhecer os termos e condições. Pode fazê-lo aqui: Azure AI Language, Azure AI Vision. Depois disso, você pode criar recursos subsequentes usando qualquer ferramenta de implantação (por exemplo, SDK, CLI ou modelo ARM) sob a mesma assinatura do Azure.

Criar uma entidade de serviço do Azure

Para que seu aplicativo interaja com sua conta do Azure, você precisa de uma entidade de serviço do Azure para gerenciar permissões. Siga as instruções em Criar uma entidade de serviço do Azure.

Ao criar uma entidade de serviço, você verá que ela tem um valor secreto, uma ID e uma ID de aplicativo. Salve o ID e o segredo do aplicativo em um local temporário para etapas posteriores.

Criar um grupo de recursos

Antes de criar um recurso de serviços de IA do Azure, sua conta deve ter um grupo de recursos do Azure para conter o recurso. Se você ainda não tiver um grupo de recursos, crie um no portal do Azure antes de continuar.

Criar uma aplicação Python nova

Crie um novo aplicativo Python em seu editor ou IDE preferido e navegue até seu projeto em uma janela do console.

Instalar a biblioteca de cliente

Você pode instalar a biblioteca de cliente com:

pip install azure-mgmt-cognitiveservices

Instale também a biblioteca de Identidade do Azure para suporte à autenticação de token do Microsoft Entra.

pip install azure-identity

Importar bibliotecas

Abra o script Python e importe as seguintes bibliotecas.

import time
from azure.identity import ClientSecretCredential
from azure.mgmt.cognitiveservices import CognitiveServicesManagementClient
from azure.mgmt.cognitiveservices.models import Account, Sku

Autenticar o cliente

Adicione os seguintes campos à raiz do seu script e preencha seus valores, usando a entidade de serviço que você criou e as informações da sua conta do Azure.

# Be sure to use the service pricipal application ID, not simply the ID. 
service_principal_application_id = "PASTE_YOUR_SERVICE_PRINCIPAL_APPLICATION_ID_HERE"
service_principal_secret = "PASTE_YOUR_SERVICE_PRINCIPAL_SECRET_HERE"

# The ID of your Azure subscription. You can find this in the Azure Dashboard under Home > Subscriptions.
subscription_id = "PASTE_YOUR_SUBSCRIPTION_ID_HERE"

# The Active Directory tenant ID. You can find this in the Azure Dashboard under Home > Azure Active Directory.
tenant_id = "PASTE_YOUR_TENANT_ID_HERE"

# The name of the Azure resource group in which you want to create the resource.
# You can find resource groups in the Azure Dashboard under Home > Resource groups.
resource_group_name = "PASTE_YOUR_RESOURCE_GROUP_NAME_HERE"

# The name of the custom subdomain to use when you create the resource. This is optional.
# For example, if you create a Bing Search v7 resource with the custom subdomain name 'my-search-resource',
# your resource would have the endpoint https://my-search-resource.cognitiveservices.azure.com/.
# Note not all Cognitive Services allow custom subdomain names.
subdomain_name = "PASTE_YOUR_SUBDOMAIN_NAME_HERE"

# How many seconds to wait between checking the status of an async operation.
wait_time = 10

Em seguida, adicione o seguinte código para construir um objeto CognitiveServicesManagementClient . Este objeto é necessário para todas as suas operações de gerenciamento do Azure.

credential = ClientSecretCredential(tenant_id, service_principal_application_id, service_principal_secret)
client = CognitiveServicesManagementClient(credential, subscription_id)

Criar um recurso de serviços de IA do Azure (Python)

Para criar e assinar um novo recurso de serviços de IA do Azure, use a função Criar . Esta função adiciona um novo recurso faturável ao grupo de recursos que você passa. Ao criar seu novo recurso, você precisará saber o "tipo" de serviço que deseja usar, juntamente com sua camada de preço (ou SKU) e um local do Azure. A função a seguir usa todos esses argumentos e cria um recurso.

def create_resource (resource_name, kind, sku_name, location) :
    print("Creating resource: " + resource_name + "...")

# NOTE If you do not want to use a custom subdomain name, remove the customSubDomainName
# property from the properties object.
    parameters = Account(sku=Sku(name=sku_name), kind=kind, location=location, properties={ 'custom_sub_domain_name' : subdomain_name })

    poller = client.accounts.begin_create(resource_group_name, resource_name, parameters)
    while (False == poller.done ()) :
        print ("Waiting {wait_time} seconds for operation to finish.".format (wait_time = wait_time))
        time.sleep (wait_time)
# This will raise an exception if the server responded with an error.
    result = poller.result ()

    print("Resource created.")
    print()
    print("ID: " + result.id)
    print("Name: " + result.name)
    print("Type: " + result.type)
    print()

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

Ao criar um novo recurso, você precisará saber o "tipo" de serviço que deseja usar, juntamente com a camada de preço (ou SKU) desejada. Você usará essas e outras informações como parâmetros ao criar o recurso. A função a seguir lista os "tipos" de serviços de IA do Azure disponíveis.

def list_available_kinds_skus_locations():
    print("Available SKUs:")
    result = client.resource_skus.list()
    print("Kind\tSKU Name\tSKU Tier\tLocations")
    for x in result:
        locations = ",".join(x.locations)
        print(x.kind + "\t" + x.name + "\t" + x.tier + "\t" + locations)

As tabelas a seguir fornecem informações sobre produtos e preços para serviços de IA do Azure.

Multi-serviço

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

Visão

Serviço Variante
Visão ComputerVision
Visão Personalizada - Previsão CustomVision.Prediction
Visão Personalizada - Formação CustomVision.Training
Face Face
Inteligência Documental FormRecognizer

Voz

Serviço Variante
Voz SpeechServices

Linguagem

Serviço Variante
Compreensão de Idiomas (LUIS) LUIS
Criador de FAQ QnAMaker
Linguagem TextAnalytics
Tradução de Texto TextTranslation

Decisão

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

Azure OpenAI

Serviço Variante
Azure OpenAI OpenAI

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

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

  • Número máximo de transações permitidas por segundo (TPS).
  • Recursos de serviço habilitados dentro do nível de preço.
  • Custo para um número predefinido de transações. Ultrapassar este número implicará um custo adicional, conforme especificado nos detalhes do preço do seu serviço.

Nota

Muitos dos serviços de IA do Azure têm uma camada gratuita que você pode usar para experimentar o serviço. Para usar o nível gratuito, use F0 como o nível de preço para seu recurso.

Ver os seus recursos

Para exibir todos os recursos em sua conta do Azure (em todos os grupos de recursos), use a seguinte função:

def list_resources():
    print("Resources in resource group: " + resource_group_name)
    result = client.accounts.list_by_resource_group(resource_group_name)
    for x in result:
        print(x.name)
        print(x)
        print()

Eliminar um recurso

A função a seguir exclui o recurso especificado do grupo de recursos determinado.

def delete_resource(resource_name) :
    print("Deleting resource: " + resource_name + "...")

    poller = client.accounts.begin_delete(resource_group_name, resource_name)
    while (False == poller.done ()) :
        print ("Waiting {wait_time} seconds for operation to finish.".format (wait_time = wait_time))
        time.sleep (wait_time)
# This will raise an exception if the server responded with an error.
    result = poller.result ()

    print("Resource deleted.")

Funções de gestão de chamadas

Adicione o seguinte código à parte inferior do script para chamar as funções acima. Esse código lista os recursos disponíveis, cria um recurso de exemplo, lista seus recursos de propriedade e, em seguida, exclui o recurso de exemplo.

resource_name = "test_resource"
resource_kind = "TextTranslation"
resource_sku = "F0"
resource_location = "Global"

# Uncomment this to list all available resource kinds, SKUs, and locations for your Azure account.
#list_available_kinds_skus_locations ()

# Create a resource with kind Text Translation, SKU F0 (free tier), location global.
create_resource(resource_name, resource_kind, resource_sku, resource_location)

# Uncomment this to list all resources for your Azure account.
#list_resources()

# Delete the resource.
delete_resource(resource_name)

# NOTE: Deleting a resource only soft-deletes it. To delete it permanently, you must purge it.
# Otherwise, if you later try to create a resource with the same name, you will receive the following error:
# azure.core.exceptions.ResourceExistsError: (FlagMustBeSetForRestore) An existing resource with ID '<your resource ID>' has been soft-deleted. To restore the resource, you must specify 'restore' to be 'true' in the property. If you don't want to restore existing resource, please purge it first.
# Code: FlagMustBeSetForRestore

# Purge the resource.
purge_resource(resource_name, resource_location)

Executar a aplicação

Execute seu aplicativo a partir da linha de comando com o python comando.

python <your-script-name>.py

Próximos passos

  • Agora que você tem um recurso, pode autenticar suas solicitações de API em um dos serviços de IA do Azure com suporte.