Tester des agents à l’aide du Kit de développement logiciel (SDK) Microsoft Agent 365

Avant le déploiement, testez votre agent localement à l’aide d’Agents Playground. Ce guide couvre la configuration de votre environnement de développement, l’authentification et la validation des fonctionnalités de votre agent en utilisant l’outil de test Agents Playground.

Une fois que votre agent fonctionne localement, suivez le cycle de vie de développement Agent 365 pour tester dans des applications Microsoft 365 telles que Teams, Word et Outlook.

Prérequis

Avant de commencer à tester votre assistant, assurez-vous que les prérequis suivants sont en place :

Conditions préalables courantes

• Éditeur de code  : n’importe quel éditeur de code de votre choix. Visual Studio Code est recommandé.
• Agents Playground : Installez Agents Playground en utilisant l’une des méthodes suivantes :
  • Windows : winget install agentsplayground
  • npm : npm install -g @microsoft/m365agentsplayground
• Interface CLI A365 : obligatoire pour le déploiement et la gestion de l’assistant. Installez la CLI de l’Agent 365.
• Accès à l’API LLM : choisissez le service approprié en fonction de la configuration de votre assistant ou de votre fournisseur de modèles préféré :
  • Clé API OpenAI : Obtenez votre clé API OpenAI.
  • Azure OpenAI : Creater et déployer une ressource OpenAI Azure pour obtenir votre clé API et votre point de terminaison.
• Configuration du portail développeur : Après avoir publié votre agent, vous devez configurer le blueprint de l’agent dans le portail développeur avant de créer des instances. Apprenez à configurer le plan d’agent dans le Portail développeur

Conditions préalables spécifiques à la langue

Configurer l’environnement de test de l’agent

Cette section décrit comment définir les variables d’environnement, authentifier votre environnement de développement et préparer votre agent alimenté par Agent 365 pour les tests.

Configurez votre environnement de test d’agent en suivant ce flux de travail séquentiel :

1. Configurez votre environnement - Créez ou mettez à jour votre fichier de configuration d’environnement.

2. configuration LLM - Obtenir des clés API et configurer les paramètres OpenAI ou Azure OpenAI.

3. Configurer l’authentification - Configurer l’authentification agentique.

4. Référence sur les variables d’environnement – Configurer les variables d’environnement requises :

   1. Variables d’authentification
   2. Configuration du point de terminaison MCP
   3. Variables d’observabilité
   4. Configuration du serveur d’applications de l’assistant

Une fois ces étapes terminées, vous êtes prêt à commencer à tester votre agent dans Agent Playground.

Étape 1 : Configurer votre environnement

Configurer votre fichier de configuration :

cp .env.template .env

cp .env.template .env

Étape 2 : configuration de LLM

Configurez OpenAI ou Azure paramètres OpenAI pour les tests locaux. Ajoutez vos clés API et vos points de terminaison de service issus des prérequis à votre fichier de configuration ainsi que tous les paramètres du modèle.

# Replace with your actual OpenAI API key
OPENAI_API_KEY=

# Azure OpenAI Configuration
AZURE_OPENAI_API_KEY=
AZURE_OPENAI_ENDPOINT=
AZURE_OPENAI_DEPLOYMENT=
AZURE_OPENAI_API_VERSION=

# Replace with your actual OpenAI API key
OPENAI_API_KEY=

# Azure OpenAI Configuration
AZURE_OPENAI_API_KEY=
AZURE_OPENAI_ENDPOINT=
AZURE_OPENAI_DEPLOYMENT=
AZURE_OPENAI_API_VERSION=

{
  "AIServices": {
    "AzureOpenAI": {
      "DeploymentName": "", // Deployment (as opposed to model) name of the Azure OpenAI model
      "Endpoint": "", // Endpoint of the Azure OpenAI model deployment
      "ApiKey": "" // API Key of the Azure OpenAI model deployment
    },
    "OpenAI": {
      "ModelId": "", // Model ID of the OpenAI model
      "ApiKey": "" // API Key of the OpenAI model
    },
    "UseAzureOpenAI": true // Flag to use Azure OpenAI vs OpenAI
  }
}

