Azure AI SDK를 시작하는 방법

  • 아티클

참고 항목

Azure AI Studio 는 현재 공개 미리 보기로 제공됩니다. 이 미리 보기는 서비스 수준 계약 없이 제공되며 프로덕션 워크로드에는 사용하지 않는 것이 좋습니다. 특정 기능이 지원되지 않거나 기능이 제한될 수 있습니다. 자세한 내용은 Microsoft Azure Preview에 대한 추가 사용 약관을 참조하세요.

Azure AI SDK는 Azure OpenAI 및 Speech와 같은 Azure AI 서비스에 대한 액세스를 제공하는 패키지 제품군입니다.

이 문서에서는 생성 AI 애플리케이션에 대한 Azure AI SDK를 시작하는 방법을 알아봅니다. 구체적으로 다음과 같은 옵션을 선택할 수 있습니다.

기존 개발 환경에 SDK 설치

Python 설치

먼저 Python 3.10 이상을 설치하고, 가상 환경 또는 conda 환경을 만들고, 해당 가상 또는 conda 환경에 패키지를 설치합니다. 전역 Python 설치에 생성 AI SDK를 설치하지 마세요. Python 패키지를 설치할 때 항상 가상 또는 conda 환경을 사용해야 합니다. 그렇지 않으면 Python의 시스템 설치를 중단시킬 수 있습니다.

가상 환경을 통해 Python 설치

운영 체제에서 Python을 설치하고 가상 환경을 만드는 가장 쉬운 방법은 VS Code Python 자습서 의 지침을 따릅니다.

Python 3.10 이상이 이미 설치된 경우 다음 명령을 사용하여 가상 환경을 만들 수 있습니다.

py -3 -m venv .venv
.venv\scripts\activate

Conda 환경을 통해 Python 설치

먼저 여기에 있는 지침에 따라 miniconda를 설치합니다.

그런 다음, 새 Python 3.10 환경을 만들고 활성화합니다.

conda create --name ai_env python=3.10
conda activate ai_env

Azure AI 생성 SDK 설치

현재 Azure AI SDK의 생성 패키지를 사용하려면 이 섹션에 설명된 대로 패키지 집합을 설치합니다.

주의

가상 환경, conda 환경 또는 Docker 컨테이너에 SDK를 설치하는 것이 좋습니다. 이 작업을 수행하지 않으면 시스템에 설치한 패키지에 종속성 문제가 발생할 수 있습니다. 자세한 내용은 Python 설치를 참조 하세요.

옵션 1: pip를 통해 설치

pip install azure-ai-generative[index,evaluate,promptflow]
pip install azure-identity

옵션 2: requirements.txt를 통해 설치

  1. 프로젝트 디렉터리에 명명된 requirements.txt 새 텍스트 파일을 만듭니다.

  2. GitHub의 Azure/aistudio-copilot-sample requirements.txt 리포지토리의 콘텐츠를 파일에 복사합니다 requirements.txt .

  3. 다음 명령을 입력하여 파일에서 requirements.txt 패키지를 설치합니다.

    pip install -r requirements.txt

이제 Azure AI SDK를 설치하고 사용할 준비가 되었습니다.

Azure AI SDK를 설치하지 않고 사용

앞에서 설명한 대로 Azure AI SDK를 로컬로 설치하거나 인터넷 브라우저 또는 Docker 컨테이너를 통해 실행할 수 있습니다.

옵션 1: Azure AI Studio에서 VS Code(웹) 사용

Azure AI Studio의 VS Code(웹)는 컴퓨팅 인스턴스에서 개발 컨테이너를 만들고 실행합니다. 이 방법을 시작하려면 VS Code(웹)에서 Azure AI Studio 프로젝트를 사용하는 방법의 지침을 따르세요.

미리 빌드된 개발 환경은 Azure AI 생성 SDK, Azure AI CLI, 프롬프트 흐름 SDK 및 기타 도구가 있는 Docker 컨테이너를 기반으로 합니다. 컨테이너 내에서 원격으로 VS Code를 실행하도록 구성됩니다. Docker 컨테이너는 이 Dockerfile에 정의되며 Microsoft의 Python 3.10 개발 컨테이너 이미지를 기반으로 합니다.

옵션 2: Visual Studio Code 개발 컨테이너

VS Code Dev Containers를 사용하여 Docker 컨테이너에서 Azure AI SDK를 실행할 수 있습니다.

  1. VS Code 개발 컨테이너에 대한 설치 지침을 따릅니다.
  2. aistudio-copilot-sample 리포지토리를 복제하고 VS Code를 사용하여 엽니다.
    git clone https://github.com/azure/aistudio-copilot-sample
code aistudio-copilot-sample
  3. 개발 컨테이너에서 다시 열기 단추를 선택합니다. 표시되지 않으면 명령 팔레트(Ctrl+Shift+P Windows 및 Linux, Cmd+Shift+P Mac)를 열고 명령을 실행합니다 Dev Containers: Reopen in Container .

옵션 3: GitHub Codespaces

GitHub Codespaces의 Azure AI 코드 샘플을 사용하면 로컬에 아무것도 설치하지 않고도 빠르게 시작할 수 있습니다.

Open in GitHub Codespaces

다음 단계