Preparare l'ambiente di sviluppo

Preparare l'ambiente di sviluppo per la compilazione con Microsoft Foundry. È necessario un linguaggio di programmazione supportato, Git e gli strumenti di sviluppo Foundry che soddisfano il flusso di lavoro.

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 e gli strumenti di sviluppo. Non tratta i pacchetti SDK specifici dello scenario o il codice di autenticazione. Quando l'ambiente è pronto, prosegui con la guida introduttiva.

Prerequisiti

Installare Foundry DevPack

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

winget install Microsoft.FoundryDevPack

DevPack installa gli strumenti di base e aggiunge estensioni host solo quando sono presenti le app:

Tool Cosa puoi fare
azd e azd ai Creare la struttura, distribuire, valutare e automatizzare dal terminale.
Competenza Microsoft Foundry Fornisci agli agenti di coding linee guida riutilizzabili per i flussi di lavoro Foundry.
Microsoft Foundry Toolkit per Visual Studio Code Installato solo quando è presente Visual Studio Code. Compilare, testare, valutare e distribuire dall'editor.
Foundry Canvas (anteprima) Installato solo quando è presente GitHub Copilot'app. Progetta e distribuisci agenti ospitati partendo da un'area di lavoro guidata.

DevPack non installa Visual Studio Code o GitHub Copilot App.

Continuare con le sezioni seguenti per configurare il linguaggio di programmazione 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 Git

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

Installare gli strumenti di sviluppo separatamente

Se non si usa Foundry DevPack, selezionare una scheda per installare solo gli strumenti necessari.

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

  2. Installare le estensioni Foundry:

    azd ext install microsoft.foundry

Per installare singole estensioni anziché il bundle completo, vedere Installare le estensioni foundry dell'interfaccia della riga di comando per sviluppatori Azure.

Per la gestione diretta e granulare delle singole risorse Azure, usare il interfaccia della riga di comando di Azure (az). Vedi interfaccia della riga di comando per sviluppatori di Azure e interfaccia della riga di comando di Azure.

Risoluzione dei problemi

Problema Risoluzione
Comando non trovato dopo l'installazione Chiudere e riaprire il terminale. Se si usa Visual Studio Code, riavviarlo in modo che le modifiche PATH vengano applicate.
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