Créer une ressource de bot Azure
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 se trouvent, de votre application ou de votre site web à Teams, Messenger et de nombreux autres canaux. 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 .
Cet article explique comment créer une ressource de bot via le Portail Azure. Pour plus d’informations sur la création d’une ressource de bot via Azure CLI, découvrez comment déployer votre bot dans Azure.
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 pour C# et JavaScript au Kit de développement logiciel (SDK) Bot Framework 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, les Composer, les Emulator 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
Les types de ressources Azure Web App Bot et Bot Channels Registration sont déconseillés. Les ressources configurées et déployées avant la dépréciation 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.
Accédez au portail Azure.
Dans le volet droit, sélectionnez Créer une ressource.
Dans la zone de recherche, entrez
bot, puis appuyez sur Entrée.Sélectionnez la carte Azure Bot .
Sélectionnez Create (Créer).
Entrez des valeurs dans les champs obligatoires. Choisissez le type d’application à créer et s’il faut utiliser des informations d’identité existantes ou créer de nouvelles informations d’identité.
Sélectionnez Revoir + créer.
Si la validation réussit, sélectionnez Créer.
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é.
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.
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. |
Si vous disposez d’une ressource d’application web existante 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 l’application web de votre bot :
- Accédez au panneau App Service pour l’application web de votre bot.
- Sous Paramètres, sélectionnez Identité.
- Dans le panneau Identité , sélectionnez l’onglet Affecté par l’utilisateur et Ajoutez (+).
- Dans le panneau Ajouter une 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’ID d’application ou de locataire de votre bot :
- Accédez au panneau des ressources Azure Bot pour votre bot.
- 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.
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 d’application web 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, en regard de l’ID d’application Microsoft, pour accéder au panneau Certificats + secrets de l’application web.
- 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
- Pour plus d’informations sur la gestion des identités avec Azure Active Directory, consultez Qu’est-ce que Azure Active Directory ?.
- Pour plus d’informations sur les plans Azure App Service et App Service, consultez la vue d’ensemble des 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.
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.