Configurer les paramètres d’inscription du bot
S’APPLIQUE À : SDK v4
Les paramètres de ressource Azure Bot, tels que le nom complet, l’icône et la description, peuvent être affichés et modifiés dans le volet Profil de bot. Les paramètres des ressources Azure Bot, tels que le point de terminaison de la messagerie, l’ID d’application Microsoft et Application Insights, peuvent être affichés et modifiés dans le volet Configuration.
Profil de bot
Vous trouverez ci-dessous la liste des champs de profil bot :
| Champ | Description |
|---|---|
| Icône | Icône personnalisée permettant d’identifier visuellement le bot dans les canaux et servant d’icône pour votre bot dans Microsoft Teams ou dans d’autres services. |
| Nom d’affichage | Nom du bot dans les répertoires et les canaux. Vous pouvez modifier cette valeur ultérieurement. |
| Descripteur du bot | Identificateur unique de votre bot. Cette valeur n’est plus modifiable une fois le bot créé avec le service bot. |
| Description | Description de votre bot. Certains canaux affichent la description. Vous pouvez modifier cette valeur ultérieurement. |
Pour enregistrer les modifications, sélectionnez Appliquer dans la partie inférieure du panneau.
Configuration
Vous trouverez ci-dessous la liste des champs Configuration :
| Champ | Description |
|---|---|
| Point de terminaison de messagerie | Point de terminaison permettant de communiquer avec le bot. |
| ID d’application Microsoft | Identificateur unique du bot. Cette valeur ne peut pas être modifiée. Pour générer un nouveau mot de passe, cliquez sur le lien Gérer. |
| Version de transformation de schéma | Version de transformation de schéma de bot à utiliser pour ce bot. Pour en savoir plus, reportez-vous à Connecter un bot à des canaux. |
| Clé d'instrumentation Application Insights | Clé unique de télémétrie du bot. Copiez votre clé Azure Application Insights dans ce champ si vous souhaitez recevoir les données de télémétrie du bot. Cette valeur est facultative. Pour plus d’informations sur ce champ, voir Clés Application Insights. |
| Clé API Application Insights | Clé unique d’analyse du bot. Copiez votre clé API Azure Application Insights dans ce champ si vous souhaitez afficher des données d’analyse sur votre bot dans le Tableau de bord. Cette valeur est facultative. Pour plus d’informations sur ce champ, voir Clés Application Insights. |
| ID d'application Application Insights | ID unique d’analyse du bot. Copiez votre clé d’ID d’application Azure Application Insights dans ce champ si vous souhaitez afficher des données d’analyse sur votre bot dans le Tableau de bord. Cette valeur est facultative. Pour plus d’informations sur ce champ, voir Clés Application Insights. |
Pour enregistrer les modifications, sélectionnez Appliquer dans la partie inférieure du panneau.
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 | File name | 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. |
Informations supplémentaires
Vous pouvez utiliser az bot update pour mettre à jour les paramètres du bot à partir de la ligne de commande.