Partager via

Agents de test en utilisant des tunnels de développement

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.

En utilisant les Dev Tunnels, vous pouvez tester votre agent Agent 365 avec des applications Microsoft 365 (comme Teams, Outlook ou Word) pendant que votre agent 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 des agents dans les environnements Microsoft 365 réels avant de déployer sur le cloud.

Prerequisites

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

Installer un tunnel de développement

Configurez un tunnel de développement pour exposer votre point de terminaison d’agent local aux services Microsoft 365.

Créez et commencez un tunnel

  1. Connexion au tunnel de développement :

    devtunnel user login

  2. Créez un tunnel persistant :

    devtunnel create --allow-anonymous

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

  3. Configurez le port tunnel :

    Attribuez le port utilisé par votre serveur agent (généralement 3978) :

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

  4. Commencez 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’étape suivante.

Conseil / Astuce

Utilisez-vous devtunnel list pour voir tous vos tunnels et devtunnel delete <tunnel-id> pour retirer des tunnels dont vous n’avez plus besoin.

Configurer le point de terminaison de messagerie de l’agent

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’agent afin que Microsoft 365 sache où renvoyer les messages. N’oubliez pas le /api/messages suffixe du point d’arrivée.

Veuillez consulter Définir le point de terminaison de messagerie agent

Test avec Microsoft 365

Avec votre Dev Tunnel actif et votre endpoint enregistré, testez votre agent dans les applications Microsoft 365.

Tester dans Microsoft Teams

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

  2. Vérifier la connectivité du tunnel :

    devtunnel list

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

  3. Interagissez avec votre agent dans Teams :

    • Ouvrir Microsoft Teams (web ou bureau)
    • Dans la barre de recherche Teams, recherchez votre agent par nom ou email
    • Engage une conversation avec l’agent
    • Envoyez un message et observez la réponse
    • Vérifiez votre console locale pour les requêtes entrantes et l’activité des agents

Notifications de test par e-mail

Si votre agent est configuré pour recevoir des notifications par email :

  1. Envoyez un e-mail à l’adresse de votre agent
  2. Mettez votre agent en copie dans un fil de discussion par e-mails
  3. Surveillez votre console locale pour le webhook de notification
  4. Vérifiez que votre agent traite et répond à l’e-mail

Intégration des mots de test

Pour les agents qui répondent aux commentaires Word :

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

Surveillez l’activité du tunnel

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

devtunnel show <tunnel-id>

Cette commande affiche :

  • Des connexions actives et des détails de session.
  • Informations sur les demandes et les réponses.
  • Statistiques du volume de trafic.
  • Erreurs de connexion et avertissements.

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

Maintenir les connexions des tunnels

Les tunnels de développement exigent que le processus continue d’être devtunnel host en fonctionnement. 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érifier l’état du tunnel

Vérifiez si votre tunnel est actif :

devtunnel list

La sortie affiche :

  • ID du tunnel : Votre identifiant de tunnel
  • Connexions hôte : Nombre de connexions actives (doit être une ou plusieurs lors de devtunnel host l’exécution)
  • Ports : Ports configurés
  • Expiration : Temps d’expiration du tunnel

Si Host Connections affiche 0, le tunnel existe mais n’est pas actuellement hébergé.

Redémarrer un tunnel déconnecté

Si votre connexion au tunnel tombe, redémarrez-la en utilisant le même identifiant de tunnel :

devtunnel host <tunnel-id>

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

Gardez les tunnels actifs pendant le développement

Pour maintenir des connexions stables :

  • Gardez la fenêtre du terminal ouverte - Ne fermez pas le terminal en marche devtunnel host.
  • Empêcher la veille de l’ordinateur - Configurez votre système pour rester éveillé pendant les sessions de test.
  • Surveillez les erreurs de connexion - Surveillez la sortie devtunnel host du terminal pour les messages de déconnexion.
  • Redémarrez après un changement de réseau - Si vous changez de réseau ou vous reconnectez au VPN, redémarrez le tunnel.

Conseil / Astuce

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

Nettoyage

Lorsque vous aurez fini de tester avec Dev Tunnels :

Arrêtez le tunnel

Appuyez 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 messagerie de votre agent. Lorsque vous déployez en production, définissez l’URL du point de terminaison hébergé dans le cloud.

Note

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

Limites

Considérez ces limitations lors des tests avec les Dev Tunnels :

  • Développement uniquement : Utilisez les tunnels de développement pour le développement et les tests, pas pour la production.
  • Performances : Attendez-vous à une latence plus élevée par rapport aux agents hébergés dans le cloud en raison du routage réseau.
  • Stabilité des connexions : Les connexions tunnel peuvent parfois tomber et nécessiter un redémarrage manuel.
  • Considérations de sécurité : Le --allow-anonymous drapeau est pratique pour les tests mais ne l’utilisez pas avec des données sensibles.
  • Gestion des sessions : Vous devrez peut-être vous authentifier périodiquement selon la durée de votre séance.

Étapes suivantes

Après des tests réussis 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 un dépannage plus large de l’Agent 365 (configuration, authentification et messagerie), voir Dépannage.

É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’agent local

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

Solutions :

  • Confirmez que votre agent est en activité locale
  • Vérifiez que le tunnel est actif : devtunnel list cela devrait indiquer « Connecté »
  • Vérifie la configuration du point de terminaison : a365 config display devrait afficher l’URL de ton Dev Tunnel
  • Vérifiez les journaux du Dev Tunnel dans le terminal en cours devtunnel host d’exécution 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 le Dev Tunnel

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

Solutions :

  • Vérifier que l’authentification agentique est configurée (l’authentification par jeton porteur ne fonctionne pas avec les tunnels de développement pour l’intégration Microsoft 365).
  • Vérifiez les identifiants des plans d’agent en utilisant a365 config display -g.
  • Confirmez que votre agent a les 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 agent.

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