Microsoft Foundry용 프로젝트 만들기

비고

🔄새 포털을 사용하는 경우 Microsoft Foundry(새) 설명서로 전환합니다.

비고

이 문서는 Microsoft Foundry(신규) 포털을 참조합니다.

이 문서에서는 Microsoft Foundry에서 Foundry 프로젝트를 만드는 방법을 설명합니다. 프로젝트를 사용하면 상태 저장 앱을 빌드하고 새로운 아이디어를 탐색할 때 에이전트, 평가 및 파일과 같은 작업을 구성할 수 있습니다.

Foundry 프로젝트는 Microsoft Foundry 리소스로 관리됩니다. 액세스 관리, 데이터 업로드 및 통합 및 모니터링을 위한 컨테이너입니다. 이렇게 하면 추가 Azure 리소스를 만들지 않고도 사용 사례 간에 작업을 분리된 상태로 유지할 수 있습니다.
이 프로젝트 유형은 다음을 포함하여 Foundry의 최신 생성 AI 기능에 대한 액세스를 제공합니다.
- 요원
- 에이전트를 빌드하고 모델 간에 쉽게 전환할 수 있는 Foundry SDK 및 API
- Azure에서 직접 판매하는 모델 - Azure OpenAI, Mistral, xAI, DeepSeek 등
- Marketplace를 통해 판매된 파트너 및 커뮤니티 모델 - 안정성, 일관성 등
- 콘텐츠 이해
- 평가
- 미세 조정
- Batch 및 저장된 완료를 포함한 OpenAI SDK 및 API
- 주조 도구
오픈 소스 모델 또는 PromptFlow에 액세스해야 합니까? 대신 허브 프로젝트 형식을 만듭니다.
다양한 프로젝트 형식 에 대한 자세한 내용은 프로젝트 유형을 참조하세요.

조직에서 대체 이름, 보안 제어 또는 비용 태그와 같은 사용자 지정된 Azure 구성이 필요한 경우 Azure Portal 또는 템플릿 옵션을 사용하여 조직의 Azure Policy 요구 사항을 준수해야 할 수 있습니다.

필수 조건

다음 탭을 사용하여 Foundry 프로젝트를 만드는 데 사용할 메서드를 선택합니다.

활성 구독이 있는 Azure 계정. 계정이 없는 경우 평가판 구독을 포함하는 무료 Azure 계정을 만듭니다.

프로젝트의 부모인 Foundry 리소스를 만드는 데 필요한 적절한 액세스 제어를 갖도록 하려면 구독의 소유자 여야 합니다. 이 액세스 권한이 없는 경우 관리자가 사용할 수 있도록 Foundry 리소스를 만들도록 하십시오. 그런 다음 동일한 리소스에 여러 프로젝트 만들기로 건너뛰어 프로젝트를 만듭니다.

프로젝트의 부모인 Foundry 리소스를 만드는 데 필요한 적절한 액세스 제어를 갖도록 하려면 구독의 소유자 여야 합니다. 이 액세스 권한이 없다면, 관리자에게 프로젝트를 만들어 달라고 요청하십시오.

활성 구독이 있는 Azure 계정. 계정이 없는 경우 평가판 구독을 포함하는 무료 Azure 계정을 만듭니다.
프로젝트를 사용하는 데 필요한 적절한 액세스 제어를 얻으려면 구독의 소유자 여야 합니다.
개발 환경을 설정하세요
코드 실행 전에 사용자 환경에서 az login 또는 az login --use-device-code을(를) 실행하세요.

