Créer un botCreate a bot

Important

Les Articles de cette section sont basés sur le kit de développement logiciel (SDK) de l’infrastructure de robots v3.The articles in this section are based on the v3 Bot Framework SDK. Si vous recherchez de la documentation actuelle (version 4,6 ou ultérieure du kit de développement logiciel (SDK)), reportez-vous à la section robots de conversation .If you're looking for current documentation (version 4.6 or later of the SDK) see the Conversational Bots section.

Tous les robots créés à l’aide de Microsoft bot Framework sont configurés et prêts à fonctionner dans Microsoft Teams.All bots created using the Microsoft Bot Framework are configured and ready to work in Microsoft Teams.

Consultez la documentation de la structure de bot pour obtenir des informations générales sur les robots.See the Bot Framework Documentation for general information on bots.

Créer un bot dans Microsoft TeamsCreate a bot for Microsoft Teams

Teams App Studio est un outil qui peut vous aider à créer votre robot, ainsi qu’un package d’application qui fait référence à votre bot.Teams App Studio is a tool that can help create your bot, and an app package that references your bot. Elle contient également une bibliothèque de contrôle React et des exemples configurables pour les cartes.It also contains a React control library and configurable samples for cards. Consultez Commencer à gérer App Studio de Teams.See Getting started with Teams App Studio. Les étapes qui suivent supposent que vous configuriez votre robot et que vous n’utilisiez pas Team App Studio.The steps that follow assume that you are hand configuring your bot and not using Teams App Studio.

  1. Créez le bot à l’aide de https://dev.botframework.com/bots/newce lien :.Create the bot using this link: https://dev.botframework.com/bots/new. Veillez à ajouter Microsoft Teams sous la forme d’un canal à partir de la liste de chaînes proposées après avoir créé votre bot.Be sure to add Microsoft Teams as a channel from the featured channels list after creating your bot. N’hésitez pas à réutiliser tout ID d’application Microsoft que vous avez généré si vous avez déjà créé votre package d’application/manifeste.Feel free to re-use any Microsoft App ID you generated if you've already created your app package/manifest.

    Page d’inscription de Bot Framework

Notes

Si vous ne souhaitez pas créer de robot dans Azure, vous devez utiliser ce lien pour créer un nouveau robot : https://dev.botframework.com/bots/new.If you do not wish to create your bot in Azure, you must use this link to create a new bot: https://dev.botframework.com/bots/new. Si vous cliquez sur le bouton créer un bot dans le portail de l’infrastructure bot à la place, vous allez créer votre robot dans Microsoft Azure .If you click on the Create a bot button in the Bot Framework portal instead, you will create your bot in Microsoft Azure instead.

  1. Générez le bot à l’aide du package NuGet Microsoft. Bot. Connector. teams , du Kit de développement logiciel (SDK) de l’infrastructure bot ou de l' API du connecteur bot.Build the bot using the Microsoft.Bot.Connector.Teams NuGet package, the Bot Framework SDK, or the Bot Connector API. Voir aussi exemples de robots d’infrastructure.See also Bot Framework samples.

  2. Testez le bot à l’aide de l’émulateur de l' infrastructure bot.Test the bot using the Bot Framework Emulator.

  3. Déployez le robot sur un service Cloud, tel que Microsoft Azure.Deploy the bot to a cloud service, such as Microsoft Azure. Vous pouvez également exécuter votre application localement et utiliser un service de tunneling tel ngrok pour exposer un point de terminaison HTTPS://pour votre bot https://45az0eb1.ngrok.io/api/messages, tel que.Alternatively, run your app locally and use a tunneling service such ngrok to expose an https:// endpoint for your bot, such as https://45az0eb1.ngrok.io/api/messages.

Notes

Robots et Microsoft AzureBots and Microsoft Azure

Depuis décembre 2017, le portail de l’infrastructure bot est optimisé pour l’enregistrement des robots dans Microsoft Azure.As of December, 2017, the Bot Framework portal is optimized for registering bots in Microsoft Azure. Voici quelques opérations que vous pouvez prendre en compte :Here are some things to know:

  • Le canal Microsoft Teams pour les bots inscrits sur Azure est gratuit.The Microsoft Teams channel for bots registered on Azure is free. Les messages envoyés via le canal Teams ne seront pas pris en compte dans les messages consommés pour le bot.Messages sent over the Teams channel will not count towards the consumed messages for the bot.
  • Bien qu’il soit possible de créer un nouveau robot d’infrastructure bot sans utiliser Azure, vous devez utiliser cettehttps://dev.botframework.com/bots/new)URL (, qui n’est plus exposée dans le portail de l’infrastructure bot.While it's possible to create a new Bot Framework bot without using Azure, you must use that URL (https://dev.botframework.com/bots/new), which is no longer exposed in the Bot Framework portal.
  • Lorsque vous modifiez les propriétés d’un bot existant dans la liste de vos robots dans l’infrastructure de robot , telle que son « point de terminaison de messagerie », qui est courante lors du premier développement d’un robot, en particulier si vous utilisez ngrok, vous verrez la colonne « État de la migration » et un bouton « déplacer » bleu qui vous permettra d’accéder au portail Microsoft Azure.When you edit the properties of an existing bot in the list of your bots in Bot Framework such as its "messaging endpoint," which is common when first developing a bot, especially if you use ngrok, you will see "Migration status" column and a blue "Migrate" button that will take you into the Microsoft Azure portal. Ne cliquez pas sur le bouton « migrer », sauf si c’est ce que vous voulez faire ; au lieu de cela, cliquez sur le nom du bot et vous pouvez modifier ses propriétés :Don't click on the "Migrate" button unless that's what you want to do; instead, click on the name of the bot and you can edit its properties:
    Modifier les propriétés du botEdit Bot Properties
  • Si vous enregistrez votre bot à l’aide de Microsoft Azure, votre code de robot n’a pas besoin d’être hébergé sur Microsoft Azure.If you register your bot using Microsoft Azure, your bot code does not need to be hosted on Microsoft Azure.
  • Si vous inscrivez un bot à l’aide du Portail Microsoft Azure, vous devez disposer d’un compte Microsoft Azure.If you do register a bot using Microsoft Azure portal, you must have a Microsoft Azure account. Vous pouvez en créer un gratuitement.You can create one for free. Pour vérifier votre identité lors de sa création, vous devez fournir une carte de crédit, mais elle ne sera pas facturée ; Il est toujours gratuit de créer et d’utiliser des robots avec Microsoft Teams.To verify your identity when you create one, you must provide a credit card, but it won't be charged; it's always free to create and use bots with Microsoft Teams.
  • Vous pouvez désormais utiliser app Studio pour enregistrer/mettre à jour des informations sur les applications et les robots directement dans Microsoft Teams.You can now use App Studio to register/update app and bot information directly within Microsoft Teams. Il vous suffit d’utiliser le portail Microsoft Azure pour ajouter/configurer d’autres canaux de l’infrastructure de robots, tels que la ligne directe, la conversation Web, Skype et Facebook Messenger.You'll only have to use the Microsoft Azure portal for adding/configuring other Bot Framework channels such as Direct Line, Web Chat, Skype, and Facebook Messenger.