Criar um recurso de Serviços Cognitivos utilizando o portal AzureCreate a Cognitive Services resource using the Azure portal

Utilize este quickstart para começar a utilizar os Serviços Cognitivos Azure.Use this quickstart to start using Azure Cognitive Services. Depois de criar um recurso de Serviço Cognitivo no portal Azure, você receberá um ponto final e uma chave para autenticar as suas aplicações.After creating a Cognitive Service resource in the Azure portal, you'll get an endpoint and a key for authenticating your applications.

Você pode aceder aos Serviços Cognitivos Azure através de dois recursos diferentes: um recurso multi-serviço, 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 multi-serviço:Multi-service resource:
    • Aceda a vários Serviços Cognitivos Azure com uma única chave e ponto final.Access multiple Azure Cognitive Services with a single key and endpoint.
    • Consolida a faturação dos serviços que utiliza.Consolidates billing from the services you use.
  • Recurso de serviço único:Single-service resource:
    • Aceda a um único Serviço Cognitivo Azure com uma chave e ponto final únicos para cada serviço criado.Access a single Azure Cognitive Service with a unique key and endpoint for each service created.
    • Utilize o nível gratuito para experimentar o serviço.Use the free tier to try out the service.

Pré-requisitosPrerequisites

Criar um novo recurso Azure Cognitive ServicesCreate a new Azure Cognitive Services resource

  1. Criar um recurso.Create a resource.

    O recurso multi-serviço chama-se Serviços Cognitivos no portal.The multi-service resource is named Cognitive Services in the portal. Criar um recurso de Serviços Cognitivos.Create a Cognitive Services resource.

    Neste momento, o recurso multi-serviço permite o acesso aos seguintes Serviços Cognitivos:At this time, the multi-service resource enables access to the following Cognitive Services:

    • Imagem DigitalizadaComputer Vision
    • Content ModeratorContent Moderator
    • RostosFace
    • Compreensão de Idiomas (LUIS)Language Understanding (LUIS)
    • Análise de TextoText Analytics
    • TradutorTranslator
    • Bing Search v7Bing Search v7
      (Web, Imagem, Notícias, Vídeo, Visual)(Web, Image, News, Video, Visual)
    • Pesquisa Personalizada do BingBing Custom Search
    • Pesquisa de Entidades 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 seu recurso de serviços cognitivos.A descriptive name for your cognitive services resource. Por exemplo, MyCognitiveServicesResource.For example, MyCognitiveServicesResource.
    SubscriçãoSubscription Selecione uma das suas subscrições Azure disponíveis.Select one of your available Azure subscriptions.
    LocalizaçãoLocation A localização do seu serviço cognitivo.The location of your cognitive service instance. Diferentes localizações podem introduzir latência, mas não têm impacto na 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.
    Escalão de preçoPricing tier O custo da sua conta de Serviços Cognitivos depende das opções que escolher e da sua utilização.The cost of your Cognitive Services account depends on the options you choose and your usage. Para mais informações, consulte os detalhes dos preços daAPI.For more information, see the API pricing details.
    Grupo de recursosResource group O grupo de recursos Azure que conterá o seu recurso de Serviços Cognitivos.The Azure resource group that will contain your Cognitive Services resource. Pode criar um novo 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 Create (Criar).Click 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.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 não for o proprietário da subscrição, peça ao Proprietário da Subscrição 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.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.

Obtenha as chaves do seu recursoGet the keys for your resource

  1. Depois de o seu recurso ter sido implementado com sucesso, clique em Ir para o recurso sob os Próximos Passos.After your resource is successfully deployed, click on Go to resource under Next Steps.

    Pesquisa de Serviços Cognitivos

  2. A partir do painel de arranque rápido que se abre, pode aceder à sua chave e ponto final.From the quickstart pane that opens, you can access your key and endpoint.

    Obtenha chave e ponto final

Configure uma variável ambiental para a autenticaçãoConfigure an environment variable for authentication

As aplicações precisam de autenticar o acesso aos Serviços Cognitivos que utilizam.Applications need to authenticate access to the Cognitive Services they use. Para autenticar, recomendamos a criação de uma variável ambiental para armazenar as chaves para os seus Recursos Azure.To authenticate, we recommend creating an environment variable to store the keys for your Azure Resources.

Depois de ter a sua chave, escreva-a para uma nova variável de ambiente na máquina local que executa a aplicação.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 da consola e siga as instruções relevantes para o seu sistema operativo.To set the environment variable, open a console window, and follow the instructions for your operating system. Substitua your-key por uma das teclas do seu 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, 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.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 a utilizar o Visual Studio como seu editor, reinicie o Visual Studio 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 pretender limpar e remover uma subscrição dos Serviços Cognitivos, pode eliminar o grupo de recursos ou recursos.If you want to clean up and remove a Cognitive Services subscription, you can delete the resource or resource group. A eliminação do grupo de recursos também elimina quaisquer 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 no lado esquerdo para abrir o menu de serviços e escolha Grupos de Recursos, para apresentar 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. Localizar o grupo de recursos que contém o recurso a eliminarLocate the resource group containing the resource to be deleted
  3. Clique com o botão direito na listagem do grupo de recursos.Right-click on the resource group listing. Selecione Eliminar grupo de recursos e confirme.Select Delete resource group, and confirm.

Veja tambémSee also