Utiliser le Portail Azure pour créer une ressource Azure Bot

S’APPLIQUE À : Kit de développement logiciel (SDK) v4

La ressource Azure Bot (ressource bot) vous permet d’inscrire votre bot auprès d’Azure Bot Services et de connecter votre bot à des canaux. Vous pouvez créer, connecter et gérer des bots pour interagir avec vos utilisateurs où qu’ils soient, de votre application ou de votre site web vers Teams, Messenger et de nombreux autres canaux.

Cet article explique comment créer une ressource de bot via le Portail Azure.

Gestion des ressources

Lorsque vous créez une ressource de bot, Azure crée des ressources associées. Certaines des ressources créées dépendent de la façon dont vous décidez de gérer l’identité de votre bot.

Votre identité de bot peut être gérée dans Azure de différentes façons.

  • En tant qu’identité managée affectée par l’utilisateur, vous n’avez donc pas besoin de gérer vous-même les informations d’identification du bot.
  • En tant qu’application monolocataire .
  • En tant qu’application mutualisée .

La prise en charge de l’identité managée affectée par l’utilisateur et des types d’applications monolocataires a été ajoutée au Kit de développement logiciel (SDK) Bot Framework pour C# et JavaScript dans la version 4.15.0. Ces types d’application ne sont pas pris en charge dans les autres langues ou dans Bot Framework Composer, Bot Framework Emulator ou ngrok.

Type d’application Support
Identité managée affectée par l’utilisateur Kits de développement logiciel (SDK) Azure Bot Service et C# et JavaScript
Monolocataire Kits de développement logiciel (SDK) Azure Bot Service et C# et JavaScript
Multi-locataire Azure Bot Service, tous les langages du Kit de développement logiciel (SDK) Bot Framework, Composer, l’émulateur et ngrok

Prérequis

  • Si vous n’avez pas d’abonnement Azure, créez un compte gratuit avant de commencer.
  • Kit de développement logiciel (SDK) Bot Framework pour C# ou JavaScript version 4.15.0 ou ultérieure, pour l’identité managée affectée par l’utilisateur et les bots monolocataires.

Créer la ressource

Créez la ressource Azure Bot, qui vous permettra d’inscrire votre bot auprès d’Azure Bot Service.

Conseil

Vous ne pouvez pas créer de ressources d’inscription de bots et de bots Web App Bot; toutefois, toutes les ressources existantes configurées et déployées continueront de fonctionner. Les bots créés à partir d’un modèle VSIX ou Yeoman à partir du SDK version 4.14.1.2 ou ultérieure contiennent des modèles ARM qui génèrent une ressource Azure Bot.

  1. Accédez au portail Azure.

  2. Dans le volet droit, sélectionnez Créer une ressource.

  3. Dans la zone de recherche, entrez bot, puis appuyez sur Entrée.

  4. Sélectionnez la carte Azure Bot .

    Sélectionner une ressource de bot Azure

  5. Sélectionnez Create (Créer).

  6. Entrez des valeurs dans les champs obligatoires et passez en revue et mettez à jour les paramètres.

    1. Fournissez des informations sous Détails du projet. Indiquez si votre bot aura une résidence globale ou locale des données. Actuellement, la fonctionnalité de résidence des données locales est disponible uniquement pour les ressources de la région « westeurope ». Pour plus d’informations, consultez Régionalisation dans Azure Bot Service.

      Paramètres des détails du projet pour une ressource Azure Bot

    2. Fournissez des informations sous l’ID d’application Microsoft. Sélectionnez la façon dont votre identité de bot sera gérée dans Azure et indiquez si vous souhaitez créer une identité ou utiliser une identité existante.

      Paramètres d’ID d’application Microsoft pour une ressource Azure Bot

  7. Sélectionnez Revoir + créer.

  8. Si la validation réussit, sélectionnez Créer.

  9. Une fois le déploiement terminé, sélectionnez Accéder à la ressource. Vous devez voir le bot et les ressources associées répertoriées dans le groupe de ressources que vous avez sélectionné.

  10. Si vous n’avez pas encore le Kit de développement logiciel (SDK) Bot Framework, sélectionnez Télécharger à partir de GitHub pour apprendre à utiliser les packages pour votre langue préférée.

    Créer un bot dans le Kit de développement logiciel (SDK)

Vous êtes maintenant prêt à créer votre bot avec le Kit de développement logiciel (SDK) Bot Framework.

Conseil

Quand Azure crée une ressource Azure Bot monolocataire ou mutualisée avec un nouvel ID d’application, elle génère également un mot de passe.

Informations sur l’identité du bot

