Gérez vos applications dans le portail des développeurs

Après avoir chargé votre application dans Microsoft Teams, vous pouvez la gérer dans le Portail des développeurs. Cet article fournit des conseils complets sur la configuration, l’analytique et la validation des applications pour améliorer l’expérience de l’application Teams. En outre, vous découvrez Agent Identity Blueprint pour créer et gérer les identités d’agent pour votre agent.

Vue d’ensemble

Dans la section Vue d’ensemble , vous pouvez afficher les composants suivants pour gérer votre application :

• Tableau de bord

  • Dans le tableau de bord , sous la section Vue d’ensemble , vous pouvez afficher les composants suivants pour votre application :

    • Recommandation : L’outil de validation d’application vérifie votre package d’application par rapport aux cas de test que Microsoft utilise lors de l’examen de votre application.
    • Annonce : affiche les dernières mises à jour de vos applications sur le Portail des développeurs.
    • Utilisateurs actifs (préversion) : affiche le nombre d’utilisateurs actifs.
    • Informations de base : affiche l’ID de l’application, la version, la version du manifeste et d’autres informations de base.

    

• Analyse

  Dans la section Analytique sous la section Vue d’ensemble , vous pouvez obtenir une vue d’ensemble de l’utilisation, de l’engagement et d’autres insights de votre application. Pour plus d’informations, consultez comment analyser l’utilisation de votre application.

Configurer

Pour installer et afficher votre application dans Teams, vous devez inclure un ensemble de configurations que Teams reconnaît. Pour charger vos applications dans Teams, vous devez disposer d’un manifeste d’application, qui contient tous les détails de l’application pour afficher votre application dans Teams. Cela peut être réalisé à l’aide des composants et outils disponibles dans le Portail des développeurs.

Dans la section Configurer , vous pouvez afficher les composants suivants pour gérer votre application et y accéder :

• Informations de base : cette section affiche et vous permet de modifier les noms des applications, l’ID de l’application, les descriptions, la version, les informations sur le développeur, les URLd’application, l’ID d’application (client) et l’ID CCP (Microsoft Partner Network ID ).

• Personnalisation : cette section vous permet d’ajouter l’icône Couleur et l’icône Plan au .png format.

• Fonctionnalités de l’application : cette section vous permet d’ajouter les fonctionnalités suivantes à votre application :

  • Application personnelle
  • Bot
  • Connector
  • Scène
  • Application de groupe et de canal
  • Extension de la messagerie
  • Extension de réunion
  • Notification de flux d’activité

  Remarque

  Le connecteur est disponible dans le cloud de la communauté du secteur public (GCC), mais il n’est pas disponible dans GCC High, Department of Defense (DoD) et Teams gérés par les environnements 21Vianet.

• Éditeur de package d’application : cette section vous permet de créer, gérer et personnaliser des packages d’application pour Teams. Comme Visual Studio Code, il vous permet de modifier en toute transparence les composants de votre application, notamment le manifeste, les icônes, les fichiers de l’agent Copilot, les scènes, les fichiers JSON et YAML. Vous pouvez également ajouter un agent déclaratif et ses fichiers associés dans votre package d’application.

  

  Après avoir modifié ou ajouté de nouveaux fichiers à votre package d’application, vous pouvez ignorer ou mettre à jour le package. Si vous sélectionnez Mettre à jour, le portail des développeurs examine les fichiers et identifie les erreurs. Vous pouvez enregistrer le package avec des erreurs, mais vous devez les résoudre avant de publier.

  

  Remarque

  Si la version de votre manifeste d’application est v1.19, vous pouvez ajouter un agent déclaratif via cet éditeur de package d’application. Pour créer un agent déclaratif, ajoutez un fichier JSON qui définit le comportement de l’agent. Vous pouvez également créer un fichier YAML pour définir des API personnalisées et les connecter à l’agent déclaratif.

  
  
  Ajouter un agent déclaratif à votre package d’application à l’aide du Portail des développeurs

  
  

  Avant d’ajouter un agent déclaratif à votre package d’application, vérifiez que votre package d’application est mis à jour vers la dernière version v1.19.

  1. Dans le portail des développeurs Teams, sélectionnez Applications dans le volet gauche, puis sélectionnez votre application.

  2. Accédez à Configurer l’éditeur>de package d’application.

     

  3. Sélectionnez les points de suspension (...) sous Actions du fichier manifest.json , puis sélectionnez Modifier.

     

  4. Ajoutez la propriété copilotAgents manifeste et la sous-propriété declarativeAgents, puis définissez les détails requis. Sélectionnez Enregistrer.

     

  5. Sélectionnez Nouveau fichier>JSON et définissez le comportement de votre agent.

     

  6. Sélectionnez Mettre à jour.

     

     À présent, le portail des développeurs examine les fichiers et identifie les erreurs que vous devez résoudre avant de publier.