Python 스크립트를 시작하려면 다음 단계를 완료합니다.
1. 패키지 설치: pip install azure-identity azure-mgmt-cognitiveservices~=13.7.0b1. 전자 필기장 셀에 있는 경우 %pip install를 대신 사용하세요.
2. pip show azure-mgmt-cognitiveservices을 사용하여 버전이 13.7 이상인지 확인하세요.
3. 다음 코드로 스크립트를 시작하여 이 문서 전체에서 client 사용되는 연결 및 변수를 만듭니다. 이 예제에서는 미국 동부에서 프로젝트를 만듭니다.
```
from azure.identity import DefaultAzureCredential
from azure.mgmt.cognitiveservices import CognitiveServicesManagementClient

subscription_id = 'your-subscription-id'
resource_group_name = 'your-resource-group-name'
foundry_resource_name = 'your-foundry-resource-name'
foundry_project_name = 'your-foundry-project-name'
location = 'eastus'

client = CognitiveServicesManagementClient(
    credential=DefaultAzureCredential(), 
    subscription_id=subscription_id,
    api_version="2025-04-01-preview"
)
```
4. (선택 사항) 계정이 여러 개 있는 경우, Microsoft Entra ID의 테넌트 ID를 DefaultAzureCredential에 추가하세요.
```
DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
```
5. (선택 사항) 21Vianet 지역에서 운영하는 Azure Government - 미국 또는 Azure에서 작업하는 경우 인증할 지역을 지정합니다. 이 예제에서는 Azure Government - 미국 지역에 인증합니다.
```
from azure.identity import AzureAuthorityHosts
DefaultAzureCredential(authority=AzureAuthorityHosts.AZURE_GOVERNMENT)
```

Python 스크립트를 시작하려면 다음 단계를 완료합니다.
1. 패키지 설치: pip install azure-identity azure-mgmt-cognitiveservices~=13.7.0b1. 전자 필기장 셀에 있는 경우 %pip install를 대신 사용하세요.
2. pip show azure-mgmt-cognitiveservices을 사용하여 버전이 13.7 이상인지 확인하세요.
3. 다음 코드로 스크립트를 시작하여 이 문서 전체에서 client 사용되는 연결 및 변수를 만듭니다. 이 예제에서는 미국 동부에서 프로젝트를 만듭니다.
```
from azure.identity import DefaultAzureCredential
from azure.mgmt.cognitiveservices import CognitiveServicesManagementClient

subscription_id = 'your-subscription-id'
resource_group_name = 'your-resource-group-name'
foundry_resource_name = 'your-foundry-resource-name'
foundry_project_name = 'your-foundry-project-name'
location = 'eastus'

client = CognitiveServicesManagementClient(
    credential=DefaultAzureCredential(), 
    subscription_id=subscription_id,
    api_version="2025-04-01-preview"
)
```
4. (선택 사항) 계정이 여러 개 있는 경우, Microsoft Entra ID의 테넌트 ID를 DefaultAzureCredential에 추가하세요.
```
DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
```

활성 구독이 있는 Azure 계정. 계정이 없는 경우 평가판 구독을 포함하는 무료 Azure 계정을 만듭니다.
프로젝트를 사용하는 데 필요한 적절한 액세스 제어를 받으려면 구독의 소유자 여야 합니다.
Azure CLI 설치

및 subscription에 대한 resource group 기본값을 설정합니다.

  # Set your default subscription
  az account set --subscription "{subscription-name}"

  # Set default resource group
  az config set defaults.group={resource-group-name}

Foundry 프로젝트 만들기

이러한 단계는 기본 설정으로 새 Azure 리소스를 만드는 방법을 제공합니다.

Foundry 프로젝트를 만들려면 다음 단계를 수행합니다.

Microsoft Foundry에 로그인합니다. New Foundry 토글이 꺼져 있는지 확인합니다. 이러한 단계는 Foundry(클래식)를 참조합니다.