Étape 3 : Configurez l’authentification de votre agent

Choisissez l’une des méthodes d’authentification suivantes pour votre agent :

• Authentification agente - Utilisation pour des scénarios de production lorsqu’une identité utilisateur agent est disponible.
• Authentification OBO - À utiliser pour des scénarios de production lorsque vous avez besoin de permissions utilisateur déléguées sans identité utilisateur agente.
• Authentification par jeton porteur - À utiliser uniquement pour des scénarios de développement et de test précoces avant la configuration de l’authentification en production.

Authentification agentique

Utilisez la commande CLI Agent 365 a365 config display pour récupérer vos informations d’identification de blueprint d’assistant.

a365 config display -g

Cette commande affiche la configuration du blueprint de votre assistant. Copiez les valeurs suivantes :

Utilisez ces valeurs pour configurer l’authentification agentique dans votre assistant :

USE_AGENTIC_AUTH=true
CONNECTIONS__SERVICE_CONNECTION__SETTINGS__CLIENTID=<agentBlueprintId>
CONNECTIONS__SERVICE_CONNECTION__SETTINGS__CLIENTSECRET=<agentBlueprintClientSecret>
CONNECTIONS__SERVICE_CONNECTION__SETTINGS__TENANTID=<your-tenant-id>

USE_AGENTIC_AUTH=true
connections__service_connection__settings__clientId=<agentBlueprintId>
connections__service_connection__settings__clientSecret=<agentBlueprintClientSecret>
connections__service_connection__settings__tenantId=<your-tenant-id>

{
  "AgentBluePrint": {
    "Settings": {
      "ClientId": "<agentBlueprintId>",
      "ClientSecret": "<agentBlueprintClientSecret>",
      "TenantId": "<your-tenant-id>"
    }
  }
}

Authentification OBO

À l’aide de l’authentification on-Behalf-Of (OBO), votre agent peut accéder aux outils serveur MCP à l’aide d’autorisations d’utilisateur déléguées sans nécessiter d’identité d’utilisateur agentique. Dans ce flux, l’agent reçoit le jeton délégué par un utilisateur et l’échange pour effectuer des actions en son nom.

L’authentification OBO convient aux scénarios de production où :

• Votre agent n’a pas d’identité utilisateur agentique.
• Vous devez accéder aux ressources avec des autorisations spécifiques à chaque utilisateur.
• Vous voulez que l’agent agisse au nom de l’utilisateur authentifié.

Pour plus de détails sur le fonctionnement du flux OBO, voir Flux d’authentification. Pour obtenir un exemple d’implémentation complet, consultez l’exemple d’autorisation OBO dans le Microsoft 365 Agents SDK.

Authentification par jeton porteur

Pour les scénarios de développement et de test précoces où l’authentification en production n’est pas configurée, utilisez l’authentification par jeton porteur pour tester votre agent. Cette méthode utilise une authentification interactive par navigateur pour obtenir un jeton d’accès délégué. En utilisant ce jeton, votre agent peut appeler des outils MCP Server en utilisant vos permissions utilisateur. Cette approche simule la manière dont un utilisateur agent accède aux ressources en production sans nécessiter une instance d’agent réelle.

D’abord, utilisez a365 develop add-permissions pour ajouter les permissions serveur MCP requises à votre application :

a365 develop add-permissions

Ensuite, utilisez a365 develop get-token pour récupérer et configurer les jetons porteurs :

a365 develop get-token

La commande get-token effectue automatiquement :