Suivez ces étapes pour ajouter des informations d’identité au fichier de configuration de votre bot. Le fichier diffère selon le langage de programmation que vous utilisez pour créer le bot.

Important

Les versions Java et Python du Kit de développement logiciel (SDK) Bot Framework prennent uniquement en charge les bots multilocataires. Les versions C# et JavaScript prennent en charge les trois types d’applications pour la gestion de l’identité du bot.

Language Nom de fichier Notes
C# appsettings.json Prend en charge les trois types d’applications pour la gestion de l’identité de votre bot.
JavaScript .env Prend en charge les trois types d’applications pour la gestion de l’identité de votre bot.
Java application.properties Prend uniquement en charge les bots multilocataires.
Python config.py Prend uniquement en charge les bots multilocataires. Fournissez les propriétés d’identité en tant qu’arguments aux appels de os.environ.get méthode.

Les informations d’identité que vous devez ajouter dépendent du type d’application du bot. Fournissez les valeurs suivantes dans votre fichier de configuration.

Disponible uniquement pour les bots C# et JavaScript.

Propriété Valeur
MicrosoftAppType UserAssignedMSI
MicrosoftAppId ID client de l’identité managée affectée par l’utilisateur.
MicrosoftAppPassword Non applicable. Laissez ce champ vide pour un bot d’identité managée affectée par l’utilisateur.
MicrosoftAppTenantId ID de locataire de l’identité managée affectée par l’utilisateur.

Pour mettre à jour votre service d’application

Si vous disposez d’une ressource de App Service existante (application web) pour votre bot et que votre bot est une application d’identité managée affectée par l’utilisateur, vous devrez peut-être mettre à jour le service d’application de votre bot :

  1. Accédez au panneau App Service pour l’application web de votre bot.
  2. Sous Paramètres, sélectionnez Identité.
  3. Dans le panneau Identité , sélectionnez l’onglet Affecté par l’utilisateur et Ajoutez (+).
  4. Dans le panneau Ajouter une identité managée affectée par l’utilisateur :
    1. Sélectionnez votre abonnement.

    2. Pour les identités managées affectées par l’utilisateur, sélectionnez l’identité managée pour votre bot. Si l’identité managée a été générée automatiquement pour vous, elle aura le même nom que votre bot.

    3. Sélectionnez Ajouter pour utiliser cette identité pour votre bot.

      Panneau App Service Identité avec l’identité managée pour le bot sélectionné.

Pour obtenir votre application ou VOTRE ID de locataire

Pour obtenir l’ID d’application ou de locataire de votre bot :

  1. Accédez au panneau des ressources Azure Bot pour votre bot.
  2. Accédez au panneau Configuration du bot. À partir de ce panneau, vous pouvez copier l’ID d’application Microsoft du bot ou l’ID de locataire d’application.

Pour générer un nouveau mot de passe

Les bots monolocataires et multilocataires ont un secret d’application ou un mot de passe dont vous avez besoin pour certaines opérations. Azure Bot Service masque le secret de votre bot. Toutefois, le propriétaire de la ressource App Service du bot peut générer un nouveau mot de passe :

  1. Accédez au panneau des ressources Azure Bot pour votre bot.
  2. Accédez au panneau Configuration du bot.
  3. Sélectionnez Gérer, en regard de l’ID d’application Microsoft, pour accéder au panneau Certificats + secrets du service d’application.
  4. Suivez les instructions du panneau pour créer une clé secrète client et enregistrer la valeur dans un endroit sûr.

Informations supplémentaires

Notes

Actuellement, les Bot Framework Composer et les Bot Framework Emulator prennent uniquement en charge les bots multilocataires. Le Kit de développement logiciel (SDK) Bot Framework pour C# ou JavaScript version 4.15.0 ou ultérieure est requis pour les bots à locataire unique et d’identité managée attribuées par l’utilisateur.

Prise en charge des compétences

Certains types de consommateurs de compétences ne peuvent pas utiliser certains types de bots de compétence. Le tableau suivant décrit les combinaisons prises en charge.

  Compétence multilocataire Compétence monolocataire Compétence d’identité managée affectée par l’utilisateur
Consommateur multilocataire Pris en charge Non pris en charge Non pris en charge
Consommateur monolocataire Non pris en charge Pris en charge si les deux applications appartiennent au même locataire Pris en charge si les deux applications appartiennent au même locataire
Consommateur d’identité managée affectée par l’utilisateur Non pris en charge Pris en charge si les deux applications appartiennent au même locataire Pris en charge si les deux applications appartiennent au même locataire

Pour plus d’informations sur la configuration d’une compétence ou d’un consommateur de compétences, consultez Implémenter une compétence ou Implémenter un consommateur de compétences.

Étapes suivantes