Microsoft Foundry에 로그인합니다. 새 Foundry 토글이 켜져 있는지 확인합니다. 이러한 단계는 Foundry(신규)를 참조합니다.
다음에 수행할 작업은 현재 위치에 따라 달라집니다.
- 기존 프로젝트가 없는 경우: 빠른 시작의 단계에 따라 Microsoft Foundry를 시작하여 첫 번째 프로젝트를 만듭니다.
- 프로젝트에 있다면: 프로젝트 탐색 경로를 선택한 다음, 새 리소스 만들기를 선택합니다.
- 프로젝트에 없는 경우: 오른쪽 위에서 새로 만들기 를 선택하여 새 Foundry 프로젝트를 만듭니다.
Foundry 리소스를 선택한 다음, 다음을 선택합니다.
프로젝트의 이름을 입력하고 만들기를 선택합니다. 또는 고급 옵션에 대한 다음 섹션을 참조하세요.

이러한 단계는 기본 설정으로 새 Azure 리소스를 만드는 방법을 제공합니다.

Foundry 프로젝트를 만들려면 다음 단계를 수행합니다.

Microsoft Foundry에 로그인합니다. New Foundry 토글이 꺼져 있는지 확인합니다. 이러한 단계는 Foundry(클래식)를 참조합니다.

Microsoft Foundry에 로그인합니다. 새 Foundry 토글이 켜져 있는지 확인합니다. 이러한 단계는 Foundry(신규)를 참조합니다.
작업 중인 프로젝트가 왼쪽 위 모서리에 나타납니다.
새 프로젝트를 만들려면 프로젝트 이름을 선택한 다음 새 프로젝트 만들기를 선택합니다.
프로젝트에 이름을 지정하고 프로젝트 만들기를 선택합니다. 또는 고급 옵션에 대한 다음 섹션을 참조하세요.

고급 옵션

Foundry 프로젝트는 Foundry 리소스에서 만들어집니다. 이 리소스는 프로젝트를 만들 때 자동으로 만들어집니다. 사용할 기존 리소스 그룹을 선택하거나 기본값을 그대로 두고 새 리소스 그룹을 만듭니다.

팁 (조언)

특히 시작하기 위해 프로젝트에 대한 새 리소스 그룹을 만드는 것이 좋습니다. 리소스 그룹을 사용하면 프로젝트와 모든 리소스를 쉽게 함께 관리할 수 있습니다.
위치를 선택하거나 기본값을 사용합니다. 위치는 프로젝트의 리소스가 호스트되는 지역입니다.
선택하고생성합니다. 리소스 만들기 진행률이 표시됩니다. 프로세스가 완료되면 프로젝트가 만들어집니다.

Foundry 프로젝트를 만들려면 다음을 수행합니다.

client의 변수 및 연결을 사용하여 Foundry 프로젝트를 만들려면 이 코드를 추가합니다.

# Create resource
resource = client.accounts.begin_create(
    resource_group_name=resource_group_name,
    account_name=foundry_resource_name,
    account={
        "location": location,
        "kind": "AIServices",
        "sku": {"name": "S0",},
        "identity": {"type": "SystemAssigned"},
        "properties": {
            "allowProjectManagement": True,
            "customSubDomainName": foundry_resource_name
        }
    }
)

# Wait for the resource creation to complete
resource_result = resource.result()

# Create default project
project = client.projects.begin_create(
    resource_group_name=resource_group_name,
    account_name=foundry_resource_name,
    project_name=foundry_project_name,
    project={
        "location": location,
        "identity": {
            "type": "SystemAssigned"
        },
        "properties": {}
    }
)

다음 명령을 사용하여 Azure CLI에서 Azure 구독에 인증합니다.
```
az login
```
인증에 대한 자세한 내용은 인증 방법을 참조하세요.
예를 들어 미국 동부에서 리소스 그룹을 만듭니다.
```
az group create --name {my_resource_group} --location eastus
```

Foundry 리소스 만들기

az cognitiveservices account create \
--name {your-foundry-resource-name} \
--kind AIServices \
--location eastus \
--sku s0 \
--allow-project-management

프로젝트 만들기:

az cognitiveservices account project create \
--name {your-foundry-resource-name} \
--project-name {your-project-name} \
--location eastus

동일한 리소스에 여러 프로젝트 만들기