• Lire ToolingManifest.json pour un processus de découverte de tous les serveurs MCP configurés.
• Acquiert un jeton par audience : les serveurs MCP par serveur reçoivent un jeton limité à leur ID d’application spécifique ; les serveurs ATG partagés reçoivent un jeton limité à l’ID d’application de passerelle d’outils d’agent partagé (ea9ffc3e-8a23-4a7d-836d-234d7c7565c1).
• Écrit des jetons dans vos fichiers de configuration de projet :
  • Jetons par serveur : BEARER_TOKEN_<SERVER_NAME> (par exemple, BEARER_TOKEN_MCP_MAILTOOLS)
  • Jeton ATG partagé : BEARER_TOKEN

Avant d’exécuter get-token, ajoutez des espaces réservés à votre fichier de configuration :

• .NET : ajoutez "BEARER_TOKEN": "" et/ou "BEARER_TOKEN_<SERVER_NAME>": "" à environmentVariables dans chaque profil dans Properties/launchSettings.json. La commande met uniquement à jour les profils dont ces clés sont déjà définies.
• Python/Node.js : créez un fichier .env avec BEARER_TOKEN= et/ou BEARER_TOKEN_<SERVER_NAME>= avant l’exécution. Si le fichier est manquant, la commande ignore l’enregistrement et affiche des instructions.

Étape 4 : Référence sur les variables d’environnement

Terminez la configuration de votre environnement en configurant les variables d’environnement requises suivantes :

• Variables d’authentification – Paramètres requis pour l’authentification agentique
• Configuration du point de terminaison MCP : spécifier le point de terminaison de la plateforme Agent 365
• Variables d’observabilité : activez la journalisation et le suivi distribué
• Configuration du serveur d’application de l’assistant : configurez le port sur lequel votre serveur d’assistant s’exécute

Variables d’authentification

Configurez les paramètres du gestionnaire d’authentification requis pour que l’authentification agentique fonctionne correctement.

# Agentic Authentication Settings
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__TYPE=AgenticUserAuthorization
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__SCOPES=https://graph.microsoft.com/.default
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__ALTERNATEBLUEPRINTCONNECTIONNAME=service_connection

# Connection Mapping
CONNECTIONSMAP_0_SERVICEURL=*
CONNECTIONSMAP_0_CONNECTION=SERVICE_CONNECTION

# Agentic Authentication Options
agentic_type=agentic
agentic_altBlueprintConnectionName=service_connection
agentic_scopes=aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/.default

# Set service connection as default
connectionsMap__0__serviceUrl=*
connectionsMap__0__connection=service_connection

{
  "AgentApplication": {
    "StartTypingTimer": false,
    "RemoveRecipientMention": false,
    "NormalizeMentions": false,
    "UserAuthorization": {
      "AutoSignin": false,
      "Handlers": {
        "agentic": {
          "Type": "AgenticUserAuthorization",
          "Settings": {
            "Scopes": [
              "https://graph.microsoft.com/.default"
            ]
          }
        }
      }
    }
  },
  "ConnectionsMap": [
    {
      "ServiceUrl": "*",
      "Connection": "ServiceConnection"
    }
  ]
}

Variables de jeton porteur (développement local uniquement)

Configuration du point de terminaison MCP

Spécifiez le point de terminaison de la plateforme Agent 365 auquel votre agent est connecté. Lorsque vous générez le manifeste d’outils qui définit les serveurs d’outils pour votre agent, spécifiez le point de terminaison de la plateforme MCP. Ce point de terminaison détermine l’environnement (préprod, test ou production) auquel les serveurs d’outils MCP se connectent pour Microsoft 365 fonctionnalités d’intégration.

# MCP Server Configuration
MCP_PLATFORM_ENDPOINT=<MCP endpoint>

# MCP Server Configuration
MCP_PLATFORM_ENDPOINT=<MCP endpoint>

{
  "profiles": {
    "Sample Agent": {
      "commandName": "Project",
      "launchBrowser": true,
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development",
        "MCP_PLATFORM_ENDPOINT": "<MCP endpoint>"
      },
      "applicationUrl": "https://localhost:64896;http://localhost:64897"
    }
  }
}

