Utiliser l’extension Microsoft Foundry pour Visual Studio Code

Dans cet article, découvrez comment installer et utiliser l’extension Microsoft Foundry pour Visual Studio Code. Créez des projets, déployez des modèles à partir du catalogue de modèles Foundry, et interagissez avec les aires de jeu de modèles à partir de VS Code.

Important

Les éléments marqués (aperçu) dans cet article sont actuellement en aperçu public. Cette version préliminaire est fournie sans contrat de niveau de service, et nous la déconseillons pour les charges de travail en production. Certaines fonctionnalités peuvent être limitées ou non prises en charge. Pour plus d’informations, consultez Conditions d’utilisation supplémentaires pour les préversions de Microsoft Azure.

Prerequisites

• Un abonnement Azure. Créez-en un gratuitement.
• Visual Studio Code installé.
• Votre abonnement doit être inférieur à votre limite de quota pour déployer un nouveau modèle dans cet article. Si vous avez déjà atteint votre limite de quota, vous devez disposer d’un modèle de conversation déployé.
• Autorisations RBAC appropriées pour créer et gérer des ressources Foundry. Pour plus d’informations, consultez le contrôle d’accès en fonction du rôle pour Foundry.

Installer l’extension

Pour utiliser les fonctionnalités Foundry dans VS Code, installez l’extension Foundry pour Visual Studio Code. Installez à partir de Visual Studio Code Marketplace ou directement à partir de VS Code.

Installation à partir de la Place de marché Visual Studio Code

Utilisez la Place de marché pour installer l’extension sans ouvrir VS Code en premier.

1. Ouvrez la page d’extension Foundry pour Visual Studio Code.
2. Sélectionnez le bouton Installer.
3. Suivez les invites pour installer l’extension dans Visual Studio Code.
4. Après l’installation, ouvrez Visual Studio Code et vérifiez que l’extension est installée correctement à partir des messages d’état.
5. L’icône Foundry apparaît dans la barre de navigation principale sur le côté gauche de VS Code.

Installer depuis Visual Studio Code

Vous pouvez également rechercher l’extension directement à partir de la vue extensions VS Code.

1. Ouvrez VS Code.

2. Sélectionnez Extensions depuis le volet gauche.

3. Sélectionnez l’icône Paramètres en haut à droite dans le volet des extensions.

4. Recherchez et sélectionnez Foundry.

5. Sélectionnez Installer.

6. Une fois l’installation terminée, un message d’état confirme que l’extension est installée. L’icône Foundry s’affiche dans la barre de navigation de gauche.

Se connecter à vos ressources Azure

Après avoir installé l’extension, connectez-vous à votre abonnement Azure et ouvrez un projet Foundry pour commencer à utiliser des modèles, des agents et des terrains de jeux.

Note

Pour obtenir la liste complète des fonctionnalités disponibles dans l’extension, utilisez la palette de commandes. Sélectionnez F1 pour ouvrir la palette de commandes et rechercher Foundry. La capture d’écran suivante montre quelques-unes des commandes disponibles.

Connectez-vous à vos ressources

Connectez-vous à votre abonnement Azure afin que l’extension puisse accéder à vos projets Foundry et aux modèles déployés.

1. Sélectionnez l’icône Azure dans la barre de navigation VS Code.

2. Sélectionnez Se connecter à Azure... dans la vue Ressources Azure .

3. Dans la section Ressources , sélectionnez votre abonnement Azure et votre groupe de ressources.

4. Sélectionnez Foundry et cliquez avec le bouton droit sur votre projet.

5. Sélectionnez Ouvrir dans l’extension Foundry.

   Les ressources de votre projet Foundry apparaissent dans la vue d’extension, et l’icône Foundry s’affiche dans la barre de navigation VS Code.

Naviguer dans l’interface d’extension

L’extension Foundry organise votre espace de travail en trois sections principales.

Section	Contenu	Quand l′utiliser ?
Ressources	Modèles déployés, agents déclaratifs, agents hébergés, connexions et magasins vectoriels pour votre projet Foundry.	Affichez et gérez vos ressources de projet.
Outils	Catalogue de modèles, terrain de jeu de modèles, terrains de jeu d’agents (distants et locaux), visualiseur local et déploiement d’agents hébergés.	Déployez de nouveaux modèles, des invites de test et interagissez avec des agents.
Aide et commentaires	Documentation, dépôt GitHub, Déclaration de confidentialité Microsoft et liens de la communauté.	Obtenez de l’aide ou fournissez des commentaires.

Création d’un projet

Créez un projet Foundry directement à partir de l’extension pour organiser vos modèles et ressources.

