Créer des instances d’assistant

Après avoir publié votre assistant et l’avoir rendu disponible dans le Centre d’administration Microsoft, vous pouvez créer des instances d’assistant et des utilisateurs d’assistant. Ces instances et utilisateurs utilisent le blueprint et le code de l’assistant que vous avez créés.

Cet article décompose le processus en trois principales étapes :

  1. Configurer l’assistant dans le Developer Portal Teams
  2. Création de l’instance d’assistant
  3. Tester votre assistant déployé

Si vous rencontrez des difficultés, reportez-vous à la section Dépannage.

Configuration requise

1. Configurer l’assistant dans le Developer Portal Teams

Après publication, configurez le blueprint de l’assistant dans le Developer Portal Teams pour connecter votre assistant à l’infrastructure de messagerie Microsoft 365. Sans cette configuration, votre assistant ne reçoit pas de messages provenant de Teams, des courriers électroniques ou d’autres services Microsoft 365.

  1. Obtenir votre ID de blueprint

    Ouvrez a365.generated.config.json dans votre répertoire de travail et copiez la valeur agentBlueprintId.

  2. Accédez à Teams Developer Portal

    Ouvrez votre navigateur, puis accédez à la page de configuration :

    https://dev.teams.microsoft.com/tools/agent-blueprint/<your-blueprint-id>/configuration

    Remplacez <your-blueprint-id> par la valeur agentBlueprintId que vous avez copiée.

    Note

    Si vous n’avez pas accès au Developer Portal, contactez votre administrateur du client pour qu’il vous accorde l’accès ou effectue cette configuration en votre nom.

  3. Configurez l’assistant

    Dans le Developer Portal :

    1. Définissez le Type d’assistant sur Basé sur une API

    2. Définissez l’URL de notification sur le point de terminaison de messagerie de votre assistant. Trouvez la valeur de messagingEndpoint dans a365.generated.config.json.

    3. Cliquez sur Enregistrer.

    Capture d’écran montrant la page de configuration du Developer Portal avec le type d’assistant défini sur API Based et le champ Notification URL.

Vous avez besoin de cette configuration avant de pouvoir créer des instances d’assistant dans Teams.

En savoir plus sur les blueprints d’identité d’assistant et sur la configuration du Developer Portal.

2. Créer l’instance d’assistant

Vous pouvez maintenant demander une instance de votre blueprint d’assistant via Teams. Découvrez comment rechercher, créer et intégrer un assistant..

Lorsque vous demandez une instance d’assistant, Teams envoie la requête à votre administrateur du locataire pour approbation. Les administrateurs peuvent vérifier et approuver les demandes depuis la page Centre d’administration Microsoft - Assistants demandés.

Après que l’administrateur a approuvé votre demande, Teams crée votre instance d’assistant et la rend disponible dans Teams.

3. Tester votre assistant déployé

Après avoir créé une instance d’assistant, testez-la dans Microsoft 365 pour vous assurer qu’elle fonctionne correctement en production.

Après le déploiement et l’activation des notifications d’assistant dans le SDK Agent 365, votre assistant s’intègre aux services Microsoft 365. Il s’intègre à Teams pour les conversations, les canaux et les réunions ; à la messagerie et au calendrier pour l’envoi, la réception et la planification ; ainsi qu’à SharePoint et OneDrive pour l’accès aux documents et le partage de fichiers. Il prend également en charge des fonctionnalités de collaboration telles que la présence organisationnelle, les tâches Planner et les commentaires de documents.

Important

À l’instar des utilisateurs classiques, les utilisateurs assistants doivent également disposer des licences Microsoft 365 appropriées pour accéder aux services. Les licences courantes incluent Microsoft 365 E5, Teams Entreprise et Microsoft 365 Copilot.

Afficher l’assistant déployé dans le Centre d’administration

Une fois qu’il a été publié, votre assistant apparaît dans le Centre d’administration Microsoft, où il peut être engagé. La propagation peut prendre un certain temps.

Accédez à Centre d’administration Microsoft 365 - Assistants pour :

  • Afficher votre assistant publié
  • Gérer les paramètres de l’assistant
  • Surveiller l’utilisation de l’assistant
  • Configurer les autorisations

Tester l’assistant dans Teams

Après avoir déployé, publié et configuré votre Blueprint d’assistant et créé un utilisateur assistant, testez l’utilisateur assistant directement dans Microsoft Teams :