Variables d’observabilité

Configurez ces variables requises pour activer la journalisation et le suivi distribué pour votre assistant. Pour obtenir la liste complète des variables d’environnement, des options de configuration et des exemples de code, consultez l’observabilité de l’agent.

Configuration du serveur d’applications de l’assistant

Configurez le port dans lequel votre serveur d’applications d’assistant s’exécute. Ce paramètre est facultatif et s’applique aux agents Python et JavaScript.

# Server Configuration
PORT=3978

# Server Configuration
PORT=3978

Installer les dépendances et démarrer le serveur d’applications de l’assistant

Après avoir configuré votre environnement, installez les dépendances requises et lancez localement votre serveur d’application agent pour les tests.

Installer des dépendances

uv pip install -e .

python <main.py>

uv run python <main.py>

npm install

npm run dev

dotnet restore

dotnet build

dotnet run --launch-profile "Sample Agent with MCP Platform"

Votre serveur d’agent est maintenant en cours d’exécution et prêt à recevoir des demandes provenant d’Agents Playground ou d’applications Microsoft 365.

Tester l'agent dans Agents Playground

Agents Playground est un outil de test local qui simule l’environnement Microsoft 365 sans nécessiter une configuration complète du locataire. Il s’agit du moyen le plus rapide de valider la logique et les appels d’outils de votre assistant. Pour plus d’informations, consultez Tester avec Agents Playground.

Configurez Agents Playground pour l’authentification agentique

Lorsque vous utilisez l’authentification agentique, configurez le fichier YAML Agents Playground avec les détails de votre agent :

1. Configurez le fichier de configuration : Créez ou mettez à jour le .m365agentsplayground.yml fichier dans le dossier où vous exécutez Agents Playground. Pour des instructions de configuration détaillées, voir Personnaliser le contexte de Teams.

2. Mettez à jour la configuration du bot : Ajoutez les détails suivants du bot à votre .m365agentsplayground.yml fichier, en remplaçant les valeurs provisoires par vos véritables identifiants d’agent :

   bot:
     id: <your-agent-email>@<your-tenant>.onmicrosoft.com
     name: <Your Agent Name>
     role: agenticUser
     agenticUserId: <your-agentic-user-id>
     agenticAppId: <your-agentic-app-id>
   

   Propriété	Description	Obligatoire
   id	L’adresse e-mail de votre agent dans le format agentusername@tenant.onmicrosoft.com	Oui
   name	Nom d’affichage pour votre utilisateur agent	Oui
   role	Doit être défini sur agenticUser pour l’authentification agentique	Oui
   agenticUserId	L’ID d’objet de l’utilisateur de l’assistant. Recherchez cette valeur dans le centre d'administration Microsoft Entra sur la page de profil de l'utilisateur agent.	Oui
   agenticAppId	ID d’assistant de l’utilisateur de l’assistant. Recherchez cette valeur dans le centre d'administration Microsoft Entra sur la page de profil de l'utilisateur agent.	Oui

Ouvrez un nouveau terminal (PowerShell sur Windows) et démarrez Agents Playground :

agentsplayground

Cette commande ouvre un navigateur web avec l’interface Agents Playground. L’outil affiche une interface de conversation dans laquelle vous pouvez envoyer des messages à votre assistant.

Test de base

Commencez par vérifier que votre assistant est correctement configuré. Envoyez un message à l’assistant :

What can you do?

L'agent répond avec les instructions pour lesquelles il a été configuré, en fonction du message système et des capacités de votre agent. Cette réponse confirme que :

• Votre agent fonctionne correctement.
• L’agent peut traiter les messages et répondre.
• La communication entre Agent Playground et votre agent fonctionne.

Appels d’outils de test

Après avoir configuré vos serveurs d’outils MCP dans toolingManifest.json (voir Outillage pour les instructions de configuration), testez les invocations d’outils en utilisant des exemples comme ceux-ci :

