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

Articolo
12/01/2023

Il pacchetto Azure AI Resources fa parte di Azure AI SDK per Python e contiene funzionalità per la connessione e la gestione delle risorse e dei progetti di Intelligenza artificiale di Azure. All'interno dei progetti di Intelligenza artificiale di Azure fornisce operazioni del piano di controllo per la creazione e la gestione di dati, indici, modelli e distribuzioni.

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-resources
pip install azure-identity

Autenticare il 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')

Concetti chiave

Usare questa libreria all'interno dei progetti di Intelligenza artificiale di Azure per fornire operazioni del piano di controllo per la creazione e la gestione di dati, indici, modelli e distribuzioni.

Esempio

Visualizzare il repository degli esempi in GitHub per esempi che illustrano 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_RESOURCES_ENABLE_LOGGING" di ambiente su "False".

Passaggi successivi