Azure AI Resources Package-klientbibliotek för Python – version 1.0.0b2

Artikel
12/01/2023

Azure AI-resurspaketet är en del av Azure AI SDK för Python och innehåller funktioner för att ansluta till och hantera dina Azure AI-resurser och -projekt. I dina Azure AI-projekt tillhandahåller den kontrollplansåtgärder för att skapa och hantera data, index, modeller och distributioner.

| KällkodPaket (PyPI) | API-referensdokumentation | Produktdokumentation | [Exempel] [ml_samples]

Det här paketet har testats med Python 3.7, 3.8, 3.9 och 3.10.

En mer fullständig uppsättning Azure-bibliotek finns i https://aka.ms/azsdk/python/all.

Komma igång

Förutsättningar

Python 3.7 eller senare krävs för att använda det här paketet.
Du måste ha en Azure-prenumeration.
En Azure Machine Learning-arbetsyta.

Installera paketet

Installera det generativa Azure AI-paketet för Python med pip:

pip install azure-ai-resources
pip install azure-identity

Autentisera klienten

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

Viktiga begrepp

Använd det här biblioteket i dina Azure AI-projekt för att tillhandahålla kontrollplansåtgärder för att skapa och hantera data, index, modeller och distributioner.

Exempel

Visa vår exempellagringsplats på GitHub för exempel som visar hur du använder Azure AI Generative Python SDK.

Felsökning

Allmänt

Azure AI-klienter genererar undantag som definierats i 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))

Loggning

Det här biblioteket använder standardloggningsbiblioteket för loggning. Grundläggande information om HTTP-sessioner (URL:er, rubriker osv.) loggas på INFO-nivå.

Detaljerad loggning på FELSÖKNINGsnivå, inklusive begärande-/svarskroppar och oredigerade huvuden, kan aktiveras på en klient med logging_enable argumentet .

Se fullständig SDK-loggningsdokumentation med exempel här.

Telemetri

Azure AI Generative Python SDK innehåller en telemetrifunktion som samlar in användnings- och feldata om SDK:n och skickar den till Microsoft när du endast använder SDK:n i en Jupyter Notebook. Telemetri samlas inte in för användning av Python SDK utanför en Jupyter Notebook.

Telemetridata hjälper SDK-teamet att förstå hur SDK:n används så att den kan förbättras och informationen om fel hjälper teamet att lösa problem och åtgärda buggar. SDK-telemetrifunktionen är aktiverad som standard för Jupyter Notebook användning och kan inte aktiveras för icke-Jupyter-scenarier. Om du vill välja bort telemetrifunktionen i ett Jupyter-scenario ställer du in miljövariabeln "AZURE_AI_RESOURCES_ENABLE_LOGGING" på "False".

Nästa steg