Créer des instances d’agent

Important

Vous devez faire partie du programme Frontier en version préliminaire pour obtenir un accès anticipé à Microsoft Agent 365. Frontier vous connecte directement aux dernières innovations d’IA de Microsoft. Les versions préliminaires Frontier sont soumises aux conditions existantes de vos contrats clients qui régissent les versions préliminaires. Comme ces fonctionnalités sont encore en cours de développement, leur disponibilité et leurs capacités peuvent évoluer au fil du temps.

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

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

1. Configurer l’agent dans le portail développeur Teams
2. Créer une instance d’agent
3. Testez votre agent déployé

Si vous rencontrez des difficultés, consultez la section Dépannage .

Prerequisites

• Plan d’agent correctement configuré selon l’étape de configuration de l’agent blueprint.
• Application agent correctement publiée selon Publish agent vers Microsoft admin center.

1. Configurer l’agent dans le portail développeur Teams

Après publication, configurez le blueprint de l’agent dans le portail développeur Teams pour connecter votre agent à l’infrastructure de messagerie Microsoft 365. Sans cette configuration, votre agent ne reçoit pas de messages provenant de Teams, d’e-mail ou d’autres services Microsoft 365.

1. Obtenez votre ID de plan

   Exécutez la commande d’affichage de la configuration a365 -g pour afficher votre configuration :

   a365 config display -g
   

   Copiez la valeur agentBlueprintId de la sortie.

2. Naviguer vers le portail développeur

   Ouvrez votre navigateur et allez à la page de configuration :

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

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

   Note

   Si vous n’avez pas accès au portail développeur, contactez votre administrateur locataire pour qu’il vous accorde ou réalise cette configuration en votre nom.

3. Configurez l’agent

   Dans le portail développeur :

   1. Définir le type d’agent sur un bot
   2. Définissez l’ID du bot à votre agentBlueprintId valeur
   3. Cliquez sur Enregistrer

   

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

En savoir plus sur les plans d’identité d’agent et la configuration du portail développeur.

2. Créer une instance d’agent

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

Lorsque vous demandez une instance d’agent, Teams envoie la requête à votre administrateur locataire pour approbation. Les administrateurs peuvent examiner et approuver les demandes depuis la page des agents demandés du centre d’administration Microsoft .

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

3. Testez votre agent déployé

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

Après le déploiement, et avec les notifications d’agent activées dans le SDK Agent 365, votre agent s’intègre aux services Microsoft 365. Il fonctionne avec Teams pour les discussions, les canaux et les réunions ; avec email et calendrier pour l’envoi, la réception et la planification ; et avec 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

Comme les utilisateurs classiques, les utilisateurs agents doivent également disposer de licences Microsoft 365 appropriées pour accéder aux services. Les licences courantes incluent Microsoft 365 E5, Teams Entreprise et Microsoft 365 Copilot.

Voir l’agent déployé dans le centre d’administration

Après avoir publié votre agent, il apparaît dans le centre d’administration Microsoft pour le recrutement. Cela peut prendre un certain temps pour se propager.

Rendez-vous dans le centre d’administration Microsoft 365 - Agents pour :

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

Tester l’assistant dans Teams

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

Note

Frontier exige : Assurez-vous que Microsoft Agent 365 Frontier est activé pour votre locataire et que votre administrateur doit vous accorder l’accédre. Cet accès est nécessaire pour créer des instances d’agents et interagir avec les agents dans Microsoft Teams pendant que l’Agent 365 est en aperçu. En savoir plus sur Frontier Contactez votre administrateur locataire si vous n’avez pas accès.

Début des tests

1. Recherchez votre nouvel utilisateur agent dans Teams

   Note

   Le processus de création de l’utilisateur agent est asynchrone et peut prendre de quelques minutes à quelques heures pour que l’utilisateur de l’agent devienne consultable après sa création.

2. Commencez une nouvelle discussion avec votre nouvelle instance d’agent créée.

3. Envoyez des messages de test pour vérifier le fonctionnement de l’agent.

Exemple de message de test

