Tester, déployer et intégrer des agents

Les tests, le déploiement et la publication des agents sont des étapes critiques pour passer du développement à la production. Microsoft Foundry fournit des fonctionnalités complètes pour valider le comportement de l’agent, le déploiement sur votre projet Foundry et la publication d’agents en tant que points de terminaison appelants que les consommateurs externes et les applications peuvent utiliser.

Stratégies de test pour les agents

Les tests approfondis garantissent que vos agents se comportent de manière fiable dans différents scénarios avant d’atteindre les utilisateurs. Le portail Foundry et l’extension Visual Studio Code fournissent des terrains de jeu pour les tests interactifs.

Utilisation efficace du terrain de jeu :

• Test de chemin d’accès heureux : vérifiez que l’agent gère correctement les demandes courantes et attendues.
• Test de cas Edge : essayez des entrées ambiguës, des informations incomplètes et des demandes inhabituelles pour révéler comment les agents gèrent l’incertitude.
• Test des limites : vérifiez que l’agent respecte les limites définies dans ses instructions en testant les demandes hors portée.
• Test de conversation à plusieurs tour - Vérifiez que l’agent conserve le contexte entre plusieurs échanges et s’appuie sur les réponses précédentes.
• Test d’appel d’outil : vérifiez que les agents appellent les bons outils au bon moment et incorporent correctement les résultats.

Enregistrez les résultats des tests pour suivre les améliorations et intercepter les régressions.

Déploiement d’agents sur votre projet

Microsoft Foundry prend en charge le déploiement d’agents à partir du portail ou de Visual Studio Code. Le déploiement enregistre la configuration de votre agent dans votre projet Foundry afin de pouvoir tester et itérer.

Déploiement à partir du portail Foundry

1. Accédez à votre agent dans le portail Foundry
2. Vérifier que la configuration et les résultats des tests sont satisfaisants
3. Sélectionner Enregistrer dans la page de l’agent
4. Confirmer les paramètres de version et de déploiement

Déploiement à partir de Visual Studio Code

1. Ouvrez votre agent dans le Kit de ressources Foundry
2. Sélectionnez Enregistrer dans Foundry pour envoyer (push) les modifications de configuration
3. Pour les agents hébergés, ouvrez le menu +Générer dans les outils de développement, puis sélectionnez Déployer sur Microsoft Foundry
4. Choisissez une méthode de déploiement :
   • Code (ZIP Code Deploy) : empaquette votre code source et le déploie directement sans image conteneur
   • Conteneur (BYOI) - Déployer à l’aide d’une image conteneur prédéfinie à partir de Azure Container Registry
5. Sélectionnez votre modèle et confirmez

Les deux approches conservent votre agent dans votre espace de travail de projet où les membres de l’équipe peuvent y accéder et les tester.

Déploiement d’agents sur un point de terminaison

Lorsque vous créez un agent dans Microsoft Foundry, il reçoit un point de terminaison stable, sa propre identité d’agent Entra et un blueprint d’agent automatiquement. La publication consiste ensuite à distribuer l’agent afin que les consommateurs et les applications externes, y compris Microsoft Teams et Microsoft 365 Copilot, puissent l’invoquer.

Ce que chaque agent inclut

Chaque agent créé dans Foundry est approvisionné avec :

• Point de terminaison stable : URL d’appel prête pour la production qui reste constante même lorsque vous mettez à jour les versions de l’agent.
• Identité d’agent Entra - identité Microsoft Entra dédiée avec sa propre étendue RBAC, distincte de l'identité partagée du projet.
• Stratégie d’authentification : authentification Microsoft Entra ID intégrée. Les appelants doivent avoir le rôle Utilisateur Foundry sur la ressource de l’agent. L’authentification par clé API n’est pas prise en charge.

Publier dans Microsoft Teams et Microsoft 365 Copilot

À partir du portail Foundry, vous pouvez publier des agents sur Microsoft Teams et Microsoft 365 Copilot en une seule étape, sans avoir à reconstruire. L’agent transite via un pipeline unifié vers les applications où les utilisateurs travaillent déjà.

