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

  • Artigo
  • 8 minutos para ler

Use este quickstart para criar um recurso de Serviços Cognitivos. Depois de criar um recurso de Serviço Cognitivo no portal Azure, receberá um ponto final e uma chave para autenticar as suas aplicações.

Os Azure Cognitive Services são serviços baseados na nuvem com APIs REST, e SDKs da 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.
  • 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.

Criar um novo recurso Azure Cognitive Services

O recurso multi-serviço chama-se Serviços Cognitivos no portal. O recurso multi-serviço permite o acesso aos seguintes Serviços Cognitivos:

  • Decisão – Content Moderator
  • Linguagem – Linguagem, Tradutor
  • Voz – Voz
  • Visão – Imagem Digitalizada, Visão Personalizada, Face

  1. Pode selecionar esta ligação para criar um recurso multi-serviço Azure Cognitive: Criar um recurso de Serviços Cognitivos.

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

    Detalhes do projeto Descrição
    Subscrição Selecione uma das suas subscrições Azure disponíveis.
    Grupo de recursos O grupo de recursos Azure que conterá o seu recurso De Serviços Cognitivos. Pode criar um novo grupo ou adicioná-lo a um grupo pré-existente.
    Região A localização do seu serviço cognitivo. Diferentes localizações 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 o seu recurso de serviços cognitivos. Por exemplo, MyCognitiveServicesResource.
    Escalão de preço O custo da sua conta serviços cognitivos depende das opções que escolher e do seu uso. Para mais informações, consulte os detalhes dos preços da API.

    Multi-service resource creation screen

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

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

  1. Depois de o seu recurso ser implementado com sucesso, selecione Next Steps>Go para o recurso.

    Get resource keys screen

  2. A partir do painel de arranque rápido que se abre, pode aceder ao ponto final do recurso e gerir as teclas.

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.

Limpar os recursos

Se pretender limpar e remover uma subscrição dos Serviços Cognitivos, pode eliminar o grupo de recursos ou recursos. A eliminação do grupo de recursos também elimina 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 eliminar.
  3. Se pretender eliminar todo o grupo de recursos, selecione o nome do grupo de recursos. Na página seguinte, selecione eliminar o grupo de recursos e confirmar.
  4. Se pretender eliminar apenas o recurso Serviço Cognitivo, selecione o grupo de recursos para ver todos os recursos dentro dele. Na página seguinte, selecione o recurso que pretende eliminar, clique no menu de elipses para essa linha e selecione Eliminar.

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

Ver também