Criar um recurso de serviços cognitivas usando o portal do AzureCreate 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.

Você pode acessar os serviços cognitivas do Azure por meio de dois recursos diferentes: Um recurso de vários serviços ou um único 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:
    • Acesse vários serviços cognitivas do Azure com uma única chave e 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 serviço único:Single-service resource:
    • Acesse um único serviço cognitiva 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. Cria 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:

    Pesquisa Visual ComputacionalComputer Vision Content ModeratorContent Moderator Detecção FacialFace Reconhecimento Vocal (LUIS)Language Understanding (LUIS) Análise de TextoText Analytics
    Tradução de TextoTranslator Text 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 tempo de execução do seu recurso.Different locations may introduce latency, but have no impact on the runtime availability of your resource. Lembre-se do local do Azure, pois você pode precisar dele ao chamar os serviços cognitivas do Azure.Remember your Azure location, as you may need it when calling the Azure Cognitive Services.
    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á seu recurso de serviços cognitivas.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

    Clique em Criar.Click Create.

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 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 todos os outros recursos contidos no grupo.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.

Consulte tambémSee also