Créer des instances d’agent

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

• Modèle d’agent correctement configuré selon l’étape de configuration du modèle d’agent.
• L'application de l'agent a été correctement publiée conformément à Publier l'agent dans le centre d'administration Microsoft.

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

Après la publication, configurez le blueprint de l’agent dans le portail des développeurs Teams pour connecter votre agent à l’infrastructure de messagerie Microsoft 365. Sans cette configuration, votre agent ne reçoit pas de messages 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 basé sur un bot
   2. Définissez l’ID du bot à votre agentBlueprintId valeur
   3. Sélectionnez 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 schéma d’agent depuis 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 Kit de développement logiciel (SDK) Agent 365, votre agent s’intègre aux services Microsoft 365. Il fonctionne avec Teams pour les conversations, les canaux et les réunions ; avec e-mail 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.

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.

Accédez au centre d’administration Microsoft 365 - Agents pour :

• Afficher votre agent 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 d’agent, testez l’utilisateur de l’agent directement dans Microsoft Teams :

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

✅ Type d’agent : Basé sur un bot
✅ L’identifiant du bot correspond à votre agentBlueprintId
✅ Affiche le message « Sauvegardé avec succès »

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

1. > Open Teams Applications

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 Microsoft 365 centre d’administration :

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, testez leur fonctionnalité. Par exemple, si vous avez ajouté le serveur Mail MCP, envoyez-vous un e-mail test.

L’agent doit :

✅ Accusez réception 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 délai 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'applications 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>

À surveiller dans les logs :

✅ 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 :

   ✅ Sessions en cours d'apparition.
   ✅ Chaque session montre les déclencheurs et les actions.
   ✅ Les appels d’outils sont enregistrés avec des horodatages.

Étapes suivantes

Votre agent est maintenant en direct dans le cloud et prêt à travailler avec votre équipe dans 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 vie des développeurs 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
• Python SDK : Kit de développement logiciel (SDK) Agent 365 dans Python
• .NET SDK : Kit de développement logiciel (SDK) Agent 365 en C# (.NET)
• CLI DevTools de l’Agent 365 : 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’agent.

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 basé sur un bot
   3. Définir l’ID du bot sur votre agentBlueprintId
   4. Sélectionnez Enregistrer.

3. Attendez 5 à 10 minutes pour la propagation.

Vérification :

• Ouvrir des applications Teams >> Recherchez votre agent
• L'agent apparaît et est disponible pour être ajouté

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 de frontière apparaissent dans Microsoft 365 Copilot et les applications Microsoft 365 une fois que vos paramètres de licence et d’administrateur l’autorisent.

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 d'application :

   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 présente un problème lors du déploiement dans le cloud >.

Solutions courantes

• Point de terminaison de messagerie incorrect : Mise à jour dans le portail Azure et le portail développeur
• L'application web s'est arrêtée : Démarrez-la à l’aide du portail Azure ou par l’interface CLI
• Jeton expiré : Jetons de mise à jour dans les variables d’environnement de l’application Web
• Variables d'environnement manquantes : Vérifiez 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 service principal

  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
  

• 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 de l'outil via Teams et vérifier les logs pour une exécution réussie.

Vous pouvez aussi essayer ces étapes :

• Résolution des problèmes d'outillage
• 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 le centre d'administration Microsoft 365 >Facturation>Licences
   • Assurez-vous que Microsoft Agent 365 Frontier est activé pour le locataire

2. Attribuer manuellement la licence :

   • Accédez au centre d’administration Microsoft 365 >Utilisateurs
   • Trouver l'utilisateur agentique
   • 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 de Copilot)

Vérification

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