Início Rápido: Criar um recurso dos Serviços Cognitivos com o portal do Azure
Artigo
16 minutos para ler
Utilize este início rápido para criar um recurso dos Serviços Cognitivos. Depois de criar um recurso do Serviço Cognitivo no portal do Azure, obterá um ponto final e uma chave para autenticar as suas aplicações.
Os Serviços Cognitivos do Azure são serviços de inteligência artificial (IA) baseados na cloud que ajudam os programadores a criar inteligência cognitiva em aplicações sem terem conhecimentos ou competências diretas de IA ou ciência de dados. Estão disponíveis através de APIs REST e SDKs de biblioteca de cliente em linguagens de desenvolvimento populares. Os Serviços Cognitivos do Azure permitem aos programadores adicionar facilmente funcionalidades cognitivas às suas aplicações com soluções cognitivas que podem ver, ouvir, falar e analisar.
Tipos de recursos dos Serviços Cognitivos
Pode aceder aos Serviços Cognitivos do Azure através de dois recursos diferentes: um recurso multiserviço ou um único serviço.
Recurso de vários serviços:
Aceda a vários Serviços Cognitivos do 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 do Azure com uma chave e um ponto final exclusivos para cada serviço criado.
Utilize o escalão gratuito para experimentar o serviço.
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 atribuir esta função à sua conta, siga os passos na documentação Atribuir funções ou contacte o administrador.
Criar um novo recurso dos Serviços Cognitivos do Azure
Na página Criar , forneça as seguintes informações:
Detalhes do projeto
Descrição
Subscrição
Selecione uma das suas subscrições do Azure disponíveis.
Grupo de recursos
O grupo de recursos do Azure que irá conter o recurso dos Serviços Cognitivos. Pode criar um novo grupo ou adicioná-lo a um grupo pré-existente.
Região
A localização da instância do serviço cognitivo. Diferentes localizações podem introduzir latência, mas não têm impacto na disponibilidade do runtime do recurso.
Nome
Um nome descritivo para o recurso dos serviços cognitivos. Por exemplo, MyCognitiveServicesResource.
Escalão de preço
O custo da sua conta dos Serviços Cognitivos depende das opções que escolher e da utilização. Para obter mais informações, veja os detalhes dos preços da API.
Configure outras definições para o recurso conforme necessário, leia e aceite as condições (conforme aplicável) e, em seguida, selecione Rever + criar.
Na página Criar , forneça as seguintes informações:
Detalhes do projeto
Descrição
Subscrição
Selecione uma das suas subscrições do Azure disponíveis.
Grupo de recursos
O grupo de recursos do Azure que irá conter o recurso dos Serviços Cognitivos. Pode criar um novo grupo ou adicioná-lo a um grupo pré-existente.
Região
A localização da instância do serviço cognitivo. Diferentes localizações podem introduzir latência, mas não têm impacto na disponibilidade do runtime do recurso.
Nome
Um nome descritivo para o recurso dos serviços cognitivos. Por exemplo, MyCognitiveServicesResource.
Escalão de preço
O custo da sua conta dos Serviços Cognitivos depende das opções que escolher e da utilização. Para obter mais informações, veja os detalhes dos preços da API.
Selecione Rever + criar.
Selecione a seguinte ligação para criar um recurso do Content Moderator:
Na página Criar , forneça as seguintes informações:
Detalhes do projeto
Descrição
Subscrição
Selecione uma das suas subscrições do Azure disponíveis.
Grupo de recursos
O grupo de recursos do Azure que irá conter o recurso dos Serviços Cognitivos. Pode criar um novo grupo ou adicioná-lo a um grupo pré-existente.
Região
A localização da instância do serviço cognitivo. Diferentes localizações podem introduzir latência, mas não têm impacto na disponibilidade do runtime do recurso.
Nome
Um nome descritivo para o recurso dos serviços cognitivos. Por exemplo, MyCognitiveServicesResource.
Escalão de preço
O custo da sua conta dos Serviços Cognitivos depende das opções que escolher e da utilização. Para obter mais informações, veja os detalhes dos preços da API.
Selecione Rever + criar.
Selecione a seguinte ligação para criar um recurso do Assistente de Métricas:
Na página Criar , forneça as seguintes informações:
Detalhes do projeto
Descrição
Subscrição
Selecione uma das suas subscrições do Azure disponíveis.
Grupo de recursos
O grupo de recursos do Azure que irá conter o recurso dos Serviços Cognitivos. Pode criar um novo grupo ou adicioná-lo a um grupo pré-existente.
Região
A localização da instância do serviço cognitivo. Diferentes localizações podem introduzir latência, mas não têm impacto na disponibilidade do runtime do recurso.
Nome
Um nome descritivo para o recurso dos serviços cognitivos. Por exemplo, MyCognitiveServicesResource.
Escalão de preço
O custo da sua conta dos Serviços Cognitivos depende das opções que escolher e da utilização. Para obter mais informações, veja os detalhes dos preços da API.
Armazenamento
Opcionalmente, pode utilizar o seu próprio recurso de base de dados do Azure para armazenar os dados que o Assistente de Métricas irá utilizar.
Marque a sua confirmação do Contrato de Serviços e dos Termos e, em seguida, selecione Rever + criar.
Na página Selecionar funcionalidades adicionais , escolha se pretende incluir as funcionalidades de personalização que funcionam com outros serviços.
Na página Criar , forneça as seguintes informações:
Detalhes do projeto
Descrição
Subscrição
Selecione uma das suas subscrições do Azure disponíveis.
Grupo de recursos
O grupo de recursos do Azure que irá conter o recurso dos Serviços Cognitivos. Pode criar um novo grupo ou adicioná-lo a um grupo pré-existente.
Região
A localização da instância do serviço cognitivo. Diferentes localizações podem introduzir latência, mas não têm impacto na disponibilidade do runtime do recurso.
Nome
Um nome descritivo para o recurso dos serviços cognitivos. Por exemplo, MyCognitiveServicesResource.
Escalão de preço
O custo da sua conta dos Serviços Cognitivos depende das opções que escolher e da utilização. Para obter mais informações, veja os detalhes dos preços da API.
Marque a sua confirmação dos termos de IA Responsável e selecione Rever + criar.
Selecione a seguinte ligação para criar um recurso do LUIS:
Na página Criar , forneça as seguintes informações:
Detalhes do projeto
Description
Criar opções
O LUIS utiliza dois recursos separados em conjunto. O recurso Criação permite-lhe preparar modelos e o recurso Prediction permite-lhe publicar e consultar modelos. Selecione Ambos se estiver a iniciar o projeto do zero.
Subscrição
Selecione uma das suas subscrições do Azure disponíveis.
Grupo de recursos
O grupo de recursos do Azure que irá conter o recurso dos Serviços Cognitivos. Pode criar um novo grupo ou adicioná-lo a um grupo pré-existente.
Nome
Um nome descritivo para o recurso dos serviços cognitivos. Por exemplo, MyCognitiveServicesResource.
Criar Região de Recursos
A localização do recurso de Criação. Diferentes localizações podem introduzir latência, mas não têm impacto na disponibilidade do runtime do recurso.
Escalão de preço de criação
O custo da sua conta dos Serviços Cognitivos depende das opções que escolher e da utilização. Para obter mais informações, veja os detalhes dos preços da API.
Região do Recurso de Predição
A localização do recurso prediction. Diferentes localizações podem introduzir latência, mas não têm impacto na disponibilidade do runtime do recurso.
Escalão de preço de predição
O custo da sua conta dos Serviços Cognitivos depende das opções que escolher e da utilização. Para obter mais informações, veja os detalhes dos preços da API.
Selecione Rever + criar.
Selecione a seguinte ligação para criar um recurso do Translator:
Na página Criar , forneça as seguintes informações:
Detalhes do projeto
Descrição
Subscrição
Selecione uma das suas subscrições do Azure disponíveis.
Grupo de recursos
O grupo de recursos do Azure que irá conter o recurso dos Serviços Cognitivos. Pode criar um novo grupo ou adicioná-lo a um grupo pré-existente.
Região
A localização da instância do serviço cognitivo. Diferentes localizações podem introduzir latência, mas não têm impacto na disponibilidade do runtime do recurso.
Nome
Um nome descritivo para o recurso dos serviços cognitivos. Por exemplo, MyCognitiveServicesResource.
Escalão de preço
O custo da sua conta dos Serviços Cognitivos depende das opções que escolher e da utilização. Para obter mais informações, veja os detalhes dos preços da API.
Selecione Rever + criar.
Selecione a seguinte ligação para criar um recurso do Criador de FAQ:
Na página Criar , forneça as seguintes informações:
Detalhes do projeto
Descrição
Subscrição
Selecione uma das suas subscrições do Azure disponíveis.
Grupo de recursos
O grupo de recursos do Azure que irá conter o recurso dos Serviços Cognitivos. Pode criar um novo grupo ou adicioná-lo a um grupo pré-existente.
Nome
Um nome descritivo para o recurso dos serviços cognitivos. Por exemplo, MyCognitiveServicesResource.
Escalão de preço
O custo da sua conta dos Serviços Cognitivos depende das opções que escolher e da utilização. Para obter mais informações, veja os detalhes dos preços da API.
Localização do Azure Search
A localização da instância do Azure Search que irá utilizar o recurso do Criador de FAQ. Diferentes localizações podem introduzir latência, mas não têm impacto na disponibilidade do runtime do recurso.
Escalão de preço do Azure Search
O custo da sua conta dos Serviços Cognitivos depende das opções que escolher e da utilização. Para obter mais informações, veja os detalhes de preços do Cognitive Search.
Nome da aplicação
Introduza um nome para a aplicação Serviço de Aplicações que irá processar as suas consultas do Criador de FAQ.
Localização do site
A localização da instância Serviço de Aplicações que irá utilizar o recurso do Criador de FAQ. Diferentes localizações podem introduzir latência, mas não têm impacto na disponibilidade do runtime do recurso.
Informações da aplicação
Escolha se pretende utilizar um recurso do Application Insights em conjunto com o recurso do Criador de FAQ.
Localização do App Insights
Diferentes localizações podem introduzir latência, mas não têm impacto na disponibilidade do runtime do recurso.
Selecione Rever + criar.
Selecione as seguintes ligações para criar um recurso de Voz:
Na página Criar , forneça as seguintes informações:
Detalhes do projeto
Descrição
Subscrição
Selecione uma das suas subscrições do Azure disponíveis.
Grupo de recursos
O grupo de recursos do Azure que irá conter o recurso dos Serviços Cognitivos. Pode criar um novo grupo ou adicioná-lo a um grupo pré-existente.
Região
A localização da instância do serviço cognitivo. Diferentes localizações podem introduzir latência, mas não têm impacto na disponibilidade do runtime do recurso.
Nome
Um nome descritivo para o recurso dos serviços cognitivos. Por exemplo, MyCognitiveServicesResource.
Escalão de preço
O custo da sua conta dos Serviços Cognitivos depende das opções que escolher e da utilização. Para obter mais informações, veja os detalhes dos preços da API.
Na página Criar , forneça as seguintes informações:
Detalhes do projeto
Descrição
Subscrição
Selecione uma das suas subscrições do Azure disponíveis.
Grupo de recursos
O grupo de recursos do Azure que irá conter o recurso dos Serviços Cognitivos. Pode criar um novo grupo ou adicioná-lo a um grupo pré-existente.
Região
A localização da instância do serviço cognitivo. Diferentes localizações podem introduzir latência, mas não têm impacto na disponibilidade do runtime do recurso.
Nome
Um nome descritivo para o recurso dos serviços cognitivos. Por exemplo, MyCognitiveServicesResource.
Escalão de preço
O custo da sua conta dos Serviços Cognitivos depende das opções que escolher e da utilização. Para obter mais informações, veja os detalhes dos preços da API.
Marque a sua confirmação dos termos de IA Responsável e, em seguida, selecione Rever + criar.
Selecione a seguinte ligação para criar um recurso Face:
Na página Criar , forneça as seguintes informações:
Detalhes do projeto
Descrição
Subscrição
Selecione uma das suas subscrições do Azure disponíveis.
Grupo de recursos
O grupo de recursos do Azure que irá conter o recurso dos Serviços Cognitivos. Pode criar um novo grupo ou adicioná-lo a um grupo pré-existente.
Região
A localização da instância do serviço cognitivo. Diferentes localizações podem introduzir latência, mas não têm impacto na disponibilidade do runtime do recurso.
Nome
Um nome descritivo para o recurso dos serviços cognitivos. Por exemplo, MyCognitiveServicesResource.
Escalão de preço
O custo da sua conta dos Serviços Cognitivos depende das opções que escolher e da utilização. Para obter mais informações, veja os detalhes dos preços da API.
Marque a sua confirmação dos termos de utilização do Face e, em seguida, selecione Rever + criar.
Selecione a seguinte ligação para criar um recurso Visão Personalizada:
Na página Criar , forneça as seguintes informações:
Detalhes do projeto
Description
Criar opções
Visão Personalizada utiliza dois recursos separados em conjunto. O recurso Preparação permite-lhe preparar modelos e o recurso Prediction permite-lhe publicar e consultar modelos. Selecione Ambos se estiver a iniciar o projeto do zero.
Subscrição
Selecione uma das suas subscrições do Azure disponíveis.
Grupo de recursos
O grupo de recursos do Azure que contém o recurso dos Serviços Cognitivos. Pode criar um novo grupo ou adicioná-lo a um grupo pré-existente.
Região
A localização da instância do serviço cognitivo. Diferentes localizações podem introduzir latência, mas não têm impacto na disponibilidade do runtime do recurso.
Nome
Um nome descritivo para o recurso dos serviços cognitivos. Por exemplo, MyCognitiveServicesResource.
Escalão de preço de preparação
O custo da sua conta dos Serviços Cognitivos depende das opções que escolher e da utilização. Para obter mais informações, veja os detalhes dos preços da API.
Escalão de preço de predição
O custo da sua conta dos Serviços Cognitivos depende das opções que escolher e da utilização. Para obter mais informações, veja os detalhes dos preços da API.
Selecione Rever + criar.
Selecione a seguinte ligação para criar um recurso Reconhecedor de Formulários:
Na página Criar , forneça as seguintes informações:
Detalhes do projeto
Descrição
Subscrição
Selecione uma das suas subscrições do Azure disponíveis.
Grupo de recursos
Selecione o grupo de recursos do Azure que contém o recurso dos Serviços Cognitivos. Pode criar um novo grupo ou adicioná-lo a um grupo pré-existente.
Região
A localização da instância do serviço cognitivo. Diferentes localizações podem introduzir latência, mas não têm impacto na disponibilidade do runtime do recurso.
Nome
Um nome descritivo para o recurso dos serviços cognitivos. Por exemplo, MyCognitiveServicesResource.
Se a sua subscrição não permitir a criação de um recurso do Serviço Cognitivo, poderá ter de ativar o privilégio desse fornecedor de recursos do Azure com 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 uma função de administrador para concluir o registo por si ou peça que os privilégios /register/action sejam concedidos à sua conta.
Obter as chaves do recurso
Depois de o recurso ser implementado com êxito, selecione Passos> SeguintesIr para recurso.
No painel de início rápido que é aberto, pode aceder ao ponto final do recurso e gerir chaves.
Configurar uma variável de ambiente para autenticação
A sua aplicação tem de ser autenticada para aceder aos recursos dos Serviços Cognitivos. Para produção, utilize uma forma segura de armazenar e aceder às suas credenciais. Por exemplo, depois de ter uma chave para o recurso, escreva-a numa nova variável de ambiente no computador local que executa a aplicação.
Dica
Não inclua a chave diretamente no seu código e nunca a publique publicamente. Veja o artigo Segurança dos Serviços Cognitivos para obter mais opções de autenticação, como o Azure Key Vault.
Para definir a variável de ambiente para a chave de recurso, abra uma janela da consola e siga as instruções para o seu sistema operativo e ambiente de desenvolvimento. Para definir a COGNITIVE_SERVICE_KEY variável de ambiente, substitua por your-key uma das chaves do recurso.
Se apenas precisar de aceder à variável de ambiente na consola de execução atual, pode definir a variável de ambiente com set em vez de setx.
Depois de adicionar a variável de ambiente, poderá ter de reiniciar quaisquer consolas em execução ou outros programas que precisem de ler a variável de ambiente. Por exemplo, se estiver a utilizar o Visual Studio como editor, reinicie o Visual Studio antes de executar o exemplo.
export COGNITIVE_SERVICE_KEY=your-key
Depois de adicionar a variável de ambiente, execute source ~/.bashrc a partir da janela da consola para que as alterações entrem em vigor.
Bash
Edite o seu .bash_profile e adicione a variável de ambiente:
export COGNITIVE_SERVICE_KEY=your-key
Depois de adicionar a variável de ambiente, execute source ~/.bash_profile a partir da janela da consola para que as alterações entrem em vigor.
Xcode
Para desenvolvimento de iOS e macOS, defina as variáveis de ambiente no Xcode. Por exemplo, siga estes passos para definir a variável de ambiente no Xcode 13.4.1.
SelecionarEsquema de Edição do Esquema de>Produtos>
Selecionar Argumentos na página Executar (Execução de Depuração)
Em Variáveis de Ambiente , selecione o sinal de adição (+) para adicionar uma nova variável de ambiente.
Introduza COGNITIVE_SERVICE_KEY para o Nome e introduza a sua chave de recurso para o Valor.
Para definir a variável de ambiente para a região do recurso de Voz, siga os mesmos passos. Defina COGNITIVE_SERVICE_REGION como a região do recurso. Por exemplo, westus.
Limpar os recursos
Se quiser limpar e remover uma subscrição dos Serviços Cognitivos, pode eliminar o recurso ou grupo de recursos. Eliminar o grupo de recursos também elimina quaisquer outros recursos contidos no grupo.
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.
Localize o grupo de recursos que contém o recurso a eliminar.
Se quiser eliminar todo o grupo de recursos, selecione o nome do grupo de recursos. Na página seguinte, selecione Eliminar grupo de recursos e confirme.
Se quiser eliminar apenas o recurso do Serviço Cognitivo, selecione o grupo de recursos para ver todos os recursos dentro do mesmo. Na página seguinte, selecione o recurso que pretende eliminar, selecione o menu de reticências dessa linha e selecione Eliminar.
