Créer une ressource de robot AzureCreate an Azure Bot resource

s’applique à : SDK v4APPLIES TO: SDK v4

La ressource Azure bot vous permet d’inscrire votre bot auprès du Azure bot service.The Azure Bot resource allows you to register your bot with the Azure Bot Service. vous pouvez créer, connecter et gérer des robots 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.You can build, connect, and manage bots to interact with your users wherever they are, from your app or website to Teams, Messenger and many other channels. Pour savoir comment créer un bot, consultez l’article de démarrage rapide applicable à votre langage de programmation.To learn how to create a bot, see the quick start article applicable to your programming language.

Conseil

Si vous débutez dans le développement de bot, nous vous recommandons d’utiliser bot Framework composer.If you're new to bot development, we recommend using the Bot Framework Composer. Vous pouvez continuer à utiliser le kit de développement logiciel (SDK) pour les robots que vous avez déjà créés.You can keep using the SDK for those bots you have already created. Toutefois, nous vous recommandons d’utiliser composer pour un nouveau développement.However, we recommend the use of Composer for new development.

PrérequisPrerequisites

Créer la ressourceCreate the resource

Créez la ressource Azure bot , ce qui vous permettra d’inscrire votre robot auprès du Azure bot service.Create the Azure Bot resource, which will allow you to register your bot with the Azure Bot Service.

Avertissement

L’inscription des canaux bot et bot de l' application Web sera déconseillée, mais les ressources existantes continueront à fonctionner.Web App Bot and Bot Channels Registration will be deprecated but existing resources will continue to work. Vous devez utiliser Azure bot à la place.You should use Azure Bot, instead.

  1. Accédez au portail Azure.Go to the Azure portal.

  2. Dans le volet droit, sélectionnez créer une ressource.In the right pane, select Create a resource.

  3. Dans la zone de recherche, entrez bot, puis appuyez sur entrée.In the search box enter bot, then press Enter.

  4. Sélectionnez la carte du robot Azure .Select the Azure Bot card.

    Sélectionner une ressource de robot Azure

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

    Créer une ressource de robot Azure

  6. Entrez les valeurs requises.Enter the required values. L’illustration suivante montre l’option créer un nouvel ID d’application Microsoft sélectionnée.The following figure shows Create new Microsoft App ID selected.

    Créer des valeurs de ressource de robot Azure

    Vous pouvez également sélectionner utiliser l’inscription d’application existante et entrer votre ID d’application et votre mot de passe existants.You can also select Use existing app registration and enter your existing app Id and password.

    Créer une ressource de robot Azure valeurs existantes

  7. Sélectionnez Revoir + créer.Select Review + create.

  8. Si la validation réussit, sélectionnez créer.If the validation passes, select Create.

  9. Sélectionnez Accéder au groupe de ressources.Select Go to resource group. Vous devez voir le bot et les ressources de Azure Key Vault associées dans le groupe de ressources que vous avez sélectionné.You should see the bot and the related Azure Key Vault resources listed in the resource group you selected.

    Conseil

    La clé secrète de l’application (mot de passe) est stockée dans le coffre de clés et il existe un coffre de clés par groupe de ressources.The app secret (password) is stored in the the key vault and there is one key vault per resource group. Il est recommandé d’utiliser le coffre de clés au lieu de copier et de stocker des données sensibles.Using key vault is recommended instead of copying and storing sensitive data.

  10. Sélectionnez Télécharger le kit de développement logiciel (SDK) à partir de GitHub pour générer votre robot avec le kit de développement logiciel (SDK) robot FrameworkSelect Get the SDK from Github to build your bot with the Bot Framework SDK.

    Créer un bot dans le SDK

Azure Key VaultAzure Key Vault

Quand Azure crée la ressource Azure bot, il génère également un ID d’application et un mot de passe , puis stocke le mot de passe dans Azure Key Vault.When Azure creates the Azure Bot resource, it also generates an app Id and a password and stores the password in Azure Key Vault.

Key Vault est un service qui fournit une gestion centralisée des secrets, avec un contrôle total sur les stratégies d’accès et l’historique d’audit.Key Vault is a service that provides centralized secrets management, with full control over access policies and audit history. Pour en savoir plus, consultez la section Utiliser des références Key Vault pour App Service et Azure Functions.For more information, see Use Key Vault references for App Service and Azure Functions. Notez que vous êtes facturé pour l’utilisation du service.Note that you will be charged a small fee for using the service. Pour plus d’informations, consultez Tarification de Key Vault.For more information, see Key Vault pricing.

ID d’application et mot de passeApp Id and password

Vous avez besoin de l’ID et du mot de passe de l' application de ressource Azure bot pour configurer votre robot en vue de son déploiement.You need the Azure bot resource app Id and password to configure your bot for deployment. Vous allez affecter leurs valeurs aux variables associées : MicrosoftAppId et MicrosoftAppPassword contenues dans le fichier de configuration de votre projet bot.You will assign their values to the related variables: MicrosoftAppId and MicrosoftAppPassword contained in your bot project configuration file. Le fichier diffère selon le langage de programmation que vous utilisez pour créer le robot, comme indiqué ci-dessous.The file differs depending on the programming language you use to create the bot, as shown below.

Le appsettings.json fichier contient les paramètres suivants :The appsettings.json file contains these settings:

{
  "MicrosoftAppId": "<your app id>",
  "MicrosoftAppPassword": "<your password>"
}

Obtient l’ID d’application de ressource du robot AzureGet Azure bot resource app Id

  1. Accédez au portail Azure.Go to the Azure portal.
  2. Sélectionnez la ressource Azure bot pour obtenir son ID d’application.Select the Azure bot resource to obtain its app Id.
  3. dans le volet gauche, dans la section Paramètres , sélectionnez Configuration.In the left pane, in the Settings section, select Configuration.
  4. Copiez et enregistrez la valeur contenue dans la zone ID de l' application Microsoft .Copy and save the value contained in the Microsoft App ID box.

Obtient le mot de passe de la ressource du robot Azure à partir de Azure Key VaultGet Azure bot resource password from Azure Key Vault

Quand Azure crée la ressource de robot Azure, il stocke le mot de passe d’application dans Azure Key Vault.When Azure creates the Azure Bot resource, it stores the app password in Azure Key Vault. Pour plus d’informations sur l’accès au coffre de clés pour obtenir votre mot de passe, consultez :For information on how to access the key vault to obtain your password, see:

Étapes suivantesNext steps