Pustaka klien Paket Sumber Daya Azure AI untuk Python - versi 1.0.0b2

Artikel
12/01/2023

Paket Sumber Daya Azure AI adalah bagian dari Azure AI SDK untuk Python dan berisi fungsionalitas untuk menyambungkan dan mengelola sumber daya dan proyek Azure AI Anda. Dalam proyek Azure AI Anda, azure AI menyediakan operasi sarana kontrol untuk membuat dan mengelola data, indeks, model, dan penyebaran.

Kode sumber | Paket (PyPI) | Dokumentasi | referensi APIDokumentasi produk | [Sampel] [ml_samples]

Paket ini telah diuji dengan Python 3.7, 3.8, 3.9 dan 3.10.

Untuk kumpulan pustaka Azure yang lebih lengkap, lihat https://aka.ms/azsdk/python/all.

Memulai

Prasyarat

Python 3.7 atau yang lebih baru diharuskan untuk menggunakan paket ini.
Anda harus memiliki langganan Azure.
Ruang Kerja Azure Machine Learning.

Instal paketnya

Instal paket generatif Azure AI untuk Python dengan pip:

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

Mengautentikasi klien

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

Konsep utama

Gunakan pustaka ini dalam proyek Azure AI Anda untuk menyediakan operasi sarana kontrol untuk membuat dan mengelola data, indeks, model, dan penyebaran.

Contoh

Lihat repositori sampel kami di GitHub misalnya yang menunjukkan cara menggunakan Azure AI Generative Python SDK.

Pemecahan Masalah

Umum

Klien Azure AI memunculkan pengecualian yang ditentukan dalam 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))

Pembuatan Log

Pustaka ini menggunakan pustaka pengelogan standar untuk pengelogan. Informasi dasar tentang sesi HTTP (URL, header, dll.) dicatat di tingkat INFO.

Pengelogan tingkat DEBUG terperinci, termasuk isi permintaan/respons dan header yang tidak diredaktifkan, dapat diaktifkan pada klien dengan logging_enable argumen .

Lihat dokumentasi pengelogan SDK lengkap dengan contoh di sini.

Telemetri

Azure AI Generative Python SDK menyertakan fitur telemetri yang mengumpulkan data penggunaan dan kegagalan tentang SDK dan mengirimkannya ke Microsoft saat Anda menggunakan SDK hanya di Jupyter Notebook. Telemetri tidak akan dikumpulkan untuk penggunaan Python SDK apa pun di luar Jupyter Notebook.

Data telemetri membantu tim SDK memahami bagaimana SDK digunakan sehingga dapat ditingkatkan dan informasi tentang kegagalan membantu tim menyelesaikan masalah dan memperbaiki bug. Fitur telemetri SDK diaktifkan secara default untuk penggunaan Jupyter Notebook dan tidak dapat diaktifkan untuk skenario non-Jupyter. Untuk menolak fitur telemetri dalam skenario Jupyter, atur variabel "AZURE_AI_RESOURCES_ENABLE_LOGGING" lingkungan ke "False".

Langkah berikutnya