Início rápido: criar um recurso de serviços cognitivas usando o portal do AzureQuickstart: Create a Cognitive Services resource using the Azure portal

Use este guia de início rápido para começar a usar os serviços cognitivas do Azure.Use this quickstart to start using Azure Cognitive Services. Depois de criar um recurso de serviço cognitiva no portal do Azure, você obterá um ponto de extremidade e uma chave para autenticar seus aplicativos.After creating a Cognitive Service resource in the Azure portal, you'll get an endpoint and a key for authenticating your applications.

Os serviços cognitivas do Azure são serviços baseados em nuvem com APIs REST e SDKs de biblioteca de cliente disponíveis para ajudar os desenvolvedores a criarem inteligência cognitiva em aplicativos sem ter informações sobre inteligência artificial direta (ia) ou ciência de dados.Azure Cognitive Services are cloud-based services with REST APIs, and client library SDKs available to help developers build cognitive intelligence into applications without having direct artificial intelligence (AI) or data science skills or knowledge. Os Serviços Cognitivos do Azure permitem que os desenvolvedores adicionem com facilidade recursos cognitivos a seus aplicativos, com soluções cognitivas capazes de ver, ouvir, falar, entender e até mesmo começar a racionalizar.Azure Cognitive Services enables developers to easily add cognitive features into their applications with cognitive solutions that can see, hear, speak, understand, and even begin to reason.

Você pode acessar os Serviços Cognitivos do Azure por meio de dois recursos diferentes: Um recurso de vários serviços ou um só serviço.You can access Azure Cognitive Services through two different resources: A multi-service resource, or a single-service one.

  • Recurso de vários serviços:Multi-service resource:
    • Acessar vários Serviços Cognitivos do Azure com uma chave e um ponto de extremidade.Access multiple Azure Cognitive Services with a single key and endpoint.
    • Consolida a cobrança dos serviços que você usa.Consolidates billing from the services you use.
  • Recurso de um serviço:Single-service resource:
    • Acesse um só Serviço Cognitivo do Azure com uma chave exclusiva e um ponto de extremidade para cada serviço criado.Access a single Azure Cognitive Service with a unique key and endpoint for each service created.
    • Use a camada gratuita para experimentar o serviço.Use the free tier to try out the service.

Pré-requisitosPrerequisites

Criar um novo recurso de serviços cognitivas do AzureCreate a new Azure Cognitive Services resource

  1. Criar um recurso.Create a resource.

    O recurso de vários serviços é chamado de Serviços cognitivas no Portal.The multi-service resource is named Cognitive Services in the portal. Crie um recurso de serviços cognitivas.Create a Cognitive Services resource.

    Neste momento, o recurso de vários serviços permite o acesso aos seguintes serviços cognitivas:At this time, the multi-service resource enables access to the following Cognitive Services:

    • Visual ComputacionalComputer Vision
    • Content ModeratorContent Moderator
    • FaceFace
    • Reconhecimento Vocal (LUIS)Language Understanding (LUIS)
    • Análise de textoText Analytics
    • TradutorTranslator
    • Pesquisa do Bing v7Bing Search v7
      (Web, imagem, notícias, vídeo, Visual)(Web, Image, News, Video, Visual)
    • Pesquisa Personalizada do BingBing Custom Search
    • Pesquisa de Entidade do BingBing Entity Search
    • Sugestão Automática do BingBing Autosuggest
    • Verificação Ortográfica do BingBing Spell Check
  2. Na página Criar, forneça as seguintes informações:On the Create page, provide the following information:

    NomeName Um nome descritivo para o recurso de serviços cognitivos.A descriptive name for your cognitive services resource. Por exemplo, MyCognitiveServicesResource.For example, MyCognitiveServicesResource.
    AssinaturaSubscription Selecione uma das suas assinaturas do Azure disponíveis.Select one of your available Azure subscriptions.
    LocalidadeLocation A localização da sua instância de serviço cognitivo.The location of your cognitive service instance. Locais diferentes podem introduzir latência, mas não têm impacto sobre a disponibilidade de runtime do seu recurso.Different locations may introduce latency, but have no impact on the runtime availability of your resource.
    Tipo de preçosPricing tier O custo da sua conta de Serviços Cognitivos depende das opções escolhidas e do seu uso.The cost of your Cognitive Services account depends on the options you choose and your usage. Para obter mais informações, consulte a API detalhes de preços.For more information, see the API pricing details.
    Grupo de recursosResource group O grupo de recursos do Azure que conterá o recurso de serviços Cognitivos.The Azure resource group that will contain your Cognitive Services resource. Você pode criar um grupo ou adicioná-lo a um grupo pré-existente.You can create a new group or add it to a pre-existing group.

    Tela de criação de recursos de recurso de vários serviços

    Clique em Criar.Click Create.

