Utiliser le portail Azure pour créer une ressource Azure Bot
S'APPLIQUE À : SDK v4
La ressource Azure Bot (ressource de bot) vous permet d'inscrire votre bot auprès d'Azure AI Bot Service et de le connecter aux canaux. Vous pouvez créer, connecter et gérer des bots pour interagir avec vos utilisateurs où qu'ils se trouvent, à partir de votre application ou de votre site Web vers Teams, Messenger et de nombreux autres canaux.
Cet article explique comment créer une ressource bot à l'aide du portail Azure.
- Pour savoir comment créer un bot, consultez le guide de démarrage rapide Créer un bot avec le kit de développement logiciel (SDK) Bot Framework.
- Pour plus d'informations sur l'approvisionnement et la publication d'un bot sur Azure, consultez comment Déployer votre bot dans 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 manière dont vous décidez de gérer l'identité de votre bot.
L'identité de votre bot peut être gérée dans Azure de différentes manières.
- S'il s'agit d'une identité managée affectée par l'utilisateur, vous n'avez pas besoin de gérer vous-même les informations d'identification du bot.
- S'il s'agit d'une application à locataire unique.
- S'il s'agit d'une application multilocataire.
La prise en charge de l'identité managée affectée par l'utilisateur et des types d'applications à locataire unique 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 langages ou dans Bot Framework Composer, Bot Framework Emulator ou ngrok.
| Type d’application | Support |
|---|---|
| Identité managée affectée par l’utilisateur | Azure AI Bot Service et les kits de développement logiciel (SDK) C# et JavaScript |
| Locataire unique | Azure AI Bot Service et les kits de développement logiciel (SDK) C# et JavaScript |
| Multilocataire | Azure AI 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 version ultérieure, pour l'identité managée affectée par l'utilisateur et les bots à locataire unique.
Créer la ressource
Créez la ressource Azure Bot, qui vous permettra d'inscrire votre bot auprès du Azure AI Bot Service.
Conseil
De nouvelles ressources de bot d'application Web et d'inscription de canaux bot ne peuvent pas être créées. Cependant, toutes les ressources existantes configurées et déployées continueront à fonctionner. Les bots créés à partir d'un modèle VSIX ou Yeoman à partir du kit de développement logiciel (SDK) version 4.14.1.2 ou ultérieure contiennent des modèles ARM qui généreront une ressource Azure Bot.
Accédez au portail Azure.
Dans le volet de droite, sélectionnez Créer une ressource.
Dans la zone de recherche, saisissez
bot, et appuyez sur Entrée.Sélectionnez la carte Azure Bot.
Sélectionnez Créer.
Saisissez des valeurs dans les champs obligatoires, puis révisez et mettez à jour les paramètres.
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 locale est disponible pour les ressources de la région « westeurope » et « centralindia ». Pour plus d'informations, consultez la rubrique Régionalisation dans Azure AI Bot Service.
Fournissez des informations sous ID d'application Microsoft. Sélectionnez comment l'identité de votre bot sera gérée dans Azure et si vous souhaitez créer une nouvelle identité ou utiliser une identité existante.
Sélectionnez Vérifier + Créer.
Si la validation est réussie, sélectionnez Créer.
Une fois le déploiement terminé, sélectionnez Accéder à la ressource. Vous devez consultez le bot et les ressources associées répertoriées dans le groupe de ressources que vous avez sélectionné.
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 langage préféré.
Vous êtes désormais prêt à créer votre bot avec le kit de développement logiciel (SDK) Bot Framework.
Conseil
Lorsqu'Azure crée une nouvelle ressource Azure Bot à locataire unique ou multilocataire avec un nouvel identifiant 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 gérer l'identité du bot.
| Langage | Nom de fichier | Notes |
|---|---|---|
| C# | appsettings.json | Prend en charge les trois types d'applications pour gérer l'identité de votre bot. |
| JavaScript | .env | Prend en charge les trois types d'applications pour gérer 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 méthode os.environ.get. |
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 :
Uniquement disponible 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 cette valeur vide pour un bot d'identité managée affecté par l'utilisateur. |
MicrosoftAppTenantId |
L'identifiant du locataire de l'identité managée affectée par l'utilisateur. |
Pour mettre à jour votre service d'application
Si vous disposez d'une ressource App Service existante (application Web) pour votre bot et que ce dernier 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 :
- Accédez au panneau App Service de l'application Web de votre bot.
- Sous Paramètres, sélectionnez Identité.
- Sous l'onglet Identité, sélectionnez Affecté par l'utilisateur, puis + Ajouter.
- Sur le panneau Ajouter l'identité managée affectée par l'utilisateur :
Sélectionnez votre abonnement.
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.
Sélectionnez Ajouter pour utiliser cette identité pour votre bot.
Pour obtenir l'identifiant de locataire ou d'application
Pour obtenir l'identifiant de l'application ou du locataire de votre bot :
- Accédez au panneau des ressources Azure Bot pour votre bot.
- Accédez au panneau Configuration du bot. Dans ce panneau, vous pouvez copier l'ID d'application Microsoft ou l'identifiant du locataire d'application du bot.
Pour générer un nouveau mot de passe
Les bots à locataire unique et à plusieurs locataires disposent d'un secret d'application ou d'un mot de passe dont vous avez besoin pour certaines opérations. Azure AI Bot Service masque votre secret de bot. Toutefois, le propriétaire de la ressource App Service du bot peut générer un nouveau mot de passe :
- Accédez au panneau des ressources Azure Bot pour votre bot.
- Accédez au panneau Configuration du bot.
- Sélectionnez Gérer, à côté de l'ID d'application Microsoft, pour accéder au panneau Certificats + secrets du service d'application.
- Suivez les instructions du panneau pour créer une clé secrète client et enregistrer la valeur dans un lieu sûr.
Informations supplémentaires
- Pour plus d'informations sur la gestion des identités avec l'ID Microsoft Entra, consultez Qu'est-ce que l'ID Microsoft Entra ?.
- Pour plus d'informations sur Azure App Service et les plans App Service, consultez la vue d'ensemble d'App Service.
- Pour plus d'informations sur les ressources Azure et leur gestion en général, consultez la vue d'ensemble d'Azure Resource Manager.
Remarque
Bot Framework Composer et Bot Framework Emulator prennent actuellement uniquement en charge les bots multilocataires. Kit de développement logiciel (SDK) Bot Framework pour C# ou JavaScript version 4.15.0 ou ultérieure est nécessaire pour l'identité managée affectée par l'utilisateur et les bots à locataire unique.
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 en matière d'identité managée affectée par l'utilisateur | |
|---|---|---|---|
| Consommateur multilocataire | Prise en charge | Non pris en charge | Non pris en charge |
| Consommateur d'un locataire unique | 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.