Preparare l'ambiente di sviluppo

Preparare l'ambiente di sviluppo per la compilazione con il Microsoft Foundry. È necessario un linguaggio di programmazione supportato, il interfaccia della riga di comando di Azure per gli strumenti di autenticazione, Git e Foundry developer.

Tip

Foundry DevPack è il modo consigliato per installare gli strumenti di sviluppo in un unico comando. È anche possibile installare ogni strumento separatamente.

Importante

Questo articolo illustra i prerequisiti generali, gli strumenti globali e la configurazione di Visual Studio Code. Non tratta i pacchetti SDK specifici dello scenario o il codice di autenticazione. Quando l'ambiente è pronto, prosegui con la guida introduttiva.

Prerequisiti

  • Un account Azure con una sottoscrizione attiva. Se non ne hai uno, crea un account gratuito Azure, che include una sottoscrizione di valutazione gratuita.

  • Scaricare, installare e configurare Visual Studio Code oppure usare l'IDE preferito.

  • Per creare e gestire le risorse di Foundry, usa uno dei seguenti ruoli RBAC di Azure:

    • Foundry Project Manager per gestire i progetti Foundry.

    Importante

    I ruoli RBAC di Foundry sono stati recentemente rinominati. Foundry User, Foundry Owner, Foundry Account Owner e Foundry Project Manager erano precedentemente denominati Azure AI User, Azure AI Owner, Azure AI Account Owner e Azure AI Project Manager. È possibile che i nomi precedenti vengano visualizzati in alcune posizioni durante l'esecuzione della ridenominazione. Gli ID ruolo e le autorizzazioni di base sono invariati dalla ridenominazione.

    • Owner per le autorizzazioni a livello di sottoscrizione e le assegnazioni di ruolo richieste da alcuni scenari.

  • Per usare un progetto esistente senza creare risorse, è necessario almeno l'utente Foundry nel progetto.

Per informazioni dettagliate su ogni ruolo, vedere Controllo degli accessi in base al ruolo per Microsoft Foundry.

Installare Foundry DevPack

Foundry DevPack installa gli strumenti di sviluppo Foundry per l'editor, il terminale e l'agente di codifica. Esegui il comando per il tuo sistema operativo.

Windows

winget install Microsoft.FoundryDevPack

macOS

brew install --cask microsoft/foundry/devpack && foundry-devpack install

Linux

curl -fsSL https://aka.ms/foundry-devpack-install.sh | bash

DevPack installa questi strumenti:

Tool Cosa puoi fare
Microsoft Foundry Toolkit per Visual Studio Code Compilare, testare, valutare e distribuire da Visual Studio Code.
azd e azd ai Creare la struttura, distribuire, valutare e automatizzare dal terminale.
Foundry Canvas (anteprima) Progetta e distribuisci agenti ospitati con l'area di progettazione guidata di Copilot.
Competenza Microsoft Foundry Fornisci agli agenti di coding linee guida riutilizzabili per i flussi di lavoro Foundry.

Continuare con le sezioni seguenti per configurare il linguaggio di programmazione, accedere con il interfaccia della riga di comando di Azure e installare Git.

Usare un linguaggio di programmazione

Usare la lingua richiesta dall'applicazione. Espandi una sezione se devi installare il relativo runtime o l'estensione di Visual Studio Code.

Python

Installare Python 3.10 o versione successiva. Python 3.9 è la versione minima supportata. Creare un ambiente virtuale per il progetto invece di installare pacchetti a livello globale.

Windows

py -3 -m venv .venv
.\.venv\Scripts\Activate.ps1

macOS e Linux

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

Per il supporto dell'editor, installare l'estensione Python per Visual Studio Code.

Java

Installare JDK 17 o versione successiva. Il Microsoft Build di OpenJDK è una distribuzione gratuita con supporto a lungo termine. Per il supporto dell'editor, installare Visual Studio Code Extension Pack per Java.

JavaScript/TypeScript

Installare Node.js. È consigliabile usare la versione 20 o successiva.

C#

Installare la versione più recente con supporto a lungo termine di .NET SDK. Per il supporto dell'editor, installare C# Dev Kit per Visual Studio Code.

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

Tenere aperto questo terminale per eseguire gli script dopo l'accesso.

Installare Git

Per clonare gli esempi di Foundry SDK, è necessario Git. Se Git non è installato, scaricarlo e installarlo dal sito Web Git.

Installare singolarmente gli strumenti di sviluppo

Se non si usa Foundry DevPack, installare ogni strumento di sviluppo separatamente:

  1. Installare l'interfaccia della riga di comando per sviluppatori Azure.
  2. Installare tutte le estensioni Foundry per azd: 
    azd ext install microsoft.foundry
    Per installare invece singole estensioni, vedere Installare le estensioni foundry dell'interfaccia della riga di comando per sviluppatori Azure.
  3. Installare l'editor e gli strumenti dell'agente di codifica:

Molti modelli di soluzione di intelligenza artificiale supportano la distribuzione con azd.

Risoluzione dei problemi

Problema Risoluzione
Comando non trovato dopo l'installazione Chiudere e riaprire il terminale o riavviare Visual Studio 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 con un codice del dispositivo.
Python non viene trovato Usare python3 invece di python in macOS o Linux o installare Python 3.9 o versione successiva.
Autorizzazione negata durante l'installazione del pacchetto di Python In macOS o Linux non usare sudo pip install. Usare invece un ambiente virtuale.

Contenuto correlato

  • Last updated on