Dica

Se sua assinatura não permitir que você crie um recurso de Serviço Cognitivo, talvez seja necessário habilitar essa capacidade do provedor de recursos do Azure com o portal do Azure, um comando do PowerShell ou um comando da CLI do Azure.If your subscription doesn't allow you to create a Cognitive Service resource, you may need to enable that ability of the Azure resource provider with the Azure portal, PowerShell command or an Azure CLI command. Se você não for o proprietário da assinatura, peça ao Proprietário da assinatura ou a alguém com uma função de administrador para concluir o registro para você ou solicitar os privilégios de /register/action concedidos à sua conta.If you are not the subscription owner, ask the Subscription Owner or someone with a role of admin to complete the registration for you or ask for the /register/action privileges granted to your account.

Obter as chaves para seu recursoGet the keys for your resource

  1. Depois que o recurso for implantado com êxito, clique em ir para o recurso em próximas etapas.After your resource is successfully deployed, click on Go to resource under Next Steps.

    Pesquise pelos Serviços Cognitivos

  2. No painel de início rápido que é aberto, você pode acessar sua chave e ponto de extremidade.From the quickstart pane that opens, you can access your key and endpoint.

    Obter chave e ponto de extremidade

Configurar uma variável de ambiente para autenticaçãoConfigure an environment variable for authentication

Os aplicativos precisam autenticar o acesso aos serviços cognitivas que eles usam.Applications need to authenticate access to the Cognitive Services they use. Para autenticar, é recomendável criar uma variável de ambiente para armazenar as chaves para os recursos do Azure.To authenticate, we recommend creating an environment variable to store the keys for your Azure Resources.

Depois de ter sua chave, grave-a em uma nova variável de ambiente no computador local que executa o aplicativo.After you have your key, write it to a new environment variable on the local machine running the application. Para definir a variável de ambiente, abra uma janela de console e siga as instruções do seu sistema operacional.To set the environment variable, open a console window, and follow the instructions for your operating system. Substitua your-key por uma das chaves do recurso.Replace your-key with one of the keys for your resource.

setx COGNITIVE_SERVICE_KEY "your-key"

Depois de adicionar a variável de ambiente, talvez seja necessário reiniciar todos os programas em execução que precisarem ler a variável de ambiente, incluindo a janela do console.After you add the environment variable, you may need to restart any running programs that will need to read the environment variable, including the console window. Por exemplo, se estiver usando o Visual Studio como seu editor, reinicie-o antes de executar o exemplo.For example, if you are using Visual Studio as your editor, restart Visual Studio before running the example.

Limpar os recursosClean up resources

Se quiser limpar e remover uma assinatura dos Serviços Cognitivos, você poderá excluir o recurso ou grupo de recursos.If you want to clean up and remove a Cognitive Services subscription, you can delete the resource or resource group. Excluir o grupo de recursos também exclui outros recursos contidos nele.Deleting the resource group also deletes any other resources contained in the group.

  1. No portal do Azure, expanda o menu à esquerda para abrir o menu de serviços e escolha Grupo de Recursos para exibir a lista dos seus grupos de recursos.In the Azure portal, expand the menu on the left side to open the menu of services, and choose Resource Groups to display the list of your resource groups.
  2. Localize o grupo de recursos que contém o recurso a ser excluídoLocate the resource group containing the resource to be deleted
  3. Clique com o botão direito do mouse na listagem do grupo de recursos.Right-click on the resource group listing. Selecione Excluir grupo de recursos e confirme.Select Delete resource group, and confirm.

Confira tambémSee also