Utiliser l’extension Microsoft Foundry pour Visual Studio Code (préversion)

Microsoft Foundry fournit une plateforme unifiée pour les opérations ia d’entreprise, les générateurs de modèles et le développement d’applications. Cette base combine l’infrastructure de niveau production avec des interfaces conviviales, ce qui permet aux organisations de créer et d’exploiter des applications IA en toute confiance.

Avec Foundry, vous pouvez :

• Déployer les derniers modèles de langage à partir de Microsoft, OpenAI, Meta, DeepSeek, et bien plus encore à l’aide du catalogue de modèles robuste

• Tester les modèles déployés dans un terrain de jeu de modèles

• Prise en main rapide du développement d’applications IA génératives à l’aide d’une collection de modèles de code organisés Azure

• Configurer et déployer des agents avec le service d'Agent Foundry

Avec l’extension Foundry pour Visual Studio Code, vous pouvez accomplir une grande partie de ce flux de travail directement à partir de Visual Studio Code. Il est également fourni avec d’autres fonctionnalités, telles que les modèles de code, les environnements interactifs, et l’intégration avec d'autres extensions et fonctionnalités VS Code.

Cet article explique comment commencer rapidement à utiliser les fonctionnalités de l’extension Foundry pour Visual Studio Code.

Conditions préalables

Avant d’utiliser l’extension Foundry pour Visual Studio Code, vous devez :

• Télécharger, installer et configurer Visual Studio Code. En savoir plus : Télécharger Visual Studio Code

• Votre abonnement doit être inférieur à votre limite de quota pour déployer un nouveau modèle dans ce guide de démarrage rapide. Sinon, vous devez déjà disposer d’un modèle de conversation déployé.

• Définissez les autorisations RBAC appropriées pour créer et gérer des ressources Foundry avec l’extension Visual Studio Code. Pour plus d’informations, consultez le contrôle d’accès en fonction du rôle pour Foundry.

Installation

Après avoir installé Visual Studio Code, vous devez installer l’extension Foundry pour Visual Studio Code.

Pour installer l’extension Foundry pour Visual Studio Code, vous pouvez utiliser Visual Studio Code Marketplace ou l’installer directement à partir de Visual Studio Code.

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

Pour installer l’extension Foundry pour Visual Studio Code à partir de Visual Studio Code Marketplace, procédez comme suit :

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’extension doit maintenant être visible dans la barre de navigation principale située à gauche de Visual Studio Code.

Installer depuis Visual Studio Code

Pour installer l’extension Foundry pour Visual Studio Code dans Visual Studio Code, procédez comme suit :

1. Ouvrez Visual Studio 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. Vérifiez que l’extension est bien installée à avec les messages d’état.

Commencez

Commencez avec l’extension Foundry en suivant les étapes suivantes.

Connectez-vous à vos ressources

Connectez-vous à votre abonnement Azure pour accéder à vos ressources en procédant comme suit :

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

2. Connectez-vous en sélectionnant l’élément Sign in to Azure... dans la vue Ressources Azure .

   

3. Sous 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.

   

Explorer l’extension Foundry

L’extension Foundry s’ouvre dans son propre affichage, avec l’icône Foundry maintenant affichée dans la barre de navigation VS Code. L’extension comporte trois sections principales : Ressources, Outils et Aide et Commentaires.

• Ressources : cette section contient les ressources auxquelles vous avez accès dans votre projet Foundry. La section Ressources est l’affichage principal de l’interaction avec vos services Foundry. Il contient les sous-sections suivantes :

  • Modèles : cette section contient les modèles que vous pouvez utiliser pour générer et déployer vos applications IA. La vue Modèles est l’emplacement où vous pouvez trouver vos modèles déployés dans votre projet Foundry.
  • Agents : cette section contient vos agents déployés dans votre projet Foundry.
  • Ressources : cette section contient les ressources dont vous disposez dans votre projet Foundry.
    • Connexions : cette sous-section contient les connexions que vous avez dans votre projet Foundry. par exemple, connexions Bing Grounding.
    • Magasins de vecteurs : cette sous-section contient les magasins vectoriels que vous avez dans votre projet Foundry.
  • Threads : cette section contient les threads et s’exécute à partir d’un agent déployé dans votre projet Foundry.

