Preparare l'ambiente di sviluppo

Configurare l'ambiente di sviluppo per l'uso di Microsoft Foundry SDK. È anche necessaria l'interfaccia della riga di comando di Azure per l'autenticazione in modo che il codice possa accedere alle credenziali utente.

Importante

Questo articolo illustra solo i prerequisiti generali , ovvero runtime del linguaggio, strumenti globali, VS Code e configurazione dell'estensione.
Non include passaggi specifici dello scenario, ad esempio l'installazione o l'autenticazione dell'SDK.
Quando l'ambiente è pronto, prosegui con l'avvio rapido per consultare le istruzioni.

Prerequisiti

• Un account Azure con una sottoscrizione attiva. Se non ne hai uno, crea un account Azure gratuito, che include una sottoscrizione gratuita di prova.
• Scaricare, installare e configurare Visual Studio Code. Altre informazioni: Scaricare Visual Studio Code
• Impostare le appropriate autorizzazioni di controllo degli accessi in base al ruolo appropriate per creare e gestire le risorse di Microsoft Foundry con l'estensione per Visual Studio Code. Per altre informazioni, vedere Controllo degli accessi in base al ruolo per Foundry.

Installare il linguaggio di programmazione

In Visual Studio Code creare una nuova cartella per il progetto. Aprire una finestra del terminale in tale cartella.

Prima di tutto è necessario creare un nuovo ambiente Python. NON installare i pacchetti nell'installazione globale di Python. Quando si installano i pacchetti Python, è necessario usare sempre un ambiente virtuale o Conda, altrimenti si rischia di interrompere l'installazione di Python nel sistema.

Se necessario, installare Python

È consigliabile usare Python 3.10 o versione successiva, ma è necessario avere almeno Python 3.9. Se non è installata una versione appropriata di Python, seguire le istruzioni riportate in Vs Code Python Tutorial per il modo più semplice per installare Python nel sistema operativo.

Creare un ambiente virtuale

Se Python 3.10 o versione successiva è già installato, creare un ambiente virtuale usando i comandi seguenti:

Windows

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

Linux

python3 -m venv .venv
source .venv/bin/activate

macOS

python3 -m venv .venv
source .venv/bin/activate

L'attivazione dell'ambiente Python significa che quando si esegue python o pip dalla riga di comando si usa l'interprete Python contenuto nella .venv cartella dell'applicazione.

Annotazioni

Per uscire dall'ambiente virtuale Python è possibile usare il comando deactivate. Potrà poi essere riattivato successivamente, quando necessario.

Installare l'estensione Python per Visual Studio Code

L'estensione Python per Visual Studio Code supporta Python con IntelliSense, debug, formattazione, linting, navigazione del codice, refactoring, Esplora variabili, Esplora test e gestione degli ambienti.

Installare l'estensione Python per Visual Studio Code.

Installare:

• Java Development Kit (JDK) 17 o versione successiva
  • È consigliabile usare Microsoft Build of OpenJDK, che è una distribuzione gratuita Long-Term Support (LTS) di OpenJDK

Installare il Visual Studio Code pacchetto di estensioni per Java

Extension Pack per Java è una raccolta di estensioni più diffuse che consentono di scrivere, testare ed eseguire il debug di applicazioni Java in Visual Studio Code.

Installare visual Studio Code Extension Pack per Java.

Installare Node.js

Assicurarsi di avere installato gli strumenti necessari per lo sviluppo .NET.

Installare il .NET SDK

È necessario .NET SDK (Software Development Kit) per creare, compilare ed eseguire applicazioni .NET. È consigliabile installare la versione LTS (Long Term Support) più recente o una versione successiva, se richiesto dal progetto.

1. Scaricare .NET SDK dalla pagina di download ufficiale di .NET. Selezionare il programma di installazione appropriato per il sistema operativo (Windows, Linux o macOS).

2. Seguire le istruzioni di installazione per il sistema operativo.

3. Verificare l'installazione aprendo un terminale o un prompt dei comandi ed eseguendo:

   dotnet --version
   

   La risposta deve essere la versione dell'SDK installata.

Installare il C# Dev Kit per Visual Studio Code

Per un'esperienza di sviluppo C# ottimale in VS Code, installare l'estensione C# Dev Kit ufficiale:

1. Apri Visual Studio Code.
2. Passare alla visualizzazione Estensioni (CTRL+MAIUSC+X o CMD+MAIUSC+X).
3. Cercare C# Dev Kit.
4. Installare l'estensione pubblicata da Microsoft. In questo modo verrà installata anche l'estensione C# di base, se non è già disponibile.

Creare un nuovo progetto .NET

È possibile creare un nuovo progetto .NET usando il terminale integrato in Visual Studio Code (Terminale > nuovo terminale).

Ad esempio, per creare una nuova applicazione 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

È ora possibile aprire questa MyConsoleApp cartella in VS Code (File > Open Folder...) per iniziare a lavorare al progetto C#. VS Code, con l'estensione C# Dev Kit, rileverà automaticamente il progetto, abilitando funzionalità come IntelliSense, debug e attività di compilazione.

Installare Azure CLI e accedere

Installare l'interfaccia della riga di comando di Azure e accedere dall'ambiente di sviluppo locale, in modo da poter usare le credenziali utente per chiamare Azure OpenAI in Microsoft Foundry Models.

Nella maggior parte dei casi è possibile installare l'interfaccia della riga di comando di Azure dal terminale usando il comando seguente:

Windows

winget install -e --id Microsoft.AzureCLI

Linux

curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash

macOS

brew update && brew install azure-cli

Se questi comandi non funzionano per il sistema operativo o l'installazione specifici, è possibile seguire le istruzioni in Come installare l'interfaccia della riga di comando di Azure.

Dopo aver installato l'interfaccia della riga di comando di Azure, accedere usando il comando az login e registrarsi tramite il browser:

az login

In alternativa, è possibile accedere manualmente tramite il browser con un codice del dispositivo.

az login --use-device-code

Mantenere aperto questo terminale per eseguire script dopo l'accesso.

Installare l'interfaccia della riga di comando per sviluppatori di Azure

L'interfaccia della riga di comando per sviluppatori di Azure (azd) è uno strumento open source che consente di configurare e distribuire le risorse dell'app in Azure. Fornisce semplici comandi per le fasi principali dello sviluppo, sia che si usino pipeline di terminale, IDE o CI/CD. Installa Azure Developer CLI per la tua piattaforma.

Installare l'estensione Foundry VS Code

L'estensione Foundry per Visual Studio Code consente di distribuire modelli, compilare app di intelligenza artificiale e usare agenti direttamente dall'interfaccia di VS Code. Installare l'estensione Foundry VS Code.

Installare Git

Molti degli esempi di Microsoft Foundry SDK usano Git per il controllo della versione. Se Git non è installato, seguire le istruzioni per la piattaforma e selezionare il sistema operativo.

Passo successivo

• Introduzione a Foundry