Cycle de développement de l’agent

Le cycle de vie du développement de l’agent dans Microsoft Foundry s’étend de la création initiale à l’analyse de production. À l’issue de ce cycle de vie, vous pouvez créer des agents fiables, détecter les problèmes tôt et expédier en toute confiance. Utilisez le portail Ou le code Foundry pour générer, personnaliser et tester le comportement de votre agent. Effectuez ensuite une itération avec le suivi, l’évaluation et la surveillance pour améliorer la qualité et la fiabilité. Lorsque vous êtes prêt, publiez votre agent en tant qu’application agent pour le partager et l’intégrer à vos applications.

Cet article est destiné aux développeurs qui souhaitent créer, tester et expédier des agents prêts pour la production.

Prerequisites

Un projet Microsoft Foundry
Familiarité avec le terrain de jeu Agents
Pour le développement de code : Connaissance de la configuration de l’environnement de développement

Cycle de vie en un clin d’œil

Utilisez ce cycle de vie comme liste de contrôle pratique pendant la génération et l’expédition d’un agent.

Choisissez un type d’agent : commencez par un agent basé sur une invite, un flux de travail ou un agent hébergé.
Créez votre agent et commencez à tester : itérer dans le terrain de jeu ou dans le code.
Ajoutez des outils et des données : attachez des outils pour la récupération et les actions, puis validez la configuration avant d’enregistrer.
Enregistrez les modifications en tant que versions : capturez des jalons significatifs et comparez les versions.
Déboguer avec le suivi : utilisez le suivi pour confirmer les appels d’outils, la latence et le comportement de bout en bout. Pour plus d’informations, consultez la vue d’ensemble du suivi de l’agent.
Évaluer la qualité et la sécurité : exécutez des évaluations reproductibles pour intercepter les régressions avant la publication. Pour des conseils conceptuels, consultez les évaluateurs d’agents.
Publier et intégrer : Publiez un point de terminaison stable et intégrez-le à votre application. Pour connaître les étapes à suivre, consultez Publier et partager des agents dans Microsoft Foundry.
Surveiller et itérer : surveillez les performances et la qualité en production, puis mettez à jour et republiez si nécessaire. Pour obtenir des conseils, consultez Surveiller la qualité et la sécurité.

Types d’agent dans Microsoft Foundry

Il existe trois types d’agents :

Basé sur les invites : un agent basé sur les invites est un agent unique défini de manière déclarative qui combine la configuration du modèle, les instructions, les outils et les invites en langage naturel pour piloter le comportement. Étendez-le en attachant des outils pour les connaissances et la mémoire. Modifiez, version, testez, évaluez, surveillez et publiez des agents basés sur des invites à partir du terrain de jeu Agents dans le portail Foundry.
Flux de travail : utilisez des flux de travail pour créer un flux de travail plus avancé qui orchestre une séquence d’actions ou coordonne plusieurs agents. Les flux de travail ont leur propre interface dans le portail, mais le même cycle de vie s’applique. Pour plus d’informations, consultez Générer un flux de travail dans Microsoft Foundry.
Hébergé (préversion) : les agents hébergés sont des agents conteneurisés que vous générez dans le code à l’aide d’infrastructures prises en charge ou d’un code personnalisé. Le service de l’agent Foundry déploie et gère ces agents. Vous ne modifiez pas les agents hébergés dans l’interface utilisateur de création d’agent, mais vous pouvez toujours appeler, évaluer, surveiller et publier ces agents. Pour plus d’informations, consultez Qu’est-ce que les agents hébergés ?

Créez des agents et des workflows basés sur des invites dans le portail Foundry ou votre propre environnement de développement à l’aide de l’interface CLI, du SDK ou de l’API REST. Pour plus d’informations, consultez le guide de démarrage rapide.

Création d’un agent basé sur une invite

Si vous connaissez déjà le type d’agent que vous souhaitez créer, nommez-le, puis commencez à configurer ses instructions et outils de modèle.