• Outils : cette section contient les outils que vous pouvez utiliser pour générer et déployer vos applications IA. L’affichage Outils est l’emplacement où vous pouvez trouver les outils disponibles pour le déploiement, puis utiliser vos modèles et agents déployés. Il contient les sous-sections suivantes :

  • Catalogue de modèles : lien vers le catalogue de modèles que vous pouvez utiliser pour découvrir et déployer des modèles.
  • Model Playground : lien vers le terrain de jeu de modèles pour interagir avec vos modèles déployés dans votre projet Foundry.
  • Agent Playground : lien vers le terrain de jeu de l’agent pour interagir avec vos agents déployés dans votre projet Foundry.

• Aide et commentaires : cette section contient des liens vers la documentation Foundry, les commentaires, le support et la Déclaration de confidentialité Microsoft. Il contient les sous-sections suivantes :

  • Documentation : lien vers la documentation de l’extension Foundry.
  • GitHub : lien vers le dépôt GitHub de l’extension Foundry.
  • Déclaration de confidentialité Microsoft : lien vers la Déclaration de confidentialité Microsoft.
  • Rejoignez la communauté Foundry : Discord + Forum : Lien vers le serveur Discord de la communauté Foundry.

Création d’un projet

Vous pouvez créer un projet Foundry à partir de la vue Extension Foundry en procédant comme suit :

1. Sélectionnez l’icône plus en regard des ressources dans la section Ressources de la vue 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. Dans le centre supérieur, sélectionnez Créer un groupe de ressources , puis appuyez sur Entrée.

      

   2. Dans le centre supérieur, entrez le nom du groupe de ressources Azure à utiliser dans la zone de texte Entrée du nouveau groupe de ressources , puis appuyez sur Entrée.

   3. Dans le centre supérieur, sélectionnez l’emplacement à utiliser dans la liste des emplacements disponibles, puis appuyez sur Entrée.

3. Pour utiliser un groupe de ressources existant :

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

4. Dans la partie supérieure centrale, entrez le nom du projet Foundry à utiliser dans la zone de texte Entrez 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 la vue Extension Foundry pour sélectionner le modèle souhaité à déployer.

Le projet Foundry par défaut

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

Changez votre projet par défaut en procédant comme suit :

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

2. En haut au centre, sélectionnez le projet Foundry que vous souhaitez utiliser dans la liste des projets disponibles, puis appuyez sur Entrée.

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

Utiliser des modèles

L’extension Foundry pour Visual Studio Code vous permet de créer, d’interagir et de déployer des modèles de langage volumineux à partir de Visual Studio Code.

Explorer tous les modèles avec le catalogue de modèles

Le catalogue de modèles dans le portail Foundry est le hub pour découvrir et utiliser un large éventail de modèles pour la création d’applications IA génératives.

Accédez au catalogue de modèles de plusieurs façons différentes :

• Commande de la palette de commandes Foundry : « Ouvrir le catalogue de modèles ».
• Sélectionnez l’icône plus en regard des modèles dans la section Ressources de la vue Extension Foundry.
• Sélectionnez le lien Catalogue de modèles dans la section Outils de la vue Extension Foundry.

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

Accédez au catalogue de modèles à partir de la palette de commandes pour explorer et déployer une sélection organisée de modèles disponibles dans Foundry, directement à partir de VS Code.

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’affiche.

   

4. Filtrez le catalogue de modèles par Publisher et/ou Task à l’aide des listes déroulantes situées en haut à gauche de la page.

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

Le catalogue de modèles est également disponible dans la section Ressources de la vue Extension Foundry.

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

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

Le catalogue de modèles est également disponible dans la section Outils de la vue Extension Foundry. Double-cliquez sur le lien Catalogue de modèles pour ouvrir le catalogue de modèles.

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

Déployez un modèle sélectionné dans le catalogue de modèles en procédant comme suit :

1. Sélectionnez le déploiement dans Azure immédiatement après le nom du modèle sélectionné.

   

2. La page Modèle de déploiement s’affiche.

   

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

   