Tout d’abord, vérifiez quels outils sont disponibles :

List all tools I have access to

Ensuite, testez les invocations spécifiques d’outils :

Outils de messagerie

Send email to your-email@example.com with subject "Test" and message "Hello from my agent"

Réponse attendue : L’agent envoie un e-mail via le serveur Mail MCP et confirme que le message a été envoyé.

Outils de calendrier

List my calendar events for today

Réponse attendue : L’agent récupère et affiche vos événements du calendrier pour le jour en cours.

outils SharePoint

List all SharePoint sites I have access to

Réponse attendue : l’agent interroge SharePoint et retourne une liste de sites auxquels vous avez accès.

Vous pouvez afficher les appels d’outils dans :

• Fenêtre de conversation : consultez la réponse de l’agent et les appels d’outils.
• Panneau Journal : consultez des informations détaillées sur l’activité, notamment les paramètres et les réponses de l’outil.

Tester avec les activités de notification

Lors du développement local, testez les scénarios de notification en utilisant les déclencheurs de notification intégrés dans Agents Playground.

Avant de tester les activités de notification, assurez-vous de :

• Configurez les serveurs d’outils MCP requis dans votre toolingManifest.json fichier. En savoir plus sur les outils.
• Activez les notifications pour votre agent. Découvrez comment configurer la notification.
• Configurez le .m365agentsplayground.yml fichier avec les détails d’authentification agentique de votre agent comme décrit dans Configure Agents Playground pour l’authentification agentique.

Notifications de test par e-mail

Pour tester la gestion des notifications par e-mail :

1. Démarrez votre assistant et Agents Playground.
2. Dans Agents Playground, allez sur Simuler une activité>Déclencher l'activité de notification.
3. Sélectionnez Envoyer un courrier électronique.
4. Dans la boîte de dialogue de la charge utile, mettez à jour les détails de l’email fictif tels que le nom de l’expéditeur et le contenu du corps de l’email selon les besoins.
5. Sélectionnez Envoyer l’activité.
6. Affichez le résultat à la fois dans la conversation instantanée et dans le volet Journal.

L’agent reçoit une notification par email simulée et la traite selon votre logique de gestion des notifications. Pour plus de détails sur la structure de la charge utile des notifications par email, voir Charge utile des notifications par email.

Tester les notifications de mention Word

Pour tester les notifications de mention dans les documents Word :

1. Démarrez votre assistant et Agents Playground.
2. Dans Agents Playground, allez sur Simuler une activité>Déclencher l'activité de notification.
3. Sélectionnez Mention dans Word.
4. Dans la boîte de dialogue de contenu, mettez à jour les détails du commentaire simulé, tels que l’ID de document et le texte du commentaire, si nécessaire.
5. Sélectionnez Envoyer l’activité.
6. Affichez le résultat à la fois dans la conversation instantanée et dans le volet Journal.

L’agent reçoit une notification de mention Word simulée et répond en fonction de votre logique de gestion des notifications. Pour plus d’informations sur la structure de charge utile de notification de commentaires Word, consultez Document comment notification payload.

Tester les événements d’installation et de désinstallation de l’agent

Lorsque Agents Playground se connecte à votre agent, il envoie automatiquement une activité InstallationUpdate avec une action add. Si vous implémentez un gestionnaire d’installation, le message de bienvenue de votre agent s’affiche immédiatement après l’établissement de la connexion.

Pour vérifier la gestion des événements d’installation :

1. Démarrez votre serveur d’agent.
2. Ouvrez Agents Playground. Le terrain de jeu se connecte à votre agent et déclenche automatiquement l’événement d’installation.
3. Vérifiez que le message d'accueil s'affiche dans la discussion de chat.

Pour plus d’informations sur l’implémentation du gestionnaire, consultez Gérer les événements d’installation et de désinstallation de l’agent.

