Python için Azure AI Kaynakları Paketi istemci kitaplığı - sürüm 1.0.0b2

Makale
12/06/2023

Azure AI Kaynakları paketi, Python için Azure AI SDK'sının bir parçasıdır ve Azure AI kaynaklarınıza ve projelerinize bağlanmaya ve yönetmeye yönelik işlevler içerir. Azure AI projelerinizde veri, dizin, model ve dağıtım oluşturma ve yönetmeye yönelik denetim düzlemi işlemleri sağlar.

Kaynak kodu | Paket (PyPI) | API başvuru belgeleri | Ürün belgeleri | [Örnekler] [ml_samples]

Bu paket Python 3.7, 3.8, 3.9 ve 3.10 ile test edilmiştir.

Azure kitaplıklarının daha eksiksiz bir kümesi için bkz https://aka.ms/azsdk/python/all. .

Başlarken

Önkoşullar

Bu paketi kullanmak için Python 3.7 veya üzeri gereklidir.
Bir Azure aboneliğiniz olmalıdır.
Azure Machine Learning Çalışma Alanı.

Paketi yükleme

Python için Azure AI oluşturma paketini pip ile yükleyin:

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

İstemcinin kimliğini doğrulama

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

Önemli kavramlar

Verileri, dizinleri, modelleri ve dağıtımları oluşturmaya ve yönetmeye yönelik denetim düzlemi işlemleri sağlamak için Azure AI projelerinizde bu kitaplığı kullanın.

Örnekler

Azure AI Generative Python SDK'sının nasıl kullanılacağını gösteren örnekler için GitHub'daki örnek depomuzu görüntüleyin.

Sorun giderme

Genel

Azure AI istemcileri, Azure Core'da tanımlanan özel durumları tetikler.

from azure.core.exceptions import HttpResponseError

try:
    ai_client.compute.get("cpu-cluster")
except HttpResponseError as error:
    print("Request failed: {}".format(error.message))

Günlüğe Kaydetme

Bu kitaplık, günlüğe kaydetme için standart günlük kitaplığını kullanır. HTTP oturumları (URL'ler, üst bilgiler vb.) hakkındaki temel bilgiler BİlGİ düzeyinde günlüğe kaydedilir.

İstek/yanıt gövdeleri ve kaydedilmemiş üst bilgiler de dahil olmak üzere ayrıntılı HATA AYıKLAMA düzeyi günlüğü bağımsız değişkeniyle logging_enable bir istemcide etkinleştirilebilir.

Burada örneklerin bulunduğu tam SDK günlük belgelerine bakın.

Telemetri

Azure AI Oluşturma Python SDK'sı, SDK hakkındaki kullanım ve hata verilerini toplayan ve SDK'yi yalnızca Jupyter Notebook kullandığınızda bunu Microsoft'a gönderen bir telemetri özelliği içerir. Python SDK'sının bir Jupyter Notebook dışında kullanılması için telemetri toplanmaz.

Telemetri verileri, SDK ekibinin SDK'nın nasıl kullanıldığını anlamasına yardımcı olur ve bu sayede sdk geliştirilebilir ve hatalar hakkındaki bilgiler ekibin sorunları çözmesine ve hataları düzeltmesine yardımcı olur. SDK telemetri özelliği, Jupyter Notebook kullanımı için varsayılan olarak etkindir ve Jupyter dışı senaryolar için etkinleştirilemez. Jupyter senaryosunda telemetri özelliğini geri çevirmek için ortam değişkenini "AZURE_AI_RESOURCES_ENABLE_LOGGING" olarak "False"ayarlayın.

Sonraki adımlar