Come iniziare a usare Azure AI SDK

  • Articolo

Nota

Studio AI della piattaforma Azure è attualmente disponibile in anteprima pubblica. Questa anteprima viene fornita senza un contratto di servizio e non è consigliabile per i carichi di lavoro di produzione. Alcune funzionalità potrebbero non essere supportate o potrebbero presentare funzionalità limitate. Per altre informazioni, vedere le Condizioni supplementari per l'uso delle anteprime di Microsoft Azure.

Azure AI SDK è una famiglia di pacchetti che forniscono l'accesso ai servizi di Azure AI come OpenAI di Azure.

Questo articolo illustra come iniziare a usare Azure AI SDK per le applicazioni di intelligenza artificiale generativa. È possibile:

Installare l'SDK in un ambiente di sviluppo esistente

Installare Python

Installare innanzitutto Python 3.10 o versione successiva, creare un ambiente virtuale o un ambiente Conda e installare i pacchetti in tale ambiente virtuale o Conda. NON installare Generative AI SDK nell'installazione globale di Python. È necessario usare sempre un ambiente virtuale o Conda quando si installano i pacchetti Python, altrimenti si rischia di interrompere l'installazione di Python nel sistema.

Installare Python tramite ambienti virtuali

Seguire le istruzioni indicate nell'esercitazione su Python di VS Code per installare Python e creare un ambiente virtuale nel sistema operativo nel modo più semplice.

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

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

Installare Python tramite ambienti Conda

Installare innanzitutto Miniconda seguendo queste istruzioni.

Quindi, creare e attivare un nuovo ambiente Python 3.10:

conda create --name ai_env python=3.10
conda activate ai_env

Installare Azure AI Generative SDK

Attualmente per usare i pacchetti generativi di Azure AI SDK, si installa un set di pacchetti come descritto in questa sezione.

Attenzione

È consigliabile installare l'SDK in un ambiente virtuale, in un ambiente Conda o in un contenitore Docker. In caso contrario, è possibile che si verifichino problemi di dipendenza con i pacchetti installati nel sistema. Per altre informazioni, vedere Installare Python.

Opzione 1: Installazione tramite pip

pip install azure-ai-generative[index,evaluate,promptflow]
pip install azure-identity

Opzione 2: Installazione tramite requirements.txt

  1. Creare un nuovo file di testo denominato requirements.txt nella directory del progetto.

  2. Copiare il contenuto dal repository Azure/aistudio-copilot-sample requirements.txt di GitHub nel file requirements.txt.

  3. Immettere il comando seguente per installare i pacchetti dal file requirements.txt:

    pip install -r requirements.txt

Azure AI SDK verrà installato e sarà pronto per l'uso.

Usare Azure AI SDK senza installarlo

È possibile installare Azure AI SDK in locale come descritto in precedenza o eseguirlo tramite un browser Internet o un contenitore Docker.

Opzione 1: Uso di VS Code (Web) in Studio AI della piattaforma Azure

VS Code (Web) in Studio AI della piattaforma Azure crea ed esegue il contenitore di sviluppo in un'istanza di ambiente di calcolo. Per iniziare a usare questo approccio, seguire le istruzioni indicate in Usare i progetti di Azure per intelligenza artificiale in VS Code.

Gli ambienti di sviluppo predefiniti si basano su un contenitore Docker che include Azure AI Generative SDK, Azure AI CLI, l'SDK del prompt flow e altri strumenti. È configurato per l'esecuzione remota di VS Code all'interno del contenitore. Il contenitore Docker è definito in questo Dockerfile e si basa sull'immagine del contenitore di sviluppo Python 3.10 di Microsoft.

OPZIONE 2: Contenitore di sviluppo di Visual Studio Code

È possibile eseguire Azure AI SDK in un contenitore Docker usando i contenitori di sviluppo di VS Code:

  1. Seguire le istruzioni di installazione per i contenitori di sviluppo di VS Code.
  2. Clonare il repository aistudio-copilot-sample e aprirlo con VS Code: 
    git clone https://github.com/azure/aistudio-copilot-sample
code aistudio-copilot-sample
  3. Selezionare il pulsante Riapri nei contenitori di sviluppo. Se non viene visualizzato, aprire il riquadro comandi (Ctrl+Shift+P in Windows e Linux, Cmd+Shift+P nel Mac) ed eseguire il comando Dev Containers: Reopen in Container.

OPZIONE 3: GitHub Codespaces

Gli esempi di codice di Azure per intelligenza artificiale in GitHub Codespaces consentono di iniziare rapidamente senza dover installare nulla in locale.

Open in GitHub Codespaces

Passaggi successivi