기존 Foundry 리소스에 여러 Foundry 프로젝트를 만들어 보안, 배포 및 연결된 도구를 비롯한 팀 공동 작업 및 공유 리소스 액세스를 사용하도록 설정합니다. 이 설정은 개발자가 미리 구성된 환경 설정 내에서 셀프 서비스 탐색 기능이 필요한 제한된 Azure 구독에 이상적입니다.

다이어그램은 팀이 Foundry 리소스의 여러 프로젝트와 리소스 액세스를 공유하는 방법을 보여줍니다.

Azure 자식 리소스인 Foundry 프로젝트는 자체 액세스 제어를 할당받을 수 있지만 부모 리소스에서 네트워크 보안, 배포 및 Azure 도구 통합과 같은 일반적인 설정을 공유합니다.

모든 Foundry 기능이 아직 프로젝트에서 작업 구성을 지원하지는 않지만 리소스의 첫 번째 "기본" 프로젝트는 더 강력합니다. UX 환경의 "기본값" 태그와 코드 옵션을 사용할 때 리소스 속성 "is_default"로 식별할 수 있습니다.

특징	기본 프로젝트	기타 프로젝트
모델 유추	✅	✅
플레이그라운드	✅	✅
요원	✅	✅
평가	✅	✅
추적	✅	✅
데이터세트	✅	✅
Indexes	✅	✅
Foundry SDK 및 API	✅	✅
콘텐츠 이해	✅	✅
OpenAI SDK 및 API	✅	응답, 파일, 대화
OpenAI Batch, 미세 조정, 저장된 결과	✅	-
언어 미세 조정	✅	✅
음성 미세 조정	✅	-
관계망	✅	✅

Foundry 리소스에 프로젝트를 추가하려면 다음을 수행합니다.
팁 (조언)

Microsoft Foundry 포털에서 왼쪽 창을 사용자 지정할 수 있으므로 이러한 단계에 표시된 것과 다른 항목이 표시될 수 있습니다. 원하는 항목이 표시되지 않으면 왼쪽 창 아래쪽에 있는 ... 더 보기를 선택하십시오.
1. Microsoft Foundry에 로그인합니다. New Foundry 토글이 꺼져 있는지 확인합니다. 이러한 단계는 Foundry(클래식)를 참조합니다.
  
  Microsoft Foundry에 로그인합니다. 새 Foundry 토글이 켜져 있는지 확인합니다. 이러한 단계는 Foundry(신규)를 참조합니다.
2. Foundry 프로젝트 또는 관련 리소스를 선택합니다.
3. 왼쪽 창에서 관리 센터를 선택합니다.
4. 리소스 섹션에서 개요를 선택합니다.
5. 새 프로젝트를 선택하고 이름을 입력합니다.
Foundry(새) 포털에는 각 Foundry 리소스에 대한 기본 프로젝트만 표시됩니다. 여러 프로젝트를 만들거나 Foundry(새) 포털에서 기본이 아닌 프로젝트를 볼 수 없습니다.
이 코드는 리소스에 추가 프로젝트를 추가할 수 있지만 Foundry(새) 포털에서 볼 수 없습니다. Foundry(신규) 포털에서는 리소스에 대한 기본 프로젝트만 사용할 수 있습니다.

스크립트에 이 코드를 추가하여 기존 리소스에 새 프로젝트를 만듭니다.
```
# Create additional project
new_project_name = 'your-new-project-name'

project = client.projects.begin_create(
    resource_group_name=resource_group_name,
    account_name=foundry_resource_name,
    project_name=new_project_name,
    project={
        "location": location,
        "identity": {
            "type": "SystemAssigned"
        },
        "properties": {}
    }
)
```
이 코드는 리소스에 추가 프로젝트를 추가할 수 있지만 Foundry(새) 포털에서 볼 수 없습니다. Foundry(신규) 포털에서는 리소스에 대한 기본 프로젝트만 사용할 수 있습니다.

