Vue d’ensemble de l’extension de l’agent Foundry Microsoft

L’extension d’agent Microsoft Foundry de l’Azure Developer CLI (azd) génère la structure de base, provisionne et déploie des agents sur Microsoft Foundry depuis votre terminal ou votre éditeur. Il associe les capacités d’agent Foundry aux azd commandes de cycle de vie pour un flux de travail cohérent du local au cloud. Vous pouvez passer d’un exemple d’agent à un point de terminaison pouvant être déployé et pouvant être appelé avec quelques commandes.

Cet article présente l’extension. Pour obtenir des instructions pas à pas complètes, consultez la documentation des agents hébergés Microsoft Foundry.

Fonctionnalités clés

Fonctionnalité Description
Structure de projet Configure des projets d’agent complets, notamment l’infrastructure en tant que modèles de code, les définitions d’agent et la configuration, afin de pouvoir démarrer immédiatement l’itération.
Configuration déclarative Définit des services, des ressources et des déploiements de modèles dans un fichier pour des azure.yaml environnements cohérents.
Approvisionnement et déploiement unifiés S’exécute azd up pour générer des conteneurs, envoyer (push) des images, créer des ressources, déployer des modèles et publier l’agent en une seule étape.
Gestion des définitions d’agent Importe les définitions d’agent à partir de catalogues, de GitHub ou de chemins d’accès locaux et mappe les paramètres requis aux variables d’environnement.
Sécurisé par défaut Configure automatiquement les identités managées et la sécurité de base sans gérer manuellement les informations d’identification.
Approvisionnement de modèles évolutifs Spécifie les noms de modèle, les versions et la capacité, et les déploie de manière cohérente entre les environnements.

Explorer le flux de travail

L’extension suit un cycle de vie classique azd, de la génération de la structure de base à un agent opérationnel :

  1. Scaffold: Initialiser un projet d’exemple d’agent, y compris l’infrastructure en tant que code, une définition d’agent ainsi que sa configuration.
  2. Provisionner et déployer : créez le compte et le projet Foundry, déployez des modèles, générez et envoyez (push) le conteneur de l’agent et publiez l’agent.
  3. Exécutez localement : itérer sur l’agent sur votre ordinateur local lors de la connexion à des ressources de Azure distantes.
  4. Invoquer et surveiller : envoyez des prompts à l’agent déployé et consultez les journaux en temps réel.
  5. Suppression: Supprimez toutes les ressources provisionnées une fois que vous avez terminé.

Essayez-le

Essayez de déployer un exemple d’agent avec le flux de travail minimal. Cet exemple utilise l’exemple Agent Framework de base de la documentation Microsoft Foundry.

  1. Structurer un exemple de projet d’agent dans un dossier vide :

    azd ai agent init -m https://github.com/microsoft-foundry/foundry-samples/blob/main/samples/python/hosted-agents/agent-framework/responses/01-basic/azure.yaml

  2. Provisionnez des ressources et déployez l’agent en une seule étape :

    azd up

    Tip

    Vous pouvez également fractionner cette étape en azd provision et azd deploy pour plus de contrôle sur chaque étape.

  3. Supprimez toutes les ressources approvisionnées lorsque vous avez terminé :

    azd down

    Avertissement

    azd down supprime définitivement chaque ressource du groupe de ressources. Utilisez-le avec soin dans des environnements partagés ou de production.

Pour connaître les prérequis, la sélection du modèle, les tests locaux et la résolution des problèmes, consultez Démarrage rapide : Déployer votre premier agent hébergé.

Quand utiliser l’extension de l’agent

Microsoft Foundry prend en charge plusieurs façons de générer et de déployer des agents hébergés, notamment le sdk Python, les Visual Studio Code et le portail. L’extension azd de l’agent est la meilleure solution lorsque vous souhaitez :

  • Travaillez principalement à partir du terminal ou de l’éditeur avec un flux de travail reproductible et scriptable.
  • Gérez ensemble l’infrastructure et les agents à l’aide de fichiers déclaratifs azure.yaml et Bicep sous contrôle de code source.
  • Passez en toute cohérence de l’environnement local au cloud à l’aide des mêmes azd commandes du cycle de vie (azd init, azd up, azd down) que vous utilisez déjà pour d’autres applications Azure.
  • Normalisez les déploiements dans les environnements (développement, test et production) et automatisez-les dans CI/CD.

Pour une expérience de portail guidée ou pour créer des agents avec le kit sdk Python, commencez par la documentation des agents hébergés Microsoft Foundry à la place.

Ressources supplémentaires

  • Last updated on