Partager via

Préparer votre environnement de développement

Configurez votre environnement de développement pour utiliser le Kit de développement logiciel (SDK) Microsoft Foundry. Vous avez également besoin d'Azure CLI pour l'authentification afin que votre code puisse accéder à vos informations d'identification utilisateur.

Dans cet article, vous installez des runtimes de langage, l’interface Azure CLI, la CLI Azure Developer, l’extension Foundry VS Code et Git.

Important

Cet article couvre uniquement les prérequis généraux , tels que les runtimes de langage, les outils globaux et la configuration de l’extension VS Code.
Elle ne couvre pas les étapes spécifiques au scénario, telles que l’installation ou l’authentification du Kit de développement logiciel (SDK).
Une fois votre environnement prêt, passez au guide de démarrage rapide pour ces instructions.

Prerequisites

  • Un compte Azure avec un abonnement actif. Si vous n'en avez pas, créez un compte Azure gratuit, qui inclut un abonnement d'essai gratuit.

  • Téléchargez, installez et configurez Visual Studio Code ou l’IDE de votre choix. Pour plus d’informations, consultez Download Visual Studio Code.

  • Pour créer et gérer des ressources Foundry, l’un des rôles Azure RBAC suivants doit être attribué.

    • Azure AI Project Manager (pour la gestion des projets Foundry)
    • Propriétaire (pour les autorisations au niveau de l’abonnement). Le rôle Propriétaire est nécessaire pour les attributions de rôles supplémentaires requises pour d’autres scénarios dans Foundry. Pour vous assurer de ne rencontrer aucun blocage dans l’ensemble des scénarios de Foundry, l’attribution du rôle Propriétaire est requise.

  • Pour utiliser le projet mais sans créer de nouvelles ressources, vous devez avoir au moins :

    • Utilisateur Azure AI sur les projets que vous utilisez (rôle de moindre privilège pour le développement)

    Pour plus d'informations sur les autorisations de chaque rôle, consultez le contrôle d'accès basé sur les rôles pour Microsoft Foundry.

Installer votre langage de programmation

Dans Visual Studio Code, créez un dossier pour votre project. Ouvrez une fenêtre de terminal dans ce dossier.

Tout d’abord, créez un environnement Python. N’installez pas de packages dans votre installation globale de Python. Utilisez toujours un environnement virtuel ou conda lors de l’installation de packages Python. Sinon, vous pouvez interrompre votre installation globale de Python.

Si nécessaire, installez Python

Utilisez Python 3.10 ou version ultérieure, mais au moins Python 3.9 est requis. Si vous n’avez pas installé une version appropriée de Python, suivez les instructions du didacticiel Python VS Code pour le moyen le plus simple d’installer Python sur votre système d’exploitation.

Créer un environnement virtuel

Si Python 3.10 ou version ultérieure est déjà installé, créez un environnement virtuel à l’aide des commandes suivantes :

py -3 -m venv .venv
.venv\scripts\activate

Lorsque vous activez l’environnement Python, l’exécution python ou pip à partir de la ligne de commande utilise l’interpréteur Python dans le .venv dossier de votre application.

Note

Utilisez la commande pour quitter l’environnement deactivate virtuel Python. Vous pouvez la réactiver ultérieurement si nécessaire.

Installer l’extension Python pour Visual Studio Code

L’extension Python pour Visual Studio Code prend en charge Python avec IntelliSense, le débogage, la mise en forme, le linting, la navigation du code, la refactorisation, l’explorateur de variables, l’explorateur de tests et la gestion de l’environnement.

Installez l’extension Python pour Visual Studio code.

Installation :

  • Kit de développement Java (JDK) 17 ou version ultérieure

Installer le pack d’extension de code Visual Studio pour Java

Le pack d’extension pour Java est une collection d’extensions populaires qui peuvent vous aider à écrire, tester et déboguer des applications Java dans Visual Studio Code.

Installez le pack d’extension de code Visual Studio pour Java.

Installez Node.js (version 18 ou ultérieure est recommandée).

Vérifiez que les outils nécessaires sont installés pour .NET développement.

Installer le Kit de développement logiciel (SDK) .NET