Si vous avez configuré l’agent avec Email, envoyez ce message pour tester la fonctionnalité de l’email. Mettez à jour la valeur de l’email 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’agent traite la demande et envoie l’e-mail sans exiger de confirmation supplémentaire.

Liste de contrôle de vérification

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

✅ Configuration du portail développeur sauvegardée
✅ L’agent apparaît dans la recherche des applications Teams
✅ Vous pouvez créer un agent d’instance pour les équipes
✅ Instance d’agent créée
✅ L’utilisateur agent apparaît dans l’organisation
✅ Agent répond aux messages
✅ L’agent peut effectuer des actions
✅ Les journaux d’application ne montrent aucune erreur
✅ Observabilité en travaillant dans un centre administratif

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

Vérifier que la configuration du portail développeur est bien enregistrée

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

✅ Types d’agents : Basé sur les robots
✅ L’identifiant du bot correspond à votre agentBlueprintId
✅ Affiche le message « Sauvegardé avec succès »

Vérifier que l’agent apparaît dans Teams

1. Applications Open Teams >

2. Cherchez le nom de votre agent

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

Vérifiez que vous pouvez créer un agent d’instance vers les équipes

Sélectionnez votre agent dans les applications Teams

✅ Le bouton Request Instance/Create Instance est activé
✅ Peut demander une instance sans erreurs

Vérification de l’instance d’agent créée

Après avoir sélectionné l’instance de requête :

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

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

Dans le centre d’administration Microsoft 365 :

1. Accédez à https://admin.cloud.microsoft/#/agents/all.
2. Naviguer vers l’onglet Requêtes de tous les agents

✅ Votre demande d’instance d’agent est indiquée par l’État comme en attente d’examen
✅ L’administrateur peut approuver l’instance de l’agent pour l’utilisation
✅ L’utilisateur peut alors créer une instance depuis Teams et lui donner un nom.

Vérifier la réponse de l’agent aux messages

Dans le chat Teams avec votre agent - Envoyez un message test : Hello!

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

Vérifier que l’agent peut effectuer des actions

Si des outils sont configurés, la fonctionnalité de l’outil de test. Par exemple, si vous avez ajouté le serveur Mail MCP, envoyez-vous un e-mail test.

L’agent doit :

✅ Accusez réceptionné de la demande
✅ Exécuter l’appel de l’outil
✅ Confirmez la réussite de l’achèvement

Vous devriez vérifier que l’e-mail arrive dans votre boîte mail.

Vérifier le fonctionnement

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

Fonctionnalités de base :

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

Fonctionnalités des outils :

Cela dépend de la configuration du serveur MCP

✅ Peut envoyer des e-mails.
✅ Peut accéder au calendrier.
✅ Peut rechercher des documents.
✅ Peut effectuer des actions configurées.

Gestion des erreurs :

✅ Traite les demandes invalides avec grâce.
✅ Fournit des messages d’erreur utiles.
✅ Ça ne plante pas à l’entrée inattendue.

Performance :

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

Vérifier les journaux d’application

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

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

À surveiller dans les journaux :

✅ Demandes entrantes de 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 administratif

Après que votre agent commence à fonctionner :

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

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

   Vous devriez voir :

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

Étapes suivantes

Votre agent est désormais en ligne dans le cloud et prêt à travailler aux côtés de votre équipe sur Microsoft 365. Ce qui a commencé comme du code local est désormais un assistant accessible et prêt pour l’entreprise, où les utilisateurs peuvent créer des instances d’agents à travers votre organisation.

Le cycle de développement de votre agent 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’agent 365 est open source et accueille les contributions de la communauté. Mentionner les bugs, les demandes de fonctionnalités et les pull requests :

• Agent 365 Samples : Vous avez des agents d’échantillons intéressants et amusants ? Partagez votre code d’agent avec la communauté open source ici !
• Node.js SDK : Le SDK de l’Agent 365 dans Node.js
• SDK Python : Le SDK Agent 365 en Python
• .NET SDK : L’Agent 365 SDK en C# (.NET)
• CLI DevTools de l’Agent 365 : Une interface de ligne de ligne 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’agent.

Conseil / Astuce

