Condividi tramite

Preparare l'ambiente di sviluppo

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

In questo articolo vengono installati i runtime del linguaggio, interfaccia della riga di comando di Azure, Azure Developer CLI, l'estensione Foundry per VS Code e Git.

Importante

Questo articolo illustra solo i prerequisiti generali , ad esempio i runtime del linguaggio, gli strumenti globali e la configurazione dell'estensione di VS Code.
Non tratta i 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 un abbonamento di prova gratuita.

  • Scaricare, installare e configurare Visual Studio Code o l'IDE preferito. Per altre informazioni, vedere Download Visual Studio Code.

  • Per creare e gestire le risorse Foundry, uno dei seguenti ruoli di controllo degli accessi in base al ruolo di Azure

    • Azure AI Project Manager (per la gestione dei progetti Foundry)
    • Proprietario (per le autorizzazioni a livello di sottoscrizione). Per assegnare ruoli aggiuntivi necessari in altri scenari in Foundry, è indispensabile il proprietario. Per garantire di essere sbloccati per tutti gli scenari in Foundry, è necessaria l'assegnazione del ruolo di Proprietario.

  • Per usare project ma non creare nuove risorse, è necessario almeno:

    • Utente di Azure AI nei progetti che utilizzi (ruolo con privilegi minimi per lo sviluppo)

    Per informazioni dettagliate sulle autorizzazioni di ogni ruolo, vedere Controllo degli accessi in base al ruolo per Microsoft 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.

Creare prima di tutto un nuovo ambiente Python. Non installare pacchetti nell'installazione globale Python. Usare sempre un ambiente virtuale o conda durante l'installazione di pacchetti Python. In caso contrario, è possibile interrompere l'installazione globale di Python.

Se necessario, installare Python

Usare Python 3.10 o versione successiva, ma è necessario 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 di installare Python nel sistema operativo.

Creare un ambiente virtuale

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

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

Quando si attiva l'ambiente di Python, l'esecuzione di python o pip dalla riga di comando usa l'interprete Python nella cartella .venv dell'applicazione.

Annotazioni

Usare il comando deactivate per uscire dall'ambiente virtuale Python. È possibile riattivarlo in un secondo momento quando necessario.

Installare l'estensione Python per Visual Studio Code

L'estensione di Python per Visual Studio Code supporta Python con IntelliSense, debugging, formattazione, linting, navigazione del codice, refactoring, esplora variabili, esplora test e gestione dell'ambiente.

Installare l'estensione Python per Visual Studio Code.

Installare:

  • Java Development Kit (JDK) 17 o versione successiva

Installare Visual Studio Code Extension Pack 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 il pacchetto di estensione Visual Studio Code per Java.

Installare Node.js (è consigliabile usare la versione 20 o successiva).

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

Installare il .NET SDK

È necessario il .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 project.

  1. Scaricare .NET SDK dalla pagina di download di .NET ufficiale. 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 di .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 cartella MyConsoleApp in VS Code (File > Apri cartella...) per iniziare a lavorare sul project C#. VS Code, con l'estensione C# Dev Kit, rileverà automaticamente il project, abilitando funzionalità come IntelliSense, debug e attività di compilazione.

Installare il interfaccia della riga di comando di Azure e accedere

Installare il interfaccia della riga di comando di Azure e accedere dall'ambiente di sviluppo locale in modo che il codice possa usare le credenziali utente per chiamare Azure servizi tramite Foundry.

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

winget install -e --id Microsoft.AzureCLI

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

Dopo aver installato il interfaccia della riga di comando di Azure, accedere usando il comando az login e accedere usando 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 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 usi un terminale, un IDE o un pipelines CI/CD. Installare Azure Developer CLI per la tua piattaforma.

Molti dei modelli di soluzione di intelligenza artificiale includono un'opzione di distribuzione usando azd.

Installare l'estensione Foundry VS Code

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

Installare Git

Git è necessario per clonare gli esempi di Foundry SDK. Se Git non è installato, seguire le istruzioni per la piattaforma e selezionare il sistema operativo.

Risoluzione dei problemi

Problema Risoluzione
Comando non trovato dopo l'installazione Chiudere e riaprire il terminale o riavviare VS Code, in modo che le modifiche di PATH siano effettive.
az login fallisce con un errore del browser Eseguire az login --use-device-code per eseguire l'autenticazione usando un flusso di codice del dispositivo.
Python non trovato Usare python3 anziché python in macOS/Linux o installare una versione supportata (3.9 o successiva).
Autorizzazione negata durante l'installazione Su macOS/Linux, evitare sudo pip install. Usare invece un ambiente virtuale .

Contenuti correlati

  • documentazione di riferimento .NET SDK
  • Documentazione di riferimento Java SDK
  • Last updated on