1. Sélectionnez l’icône plus en regard des ressources dans la section Ressources de la vue d’extension Foundry.

   Vous pouvez créer un groupe de ressources ou en sélectionner un existant.

2. Pour créer un groupe de ressources :

   1. Sélectionnez Créer un groupe de ressources , puis appuyez sur Entrée.

   2. Entrez le nom du groupe de ressources Azure dans la zone de texte Entrée du nouveau groupe de ressources , puis appuyez sur Entrée.

   3. Sélectionnez l’emplacement à utiliser dans la liste des emplacements disponibles, puis appuyez sur Entrée.

3. Pour utiliser un groupe de ressources existant :

   • Sélectionnez le groupe de ressources que vous souhaitez utiliser dans la liste des groupes de ressources disponibles, puis appuyez sur Entrée.

4. Entrez le nom du projet Foundry dans la zone de texte Entrer le nom du projet , puis appuyez sur Entrée.

Après le déploiement du projet, une fenêtre contextuelle s’affiche avec le message Projet déployé avec succès.

Pour déployer un modèle dans le projet nouvellement créé, sélectionnez le bouton Déployer un modèle dans la fenêtre contextuelle. Cette action ouvre la page Catalogue de modèles dans laquelle vous pouvez sélectionner le modèle souhaité à déployer.

Changer le projet par défaut

Lorsque vous ouvrez un projet dans l’extension Foundry, ce projet est défini comme projet par défaut. Pour changer votre projet par défaut :

1. Cliquez avec le bouton droit sur le projet Foundry et sélectionnez l’option Changer de projet par défaut dans l’extension Azure .

2. Sélectionnez le projet Foundry que vous souhaitez utiliser dans la liste des projets disponibles, puis appuyez sur Entrée.

Le projet sélectionné affiche désormais la valeur par défaut après le nom du projet.

Conseil / Astuce

Cliquez avec le bouton droit sur le nom de votre projet pour accéder au point de terminaison du projet ou à la clé API du projet.

Utiliser des modèles

L’extension Foundry vous permet de découvrir, déployer et interagir avec des modèles à partir du catalogue de modèles Foundry directement dans VS Code.

Parcourir le catalogue de modèles

Le catalogue de modèles permet d’accéder aux modèles de Microsoft, OpenAI, Meta, DeepSeek et d’autres fournisseurs. Vous pouvez ouvrir le catalogue de modèles de plusieurs façons :

• Exécutez la commande Foundry : Ouvrir le catalogue de modèles à partir de la palette de commandes.
• Sélectionnez l’icône plus en regard des modèles dans la section Ressources de la vue d’extension Foundry.
• Sélectionnez le lien Catalogue de modèles dans la section Outils de la vue d’extension Foundry.

Ouvrir le catalogue de modèles à partir de la palette de commandes

Utilisez la palette de commandes pour ouvrir le catalogue de modèles sans naviguer dans la vue d’extension.

1. Sélectionnez F1 pour ouvrir la palette de commandes.

2. Entrez Foundry : Ouvrez le catalogue de modèles , puis appuyez sur Entrée.

3. La page Catalogue de modèles s’ouvre.

   

4. Filtrez le catalogue de modèlesen fonction du type Hébergé par, Publisher, Feature ou Model à l’aide des listes déroulantes situées en haut de la page. Sélectionnez le bouton Prise en charge du réglage fin pour filtrer les modèles qui prennent en charge le réglage fin.

5. Recherchez un modèle spécifique à l’aide de la barre de recherche en haut du centre de la page.

Ouvrez le catalogue de modèles à partir de la section Ressources

Dans la vue d’extension Foundry, sélectionnez l’icône plus en regard des modèles pour ouvrir le catalogue de modèles.

Conseil / Astuce

Vous pouvez également cliquer avec le bouton droit sur Modèles et sélectionner Déployer un nouveau modèle IA pour accéder directement au flux de déploiement.

Ouvrez le catalogue de modèles à partir de la section Outils

Dans la section Outils de la vue d’extension Foundry, double-cliquez sur le lien Catalogue de modèles .

Déployer un modèle à partir du catalogue de modèles

Une fois que vous avez trouvé un modèle dans le catalogue, déployez-le sur votre projet Foundry pour pouvoir l’utiliser dans vos applications.

1. Sélectionnez le bouton Déployer en regard du nom du modèle sélectionné.

2. La page De déploiement de modèle s’ouvre.

3. Entrez le nom du déploiement du modèle dans la zone de texte Entrer le nom du déploiement , puis appuyez sur Entrée.

4. Sélectionnez le type de déploiement dans la liste déroulante Type de déploiement .

5. Sélectionnez la version du modèle dans la liste déroulante Version du modèle .

6. (Facultatif) Ajustez les jetons par minute à l’aide du curseur Jetons par minute .

