Udostępnij za pośrednictwem

Biblioteka klienta pakietu zasobów sztucznej inteligencji platformy Azure dla języka Python — wersja 1.0.0b2

  • Artykuł

Pakiet Azure AI Resources jest częścią zestawu Azure AI SDK dla języka Python i zawiera funkcje nawiązywania połączenia z zasobami i projektami usługi Azure AI oraz zarządzania nimi. W projektach sztucznej inteligencji platformy Azure zapewnia operacje płaszczyzny sterowania na potrzeby tworzenia danych, indeksów, modeli i wdrożeń oraz zarządzania nimi.

Kod | źródłowyPakiet (PyPI) | Dokumentacja referencyjna interfejsu | APIDokumentacja produktu | [Przykłady] [ml_samples]

Ten pakiet został przetestowany przy użyciu języka Python 3.7, 3.8, 3.9 i 3.10.

Aby uzyskać bardziej kompletny zestaw bibliotek platformy Azure, zobacz https://aka.ms/azsdk/python/all.

Wprowadzenie

Wymagania wstępne

Instalowanie pakietu

Zainstaluj pakiet generowania sztucznej inteligencji platformy Azure dla języka Python przy użyciu narzędzia pip:

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

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

Kluczowe pojęcia

Użyj tej biblioteki w projektach sztucznej inteligencji platformy Azure, aby zapewnić operacje płaszczyzny sterowania na potrzeby tworzenia danych, indeksów, modeli i wdrożeń oraz zarządzania nimi.

Przykłady

Zapoznaj się z naszym repozytorium przykładów w witrynie GitHub, aby zapoznać się z przykładami pokazującymi, jak używać zestawu SDK języka Python generowania sztucznej inteligencji platformy Azure.

Rozwiązywanie problemów

Ogólne

Klienci usługi Azure AI zgłaszają wyjątki zdefiniowane w usłudze 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))

Rejestrowanie

Ta biblioteka używa standardowej biblioteki rejestrowania do rejestrowania. Podstawowe informacje o sesjach HTTP (adresach URL, nagłówkach itp.) są rejestrowane na poziomie INFORMACJI.

Szczegółowe rejestrowanie na poziomie DEBUG, w tym treści żądań/odpowiedzi i nieredagowanych nagłówków, można włączyć na kliencie z argumentem logging_enable .

Zobacz pełną dokumentację rejestrowania zestawu SDK z przykładami tutaj.

Telemetria

Zestaw SDK języka Python do generowania sztucznej inteligencji platformy Azure zawiera funkcję telemetrii, która zbiera dane użycia i niepowodzeń dotyczące zestawu SDK oraz wysyła je do firmy Microsoft tylko w przypadku korzystania z zestawu SDK w Jupyter Notebook. Dane telemetryczne nie zostaną zebrane w celu użycia zestawu SDK języka Python poza Jupyter Notebook.

Dane telemetryczne pomagają zespołowi zestawu SDK zrozumieć, w jaki sposób jest używany zestaw SDK, dzięki czemu można je ulepszyć, a informacje o błędach ułatwiają zespołowi rozwiązywanie problemów i rozwiązywanie problemów. Funkcja telemetrii zestawu SDK jest domyślnie włączona dla Jupyter Notebook użycia i nie można jej włączyć w scenariuszach innych niż Jupyter. Aby zrezygnować z funkcji telemetrii w scenariuszu jupyter, ustaw zmienną "AZURE_AI_RESOURCES_ENABLE_LOGGING" środowiskową na "False".

Następne kroki

Zapoznaj się z naszym repozytorium przykładów w witrynie GitHub, aby zapoznać się z przykładami pokazującymi, jak używać zestawu SDK języka Python generowania sztucznej inteligencji platformy Azure.

Współtworzenie

Jeśli wystąpią jakiekolwiek usterki lub masz sugestie, zgłoś problem w sekcji Problemy w projekcie.

Wrażenia