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

Artykuł
12/06/2023

Pakiet generowania sztucznej inteligencji platformy Azure jest częścią zestawu Azure AI SDK dla języka Python i zawiera funkcje tworzenia, oceniania i wdrażania aplikacji generujących sztuczną inteligencję, które korzystają z usług Azure AI. Domyślna instalacja pakietu zawiera możliwości scenariuszy połączonych z chmurą, a zainstalowanie dodatków umożliwia również lokalne uruchamianie operacji (takich jak tworzenie indeksów i obliczanie metryk).

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

Do korzystania z tego pakietu wymagany jest język Python w wersji 3.7 lub nowszej.
Musisz mieć subskrypcję platformy Azure.
Obszar roboczy usługi Azure Machine Learning.

Instalowanie pakietu

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

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

Kluczowe pojęcia

Składnia [index,evaluate,promptflow] określa dodatkowe pakiety, które można opcjonalnie usunąć, jeśli nie potrzebujesz funkcji:

[index] dodaje możliwość tworzenia indeksów w lokalnym środowisku deweloperów
[evaluate] dodaje możliwość uruchamiania oceny i obliczania metryk w lokalnym środowisku deweloperów
[promptflow] dodaje możliwość tworzenia przy użyciu przepływu monitu połączonego z projektem sztucznej inteligencji platformy Azure

Użycie

Nawiązywanie połączenia z projektami

Pakiet generowania zawiera pakiet azure-ai-resources i używa go AIClient do nawiązywania połączenia z projektem.

Najpierw utwórz element 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'
)

Korzystanie z pakietu generowania

Zestaw SDK języka Python generujący sztuczną inteligencję platformy Azure oferuje następujące kluczowe możliwości.

Aby utworzyć indeks lokalnie, zaimportuj funkcję build_index:

from azure.ai.generative.index import build_index

Aby uruchomić ocenę lokalną, zaimportuj funkcję evaluate:

from azure.ai.generative.evaluate import evaluate

Aby wdrożyć funkcje czatu i przepływy monitów, zaimportuj funkcję deploy:

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

Przykładowe użycie tych przykładów można znaleźć w tym przykładzie

Przykłady

Zobacz nasze repozytorium przykładów , aby zapoznać się z przykładami korzystania z 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_GENERATIVE_ENABLE_LOGGING" środowiskową na "False".

Następne kroki