Point de terminaison de l’agent

Les agents exposent un point de terminaison stable à l’aide du protocole de l’API Responses :

https://<foundry-resource-name>.services.ai.azure.com/api/projects/<project-name>/agents/<agent-name>/endpoint/protocols/openai/responses

Cette URL reste la même que vous déployez de nouvelles versions d’agent, de sorte que les consommateurs en aval ne sont pas perturbés par les mises à jour.

Vérification du point de terminaison

Après avoir créé et configuré votre agent, vérifiez que le point de terminaison fonctionne :

1. Obtenez un jeton d’accès :

   az account get-access-token --resource https://ai.azure.com
   

2. Appelez le point de terminaison de l’agent :

   curl -X POST \
     "https://<foundry-resource-name>.services.ai.azure.com/api/projects/<project-name>/agents/<agent-name>/endpoint/protocols/openai/responses?api-version=2025-11-15-preview" \
     -H "Authorization: ******" \
     -H "Content-Type: application/json" \
     -d '{"input":"Say hello"}'
   

Si vous recevez 403 Forbidden, vérifiez que l’appelant a le rôle Utilisateur Foundry sur la ressource de l’agent.

Mise à jour des agents

Pour déployer une nouvelle version de l’agent :

1. Apportez des modifications à votre environnement de développement et testez soigneusement
2. Dans le portail Foundry, enregistrez la configuration de l’agent mise à jour
3. L’endpoint achemine automatiquement le trafic vers la nouvelle version

L’URL du point de terminaison reste inchangée, de sorte que les intégrations existantes continuent de fonctionner.

Génération de code d’intégration

Le Kit de ressources Foundry pour VS Code génère un exemple de code d’intégration pour connecter votre application à un agent publié :

1. Sélectionnez votre agent déployé dans la vue Mes ressources
2. Sélectionner Afficher le code
3. Choisir votre dossier
4. L’extension génère du code pour l’authentification, la connexion, l’envoi de messages et le traitement des réponses

Modèles d’intégration

Les modèles courants pour l’intégration d’agents publiés sont les suivants :

• Applications web : envoyez des messages utilisateur au point de terminaison de l’API Réponses et affichez les réponses dans votre interface utilisateur. Stocker l’historique des conversations côté client pour les interactions à plusieurs tours.
• Flux de travail pilotés par l’API : appelez le point de terminaison de l’agent à partir des services principaux déclenchés par des événements ou des planifications. Traitez les réponses par programmation pour générer des actions en aval.
• Interfaces de chatbot : mapper les sessions utilisateur aux conversations. Gérez l’échange de messages en temps réel via le point de terminaison.
• Automatisation en arrière-plan - Planifier des appels d’agent pour les tâches périodiques. Alimentez les données système dans les agents et traitez les sorties pour mettre à jour les systèmes métier.

Considérations relatives à la production

L’exécution d’agents dans des environnements de production nécessite une attention particulière à plusieurs domaines opérationnels :

• Surveillance : suivez les temps de réponse, les taux de réussite des appels d’outils, les modèles d’erreur et la consommation de jetons à l’aide de l’intégration d’Application Insights.
• Sécurité : utilisez des identités managées pour l’authentification, appliquez l’accès avec des privilèges minimum et définissez des stratégies de rétention des données.
• Gestion des coûts : surveillez l’utilisation des jetons, définissez des limites de longueur de réponse et implémentez la limitation du débit pour éviter les pics inattendus.
• Gestion des erreurs : implémentez une logique de nouvelle tentative avec interruption exponentielle pour les échecs temporaires. Gérer la limitation du débit avec des stratégies de limitation progressive. Validez les entrées avant d’envoyer aux agents.
• Gestion des conversations - les endpoints de l’agent prennent actuellement en charge uniquement la Responses API sans état. Stockez l’historique des conversations dans votre application client pour des expériences à tours multiples.