4. Sélectionnez le type de déploiement à utiliser dans la liste déroulante Type de déploiement, puis appuyez sur Entrée.

   

5. Sélectionnez la version du modèle à utiliser dans la liste déroulante Version du modèle, puis appuyez sur Entrée.

   

6. (Facultatif) Sélectionnez les jetons par minute à utiliser dans le curseur Jetons par minute, puis appuyez sur Entrée.

7. Dans le coin inférieur gauche, sélectionnez le bouton Déployer dans Foundry pour déployer le modèle.

8. Une boîte de dialogue de confirmation s’affiche. Sélectionnez le bouton Déployer pour déployer le modèle sur votre projet.

   

9. Une fois le déploiement réussi, votre modèle est répertorié par nom de déploiement avec vos autres modèles déployés sous la section Modèles de votre projet.

   

Afficher les modèles déployés

Dans la vue Extension des ressources Azure, sélectionnez l’icône caret en face de la section Modèles pour afficher la liste des modèles déployés.

La section Modèles développés affiche la liste des modèles déployés.

Afficher les informations de carte de modèle

La sélection d’un modèle déployé ouvre un panneau qui fournit des informations de base :

• Informations de déploiement : cette section contient les informations sur le modèle :
  • Nom
  • État de provisionnement
  • Type de déploiement
  • Informations sur la limite de débit
  • Informations de version
  • Nom du modèle
  • Version du modèle
• Informations sur le point de terminaison : cette section contient le lien URI cible, le type d’authentification et la clé.
• Liens utiles : cette section contient l’exemple de référentiel de code et les liens de didacticiel pour commencer à utiliser le développement d’applications IA.

Mettre à jour un modèle

Pour mettre à jour les informations de carte de modèle, sélectionnez le bouton Modifier en haut à droite de la carte de modèle.

Mettez à jour les champs modifiables souhaités, tels que la limite de débit directement dans VS Code.

Pour enregistrer les modifications, sélectionnez le bouton Enregistrer en haut à droite de la carte de modèle.

Explorer l’exemple de code de modèle

Créez un exemple de fichier de code en procédant comme suit.

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

   

2. Dans le centre supérieur, sélectionnez votre SDK préféré à utiliser dans la liste déroulante Choisir le SDK préféré , puis appuyez sur Entrée.

   

3. Dans le centre supérieur, sélectionnez votre langue préférée à utiliser dans la liste déroulante Choisir la langue , puis appuyez sur Entrée.

   

4. Dans le centre supérieur, sélectionnez votre méthode d’authentification préférée à utiliser dans la liste déroulante Choisir la méthode d’authentification , puis appuyez sur Entrée.

   

Exemple de fichier de code

Cet exemple de fichier de code Python est conçu pour illustrer un appel de base à l’API de complétion de chat. L’appel est synchrone :

Interagir avec des modèles à l’aide d’un terrain de jeu de modèles

Discutez de manière interactive avec le modèle, modifiez les paramètres et les instructions système à l’aide de Model Playground.

Le terrain de jeu de modèles est disponible dans la section Outils de la vue Extension Foundry. Double-cliquez sur le lien Model Playground pour ouvrir model Playground.

Vous pouvez également ouvrir le terrain de jeu de modèle en procédant comme suit :

1. Cliquez avec le bouton droit sur votre modèle déployé et sélectionnez l’option Ouvrir dans le terrain de jeu .

   

2. La page Playground s’affiche.

   

3. Tapez votre requête et consultez les sorties.

4. En outre, vous pouvez utiliser le code d’affichage dans le coin supérieur droit pour afficher des détails sur l’accès au déploiement du modèle par programmation.

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

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 pour afficher la liste des modèles déployés.

2. Cliquez avec le bouton droit sur votre modèle déployé pour supprimer et sélectionnez l’option Supprimer .

   

Supprimer vos outils

Supprimez l’outil connecté en procédant comme suit :

1. Ouvrez le portail Azure
2. Sélectionnez le groupe de ressources Azure contenant l’outil.
3. Sélectionnez le bouton Supprimer .

Étapes suivantes

• Découvrez comment utiliser le service Agent à l’aide de cette extension Visual Studio Code.