Note

Après avoir nommé votre agent, vous ne pouvez pas modifier le nom. Dans le code, vous faites référence à votre agent par <agent_name>:<version>.

Développer des agents dans le code

Si vous préférez travailler dans le code, utilisez des méthodes prises en charge pour placer votre code agent dans un environnement de développement à partir duquel vous pouvez tester localement, puis déployer sur Azure.

Dans l’onglet Code du volet de conversation de l’agent playground, vous pouvez prendre un extrait de code qui référence votre agent à un visual Studio Code dédié pour l’environnement cloud Web. L’extrait de code est préconfiguré avec les packages et les extensions dont vous avez besoin, ainsi que des instructions pour développer et déployer efficacement votre agent Foundry sur Azure. Vous pouvez également copier l’extrait de code directement dans votre environnement de développement préféré. Pour plus d’informations, consultez la documentation sur le terrain de jeu.

Fonctionnalités principales pour le cycle de vie du développement de l’agent

L'expérience de développement d'agent propose des solutions intégrées pour chaque étape clé du cycle de vie du développement d'un agent. Utilisez ces fonctionnalités principales lorsque vous développez votre application d’agent prête pour la production. Chaque fonctionnalité dispose d’une documentation détaillée dans laquelle vous pouvez en savoir plus.

Enregistrer les modifications en tant que versions

Après avoir créé la première version d’un agent basé sur des invites ou d’un flux de travail, enregistrez les modifications suivantes en tant que nouvelles versions. Vous pouvez tester les modifications non enregistrées dans le terrain de jeu de l’agent. Toutefois, si vous souhaitez afficher l’historique des conversations, surveiller les performances de votre agent ou exécuter des évaluations complètes, vous devez enregistrer vos modifications.

Le contrôle de version de l’agent fournit les fonctionnalités suivantes pour gérer les configurations et les itérations de l’agent. Ce système garantit que toutes les modifications sont suivies, testables et comparables entre les versions.

Immuabilité de version : chaque version d’un agent est immuable après l’avoir enregistrée. Toutes les modifications apportées à une version existante nécessitent d'être d'abord enregistrées puis qu'une nouvelle version soit créée. Cette exigence permet de garantir l’intégrité de la version et d’empêcher les remplacements accidentels.
Gestion de l’état brouillon : vous pouvez tester des agents dans un état non enregistré pour l’expérimentation. Vous perdez les modifications non enregistrées si vous quittez le portail Foundry, donc enregistrez fréquemment pour conserver les modifications importantes.
Opérations de contrôle de version : vous pouvez diriger les demandes vers des versions d’agent spécifiques pour activer les fonctionnalités de déploiement et de restauration contrôlées.

Navigation dans l’historique des versions : Accédez à l’historique des versions de n’importe quel agent, accédez à une version spécifique et effectuez les comparaisons suivantes :

Type de comparaison	Descriptif
Configuration de l’agent	Comparer les paramètres de configuration entre les versions à l’aide de la liste déroulante des versions
Sortie de chat	Analyser les différences de réponse entre les versions de l’agent à l’aide d’entrées identiques
Définition YAML	Passer en revue les différences dans les définitions d’agent

Ajouter des outils

Rendre votre agent plus puissant en lui donnant des connaissances (fichiers ou index spécifiques) ou en lui permettant d’effectuer des actions (appeler des API externes). Les outils sont disponibles pour la plupart des cas d’usage, à partir de chargements de fichiers simples vers des connexions de serveur MCP (Model Context Protocol) personnalisées. Pour des outils plus complexes, vous devrez peut-être configurer l’authentification ou ajouter des connexions dans le cadre de leur attachement à un agent.

Pour enregistrer un agent avec un outil attaché, vous devez configurer l’outil avec succès. Réutiliser les outils configurés entre les agents. Pour plus d’informations sur les outils disponibles, consultez le catalogue d’outils.

