Concepts clés d'API Bot Connector

  • Article

Bot Framework et Azure AI Bot Service permettent à votre bot de communiquer avec les utilisateurs de Teams, Facebook et plus encore. Les canaux sont disponibles sous deux formes :

  • En tant que service inclus dans le cadre d'Azure AI Bot Service.
  • En tant que bibliothèques d'adaptateurs à utiliser avec le kit de développement logiciel (SDK) Bot Framework.

Cet article s'intéresse aux canaux standard qui sont compris dans Azure AI Bot Service.

Canaux Bot Framework

Les canaux Bot Framework permettent à votre bot d'échanger des messages avec des canaux configurés dans le portail Azure. Bot Framework utilise des ressources REST et JSON standard sur HTTPS, et permet l'authentification avec des jetons du porteur JWT. Pour plus d'informations sur l'utilisation du service Bot Connector, consultez Authentification et les autres articles de cette section.

Activité

Le service Connector échange des informations entre bot et canal (utilisateur) en transmettant un objet d'Activité. Le type d’activité le plus courant est message, mais il existe d’autres types d’activités qui peuvent être utilisés pour communiquer différents types d’informations à un bot ou à un canal. Pour plus d’informations sur les activités dans le service Bot Connector, voir Vue d’ensemble des activités.

Authentification

Le Bot Framework Service utilise des jetons du porteur JWT pour l'authentification. Pour plus d'informations sur l'authentification des demandes sortantes que votre robot envoie à Bot Framework et sur l'authentification des demandes entrantes que votre robot reçoit de Bot Framework, consultez Authentification.

Bibliothèques clientes

Bot Framework fournit des bibliothèques de clients utilisables pour générer des bots en C#, JavaScript, Python et Java.

Remarque

Les kits de développement logiciel (SDK) JavaScript, C# et Python bot Framework continueront d'être pris en charge. Toutefois, le kit de développement logiciel (SDK) Java est progressivement mis hors service avec une prise en charge finale à long terme se terminant en novembre 2023. Seuls les correctifs de sécurité et de bogues critiques au sein de ce référentiel seront appliqués.

Les bots existants créés avec le kit de développement logiciel (SDK) Java continueront de fonctionner.

Pour la nouvelle génération de bots, envisagez d'utiliser Power Virtual Agents et découvrez comment choisir la solution de chatbot appropriée.

Pour plus d'informations, consultez Les futures versions de bot.

En plus de simplifier les appels aux API REST Bot Framework, chaque kit de développement logiciel (SDK) Bot Framework propose aussi un support de générer des dialogues qui encapsulent une logique conversationnelle, des invites intégrées pour des choses aussi simples que Oui ou Non, des chaînes, des nombres, des énumérations, la prise en charge intégrée de frameworks d'IA performants tels que LUIS et plus encore.

Remarque

Azure AI QnA Maker sera mis hors service le 31 mars 2025. À partir du 1er octobre 2022, vous ne pourrez plus créer de nouvelles ressources ou bases de connaissances QnA Maker. Une version plus récente de la fonctionnalité de questions et réponses est désormais disponible dans le cadre d’Azure AI Language.

La réponse aux questions personnalisées, une fonctionnalité d'Azure AI Language, est la version mise à jour du service QnA Maker. Pour plus d'informations sur la prise en charge des questions et réponses dans le kit de développement logiciel (SDK) Bot Framework, consultez Compréhension du langage naturel.

Remarque

Compréhension du langage (LUIS) sera mis hors service le 1er octobre 2025. À compter du 1er avril 2023, vous ne pourrez pas créer de nouvelles ressources LUIS. Une version plus récente de Compréhension du langage est désormais disponible dans le cadre d'Azure AI Language.

Compréhension du langage conversationnel (CLU), une fonctionnalité d'Azure AI Language, est la version mise à jour de LUIS. Pour plus d'informations sur la prise en charge de compréhension du langage dans le kit de développement logiciel (SDK) Bot Framework, consultez Compréhension du langage naturel.

Remarque

Au lieu d'utiliser ces kits de développement logiciel (SDK), vous pouvez générer votre propre bibliothèque de client dans le langage de votre choix en utilisant le fichier Swagger de Bot Connector ou en écrivant du code directement dans son API REST.

Service Bot State

Le service Microsoft Bot Framework State a été mis hors service le 30 mars 2018. Auparavant, les bots basés sur Azure AI Bot Service ou le kit de développement logiciel (SDK) Bot Builder avaient une connexion par défaut à ce service hébergé par Microsoft pour stocker les données Bot State. Les bots doivent être mis à jour pour utiliser leur propre stockage d’état.

Informations supplémentaires

Pour en savoir plus sur la création de bots à l'aide du service Connector, lisez les articles de cette section, à commencer par Authentification. Si vous rencontrez des problèmes ou avez des suggestions concernant le service Connector, consultez la page Support pour accéder à la liste des ressources disponibles.