• Autorisations : cette section vous permet d’accorder des autorisations d’appareil, des autorisationsd’équipe, des autorisations de conversation/réunion et des autorisationsd’utilisateur pour votre application.

  Remarque

  La limite maximale pour les autorisations RSC est de 16.

• Authentification unique : un bot inscrit sur Microsoft Entra ID prend en charge l’authentification unique (SSO). Si un bot est inscrit sur le portail Bot Framework (ou dans le portail des développeurs sous Gestion des bots), un bot ne prend pas en charge l’authentification unique et vous devez inscrire votre bot sur Microsoft Entra ID pour prendre en charge l’authentification unique. Pour un bot inscrit sur Microsoft Entra ID, ajoutez l’URI ID d’application. Pour obtenir l’URI d’ID d’application à partir de Microsoft Entra ID, découvrez comment utiliser l’authentification unique pour les bots.

• Langues : cette section vous permet de configurer ou de modifier la langue de votre application.

• Domaine : cette section vous permet d’ajouter les domaines pour charger vos applications dans le client Teams, comme *.example.com.

Avancé

Dans la section Avancé , vous pouvez afficher les composants suivants pour gérer votre application dans le Portail des développeurs :

• Propriétaires

  Chaque application comprend une page Propriétaires , dans laquelle vous pouvez partager l’inscription de votre application avec d’autres personnes de votre organisation. Vous pouvez ajouter des rôles Administrateur et Opérateur pour gérer les personnes autorisées à modifier les paramètres de votre application. Le rôle opérateur dispose d’autorisations, telles que la mise à jour de la configuration d’une application. Le rôle Administrateur dispose d’autorisations, telles que la mise à jour de la configuration d’une application, l’ajout ou la suppression de propriétaires et la suppression d’une application. S’il n’existe aucun propriétaire actif pour une application, les administrateurs peuvent être propriétaires des applications en entrant l’ID d’application dans le portail des développeurs Teams.

  Pour ajouter un propriétaire :

  1. Dans la section Avancé , sélectionnez Propriétaires.
  2. Sélectionnez Ajouter des propriétaires.
  3. Entrez un nom et sélectionnez un ID utilisateur dans la liste déroulante.
  4. Sous Rôle, sélectionnez Opérateur ou Administrateur.
  5. Sélectionnez Ajouter.

• Contenu de l’application : vous pouvez configurer votre application avec les fonctionnalités suivantes :

  • Indicateur de chargement : affiche un indicateur pour indiquer aux utilisateurs que le contenu de votre application hébergée (par exemple, Onglets et boîtes de dialogue (appelés modules de tâche dans TeamsJS v1.x)) est en cours de chargement.
  • Mode plein écran : affiche une application personnelle sans en-tête d’application. Il est pris en charge pour les applications publiées dans votre organisation.
  • Types de canaux pris en charge : répertorie les types de canaux non standard pris en charge par l’application.
  • Fonctionnalité de groupe par défaut : pour les applications qui prennent en charge plusieurs fonctionnalités de groupe, telles que les équipes, les conversations de groupe ou les réunions, sélectionnez la fonctionnalité par défaut pour parcourir les utilisateurs lorsque vous ajoutez votre application à partir du Microsoft Teams Store.

• Environnements

  Vous pouvez configurer des environnements et des variables globales pour faciliter la transition de votre application de votre runtime local vers la production. Les variables globales sont utilisées dans tous les environnements.

  Pour configurer un environnement, procédez comme suit :

  1. Dans le portail des développeurs, sélectionnez les applications que vous utilisez.
  2. Accédez à Environnements sous la section Avancé .
  3. Sélectionnez + Ajouter un environnement>Ajouter.

  • Variables globales

    1. Sélectionnez Ajouter une variable globale pour créer des variables de configuration pour votre environnement.

    Pour utiliser des variables globales :

    Utilisez les noms de variables au lieu de valeurs codées en dur pour définir les configurations de votre application.

