Cycle de vie du 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 via la surveillance de la production. Au cœur de chaque agent est un modèle du catalogue de modèles Foundry qui pilote le raisonnement et la génération de réponse. À 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.

Conditions préalables

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.

  1. Choisissez un type d’agent : commencez par un agent basé sur des prompts ou un agent hébergé.
  2. Créez votre agent et commencez à tester : itérer dans le terrain de jeu ou dans le code.
  3. 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.
  4. Enregistrez les modifications en tant que versions : capturez des jalons significatifs et comparez les versions.
  5. 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.
  6. Évaluer la qualité et la sécurité : exécutez des évaluations reproductibles pour intercepter les régressions avant la publication. Pour des conseils conceptuels, voir les évaluateurs d'agents.
  7. Optimiser les agents hébergés (préversion) : améliorez automatiquement les instructions de votre agent hébergé et découvrez les compétences à l’aide de l’optimiseur d’agent.
  8. Publier et intégrer : Publiez un point de terminaison stable et intégrez-le à votre application. Pour découvrir les étapes, consultez Applications Agent dans Microsoft Foundry.
  9. 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 les agents.

Types d’agents dans Microsoft Foundry

Il existe deux 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 un modèle Foundry, des instructions, des outils et des invites en langage naturel pour piloter le comportement. Étendez-le en attachant des outils pour les connaissances et la mémoire. Modifiez, versionnez, testez, évaluez, surveillez et publiez des agents guidés par demande à partir de l'espace de développement des Agents dans le portail Foundry.

  • Hébergé : les agents hébergés sont des agents conteneurisés que vous générez dans le code à l’aide de frameworks pris en charge ou de code personnalisé. Le service Foundry Agent 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 basés sur des prompts sur le portail Foundry ou dans votre propre environnement de développement à l’aide de l’interface de ligne de commande (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.

À partir de l'onglet Code dans le volet de conversation du terrain de jeu de l'agent, 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 création d’agent offre des expériences intégrées pour chaque étape essentielle 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 une invite, enregistrez les modifications suivantes sous forme de nouvelles versions. Vous pouvez tester les modifications non enregistrées dans le terrain de jeu des agents. 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 l’enregistrement et la création d’une nouvelle version. 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 Description
    Configuration de l’agent Comparer les paramètres de configuration entre les versions à l’aide de la liste déroulante des versions
    Sortie du 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

Faire référence à des agents avec un schéma stable de type obtenir-ou-créer

Dans le code, vous faites référence à un agent par <agent_name>:<version>. Créez chaque agent une fois, puis conservez et réutilisez cet identificateur entre les sessions et les processus.

  • Créez une fois, réutilisez l’ID. Mettre en cache le nom ou l’ID de l’agent dont dépend votre application. Ne le recréez pas à chaque exécution.
  • Traitez 404 comme terminal. Si un appel GET, d’exécution ou d’utilisation renvoie 404 Not Found pour un ID que vous avez créé précédemment, l’agent a été supprimé. Recréez-le. Ne réessayez pas le même ID dans une boucle.
  • Préférez get-or-create. Au démarrage, recherchez l’agent par nom et créez-le uniquement si la recherche retourne 404. Cette approche conserve un ID stable unique et évite les doublons orphelins.

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 l’ajout d’outils pour les agents à l’aide d’une boîte à outils et de ce qui est disponible, consultez Vue d’ensemble de la boîte à outils.

Déboguer et valider à l’aide du traçage (préversion)

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 chauds de latence dans les appels de modèle et d'outil.

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.

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 Agents de traçage.

Planifier l’identité et les 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é 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 :

Publier votre agent

Après avoir créé une version d’agent avec laquelle vous êtes satisfait, publiez-la 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éattribuez les privilèges nécessaires à l'identité de l'application de l'agent.

Difficultés courantes dans 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.
  • Réutilisation de l’ID d’un agent supprimé : un ID d’agent est invalidé lors de la suppression de l’agent. Les appels qui font référence à un ID supprimé ou qui n’a jamais été créé renvoient 404 Not Found. Considérez un code 404 pour un identifiant précédemment valide comme définitif. Recréez l’agent (ou utilisez un modèle get-or-create) au lieu de réessayer le même ID. L’interrogation répétée d’un identifiant supprimé n’aboutit jamais et ne fait que générer du trafic d’erreur.

Contenu connexe

En savoir plus sur les types d’agents :

Configurez et étendez les agents :

Publier et surveiller des agents :

Déboguer et évaluer :

  • Last updated on