Libreria client del pacchetto generativo di Azure per Python - versione 1.0.0b2

Articolo
12/06/2023

Il pacchetto Generative per intelligenza artificiale di Azure fa parte di Azure AI SDK per Python e contiene funzionalità per la compilazione, la valutazione e la distribuzione di applicazioni generative per intelligenza artificiale che sfruttano i servizi di intelligenza artificiale di Azure. L'installazione predefinita del pacchetto contiene funzionalità per gli scenari connessi al cloud e installando altre operazioni è anche possibile eseguire operazioni in locale, ad esempio la compilazione di indici e il calcolo delle metriche.

Codice | sorgentePacchetto (PyPI) | Documentazione | di riferimento sulle API Documentazione del prodotto | [Esempi] [ml_samples]

Questo pacchetto è stato testato con Python 3.7, 3.8, 3.9 e 3.10.

Per un set più completo di librerie di Azure, vedere https://aka.ms/azsdk/python/all.

Introduzione

Prerequisiti

Python 3.7 o versione successiva è necessario per usare questo pacchetto.
È necessario avere una sottoscrizione di Azure.
Un'area di lavoro di Azure Machine Learning.

Installare il pacchetto

Installare il pacchetto generativo di Intelligenza artificiale di Azure per Python con pip:

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

Concetti chiave

La [index,evaluate,promptflow] sintassi specifica pacchetti aggiuntivi che è possibile rimuovere facoltativamente se non sono necessarie le funzionalità:

[index] aggiunge la possibilità di compilare indici nell'ambiente di sviluppo locale
[evaluate] aggiunge la possibilità di eseguire la valutazione e calcolare le metriche nell'ambiente di sviluppo locale
[promptflow] aggiunge la possibilità di sviluppare con il flusso di richiesta connesso al progetto di intelligenza artificiale di Azure

Utilizzo

Connessione a progetti

Il pacchetto generativo include il pacchetto azure-ai-resources e usa per AIClient la connessione al progetto.

Creare prima di tutto un oggetto AI Client:

from azure.ai.resources.client import AIClient
from azure.identity import DefaultAzureCredential

ai_client = AIClient(
    credential=DefaultAzureCredential(),
    subscription_id='subscription_id',
    resource_group_name='resource_group',
    project_name='project_name'
)

Uso del pacchetto generativo

Azure AI Generative Python SDK offre le funzionalità chiave seguenti.

Per compilare un indice in locale, importare la funzione build_index:

from azure.ai.generative.index import build_index

Per eseguire una valutazione locale, importare la funzione evaluate:

from azure.ai.generative.evaluate import evaluate

Per distribuire funzioni di chat e flussi di richiesta, importare la funzione di distribuzione:

from azure.ai.resources.entities.deployment import Deployment

Per informazioni sull'utilizzo di questi esempi, fare riferimento a questo esempio

Esempio

Vedere il repository di esempi per esempi su come usare Azure AI Generative Python SDK.

Risoluzione dei problemi

Generale

I client di Intelligenza artificiale di Azure generano eccezioni definite in Azure Core.

from azure.core.exceptions import HttpResponseError

try:
    ai_client.compute.get("cpu-cluster")
except HttpResponseError as error:
    print("Request failed: {}".format(error.message))

Registrazione

Per la registrazione questa libreria usa la libreria di registrazione standard. Le informazioni di base sulle sessioni HTTP (URL, intestazioni e così via) vengono registrate a livello di INFO.

La registrazione dettagliata a livello di DEBUG, inclusi i corpi di richiesta/risposta e le intestazioni non contrassegnate, può essere abilitata in un client con l'argomento logging_enable .

Vedere la documentazione completa sulla registrazione dell'SDK con esempi qui.

Telemetria

Azure AI Generative Python SDK include una funzionalità di telemetria che raccoglie dati sull'utilizzo e sugli errori relativi all'SDK e li invia a Microsoft quando si usa l'SDK solo in un Jupyter Notebook. I dati di telemetria non verranno raccolti per l'uso di Python SDK all'esterno di un Jupyter Notebook.

I dati di telemetria consentono al team SDK di comprendere come viene usato l'SDK in modo che possa essere migliorato e le informazioni sugli errori consentono al team di risolvere i problemi e correggere i bug. La funzionalità di telemetria dell'SDK è abilitata per impostazione predefinita per l'utilizzo di Jupyter Notebook e non può essere abilitata per gli scenari non Jupyter. Per rifiutare esplicitamente la funzionalità di telemetria in uno scenario di Jupyter, impostare la variabile "AZURE_AI_GENERATIVE_ENABLE_LOGGING" di ambiente su "False".

Passaggi successivi