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

아티클
12/01/2023

Azure AI 생성 패키지는 Python용 Azure AI SDK의 일부이며 Azure AI 서비스를 활용하는 생성 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-generative[index,evaluate,promptflow]
pip install azure-identity

주요 개념

구문은 [index,evaluate,promptflow] 기능이 필요하지 않은 경우 선택적으로 제거할 수 있는 추가 패키지를 지정합니다.

[index] 는 로컬 개발 환경에서 인덱스를 빌드하는 기능을 추가합니다.
[evaluate] 는 로컬 개발 환경에서 평가를 실행하고 메트릭을 계산하는 기능을 추가합니다.
[promptflow] 는 Azure AI 프로젝트에 연결된 프롬프트 흐름을 사용하여 개발하는 기능을 추가합니다.

사용량

프로젝트에 연결

생성 패키지에는 azure-ai-resources 패키지가 포함되며 을 사용하여 AIClient 프로젝트에 연결합니다.

먼저 를 만듭니다.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'
)

생성 패키지 사용

Azure AI 생성 Python SDK는 다음과 같은 주요 기능을 제공합니다.

인덱스 로컬로 빌드하려면 build_index 함수를 가져옵니다.

from azure.ai.generative.index import build_index

로컬 평가를 실행하려면 evaluate 함수를 가져옵니다.

from azure.ai.generative.evaluate import evaluate

채팅 함수 및 프롬프트 흐름을 배포하려면 deploy 함수를 가져옵니다.

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

이러한 샘플 사용법은 이 샘플을 참조하세요.

예제

Azure AI 생성 Python SDK를 사용하는 방법에 대한 예제는 샘플 리포지토리 를 참조하세요.

문제 해결

일반

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_GENERATIVE_ENABLE_LOGGING""False"를 로 설정합니다.

다음 단계