Tester les assistants à l’aide de Dev Tunnels

En utilisant Dev Tunnels, vous pouvez tester votre assistant Agent 365 avec des applications Microsoft 365 (comme Teams, Outlook ou Word) pendant que votre assistant s’exécute localement sur votre machine de développement. Cette approche fait le lien entre le développement local et les tests réels, ce qui vous permet de valider le comportement de l’assistant dans des environnements Microsoft 365 réels avant de le déployer sur le cloud.

Configuration requise

Avant d’utiliser Dev Tunnels, assurez-vous d’installer l’outil en ligne de commande Dev Tunnels.

Configurer Dev Tunnel

Configurez un Dev Tunnel pour exposer votre point de terminaison d’assistant local aux services Microsoft 365.

Créer et démarrer un tunnel

  1. Se connecter à Dev Tunnel:

    devtunnel user login

  2. Créer un tunnel persistant :

    devtunnel create --allow-anonymous

    Cette commande renvoie un ID de tunnel. Enregistrez cet identifiant pour une utilisation ultérieure.

  3. Configurez le port du tunnel :

    Attribuez le port que votre serveur de l’assistant utilise (généralement 3978) :

    devtunnel port create <tunnel-id> -p <port-number>

  4. Démarrez le tunnel :

    devtunnel host <tunnel-id>

    La commande affiche l’URL de votre tunnel (par exemple, https://abc123xyz.devtunnels.ms:3978). Copiez cette URL pour l’utiliser dans l’étape suivante.

Astuce

Utilisez devtunnel list pour afficher tous vos tunnels et devtunnel delete <tunnel-id> pour supprimer les tunnels dont vous n’avez plus besoin.

Configurer le point de terminaison de messagerie de l’assistant

Enregistrez votre URL de tunnel de développement (par exemple, https://abc123xyz.devtunnels.ms:3978/api/messages) comme point de terminaison de messagerie de l’assistant afin que Microsoft 365 sache où acheminer les messages. N’oubliez pas le suffixe /api/messages du point de terminaison.

Consultez Définir le point de terminaison de messagerie de l’assistant

Test avec Microsoft 365

Avec votre tunnel dev actif et un point de terminaison enregistré, testez votre assistant dans les applications Microsoft 365.

Test dans Microsoft Teams

  1. Démarrez votre assistant local en utilisant les instructions dans Installer les dépendances et lancez le serveur d’application de l’assistant.

  2. Vérifiez la connectivité du tunnel :

    devtunnel list

    Vérifiez que votre tunnel affiche des connexions hôtes actives. La colonne « Connexions hôtes » doit afficher un nombre supérieur à 0.

  3. Interagissez avec votre assistant sur Teams :

    • Ouvrez Microsoft Teams (web ou bureau)
    • Dans la barre de recherche de « Teams », recherchez votre assistant par nom ou par e-mail.
    • Démarrer une conversation avec l’assistant
    • Envoyez un message et observez la réponse
    • Vérifiez votre console locale pour les requêtes entrantes et l’activité de l’assistant.

Tester les notifications par courrier électronique

Si votre assistant est configuré pour recevoir des notifications par courrier électronique :

  1. Envoyer un courrier électronique à l’adresse e-mail de votre assistant
  2. Mettez votre assistant en copie dans un fil de messages par courrier électronique
  3. Surveillez votre console locale afin de détecter le webhook de notification
  4. Assurez-vous que votre assistant traite et répond correctement au courrier électronique

Tester l’intégration Word

Pour les assistants qui répondent aux commentaires Word :

  1. Ouvrez un document Word auquel votre assistant a accès.
  2. Ajoutez un commentaire mentionnant votre assistant.
  3. Vérifiez la notification sur votre console locale.
  4. Vérifiez que la réponse de votre assistant apparaît dans Word.

Surveillez l’activité du tunnel

Dev Tunnels fournit une inspection du trafic pour aider à déboguer les problèmes de connexion et à comprendre le flux des requêtes :

devtunnel show <tunnel-id>

Cette commande affiche :

  • Connexions actives et détails de session.
  • Informations de requête et de réponse.
  • Statistiques du volume de trafic.
  • Les erreurs de connexion et les avertissements.

Vous pouvez également surveiller l’activité du tunnel en temps réel en observant la sortie de la commande devtunnel host.

Maintenir les connexions des tunnels

Les tunnels dev exigent que le processus continue de fonctionner devtunnel host. Si l’inactivité, des problèmes réseau ou la mise en veille de votre ordinateur provoquent une coupure de connexion, vous devez le redémarrer.

Vérification de l’état du tunnel

Vérifiez si votre tunnel est actif :

devtunnel list

La sortie affiche :

  • ID du tunnel : Votre identifiant de tunnel
  • Connexions de l’hôte : Nombre de connexions actives (doit être au moins une lorsque devtunnel host est en cours d’exécution)
  • Ports : Ports configurés
  • Expiration : Temps d’expiration du tunnel

Si Connexions de l’hôte affiche 0, le tunnel existe mais n’est pas actuellement hébergé.

Redémarrer un tunnel déconnecté

Si la connexion de votre tunnel est interrompue, redémarrez le tunnel en utilisant le même identifiant de tunnel :

devtunnel host <tunnel-id>

L’URL du tunnel reste la même ; vous n’avez donc pas besoin de mettre à jour la configuration de votre point de terminaison de messagerie d’assistant.

Gardez les tunnels actifs pendant le développement

Pour maintenir des connexions stables :

  • Garder la fenêtre du terminal ouverte : ne fermez pas le terminal en cours d’exécution devtunnel host.
  • Empêcher la mise en veille de l’ordinateur : configurez votre système pour rester actif pendant les sessions de test.
  • Surveiller les erreurs de connexion : surveillez la sortie du terminal devtunnel host pour les messages de déconnexion.
  • Redémarrer après un changement de réseau : si vous changez de réseau ou vous reconnectez à un VPN, redémarrez le tunnel.

Astuce

Si votre tunnel se déconnecte fréquemment, vérifiez vos paramètres réseau et vos règles de pare-feu pour vous assurer qu’elles ne bloquent pas la connexion.

Nettoyer

Quand vous avez terminé les tests avec Dev Tunnels :

Arrêtez le tunnel

Appuyez sur Ctrl+C sur le terminal en marche devtunnel host pour arrêter le tunnel.

Cette commande supprime l’URL du Dev Tunnel du point de terminaison de messagerie de votre assistant. Lorsque vous déployez en production, définissez l’URL du point de terminaison hébergé dans le cloud.

Remarque

Le tunnel reste disponible pour une utilisation future jusqu’à ce que vous le supprimiez explicitement en utilisant devtunnel delete <tunnel-id>.

Limitations

Prenez en compte les limitations suivantes lors des tests avec Dev Tunnels :

  • Développement uniquement : utilisez Dev Tunnels pour le développement et les tests, pas en production.
  • Performances : attendez-vous à une latence plus élevée par rapport aux assistants hébergés dans le cloud en raison du routage réseau.
  • Stabilité des connexions tunnel : les connexions tunnel peuvent occasionnellement être interrompues et nécessiter un redémarrage manuel.
  • Considérations de sécurité : l’indicateur --allow-anonymous est pratique pour les tests, mais il ne doit pas être utilisé avec des données sensibles.
  • Gestion des sessions : vous devrez peut-être vous authentifier périodiquement selon la durée de votre session.

Étapes suivantes

Après avoir réussi les tests du Dev Tunnel :

Résolution des problèmes

Si vous rencontrez des problèmes lors des tests via les Dev Tunnels, commencez par ici pour les correctifs courants de tunnel, de connectivité et de terminaison. Pour une résolution plus large des problèmes de l’Agent 365 (configuration, authentification et messagerie), voir Résolution des problèmes.

Échec de la connexion au tunnel

Symptômes : le tunnel de développement ne démarre pas ou se déconnecte immédiatement.

Solutions :

  • Vérifiez que vous êtes connecté : devtunnel user login
  • Vérifiez si un autre processus utilise le même port
  • Assurez-vous que votre pare-feu autorise les connexions Dev Tunnel
  • Supprimez et recréez le tunnel : devtunnel delete <tunnel-id>, puis créez-en un nouveau

Les messages n’atteignent pas l’assistant local

Symptômes : Microsoft 365 indique que le message a été envoyé, mais votre assistant local ne le reçoit pas.

Solutions :

  • Confirmez que votre assistant fonctionne localement
  • Vérifiez que le tunnel est actif : devtunnel list devrait afficher « Connecté »
  • Vérifiez la configuration du point de terminaison dans a365.config.json et assurez-vous que votre URL Dev Tunnel est définie comme point de terminaison de messagerie.
  • Examinez les journaux Dev Tunnel dans le terminal exécutant devtunnel host pour détecter des erreurs de connexion
  • Assurez-vous que votre port local correspond au port tunnel (les deux devraient être 3978 par défaut)

Erreurs d’authentification via Dev Tunnel

Symptômes : erreurs 401 ou 403 lors des tests via le Dev Tunnel.

Solutions :

  • Vérifiez que l’authentification agentique est configurée (l’authentification par jeton porteur ne fonctionne pas avec Dev Tunnels pour l’intégration à Microsoft 365).
  • Vérifiez les identifiants du blueprint de l’assistant dans a365.generated.config.json.
  • Confirmez que votre assistant dispose des autorisations requises pour les opérations que vous testez.
  • Assurez-vous que vos jetons d’authentification n’ont pas expiré.

URL du tunnel modifiée ou expirée

Symptômes : l’URL du tunnel qui fonctionnait auparavant ne redirige plus vers votre assistant.

Solutions :

  • Vérifiez le statut du tunnel en utilisant devtunnel list.
  • Redémarrez le tunnel en utilisant devtunnel host <tunnel-id>.
  • Mettez à jour le point de terminaison de messagerie si l’URL a changé en utilisant a365 setup blueprint --endpoint-only.
  • Last updated on