Afficher les journaux d’observabilité

Pour afficher les journaux d’observabilité pendant le développement local, instrumentez votre assistant avec un code d’observabilité (consultez Observabilité pour obtenir des exemples de code) et configurez les variables d’environnement comme décrit dans les variables d’observabilité. Pour obtenir des instructions de validation pas à pas et une sortie de journal attendue, consultez Valider localement. Une fois configurées, les traces en temps réel s'affichent dans la console pour montrer :

• Traces d’appel de l’assistant
• Détails de l’exécution de l’outil
• Les appels d’inférence LLM
• Les messages d’entrée et de sortie
• Utilisation d’un jeton
• Temps de réponse
• Informations sur l’erreur

Ces journaux vous aident à déboguer les problèmes, à comprendre le comportement des agents et à optimiser les performances. Avant la publication, utilisez Valider pour la publication sur le store pour confirmer que tous les attributs requis sont présents.

Étapes suivantes

Après avoir testé votre agent localement, déployez-le sur Azure et publiez-le sur Microsoft 365.

Pour tester votre agent dans des applications Microsoft 365 telles que Teams, Word et Outlook, consultez le Agent 365 Development Lifecycle.

Résolution des problèmes

Cette section propose des solutions aux problèmes courants que vous pourriez rencontrer lors du test local de votre agent.

Problèmes de connexion et d’environnement

Ces problèmes concernent la connectivité réseau, les conflits de ports et les problèmes de configuration de l’environnement qui empêchent votre agent de communiquer correctement.

Problèmes de connexion Agents Playground

Symptôme : Agents Playground ne peut pas se connecter à votre assistant.

Solutions :

• Vérifiez que votre serveur d’agent fonctionne.
• Vérifiez que les numéros de port correspondent entre votre assistant et Agents Playground.
• Assurez-vous qu’il n’y a pas de règles de pare-feu bloquant les connexions locales.
• Essayez de redémarrer à la fois l’agent et l'Agents Playground.

Version obsolète d’Agents Playground

Symptôme : Erreurs inattendues ou fonctionnalités manquantes dans Agents Playground.

Solution : désinstaller et réinstaller Agents Playground.

winget uninstall agentsplayground
winget install agentsplayground

Conflits au niveau des ports

Symptôme : Le port indiquant une erreur est déjà en service.

Solution:

• Arrêtez toutes les autres instances de votre assistant.
• Changez le port dans votre configuration.
• Coupez tous les processus utilisant le port.

# Windows PowerShell
Get-Process -Id (Get-NetTCPConnection -LocalPort <port>).OwningProcess | Stop-Process

Impossible d’ajouter DeveloperMCPServer

Symptom : Erreur lors de la tentative d’ajout de DeveloperMCPServer dans Visual Studio Code.

Solution : fermez et rouvrez Visual Studio Code, puis réessayez d’ajouter le serveur.

Problèmes d'authentification et de jetons d'authentification

Ces problèmes se produisent lorsque votre agent ne peut pas s'authentifier correctement avec Microsoft 365 services ou lorsque les informations d'identification expirent ou sont mal configurées.

Symptômes :

• Erreurs non autorisées 401
• Messages « jeton porteur expiré »
• Défaillances d’authentification des agents

Cause racine :

• Les jetons expirent après environ une heure
• Configuration d’authentification incorrecte
• Informations d’identification manquantes ou non valides

Solutions :

• Pour l’expiration du jeton porteur

  Rafraîchissez votre jeton et mettez à jour vos variables d’environnement.

  # Get a new token
  a365 develop get-token
  
  # Update your .env file with the new token
  

• Pour les échecs des jetons d'accès par serveur

  Vérifiez que votre fichier de configuration contient des entrées d’espace réservé pour chaque serveur (BEARER_TOKEN_<SERVER_NAME>), puis réexécutez a365 develop get-token pour les remplir. Le SDK dérive le nom de la variable en mettant mcpServerName et ToolingManifest.json en majuscules, puis en remplaçant les traits d’union par des traits de soulignement (par exemple, mcp_MailTools → BEARER_TOKEN_MCP_MAILTOOLS).