7. Sélectionnez le bouton Déployer dans Foundry dans le coin inférieur gauche.

8. Dans la boîte de dialogue de confirmation, sélectionnez Déployer.

9. Une fois le déploiement terminé, le modèle apparaît par nom de déploiement sous la section Modèles de votre projet.

Afficher et gérer les modèles déployés

Développez la section Modèles dans la vue d’extension Foundry pour afficher tous les modèles déployés dans votre projet.

Afficher les informations de carte de modèle

Sélectionnez un modèle déployé pour ouvrir un panneau avec les détails suivants :

• Informations de déploiement : nom, état d’approvisionnement, type de déploiement, limite de débit, informations de version, nom du modèle et version du modèle.
• Informations sur le point de terminaison : lien URI cible, type d’authentification et clé.
• Liens utiles : Exemples de référentiel de code et liens de didacticiel pour le développement d’applications IA.

Mettre à jour les paramètres de déploiement de modèle

Pour mettre à jour les paramètres de déploiement tels que les limites de débit :

1. Sélectionnez le bouton Modifier en haut à droite de la carte de modèle.
2. Mettez à jour les champs modifiables.
3. Cliquez ensuite sur le bouton Enregistrer pour appliquer les modifications.

Générer un exemple de code pour un modèle

Générez un fichier de code de démarrage pour votre modèle déployé afin d’accélérer le développement d’applications.

1. Cliquez avec le bouton droit sur votre modèle déployé et sélectionnez Ouvrir le fichier de code.

2. Sélectionnez votre SDK préféré dans la liste déroulante Choisir le SDK préféré .

3. Sélectionnez votre langue préférée dans la liste déroulante Choisir la langue .

4. Sélectionnez votre méthode d’authentification préférée dans la liste déroulante Choisir la méthode d’authentification .

5. Un exemple de fichier de code s’ouvre dans un nouvel onglet dans VS Code.

La capture d’écran suivante montre un exemple Python généré qui effectue un appel synchrone à l’API réponses :

Interagir avec des modèles dans le terrain de jeu

Utilisez le terrain de jeu de modèles pour discuter de manière interactive avec votre modèle déployé, ajuster les paramètres et modifier les instructions système.

Pour ouvrir le terrain de jeu, double-cliquez sur le lien Model Playground dans la section Outils de la vue d’extension Foundry. Vous pouvez également cliquer avec le bouton droit sur votre modèle déployé et sélectionner Ouvrir dans le terrain de jeu.

1. La page Playground s’ouvre.

2. Tapez votre invite d'entrée et passez en revue la sortie.

3. Sélectionnez Afficher le code dans le coin supérieur droit pour voir comment accéder au déploiement du modèle par programmation.

4. Sélectionnez le lien Historique en haut à gauche du terrain de jeu pour afficher votre historique des conversations.

Résoudre des problèmes courants

Si vous rencontrez des problèmes lors de l’utilisation de l’extension Foundry, vérifiez les problèmes courants suivants :

Problème	Résolution
L’extension n’apparaît pas après l’installation	Redémarrez VS Code et vérifiez que l’extension est activée dans la vue Extensions .
Échec de la connexion ou les abonnements ne se chargent pas	Vérifiez que votre compte Azure dispose des autorisations appropriées. Essayez de vous déconnecter et de vous reconnecter à partir de la vue Ressources Azure .
Échec du déploiement du modèle en raison d'une erreur de quota	Vérifiez votre quota d’abonnement et demandez une augmentation ou supprimez les déploiements inutilisés.

Nettoyer les ressources

Les ressources Azure que vous avez créées dans cet article sont facturées à votre abonnement Azure. Si vous pensez ne plus avoir besoin de ces ressources, supprimez-les pour éviter des frais supplémentaires.

Supprimer vos modèles

1. Dans la barre de navigation VS Code, actualisez l’extension Foundry. Dans la section Ressources , développez la sous-section Modèles .

2. Cliquez avec le bouton droit sur le modèle déployé que vous souhaitez supprimer, puis sélectionnez Supprimer.

Supprimer les ressources Azure

Pour supprimer le groupe de ressources et toutes les ressources à l’intérieur, il :

Avertissement

La suppression d’un groupe de ressources supprime définitivement toutes les ressources qu’il contient, y compris votre projet Foundry et tous les modèles déployés. Cette action ne peut pas être annulée.

1. Ouvrez le portail Azure.
2. Accédez au groupe de ressources qui contient votre projet Foundry.
3. Sélectionnez Supprimer le groupe de ressources et confirmez la suppression.

Prochaines étapes

• Explorer les modèles Foundry
• Déployer des modèles avec Foundry