Клиентская библиотека пакета ресурсов ИИ Azure для Python версии 1.0.0b2

Статья
12/01/2023

Пакет Azure AI Resources является частью пакета SDK azure AI для Python и содержит функциональные возможности для подключения к ресурсам и проектам ИИ Azure и управления ими. В проектах ИИ Azure он предоставляет операции уровня управления для создания данных, индексов, моделей и развертываний и управления ими.

Исходный код | Пакет (PyPI) | Справочная документация по | APIДокументация по продукту | [Примеры] [ml_samples]

Этот пакет протестирован с python 3.7, 3.8, 3.9 и 3.10.

Более полный набор библиотек Azure см. в разделе https://aka.ms/azsdk/python/all.

Начало работы

Предварительные требования

Для использования этого пакета требуется Python 3.7 или более поздней версии.
У вас должна быть подписка Azure.
Рабочая область Машинного обучения Azure.

Установка пакета

Установите пакет создания ИИ Azure для Python с помощью pip:

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

Аутентификация клиента

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

Основные понятия

Используйте эту библиотеку в проектах ИИ Azure для предоставления операций уровня управления для создания данных, индексов, моделей и развертываний и управления ими.

Примеры

В нашем репозитории примеров на сайте GitHub приведены примеры использования пакета SDK azure AI Generative Python.

Устранение неполадок

Общие сведения

Клиенты ИИ Azure вызывают исключения, определенные в 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))

Ведение журнала

Эта библиотека использует для ведения журнала соответствующую стандартную библиотеку. Основные сведения о сеансах HTTP (URL-адреса, заголовки и т. д.) регистрируются на уровне INFO.

Подробное ведение журнала на уровне ОТЛАДКИ, включая тексты запросов и ответов и неотредактированные заголовки, можно включить на клиенте с аргументом logging_enable .

См. полную документацию по ведению журнала пакета SDK с примерами здесь.

Телеметрия

Пакет SDK azure AI Generative Python включает функцию телеметрии, которая собирает данные об использовании и сбоях пакета SDK и отправляет их в корпорацию Майкрософт при использовании пакета SDK только в Jupyter Notebook. Данные телеметрии не будут собираться для любого использования пакета SDK для Python за пределами Jupyter Notebook.

Данные телеметрии помогают команде sdk понять, как используется пакет SDK, чтобы его можно было улучшить, а сведения о сбоях помогают команде устранять проблемы и устранять ошибки. Функция телеметрии пакета SDK включена по умолчанию для Jupyter Notebook использования и не может быть включена для сценариев, отличных от Jupyter. Чтобы отказаться от функции телеметрии в сценарии Jupyter, задайте для переменной "AZURE_AI_RESOURCES_ENABLE_LOGGING" среды значение "False".

Дальнейшие действия