1. Entrez {{ dans n’importe quel champ du portail des développeurs. Une liste déroulante s’affiche, affichant toutes les variables que vous avez créées pour l’environnement sélectionné, ainsi que les variables globales.
2. Avant de télécharger votre package d’application (pour instance, lors de la préparation de la publication sur le Magasin Teams), sélectionnez l’environnement que vous souhaitez utiliser. Les configurations de votre application sont automatiquement mises à jour en fonction de l’environnement.

• Plan et tarification : liez une offre SaaS (Software-as-a-Service) que vous avez créée dans l’Espace partenaires pour votre application.
• Administration paramètres :
  • Personnalisation de l’application : personnalisez votre application en sélectionnant différentes propriétés, telles que Nom, Description courte, Petite icône et d’autres propriétés.
  • Bloquer l’application par défaut : bloquez votre application par défaut pour les utilisateurs jusqu’à ce qu’un administrateur Teams l’active.

Développer

Dans la section Développer, ouvrez et développez votre application à l’aide de Microsoft 365 Agents Toolkit (précédemment appelé Teams Toolkit) dans Visual Studio Code et Visual Studio. Pour plus d’informations, consultez Développer votre application avec microsoft 365 Agents Toolkit.

Publier

Dans la section Publier, publiez votre application sur votre organization ou le Magasin Teams.

• Package d’application : le package d’application décrit la façon dont votre application est configurée, y compris les fonctionnalités de l’application, les ressources requises et d’autres attributs importants dans le manifeste. La définition d’application fait référence à la configuration et aux paramètres associés à l’application. L’onglet Icône affiche l’icône utilisée pour votre application.

• Validation d’application : évaluez votre package d’application en fonction des cas de test que Microsoft utilise pour passer en revue votre application, le manifeste de l’application, les informations de base de votre application et la fonctionnalité du bot. L’outil de validation d’application identifie les erreurs ou les avertissements dans votre package d’application et fournit des instructions pour la résolution.

  

  Si votre application échoue dans un cas de test, passez en revue les instructions et effectuez les mises à jour nécessaires de votre package d’application en fonction des résultats du cas de test Microsoft. Vous pouvez également télécharger votre package d’application et le rapport de validation. Pour plus d’informations sur les cas de test Microsoft, consultez Instructions de validation du Magasin Teams et Stratégies de certification de la Place de marché commerciale.

  
  
  Valider votre package d’application

  
  

  Pour vous assurer que votre application fonctionne comme prévu dans Teams, utilisez l’outil de validation d’application pour case activée votre package d’application par rapport aux cas de test de Microsoft :

  1. Dans le portail des développeurs Teams, sélectionnez Applications dans le volet gauche, puis sélectionnez votre application.

  2. Accédez à Publier>la validation> de l’applicationPrise en main.

     

  3. Cochez toutes les cases sous Accusé de réception de validation , puis sélectionnez Démarrer la validation.

     

     Remarque

     • Avant de commencer la validation, résolvez les erreurs de manifeste d’application.
     • Vous ne pouvez envoyer qu’une seule demande de validation pour une application particulière à un moment donné. Une fois la validation actuelle terminée, vous pouvez lancer une requête suivante.

     Le portail des développeurs Teams commence maintenant à valider votre package d’application :

     

     Le status de validation de l’application est mis à jour comme suit :

     1. Créé : après avoir sélectionné Démarrer la validation.
     2. En cours : la validation de l’application est lancée.
     3. Terminé : la validation de l’application est terminée.

     Sélectionnez Actualiser l’état pour récupérer la dernière status de validation lorsque la validation est en cours.

     

  4. Une fois la validation terminée, elle affiche la liste des cas de test que votre application a réussis ou a échoué. Les résultats du test de validation d’application status disponibles sont les suivants :
     

     Statut	Validation	Résultat	Description
     Success	Exécuter	Passer	Aucun problème.
     Warning	Exécuter	Passer	La résolution de ce problème est facultative, mais recommandée.
     Erreur	Exécuter	Échouer	La résolution du problème est nécessaire pour publier correctement l’application.
     Ignoré	Incomplète	N/A	Nous n’avons pas pu poursuivre la validation case activée. Il peut s’agir d’un problème temporaire. Nous vous recommandons de réexécuter le test ultérieurement.

     

  Remarque

  • La validation d’application est prise en charge uniquement pour les applications dotées d’une fonctionnalité de bot.
  • L’outil de validation d’application évalue votre package d’application en fonction des cas de test que Microsoft utilise pour la révision de l’application avant sa soumission au Microsoft Teams Store. Résolvez les erreurs ou les avertissements et lisez la liste de vérification de soumission de l’application avant d’envoyer votre application.

• Publier sur l’organisation :

  1. Dans le portail des développeurs, sélectionnez les applications sur lesquelles vous travaillez.
  2. Accédez à Publier dans l’organisation sous Publier.
  3. Sélectionnez Publier votre application.

• Publier dans le Windows Store :

  1. Dans le portail des développeurs, sélectionnez les applications sur lesquelles vous travaillez.
  2. Accédez à Publier dans le Store sous Publier.
  3. Sélectionnez Publier.

  Téléchargez le package d’application en sélectionnant le bouton Télécharger le package d’application dans la page Publier dans le magasin .

Tester votre application directement dans Teams

Le Developer Portal fournit des options pour tester et déboguer votre application :

• Dans la page Vue d’ensemble, affichez un instantané indiquant si votre application est configurée et validée par rapport aux cas de test du Magasin Teams.
• Le bouton Aperçu dans Teams lance rapidement votre application dans le client Teams pour le débogage.

Utiliser des outils pour créer des fonctionnalités d’application

Le portail des développeurs inclut des outils pour vous aider à créer des fonctionnalités clés des applications Teams. Les outils suivants sont les suivants :

• Studio de scène : concevez des scènes personnalisées en mode Ensemble dans Teams pour les réunions Teams.
• Éditeur de cartes adaptatives (préversion) : créez et affichez un aperçu des cartes adaptatives à inclure dans vos applications.
• Gestion de la plateforme d’identité (préversion) : inscrivez vos applications auprès de Microsoft Entra ID pour aider les utilisateurs à se connecter et à fournir l’accès aux API.
• Validation de l’application du Store Teams : vérifiez votre package d’application par rapport aux cas de test que Microsoft utilise pour examiner votre application. Nous vous recommandons d’utiliser le dernier outil de validation d’application dans votre application sous la section Publier .
• Blueprint d’identité de l’agent : créez, configurez et gérez des blueprints réutilisables qui définissent un Agent 365 et ses détails de connexion back-end. Pour plus d’informations, consultez Agent Identity Blueprint.
• Gestion des bots : ajoutez des bots conversationnels à votre application qui communiquent avec les utilisateurs, répondent à leurs questions et les informent de manière proactive des modifications et autres événements.

Pour ajouter un bot :

1. Dans le portail des développeurs, sélectionnez Outils dans le volet gauche.

2. Sélectionnez Gestion des bots.

   

3. Dans la page Gestion du bot, sélectionnez + Nouveau bot.

4. Entrez le nom, puis sélectionnez Ajouter.

   

Remarque

• Les bots créés à l’aide du portail des développeurs Microsoft Teams sont par défaut à locataire unique .

• Les bots configurés comme multilocataires dans Azure Bot Service sont déconseillés. Toutefois, les bots précédemment créés en tant que multilocataires continuent de fonctionner comme prévu.

• Les applications inscrites dans Microsoft Entra ID sont des applications mutualisées par défaut et restent prises en charge. Ces inscriptions d’applications sont distinctes de la configuration du locataire de bot dans Azure Bot Service Un bot configuré en tant que locataire unique dans Azure Bot Service peut utiliser une application multilocataire.

• Lorsque vous créez un bot à l’aide du portail des développeurs, un servicePrincipal correspondant est automatiquement créé dans votre locataire Microsoft Entra ID.

• Dans les scénarios délégués avec des comptes professionnels ou scolaires, l’administrateur doit se voir attribuer un rôle Microsoft Entra pris en charge ou un rôle personnalisé avec une autorisation équivalente. Les rôles les moins privilégiés suivants sont pris en charge pour cette opération :

  • Pour les applications multilocataires :

    • Administrateur de l'application
    • Administrateur de l'application cloud

  • Pour les applications monolocataires où l’utilisateur appelant est un utilisateur non administrateur, mais est le propriétaire de l’application de stockage, l’utilisateur doit avoir le rôle Développeur d’applications .

Pour les bots configurés en tant que locataire unique dans Azure Bot Service, le développeur doit s’assurer que le bot demande le jeton d’accès correct. Cela nécessite d’inclure l’ID de locataire dans les variables d’environnement lors de la demande du jeton d’accès. Pour plus d’informations, consultez Demander un jeton d’accès.

À partir du portail des développeurs, accédez au portail Bot Framework et configurez votre bot pour mettre à jour l’icône et d’autres propriétés.

Remarque

L’ID de bot ne prend pas en charge les variables d’environnement.

Blueprint d’identité de l’agent

Un blueprint d’identité d’agent fournit des configurations réutilisables pour les agents dans Agent 365 qui effectuent des tâches et interagissent avec les utilisateurs ou les services Microsoft 365. Chaque blueprint fonctionne comme un modèle spécifiant la façon dont un agent est configuré et connecté à un service principal.

Créez et gérez des blueprints d’identité d’agent dans le portail des développeurs, tout en gérant les identités d’agent dérivées dans Administration Microsoft 365 Center. Pour obtenir des conseils complets sur l’extension de votre agent à Agent 365, utilisez le Kit de développement logiciel (SDK) Microsoft Agent 365.

Afficher et utiliser des blueprints d’identité d’agent existants

L’outil Agent Identity Blueprint dans le portail des développeurs affiche une liste des blueprints existants disponibles dans votre locataire. Bien que les blueprints soient visibles par tous les utilisateurs d’un locataire, seuls les propriétaires d’un blueprint peuvent y apporter des modifications.

Utilisez le blueprint d’identité de l’agent pour :

• Affichez les détails de configuration d’un blueprint existant, y compris son type et son ID de blueprint.
• Modifier ou mettre à jour la configuration d’un blueprint.

S’il n’existe pas de blueprint approprié, créez-en un.

Créer un blueprint d’identité d’agent

1. Dans le portail des développeurs Teams, accédez à Outils et sélectionnez Blueprint d’identité de l’agent.

   

2. Sélectionnez + Nouveau blueprint.

   

3. Entrez le nom, puis sélectionnez Créer.

   

   Un ID de blueprint d’agent unique est généré automatiquement. Utilisez cet ID lors de la création d’identités d’agent basées sur ce blueprint.

Configurer le blueprint d’identité de l’agent

Chaque blueprint comprend deux zones de configuration clés :

1. Informations de base : Affichez la configuration de base suivante pour votre blueprint :

   • ID de blueprint de l’agent : identificateur unique généré par le système pour le blueprint.
   • Nom : nom attribué lors de la création du blueprint.

   

2. Configuration : dans cet onglet, spécifiez la façon dont l’agent communique avec son service.

   • Sous l’onglet Configuration , accédez à Type d’agent.

     • Choisissez la façon dont l’agent se connecte à un service principal.

     • Sélectionnez l’une des options suivantes :

       Type d’agent	Description
       none	Aucune association de bot ou d’API (par défaut).
       Basé sur un bot	Utilisez un bot existant inscrit dans Teams.
       Basé sur l’API	Utilisez un point de terminaison d’API personnalisé pour définir le comportement de l’agent.

   • En fonction du type d’agent sélectionné, entrez l’une des options suivantes :

     • ID du bot : si vous avez sélectionné Basé sur un bot, indiquez l’ID de votre bot Teams inscrit.
     • URL du back-end : si vous avez sélectionné basé sur l’API, fournissez l’URL de votre point de terminaison de service principal.

   • Sélectionnez Enregistrer pour appliquer votre configuration.

   • Sélectionnez Rétablir pour ignorer les modifications.

   

Voir aussi

• Centre d’administration Teams
• Vue d’ensemble du kit de ressources Microsoft 365 Agents
• Inclure une offre SaaS avec votre application Microsoft Teams
• Instructions de validation du Magasin Teams
• Stratégies de certification de la Place de marché commerciale