Démarrage rapide : Créer un compte Cognitive Services dans le portail Azure

  • Article
  • 15 minutes de lecture

Utilisez ce démarrage rapide pour créer une ressource Cognitive Services. Après avoir créé une ressource Cognitive Services dans le portail Azure, vous obtenez un point de terminaison et une clé pour authentifier vos applications.

La solution Azure Cognitive Services est une variété de services cloud d’intelligence artificielle (IA) qui aident les développeurs à intégrer une intelligence cognitive dans des applications sans connaissances ni compétences directes en IA ou en science des données. Ils sont disponibles via les API REST et les Kits de développement logiciel (SDK) de bibliothèque de client dans des langages de développement populaires. Azure Cognitive Services permet aux développeurs d’ajouter facilement des fonctionnalités cognitives dans leurs applications à l’aide de solutions cognitives capables de voir, entendre, parler et analyser.

Types de ressources Cognitive Services

Vous pouvez accéder à Azure Cognitive Services via deux ressources différentes : Une ressource multiservice ou une ressource monoservice.

  • Ressource multiservice :
    • Accédez à plusieurs services cognitifs Azure avec une seule clé et un seul point de terminaison.
    • Regroupe la facturation des services que vous utilisez.
  • Ressource monoservice :
    • Accédez à un seul service cognitif Azure avec une clé et un point de terminaison uniques pour chaque service créé.
    • Utilisez le niveau gratuit pour tester le service.

Prérequis

  • Un abonnement Azure valide - Créer un abonnement gratuitement
  • Un rôle Contributeur Cognitive Services doit être affecté à votre compte Azure pour que vous puissiez accepter les conditions d’utilisation de l’IA et créer une ressource. Pour que ce rôle soit attribué à votre compte, suivez les étapes de la documentation Attribuer des rôles ou contactez votre administrateur.

Créer une ressource Azure Cognitive Services

La ressource multiservice est nommée Cognitive Services dans le portail. La ressource multiservice permet d’accéder aux services Cognitive Services suivants :

  • Décision - Content Moderator
  • Langue – Langue, Traducteur
  • Speech – Speech
  • Vision – Vision par ordinateur, Custom vision, Form Recognizer, Visage

  1. Vous pouvez sélectionner ce lien pour créer une ressource multi-service Azure Cognitive Services : Créer une ressource Cognitive Services.

  2. Sur la page Créer, renseignez les informations suivantes :

    Détails du projet Description
    Abonnement Sélectionnez l’un de vos abonnements Azure disponibles.
    Groupe de ressources Groupe de ressources Azure comprenant votre ressource Cognitive Services. Vous pouvez créer un groupe ou l’ajouter à un groupe préexistant.
    Région Emplacement de votre instance Cognitive Services. Des emplacements différents peuvent entraîner une latence. Toutefois, cela n’aura pas d’impact sur la disponibilité d’exécution de votre ressource.
    Nom Nom descriptif de votre ressource Cognitive Services. Par exemple, MyCognitiveServicesResource.
    Niveau tarifaire Le coût associé à votre compte Cognitive Services dépend des options que vous choisissez, ainsi que de votre utilisation. Pour plus d'informations, consultez le détail des tarifs de l’API.

    Écran de création de ressource multiservice

  3. Configurez d’autres paramètres pour votre ressource en fonction des besoins, lisez et acceptez les conditions (le cas échéant), puis sélectionnez Vérifier + créer.

Conseil

Si votre abonnement ne vous permet pas de créer une ressource Cognitive Services, vous devrez peut-être activer le privilège de ce fournisseur de ressources Azure avec le Portail Azure, une commande PowerShell ou une commande Azure CLI. Si vous n’êtes pas le propriétaire de l’abonnement, demandez au propriétaire de l’abonnement ou à une personne disposant d’un rôle d’administrateur de terminer l’inscription à votre place ou demandez à ce que les privilèges /register/action soient accordés à votre compte.

Obtenir les clés pour votre ressource

  1. Une fois votre ressource correctement déployée, sélectionnez Étapes suivantes>Accéder à la ressource.

    Peut répertorier les clés de ressource

  2. Dans le volet de démarrage rapide qui s’ouvre, vous pouvez accéder au point de terminaison des ressources et gérer les clés.

Configurer une variable d’environnement pour l’authentification

Votre application doit être authentifiée pour accéder aux ressources Cognitive Services. Pour la production, utilisez une méthode de stockage et d’accès sécurisée pour vos informations d’identification. Par exemple, après avoir obtenu une clé pour votre ressource, écrivez-la dans une nouvelle variable d’environnement sur l’ordinateur local qui exécute l’application.

Conseil

N’incluez pas la clé directement dans votre code et ne la publiez jamais publiquement. Pour découvrir d’autres options d’authentification comme Azure Key Vault, consultez l’article sur la sécurité de Cognitive Services.

Pour définir la variable d’environnement de votre clé de ressource, ouvrez une fenêtre de console et suivez les instructions relatives à votre système d’exploitation et à votre environnement de développement. Pour définir la variable d’environnement COGNITIVE_SERVICE_KEY, remplacez your-key par l’une des clés de votre ressource.

setx COGNITIVE_SERVICE_KEY your-key

Notes

Si vous avez uniquement besoin d’accéder à la variable d’environnement dans la console en cours d’exécution, vous pouvez la définir avec set au lieu de setx.

Après avoir ajouté la variable d’environnement, vous devrez peut-être redémarrer l’ensemble des consoles et des programmes en cours d’exécution qui devront la lire. Par exemple, si vous utilisez Visual Studio comme éditeur, redémarrez Visual Studio avant d’exécuter l’exemple.

Pour définir la variable d’environnement de la région de votre ressource Speech, suivez les mêmes étapes. Définissez COGNITIVE_SERVICE_REGION sur la région de votre ressource. Par exemple : westus.

Nettoyer les ressources

Si vous souhaitez nettoyer et supprimer un abonnement Cognitive Services, vous pouvez supprimer la ressource ou le groupe de ressources. La suppression du groupe de ressources supprime également toutes les autres ressources se trouvant dans le groupe.

  1. Sur le portail Azure, développez le menu de gauche pour ouvrir le menu des services, et sélectionnez Groupes de ressources pour afficher la liste de vos groupes de ressources.
  2. Localisez le groupe de ressources contenant la ressource à supprimer.
  3. Si vous souhaitez supprimer l’intégralité du groupe de ressources, sélectionnez son nom. Dans la page suivante, sélectionnez Supprimer le groupe de ressources et confirmez.
  4. Si vous souhaitez supprimer uniquement la ressource Cognitive Services, sélectionnez le groupe de ressources pour afficher toutes les ressources qu’il contient. Dans la page suivante, sélectionnez la ressource à supprimer, cliquez sur le menu des points de suspension pour cette ligne, puis sélectionnez Supprimer.

Si vous devez récupérer une ressource supprimée, consultez Récupérer des ressources Cognitive Services supprimées.

Voir aussi