Démarrer le test

  1. Recherchez votre nouvel utilisateur assistant dans Teams.

    Note

    Le processus de création de l’utilisateur assistant est asynchrone. Après sa création, le compte utilisateur de l’assistant peut n’être disponible dans les résultats de recherche qu’au bout de quelques minutes à quelques heures.

  2. Démarrer une nouvelle conversation instantanée avec votre instance d’assistant nouvellement créé.

  3. Envoyer des messages test pour vérifier le fonctionnement de l’assistant.

Exemple de message test

Si vous avez configuré l’assistant avec Email, envoyez ce message pour tester la fonctionnalité Email. Mettez à jour la valeur de l’adresse email du destinataire recipient@contoso.com.

Send an email to <recipient@contoso.com> with subject "Hello from Teams" and message "This is a test message from my agent!"

L’assistant traite la demande et envoie le courrier électronique sans nécessiter de confirmation supplémentaire.

Liste de contrôle de vérification

Après avoir créé votre instance d’assistant, vérifiez qu’elle fonctionne correctement dans Teams.

✅ Configuration du Developer Portal enregistrée
✅ L’assistant apparaît dans la recherche des applications Teams
✅ Vous pouvez créer une instance d’assistant dans Teams
✅ Instance d’assistant créée
✅ L’utilisateur d’assistant apparaît dans l’organisation
✅ L’assistant répond aux messages
✅ L’assistant peut effectuer des actions
✅ Les journaux d’application ne montrent aucune erreur
✅ Observabilité en travaillant dans un centre d’administration

Si votre instance d’assistant ne fonctionne pas comme prévu, consultez la section Dépannage pour des solutions détaillées aux problèmes courants.

Vérifiez que la configuration du Developer Portal est enregistrée

Accédez à : https://dev.teams.microsoft.com/tools/agent-blueprint/<your-blueprint-id>/configuration

✅ Type d’assistant indique : Basé sur les API✅L’URL de notification correspond au point de terminaison de messagerie de votre assistant✅ Affiche le message Enregistré avec succès

Vérifiez que l’assistant apparaît dans Teams

  1. Dans Teams, ouvrez >Applications

  2. Rechercher le nom de votre assistant

    ✅ L’assistant apparaît dans les résultats de recherche ✅ Affiche l’icône et la description de votre assistant

Vérifiez que vous pouvez créer une instance d’assistant dans Teams

Sélectionnez votre assistant dans les applications Teams

✅ Le bouton Demande d’instance/Création d’instance est activé ✅ Vous pouvez demander une instance sans erreur

Vérifier que l’instance d’assistant a été créée

Après avoir sélectionné Demander une instance :

✅ Demande envoyée avec succès à l’administrateur

Vérifier que l’utilisateur assistant apparaît dans l’organisation

Dans le centre d’administration Microsoft 365 :

  1. Accéder à : https://admin.cloud.microsoft/#/agents/all
  2. Accédez à l’onglet Demandes de la page Tous les assistants

✅ Votre demande d’instance d’assistant est affichée avec l’état en attente de révision ✅ L’administrateur peut approuver l’instance d’assistant pour utilisation ✅ L’utilisateur peut créer une instance dans Teams et lui donner un nom.

Vérifier que l’assistant répond aux messages

Dans le chat Teams avec votre assistant – envoyez un message de test : Hello!

✅ L’assistant affiche l’indicateur de saisie ✅ L’assistant répond en quelques secondes ✅ La réponse est cohérente et pertinente

Vérifier que l’assistant peut effectuer des actions

Si vous configurez des outils, testez la fonctionnalité des outils. Par exemple, si vous ajoutez le serveur MCP Mail, envoyez un courrier électronique de test à vous-même.

L’assistant doit :

✅ Accuser réception de la requête ✅ Exécuter l’appel à l’outil ✅ Confirmer la réussite de l’opération

Vérifiez que le courrier électronique arrive dans votre boîte de réception.

Vérifier le fonctionnement

La liste de contrôle suivante fournit une approche systématique de test pour votre assistant :

Fonctionnalité de base :

✅ L’assistant répond à des salutations simples. ✅ L’assistant gère les conversations en plusieurs étapes. ✅ L’assistant fournit des réponses pertinentes.

Fonctionnalités des outils :

Dépend de la configuration du serveur MCP

✅ Peut envoyer des courriers électroniques. ✅ Peut accéder au calendrier. ✅ Peut rechercher des documents. ✅ Peut effectuer des actions configurées.

Gestion des erreurs :

✅ Gère les demandes invalides de manière appropriée. ✅ Fournit des messages d’erreur utiles. ✅ Ne s’arrête pas à l’entrée inattendue.

Niveau de performance :

✅ Répond en quelques secondes. ✅ Aucune erreur de délai d’attente. ✅ Des temps de réponse constants.

