Share via

Azure AI SDK를 시작하는 방법

  • 아티클

참고 항목

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

Azure AI SDK는 Azure OpenAI와 같은 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 스튜디오에서 VS Code(웹) 사용

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

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

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

VS Code 개발 컨테이너를 사용하여 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. 개발 컨테이너에서 다시 열기 단추를 선택합니다. 표시되지 않으면 명령 팔레트(Windows 및 Linux에서는 Ctrl+Shift+P, Mac에서는 Cmd+Shift+P)를 열고 Dev Containers: Reopen in Container 명령을 실행합니다.

옵션 3: GitHub Codespaces

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

Open in GitHub Codespaces

다음 단계