Partager via


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

Paramètres du 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 complet 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

Paramètres de configuration du bot.

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

La version Java du Kit de développement logiciel (SDK) Bot Framework prend uniquement en charge les bots multilocataires. Les versions C#, JavaScript et Python prennent en charge les trois types d’applications pour la gestion de l’identité du bot.

Langue Nom de fichier 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 en charge les trois types d'applications pour gérer l'identité de votre bot.

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 pour les bots C#, JavaScript et Python.

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.