{foundry_resource_name}에 대한 기존 값을 사용하여 리소스에 다른 프로젝트를 추가합니다.
```
 az cognitiveservices account project create \
 --name {foundry_resource_name} \
 --project-name {my_project_name} \
 --location {location}
```
Foundry 리소스의 기본 프로젝트를 삭제하면 생성된 다음 프로젝트가 기본 프로젝트가 됩니다.

프로젝트 설정 보기

프로젝트 홈 페이지에서 프로젝트에 대한 정보를 찾을 수 있습니다.

이름: 프로젝트의 이름이 왼쪽 위 모서리에 나타납니다.
구독: 프로젝트를 호스트하는 허브를 호스트하는 구독입니다.
리소스 그룹: 프로젝트를 호스트하는 허브를 호스트하는 리소스 그룹입니다.

홈페이지에 프로젝트의 프로젝트 엔드포인트 및 API 키가 표시됩니다. Microsoft Entra ID 인증을 사용하는 경우 API 키가 필요하지 않습니다.

# Get project
project = client.projects.get(
    resource_group_name=resource_group_name,
    account_name=foundry_resource_name,
    project_name=foundry_project_name
)
print(project)

프로젝트 설정을 보려면 az cognitiveservices account connection show 명령을 사용합니다. 다음은 그 예입니다.

az cognitiveservices account connection show \
--name <my_project_name> \
--resource-group <my_resource_group>

프로젝트 삭제

Microsoft Foundry에 로그인합니다. New Foundry 토글이 꺼져 있는지 확인합니다. 이러한 단계는 Foundry(클래식)를 참조합니다.

Microsoft Foundry에 로그인합니다. 새 Foundry 토글이 켜져 있는지 확인합니다. 이러한 단계는 Foundry(신규)를 참조합니다.
프로젝트를 엽니다.
관리 센터를 선택합니다.
리소스에서 개요를 선택합니다.
더 이상 유지하지 않으려는 프로젝트를 선택합니다.
프로젝트 삭제를 선택합니다.

Foundry 리소스 및 모든 프로젝트를 삭제하려면 다음을 수행합니다.

관리 센터의 개요 섹션에서 리소스 이름을 선택하여 Azure Portal로 이동합니다.
Azure Portal에서 삭제 를 선택하여 리소스 및 연결된 모든 프로젝트를 삭제합니다.

Microsoft Foundry에 로그인합니다. New Foundry 토글이 꺼져 있는지 확인합니다. 이러한 단계는 Foundry(클래식)를 참조합니다.

Microsoft Foundry에 로그인합니다. 새 Foundry 토글이 켜져 있는지 확인합니다. 이러한 단계는 Foundry(신규)를 참조합니다.
오른쪽 위 탐색 창에서 [작동]을 선택합니다.
왼쪽 창에서 관리자를 선택합니다.
프로젝트를 선택합니다.
오른쪽 위에서 휴지통 아이콘을 선택하여 프로젝트를 삭제합니다.

이 코드는 필수 구성 요소와 client connection 변수를 사용합니다. 먼저 클라이언트 연결을 만듭니다.

client.projects.begin_delete(
    resource_group_name, foundry_resource_name, foundry_project_name
)

Foundry 리소스 및 모든 프로젝트를 삭제합니다.

# Delete projects
projects = client.projects.list(resource_group_name, foundry_resource_name)

for project in projects: 
    print("Deleting project:", project.name)
    client.projects.begin_delete(resource_group_name, foundry_resource_name,
        project_name=project.name.split('/')[-1]
    ).wait()

# Delete resource
print("Deleting resource:", foundry_resource_name)
client.accounts.begin_delete(resource_group_name, foundry_resource_name).wait()

다음 명령을 실행합니다.

az cognitiveservices account project delete \
--name {foundry_resource_name} \
--project-name {my_project_name}

피드백

이 페이지가 도움이 되었나요?

Last updated on 2025-12-10