Le Guide de dépannage de l’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’agent n’apparaît pas dans Teams

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

Cause profonde : Configuration manquante du portail développeur.

Solution:

1. Obtenez votre ID de plan :

   a365 config display -g
   # Copy the agentBlueprintId value
   

2. Configurer dans le portail développeur :

   1. Accédez à https://dev.teams.microsoft.com/tools/agent-blueprint/<your-blueprint-id>/configuration.
   2. Définir le type d’agent sur un bot
   3. Définir l’ID du bot sur votre agentBlueprintId
   4. Cliquez sur Enregistrer

3. Attendez 5 à 10 minutes pour la propagation.

Vérification :

• Applications Open Teams >> Recherchez votre agent
• Agent apparaît et est disponible pour ajouter

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

Symptôme: L’agent apparaît dans Teams mais ne peut ni ajouter ni créer d’instance ; Le bouton Request Instance ne fonctionne pas.

Cause profonde : 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 Microsoft 365 une fois que vos paramètres de licence et d’administrateur le permettent.

Agent ne répondant pas aux messages

Symptôme: J’ai créé une instance d’agent mais elle ne répond pas aux messages ; Aucun journal dans l’application.

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

Dépannage de base

1. Vérifiez que l’application web fonctionne :

   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 :

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

3. Testez directement le point de terminaison :

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

4. Consultez les journaux de candidature :

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

Diagnostic avancé

1. Vérifier l’authentification :

   • Vérifiez si les jetons sont expirés. Renouvelez-les si besoin.
   • Vérifiez les identifiants dans la configuration de l’application Web.

2. Vérifier la configuration outil/MCP :

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

3. Tester localement :

   • Exécutez l’agent localement avec la même configuration.
   • Testez avec Agents Playground.
   • Cela fonctionne localement mais pas dans le déploiement cloud >

Solutions courantes

• Endpoint de messagerie incorrect : Mise à jour dans Azure Portal et Developer Portal
• Application web arrêtée : Lancez-le via Azure Portal ou CLI
• Jeton expiré : Jetons de mise à jour dans les variables d’environnement de l’application Web
• Variables d’environnement manquantes : Vérifie les paramètres de l’application dans le portail Azure
• Problèmes de serveur MCP : Vérifier le principal de service et les autorisations
• Erreurs de code : Vérifiez les journaux d’application pour les exceptions

Vérification

Envoyez un message à votre agent dans Teams et vérifiez les journaux de candidature pour les demandes entrantes.

Vous pouvez aussi essayer :

• Dépannage du déploiement d’un agent sur Amazon Web Services
• Dépannage du déploiement d’un agent sur Google Cloud Platform

Échec des appels d’outils

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

Cause profonde : Permissions manquantes du serveur MCP, principal de service 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 permissions dans le centre d’administration

  Examiner et approuver les autorisations requises du serveur MCP :

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

• Vérifier le principal du service

  Exécutez le script de configuration à une seule utilisation si vous ne l’avez pas lancé avant :

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

• Vérifier la configuration du point de terminaison MCP

  Assurez-vous d’utiliser le point d’accès MCP de production :

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

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

  Vérifiez que l’identité gérée est activée dans votre application Web :

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

Vérification

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

Vous pouvez aussi essayer ces étapes :

• Outils de dépannage
• Dépannage du serveur d’outils de simulation

Échec de la cession de licence

Symptôme: Impossible d’attribuer une licence à un utilisateur agent ; Erreurs de licence dans le centre d’administration.

Cause profonde : Licences insuffisantes disponibles, type de licence incorrect ou problème de permissions.

Solutions

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

1. Vérifiez que les licences sont disponibles :

   • Vérifiez leslicences de facturation> du centre > d’administration Microsoft 365
   • Assurez-vous que Microsoft Agent 365 Frontier est activé pour le locataire

2. Attribuer manuellement la licence :

   • Aller sur le centre > d’administration Microsoft 365 Utilisateurs
   • Trouver l’utilisateur agent
   • Attribuer 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 le profil utilisateur dans le centre d’administration qui affiche les licences attribuées.