Vous avez besoin du sdk .NET (Kit de développement logiciel) pour créer, générer et exécuter des applications .NET. Nous vous recommandons d’installer la dernière version LTS (support à long terme) ou une version ultérieure si nécessaire par votre project.

  1. Téléchargez le Kit de développement logiciel (SDK) .NET à partir de la page de téléchargement .NET officiale. Sélectionnez le programme d’installation approprié pour votre système d’exploitation (Windows, Linux ou macOS).

  2. Suivez les instructions d’installation de votre système d’exploitation.

  3. Vérifiez l’installation en ouvrant un terminal ou une invite de commandes et en exécutant :

    dotnet --version

    La réponse doit être la version du Kit de développement logiciel (SDK) installée.

Installer le Kit de développement C# pour Visual Studio Code

Pour une expérience de développement C# optimale dans VS Code, installez l’extension officielle du Kit de développement C# :

  1. Ouvrez Visual Studio Code.
  2. Accédez à la vue Extensions (Ctrl+Maj+X ou Cmd+Maj+X).
  3. Recherchez le Kit de développement C#.
  4. Installez l’extension publiée par Microsoft. Cela installe également l’extension C# de base si vous ne l’avez pas déjà.

Créer un projet .NET

Vous pouvez créer une nouvelle .NET project à l’aide du terminal intégré à Visual Studio Code (Terminal > New Terminal).

Par exemple, pour créer une application console :

# Navigate to the directory where you want to create your project
# cd path/to/your/projects

# Create a new console application in a subfolder named MyConsoleApp
dotnet new console -o MyConsoleApp

# Navigate into the newly created project folder
cd MyConsoleApp

Vous pouvez maintenant ouvrir ce dossier MyConsoleApp dans VS Code (Fichier > Ouvrir le dossier...) pour commencer à travailler sur votre project C#. VS Code, avec l’extension C# Dev Kit, détecte automatiquement les projets, en activant des fonctionnalités telles qu’IntelliSense, le débogage et les tâches de compilation.

Installer le Azure CLI et se connecter

Vous installez le Azure CLI et connectez-vous à partir de votre environnement de développement local afin de pouvoir utiliser vos informations d’identification utilisateur pour appeler Azure OpenAI dans Microsoft Foundry Models.

Dans la plupart des cas, vous pouvez installer Azure CLI à partir de votre terminal à l’aide de la commande suivante :

winget install -e --id Microsoft.AzureCLI

Vous pouvez suivre les instructions Comment installer l'Azure CLI si ces commandes ne fonctionnent pas pour votre système d'exploitation ou configuration particulière.

Après avoir installé le Azure CLI, connectez-vous à l’aide de la commande az login et connectez-vous à l’aide du navigateur :

az login

Vous pouvez également vous connecter manuellement via le navigateur avec un code d’appareil.

az login --use-device-code

Laissez ce terminal ouvert pour exécuter des scripts après la connexion.

Installer l’interface en ligne de commande pour développeurs Azure

L’interface CLI Azure développeur (azd) est un outil open source qui vous permet de configurer et de déployer des ressources d’application sur Azure. Il fournit des commandes simples pour les étapes clés du développement, que vous utilisiez un terminal, un IDE ou un pipelines CI/CD. Installez l’interface CLI Azure Développeur pour votre plateforme.

La plupart des modèles de solution IA incluent une option de déploiement à l’aide azdde .

Installez l’extension Foundry pour VS Code

L’extension Foundry pour Visual Studio Code vous permet de déployer des modèles, de générer des applications IA et d’utiliser des agents directement à partir de l’interface VS Code. Installez l’extension Foundry VS Code.

Installer Git

Git est requis pour cloner des exemples du Kit de développement logiciel (SDK) Foundry. Si Git n’est pas installé, suivez les instructions de votre plateforme et sélectionnez votre système d’exploitation.

Résolution des problèmes

Problème Résolution
Commande introuvable après l’installation Fermez et rouvrez votre terminal ou redémarrez VS Code afin que les modifications PATH prennent effet.
az login échoue avec une erreur de navigateur Exécutez az login --use-device-code plutôt pour vous authentifier à l’aide d’un flux de code d’appareil.
Python introuvable Utilisez python3 plutôt python que sur macOS/Linux ou installez une version prise en charge (3.9 ou ultérieure).
Autorisation refusée pendant l’installation Sur macOS/Linux, évitez sudo pip install. Utilisez plutôt un environnement virtuel .

Contenu connexe

  • La documentation de référence du Java SDK
  • Last updated on