Python용 Azure AI 리소스 패키지 클라이언트 라이브러리 - 버전 1.0.0b2

아티클
12/01/2023

Azure AI 리소스 패키지는 Python용 Azure AI SDK의 일부이며 Azure AI 리소스 및 프로젝트에 연결하고 관리하기 위한 기능을 포함합니다. Azure AI 프로젝트 내에서 데이터, 인덱스, 모델 및 배포를 만들고 관리하기 위한 컨트롤 플레인 작업을 제공합니다.

소스 코드 | 패키지(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 Machine Learning 작업 영역.

패키지 설치

pip를 사용하여 Python용 Azure AI 생성 패키지를 설치합니다.

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 AI 프로젝트 내에서 이 라이브러리를 사용하여 데이터, 인덱스, 모델 및 배포를 만들고 관리하기 위한 컨트롤 플레인 작업을 제공합니다.

예제

Azure AI 생성 Python SDK를 사용하는 방법을 보여주는 예제는 GitHub의 샘플 리포지토리 를 참조하세요.

문제 해결

일반

Azure AI 클라이언트는 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 수준에서 기록됩니다.

요청/응답 본문 및 수정되지 않은 헤더를 포함한 자세한 DEBUG 수준 로깅은 인수가 있는 클라이언트 logging_enable 에서 사용하도록 설정할 수 있습니다.

여기에 예제가 포함된 전체 SDK 로깅 설명서를 참조하세요.

원격 분석

Azure AI 생성 Python SDK에는 SDK에 대한 사용량 및 실패 데이터를 수집하고 Jupyter Notebook SDK를 사용하는 경우에만 Microsoft에 보내는 원격 분석 기능이 포함되어 있습니다. 원격 분석은 Jupyter Notebook 외부에서 Python SDK를 사용하기 위해 수집되지 않습니다.

원격 분석 데이터는 SDK 팀이 SDK를 사용하는 방법을 이해하여 SDK를 개선하는 데 도움이 되며 실패에 대한 정보는 팀이 문제를 resolve 버그를 해결하는 데 도움이 됩니다. SDK 원격 분석 기능은 Jupyter Notebook 사용에 대해 기본적으로 사용하도록 설정되며 Jupyter가 아닌 시나리오에서는 사용하도록 설정할 수 없습니다. Jupyter 시나리오에서 원격 분석 기능을 옵트아웃하려면 환경 변수 "AZURE_AI_RESOURCES_ENABLE_LOGGING""False"를 로 설정합니다.

다음 단계