Microsoft Foundry SDK를 사용하도록 개발 환경을 설정합니다. 또한 코드가 사용자 자격 증명에 액세스할 수 있도록 인증을 위해 Azure CLI가 필요합니다.
중요합니다
이 문서에서는 언어 런타임, 전역 도구, VS Code 및 확장 설정과 같은 일반적인 필수 구성 요소 만 다룹니다.
SDK 설치 또는 인증과 같은 시나리오별 단계는 포함되지 않습니다 .
환경이 준비되면 빠른 시작 설명으로 계속 진행하세요.
필수 조건
- 활성 구독이 있는 Azure 계정. 계정이 없는 경우 평가판 구독을 포함하는 무료 Azure 계정을 만듭니다.
- Visual Studio Code를 다운로드, 설치 및 구성합니다. 추가 정보: Visual Studio Code 다운로드
- Visual Studio Code 확장을 사용하여 Microsoft Foundry 리소스를 만들고 관리하기 위한 적절한 RBAC 권한을 설정합니다. 자세한 내용은 Foundry에 대한 역할 기반 액세스 제어를 참조하세요.
프로그래밍 언어 설치
Visual Studio Code에서 프로젝트에 대한 새 폴더를 만듭니다. 해당 폴더에서 터미널 창을 엽니다.
먼저 새 Python 환경을 만들어야 합니다. 전역 Python 설치에 패키지를 설치하지 마세요. Python 패키지를 설치할 때 항상 가상 환경 또는 conda 환경을 사용해야 합니다. 그렇지 않으면 Python의 전역 설치가 중단될 수 있습니다.
필요한 경우 Python을 설치합니다.
Python 3.10 이상을 사용하는 것이 좋지만 Python 3.9 이상이 필요합니다. 적합한 버전의 Python이 설치되어 있지 않은 경우 운영 체제에 Python을 설치하는 가장 쉬운 방법은 VS Code Python 자습서 의 지침을 따르세요.
가상 환경 만들기
Python 3.10 이상이 이미 설치된 경우 다음 명령을 사용하여 가상 환경을 만듭니다.
Python 환경을 활성화한다는 것은 명령줄에서 python 또는 pip을(를) 실행할 때, 애플리케이션의 .venv 폴더에 포함된 Python 인터프리터를 사용한다는 것을 의미합니다.
비고
deactivate 명령을 사용하여 Python 가상 환경을 종료하고 나중에 필요할 때 다시 활성화할 수 있습니다.
Visual Studio Code용 Python 확장 설치
Visual Studio Code용 Python 확장은 IntelliSense, 디버깅, 서식 지정, 린팅, 코드 탐색, 리팩터링, 변수 탐색기, 테스트 탐색기 및 환경 관리를 사용하여 Python을 지원합니다.
설치하다:
- JDK(Java Development Kit) 17 이상
- OpenJDK의 무료 Long-Term 지원(LTS) 배포인 Microsoft Build of OpenJDK를 사용하는 것이 좋습니다.
Java용 Visual Studio Code 확장 팩 설치
Java용 확장 팩은 Visual Studio Code에서 Java 애플리케이션을 작성, 테스트 및 디버그하는 데 도움이 되는 인기 있는 확장 모음입니다.
Node.js 설치하기
.NET 개발에 필요한 도구가 설치되어 있는지 확인합니다.
.NET SDK 설치
.NET 애플리케이션을 만들고 빌드하고 실행하려면 .NET SDK(소프트웨어 개발 키트)가 필요합니다. 프로젝트에 필요한 경우 최신 LTS(장기 지원) 버전 또는 이후 버전을 설치하는 것이 좋습니다.
공식 .NET 다운로드 페이지에서 .NET SDK를 다운로드합니다. 운영 체제(Windows, Linux 또는 macOS)에 적합한 설치 관리자를 선택합니다.
사용 중인 운영 체제의 설치 지침을 따르세요.
터미널 또는 명령 프롬프트를 열고 다음을 실행하여 설치를 확인합니다.
dotnet --version응답은 설치된 SDK 버전이어야 합니다.
Visual Studio Code용 C# 개발 키트 설치
VS Code에서 최상의 C# 개발 환경을 위해 공식 C# Dev Kit 확장을 설치합니다.
- Visual Studio Code를 엽니다.
- 확장 보기(Ctrl+Shift+X 또는 Cmd+Shift+X)로 이동합니다.
- C# 개발 키트를 검색합니다.
- Microsoft에서 게시한 확장을 설치합니다. 아직 없는 경우 기본 C# 확장도 설치됩니다.
새 .NET 프로젝트 만들기
Visual Studio Code( > 터미널 새 터미널)에 통합된 터미널을 사용하여 새 .NET 프로젝트를 만들 수 있습니다.
예를 들어 새 콘솔 애플리케이션을 만들려면 다음을 수행합니다.
# Navigate to the directory where you want to create your project
# cd path/to/your/projects
# Create a new console application in a subfolder named MyConsoleApp
dotnet new console -o MyConsoleApp
# Navigate into the newly created project folder
cd MyConsoleApp
이제 VS Code(파일 MyConsoleApp 열기 폴더...)에서 이 > 폴더를 열어 C# 프로젝트 작업을 시작할 수 있습니다. C# Dev Kit 확장을 사용하는 VS Code는 프로젝트를 자동으로 검색하여 IntelliSense, 디버깅 및 빌드 작업과 같은 기능을 사용하도록 설정합니다.
Azure CLI 설치 및 로그인
사용자 자격 증명을 사용하여 Microsoft Foundry Models에서 Azure OpenAI를 호출할 수 있도록 Azure CLI 를 설치하고 로컬 개발 환경에서 로그인합니다.
대부분의 경우 다음 명령을 사용하여 터미널에서 Azure CLI를 설치할 수 있습니다.
특정 운영 체제나 설정에서 이러한 명령이 작동하지 않는 경우 Azure CLI 설치 방법 지침을 따를 수 있습니다.
Azure CLI를 설치한 후 az login 명령을 사용하여 로그인하고 브라우저를 사용하여 로그인합니다.
az login
또는 디바이스 코드를 사용하여 브라우저를 통해 수동으로 로그인할 수 있습니다.
az login --use-device-code
로그인한 후 스크립트를 실행하려면 이 터미널을 열어 둡니다.
Azure 개발자 CLI 설치
Azure 개발자 CLI(azd)는 Azure에서 앱 리소스를 설정하고 배포하는 데 도움이 되는 오픈 소스 도구입니다. 터미널, IDE 또는 CI/CD 파이프라인을 사용하는지 여부에 관계없이 개발의 주요 단계에 대한 간단한 명령을 제공합니다. 플랫폼용 Azure 개발자 CLI를 설치합니다.
Foundry VS Code 확장 설치
Visual Studio Code용 Foundry 확장을 사용하면 모델을 배포하고, AI 앱을 빌드하고, VS Code 인터페이스에서 에이전트로 직접 작업할 수 있습니다. Foundry VS Code 확장을 설치합니다.
Git 설치
대부분의 Microsoft Foundry SDK 샘플은 버전 제어에 Git을 사용합니다. Git이 설치되어 있지 않은 경우 플랫폼에 대한 지침에 따라 운영 체제를 선택합니다.