Vérifier les journaux d’application

Pour voir ce que fait votre assistant, vérifiez les journaux d’application avec la commande az webapp log tail.

# Real-time logs from Azure
az webapp log tail --name <your-web-app> --resource-group <your-resource-group>

Ce qu’il faut rechercher dans les journaux :

✅ Requêtes entrantes depuis Teams ✅ Authentification réussie ✅ Appels d’outils en cours d’exécution ✅ Réponses envoyées ❌ Messages d’erreur ou exceptions

Vérifier l’observabilité dans le centre d’administration

Une fois que votre assistant commence à s’exécuter :

  1. Accédez à https://admin.cloud.microsoft/#/agents/all.

  2. Sélectionnez votre assistant et ouvrez l’onglet Activité.

    Ce qui suit doit s’afficher :

    ✅ Sessions qui s’affichent. ✅ Chaque session montre les déclencheurs et les actions. ✅ Les appels d’outils sont enregistrés avec des horodatages.

Étapes suivantes

Votre assistant est maintenant opérationnel dans le cloud et prêt à travailler aux côtés de votre équipe dans Microsoft 365. Ce qui a débuté comme du code local est désormais un assistant enregistré, prêt à l’emploi en entreprise, permettant aux utilisateurs de créer des instances d’assistant dans l’ensemble de votre organisation.

Le cycle de développement de votre assistant est terminé, mais son impact ne fait que commencer. Une grande partie de ce que vous avez construit dans le cycle de développement de l’assistant Agent 365 est open source et est ouverte aux contributions de la communauté. Soumettez des bugs, des demandes de fonctionnalités et des pull requests :

  • Exemples Agent 365 : Vous cherchez des exemples d’assistants intéressants et amusants ? Partagez votre code d’assistant avec la communauté open source ici !
  • SDK Node.js : le SDK Agent 365 en Node.js.
  • SDK Python : le SDK Agent 365 en Python.
  • SDK .NET : SDK Agent 365 en C# (.NET).
  • CLI Agent 365 DevTools : une interface en ligne de commande pour vous accompagner tout au long du cycle de développement de l’Agent 365.

Résolution des problèmes

Cette section contient les problèmes courants lors de la création et du test d’instances d’assistant.

Astuce

Le Guide de dépannage Agent 365 contient des recommandations générales de dépannage, les meilleures pratiques et des liens vers du contenu de dépannage pour chaque étape du cycle de développement de l’Agent 365.

L’assistant n’apparaît pas dans Teams

Symptôme : L’assistant apparaît dans le centre d’administration mais vous ne le trouvez pas dans les applications Teams.

Cause principale : configuration manquante du Developer Portal.

Solution :

  1. Récupérez l’identifiant de votre blueprint depuis a365.generated.config.json ; recherchez agentBlueprintId.

  2. Configurer dans Developer Portal :

    1. Accéder à : https://dev.teams.microsoft.com/tools/agent-blueprint/<your-blueprint-id>/configuration

    2. Définissez le Type d’assistant sur Basé sur une API

    3. Définissez l’URL de notification sur le point de terminaison de messagerie de votre assistant. Trouvez la valeur de messagingEndpoint dans a365.generated.config.json.

    4. Cliquez sur Enregistrer.

  3. Patientez 5 à 10 minutes afin que la propagation s’effectue.

Vérification :

  • Ouvrir Teams > Application > Recherchez votre assistant.
  • L’assistant s’affiche et peut être ajouté.

Impossible de créer une instance d’assistant dans Teams

Symptôme : L’assistant apparaît dans Teams, mais vous ne pouvez ni ajouter ni créer une instance ; le bouton Demander une instance ne fonctionne pas.

Cause principale : Microsoft Agent 365 Frontier n’est pas activé pour ce locataire.

Solution : Contactez votre administrateur locataire pour vérifier que Microsoft Agent 365 Frontier est activé pour le locataire.

En savoir plus sur Frontier.

Vérification :

Les fonctionnalités Frontier apparaissent dans Microsoft 365 Copilot et les applications Microsoft 365 une fois que vos licences et les paramètres de l’administrateur le permettent.

L’assistant ne répond pas aux messages

Symptôme : Vous créez une instance d’assistant mais elle ne répond pas aux messages. Aucun journal ne s’affiche dans l’application.

Cause racine: Plusieurs causes possibles : problèmes de point de terminaison de messagerie, problèmes d’authentification ou erreurs de configuration.

Dépannage de base

  1. Vérifiez que l’application web est en cours d’exécution :

    az webapp show --name <your-app-name> --resource-group <your-resource-group> --query state