• Pour les erreurs d'authentification agent (Python)

  Vérifiez votre .env dossier :

  # Should be (with underscore):
  AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__ALT_BLUEPRINT_NAME=SERVICE_CONNECTION
  
  # Not:
  AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__ALT_BLUEPRINT_NAME=ServiceConnection
  

• Pour les identifiants manquants

  Confirmez la présence des identifiants requis avant le test.

  Assurez-vous que .env et appsettings.json contiennent :

  • Clés API et secrets
  • ID du locataire
  • ID de client
  • ID de blueprint (si on utilise une authentification par assistant)

  Vérification :

  Testez avec une simple requête dans Agents Playground. Vous devriez recevoir une réponse sans erreurs 401.

• Problèmes d’outils et de notifications

  Ces problèmes concernent les invocations d’outils, les interactions avec les serveurs MCP et la livraison de notifications.

Courrier électronique non reçu

Symptôme : l’assistant indique que le courrier électronique a été envoyé, mais que vous ne le recevez pas

Solutions :

• Vérifiez votre dossier Courrier indésirable ou Spam.
• La livraison des e-mails peut être retardée de quelques minutes. Attendez jusqu’à cinq minutes.
• Vérifiez que l’adresse e-mail du destinataire est correcte.
• Vérifiez les journaux des agents pour détecter d’éventuelles erreurs lors de l’envoi d’un e-mail.

Word réponses aux commentaires ne fonctionnent pas

Problème connu : le service de notification ne peut pas répondre directement aux commentaires Word. Cette fonctionnalité est en cours de développement.

Les messages ne parviennent pas à l’agent

Symptôme : Votre application d’agent ne reçoit pas les messages envoyés à l’agent dans Teams.

Causes possibles :

• Le portail développeur n’est pas configuré avec le blueprint de l’agent.
• Problèmes d'application web Azure (échecs de déploiement, application qui ne s'exécute pas, erreurs de configuration).
• L’instance d’agent n’est pas créée correctement dans Teams.

Solutions :

• Vérifier la configuration du portail développeur :

  Assurez-vous de bien compléter la configuration du plan d’agent dans le Portail Développeur. Apprenez à configurer le blueprint de l’agent dans le Portail développeur.

• Vérifier l'intégrité de l'application Web Azure :

  Si vous déployez votre agent sur Azure, vérifiez que l’application web s’exécute correctement :

  1. Accédez au portail Azure.
  2. Rendez-vous sur la ressource de votre application Web.
  3. Vérifiez Aperçu>Status (cela devrait indiquer « En cours »).
  4. Vérifiez le flux de journal sous Surveillance pour détecter les erreurs d’exécution.
  5. Consultez les journaux du Centre de déploiement pour vérifier que le déploiement a réussi.
  6. Vérifier que>les paramètres de configuration de l’application contiennent toutes les variables d’environnement requises.

• Vérifier la création d’instance d’agent :

  Vérifiez que vous créez correctement l’instance de l’agent dans Microsoft Teams :

  1. Ouvrez Microsoft Teams.
  2. Allez dans Applications et recherchez votre agent.
  3. Vérifiez que l’agent apparaît dans les résultats de recherche.
  4. S'il est introuvable, vérifiez qu'il est publié dans Microsoft 365 admin center - Agents.
  5. Créez une nouvelle instance en cliquant sur Ajouter sur votre agent.
  6. Pour des instructions détaillées, voir Agents embarqués.

Résoudre les problèmes liés aux journaux d’observabilité

Si les journaux d’observabilité de votre agent n’apparaissent pas comme prévu, consultez le guide de résolution des problèmes dans le guide d’observabilité.