Klientská knihovna balíčku prostředků Azure AI pro Python – verze 1.0.0b2

Článek
12/06/2023

Balíček Azure AI Resources je součástí sady Azure AI SDK pro Python a obsahuje funkce pro připojení k prostředkům a projektům Azure AI a jejich správě. V rámci projektů Azure AI poskytuje operace řídicí roviny pro vytváření a správu dat, indexů, modelů a nasazení.

Zdrojový kód | Balíček (PyPI) | Referenční dokumentace k | rozhraní APIDokumentace k produktu | [Ukázky] [ml_samples]

Tento balíček byl testován s Pythonem 3.7, 3.8, 3.9 a 3.10.

Ucelenější sadu knihoven Azure najdete v tématu https://aka.ms/azsdk/python/all.

Začínáme

Požadavky

K použití tohoto balíčku se vyžaduje Python 3.7 nebo novější.
Musíte mít předplatné Azure.
Pracovní prostor služby Azure Machine Learning.

Instalace balíčku

Nainstalujte generativní balíček Azure AI pro Python pomocí pipu:

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

Ověření klienta

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

Klíčové koncepty

Pomocí této knihovny v rámci projektů Azure AI můžete poskytovat operace řídicí roviny pro vytváření a správu dat, indexů, modelů a nasazení.

Příklady

Podívejte se na naše úložiště ukázek na GitHubu, kde najdete příklady, jak používat sadu Azure AI Generative Python SDK.

Řešení potíží

Obecné

Klienti Azure AI vyvolávají výjimky definované v 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))

protokolování

Tato knihovna používá pro protokolování standardní knihovnu protokolování. Základní informace o relacích HTTP (adresy URL, hlavičky atd.) se protokolují na úrovni INFO.

Na klientovi s argumentem logging_enable je možné povolit podrobné protokolování úrovně LADĚNÍ, včetně těl požadavků/odpovědí a nereagovaných hlaviček.

Kompletní dokumentaci k protokolování sady SDK s příklady najdete tady.

Telemetrie

Sada Azure AI Generative Python SDK obsahuje telemetrii, která shromažďuje data o využití a selhání sady SDK a odesílá je do Microsoftu, když sadu SDK používáte jenom v Jupyter Notebook. Telemetrie se nebude shromažďovat pro použití sady Python SDK mimo Jupyter Notebook.

Telemetrická data pomáhají týmu sady SDK pochopit, jak se sada SDK používá, aby bylo možné ji vylepšit, a informace o chybách pomáhají týmu řešit problémy a opravovat chyby. Funkce telemetrie sady SDK je ve výchozím nastavení povolená pro Jupyter Notebook využití a nedá se povolit ve scénářích bez Jupyteru. Pokud chcete funkci telemetrie ve scénáři Jupyter zrušit, nastavte proměnnou "AZURE_AI_RESOURCES_ENABLE_LOGGING" prostředí na "False".

Další kroky