# Should be: "Running"

  2. Vérifiez le point de terminaison de messagerie :

    • Doit être : https://<your-app-root-url>/api/messages
    • Vérifiez-le dans a365.config.json et a365.generated.config.json

  3. Tester le point de terminaison directement :

    curl https://<your-app-root-url>/api/messages
# Should not return 404

  4. Vérifiez les journaux d’application :

    az webapp log tail --name <your-app-name> --resource-group <your-resource-group>
# Look for incoming requests and errors

Diagnostics avancés

  1. Vérifier l’authentification :

    • Vérifiez si les jetons sont expirés. Renouvelez-les si nécessaire.
    • Vérifiez les informations d’identification dans la configuration de l’application Web.

  2. Vérifiez la configuration des outils/MCP :

    • Vérifiez que les serveurs MCP sont configurés.
    • Vérifiez que les autorisations sont accordées.

  3. Tester localement :

    • Exécutez l’assistant localement avec la même configuration.
    • Testez avec Agents Playground.
    • Si cela fonctionne localement mais pas dans le cloud > problème de déploiement

Solutions courantes

  • Point de terminaison de messagerie incorrect : Mettez à jour dans le Portail Azure et le Developer Portal.
  • Application web arrêtée : Lancez-la avec la CLI ou le portail Azure.
  • Jeton expiré : Mettez à jour les jetons dans les variables d’environnement de Web App.
  • Variables d’environnement manquantes : Vérifiez les paramètres d’application dans le Portail Azure.
  • Problèmes du serveur MCP : Vérifiez le service principal et les autorisations.
  • Erreurs de code : Vérifiez les journaux d’application pour des exceptions.

Vérification

Envoyez un message à votre assistant dans Teams et vérifiez les journaux d’application pour les requêtes entrantes.

Vous pouvez également essayer :

Échec des appels d’outils

Symptôme : L’assistant répond aux messages mais les appels d’outils échouent. Vous voyez des erreurs d’autorisation refusée ou d’expiration du délai.

Cause racine : autorisations du serveur MCP manquantes, service principal non configuré, problèmes de connectivité réseau ou configuration incorrecte de l’outil.

Solutions

Essayez les solutions suivantes lorsque les appels d’outils échouent :

  • Vérifier les autorisations dans le Centre d’administration

    Vérifiez et approuvez les autorisations requises du serveur MCP :

    • Accéder à : https://admin.cloud.microsoft/#/agents/all
    • Sélectionnez votre assistant > Autorisations
    • Assurez-vous que la liste inclut et approuve les serveurs MCP requis

  • Vérifier le principal de service

    Lancez le script d’installation unique si ce n’est pas déjà fait

    # Download and run:
# https://github.com/microsoft/Agent365-devTools/blob/main/scripts/cli/Auth/New-Agent365ToolsServicePrincipalProdPublic.ps1

  • Vérifiez la configuration du point de terminaison MCP

    Assurez-vous d’utiliser le point de terminaison MCP de production :

    # Should be production endpoint, not mock
MCP_PLATFORM_ENDPOINT=https://agent365.svc.cloud.microsoft

  • Vérifiez l’identité gérée

    Vérifiez que l’identité managée est activée sur votre application web :

    # Verify managed identity is enabled
az webapp identity show --name <your-app-name> --resource-group <your-resource-group>

Vérification

Testez les appels d’outils via Teams et vérifiez les journaux pour une exécution réussie.

Vous pourriez aussi essayer ces étapes :

L’attribution de licences échoue

Symptôme : Impossible d’attribuer une licence à un assistant utilisateur. Vous voyez des erreurs de licence dans le Centre d’administration.

Cause principale : nombre insuffisant de licences disponibles, type de licence incorrect ou problèmes d’autorisations.

Solutions

Essayez les solutions suivantes lorsque l’attribution de licence échoue :

  1. Vérifiez que des licences sont disponibles :

    • Accédez au centre d’administration Microsoft 365 >Facturation>Licences.
    • Vérifiez que Microsoft Agent 365 Frontier est activé pour le locataire.

  2. Attribuer manuellement la licence:

    • Accédez au centre d’administration Microsoft 365 >Utilisateurs.
    • Recherchez l’utilisateur de l’assistant.
    • Attribuez la licence appropriée.

  3. Licences requises pour une fonctionnalité complète :

    • Microsoft 365 E5 (ou équivalent).
    • Teams Entreprise.
    • Microsoft 365 Copilot (pour les fonctionnalités Copilot).

Vérification

Vérifiez que le profil utilisateur dans le Centre d’administration affiche les licences attribuées.

  • Last updated on