Déboguer et valider à l’aide du tracé (aperçu)

Lorsque vous ajoutez des outils et modifiez les invites, utilisez le suivi pour valider le fonctionnement global :

Vérifiez si l’agent a appelé les outils attendus.
Inspectez les entrées et sorties de l’outil.
Identifiez les points critiques de latence dans les appels de modèles et d’outils.

Pour plus d’informations, consultez la vue d’ensemble du suivi de l’agent.

Évaluer la qualité et la sécurité (aperçu)

Avant de publier votre agent (et après toute modification significative), exécutez des évaluations pour intercepter les régressions et mesurer la qualité de manière cohérente entre les versions.

Pour découvrir les dimensions d’évaluation clés des agents, consultez Évaluateurs d'agents.
Pour un workflow orienté code que vous pouvez automatiser, consultez Évaluez vos agents d'IA localement.

Surveiller après la publication

Après avoir publié une application agent, traitez-la comme un logiciel de production :

Surveillez les signaux de qualité et de sécurité.
Passez en revue les traces lorsque le comportement change.
Mettez à jour et republiez lorsque vous corrigez des problèmes ou apportez des améliorations.

Pour obtenir des conseils, consultez Surveiller la qualité et la sécurité.

Planification de l'identité et des autorisations

Les outils et les ressources en aval nécessitent souvent une authentification. Lorsque vous publiez un agent, son modèle d’identité et d’autorisation peut changer. Vérifiez que votre agent publié a uniquement l’accès dont il a besoin.

Pour plus d’informations, consultez les concepts d’identité de l’agent dans Microsoft Foundry.

Sécurité et accès

Traitez la configuration de votre agent comme le code d’application. Protégez les secrets et les autorisations tout au long du cycle de vie :

Utilisez les privilèges minimum et les attributions de rôles au lieu d’incorporer des clés. Pour plus d’informations, consultez le contrôle d’accès en fonction du rôle dans le portail Foundry.
Stockez les secrets dans un magasin de secrets managés et référencez-les par le biais de connexions au lieu de les coder en dur dans du code, des fichiers de configuration ou des invites. Pour obtenir des conseils, consultez Configurer une connexion Key Vault.
Avant de publier, vérifiez que l'identité de l'agent et les connexions des outils dans l'application de l'agent publiée ont uniquement l'accès dont elles ont besoin. Pour plus d’informations, consultez les concepts d’identité de l’agent dans Microsoft Foundry.

Publier votre agent ou flux de travail

Après avoir créé un agent ou une version de workflow avec laquelle vous êtes satisfait, publiez-le en tant qu’application agent. Vous obtenez un point de terminaison stable que vous pouvez ouvrir et tester dans le navigateur, partager avec d’autres personnes ou incorporer dans vos applications existantes. Vous et vos collaborateurs pouvez valider les performances et identifier les besoins d’affinement. Effectuez les mises à jour nécessaires et republiez une nouvelle version à tout moment.

Important

Les autorisations affectées à l’identité de projet ne sont pas transférées automatiquement vers l’agent publié. Après la publication, réaffectez les privilèges nécessaires à l’identité de l’application agent.

Pièges courants pour le développement d’agents

Les modifications non enregistrées sont temporaires : si vous souhaitez comparer des versions, afficher l’historique ou exécuter des évaluations complètes, enregistrez vos modifications en tant que version.
Les outils doivent être configurés avant d’enregistrer : si un outil nécessite une authentification ou une connexion, effectuez la configuration avant d’enregistrer.
La publication peut nécessiter des mises à jour d’autorisation : après la publication, vérifiez à nouveau l’accès aux ressources pour l’identité de l’agent publié et supprimez tout accès dont l’agent n’a plus besoin.

En savoir plus sur les types d’agents :

Configurez et étendez les agents :

Publier et surveiller des agents :

Déboguer et évaluer :

Commentaires

Cette page a-t-elle été utile ?

Last updated on 2026-02-28